To establish a link within a document, you can use the command
\htmlref{<active link text>}{<label>},
where the label is simply a LaTeX label. A little re-expression is often required to ensure a suitable text for the printed and the HTML version. For example, you may wish to refer to a particular section:
Our discussion of linguistic structures is possibly hard to understand.
This was accomplished as follows:
Our discussion
of \htmlref{linguistic structures}{ls:lgst}\latex{ (\ref{ls:lgst})}
is possibly hard to understand.
The command \latex{} ensures that an appropriate section number
will appear within parentheses only in the LaTeX version (section
numbering is hardly of use in a hypertext environment).
Important note: Do not insert a label only in a command destined for
HTML conversion -- it will not appear in the LaTeX version as it
will not be seen by the LaTeX system.
Thus, ensure that any label appears twice, once
as the 2nd argument of the \htmlref{}{} command and once in
the scope of a \latex{} command. This is why, for example, a label
is duplicated in the \latexonly and \htmlonly environments
of enumerated examples.
Finally, please avoid the `here' phenomenon, as in:
Click here for a detailed example.
where the `here' would be an active link. This is a naive way to express a hyperlink. It is much better to say (in the HTML version):
A detailed example is available.
where the string ``detailed example'' becomes the active link. This would be achieved as follows:
A \hyperref{detailed example}{ls:fs} \html{is available}\latex{may
be found in section~\ref{ls:fs}}.
where the \html{} command analogously screens text from the
LaTeX system but ensures it will appear in HTML when the file is
converted.