Index
Go backward to Links to external information
Go up to Moving information around
Go forward to Bibliography and citation

Links into your document

The Hyperlatex converter automatically partitions your document into HTML-nodes and generates HTML-tags for your \label's. These automatically created names are simply numbers, and are not useful for external references into your document--after all, the exact numbers are going to change whenever you add or delete a section or label, or when you change the \htmldepth.

If you want to allow links from the outside world into your new document, you will have to do two things: First, you should give that HTML node a mnemonic name that is not going to change when the document is revised. Furthermore, you may want to place a mnemonic label inside the node.

The \xname{name} command is used to give the mnemonic name name to the next node created by Hyperlatex. This means that you ought to place it in front of a sectioning command. The \xname command has no function for the LaTeX-document. No warning is created if no new node is started in between two \xname commands.

If you need an HTML label within a node to be referenced from the outside, you can use the \xlabel{label} command. label has to be a legal HTML label.

The argument of \xname and \xlabel is not expanded, so you should not escape any special characters (such as _). On the other hand, if you reference them using \xlink, you will have to escape special characters.

Here is an example: The section "Changes between Hyperlatex 1.0 and Hyperlatex 1.1" in this document starts as follows.

   \xname{hyperlatex_changes}
   \section{Changes from Hyperlatex~1.0 to Hyperlatex~1.1}
   \label{sec:changes}
It can be referenced inside this document with \link{Changes}{sec:changes}, and both inside and outside this document with \xlink{Changes}{hyperlatex\_changes.html}.

The entry about \xname and \xlabel in that section has been marked using \xlabel{external_labels}. You can therefore directly refer to that position from anywhere using

   \xlink{xlabel is new}{hyperlatex\_changes.html\#external\_labels}

otfried@postech.vision.ac.kr

Prev Up Next