\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}