Creating labels, links and references

You may create a new inactive label using M-! or Insert→Link→Label and a reference to this label using M-? or Insert→Link→Reference. After typing the name of the label or reference, remember to hit return in order to activate it. You may also type the first characters of the name of a reference and use the tab key in order to automatically complete it.

You should be careful to put the label at a point where its number will be correct. When labeling sections, the recommended place is just after the sectional tag. When labeling single equations (created using Insert→Mathematics→Equation), the recommended place is at the start inside the equation. When labeling multiple equations (created using Insert→Mathematics→Equations), you must put the labels just behind the equation numbers. Recall that you may use A-* in order to transform an unnumbered environment or equation into a numbered one, and vice versa.

It is possible to create hyperlinks to other documents using M-i > or Insert→Link→Hyperlink. The first field of the hyperlink is the associated text, which is displayed in blue when activated. The second field contains the name of a document, which may be on the web. As is usual for hyperlinks, a link of the form #label points to a label in the same document and a link of the form url#label points to a label in the document located at url.

In a similar fashion, an action may be associated to a piece of text or graphics using M-i * or Insert→Link→Action. The second field now contains a Guile/Scheme script command, which is executed whenever you double click on the text, after its activation. For security reasons, such scripts are not always accepted. By default, you are prompted for acceptation; this default behaviour may be changed in Options→Security. Notice that the Guile/Scheme command

    (system "shell-command")

evaluates shell-command as a shell command.

Finally, you may directly include other documents inside a given document using M-i i or Insert→Link→Include. This allows you for instance to include the listing of a program in your text in such a way that your modifications in your program are automatically reflected in your text.