| | | Customizing the navigation panels | Contents | Index |
Normally, Hyperlatex adds a "navigation panel" at the beginning of every HTML node. This panel has links to the next and previous node on the same level, as well as to the parent node.
The easiest way to customize the navigation panel is to turn it off
for selected nodes. This is done using the commands \htmlpanel{0}
and \htmlpanel{1}. All nodes started while \htmlpanel is set
to 0 are created without a navigation panel.
If you wish to add additional fields (such as an index or table of
contents entry) to the navigation panel, you can use
\htmlpanelfield in the preamble. It takes two arguments, the text
to show in the field, and a label in the document where clicking the
link should take you. For instance, the navigation panels for this
manual were created by adding the following two lines in the preamble:
\htmlpanelfield{Contents}{hlxcontents}
\htmlpanelfield{Index}{hlxindex}
Furthermore, the navigation panels (and in fact the complete outline
of the created HTML files) can be customized to your own taste by
redefining some Hyperlatex macros. When it formats an HTML node,
Hyperlatex inserts the macro \toppanel at the beginning, and the
two macros \bottommatter and bottompanel at the end. When
\htmlpanel{0} has been set, then only \bottommatter is inserted.
The macros \toppanel and \bottompanel are responsible for
typesetting the navigation panels at the top and the bottom of every
node. You can change the appearance of these panels by redefining
those macros. See bluepanels.hlx for their default definition.
You can use \htmltopname to change the name of the top node.
If you have included language packages from the babel package, you can
change the language of the navigation panel using, for instance,
\htmlpanelgerman.
The following commands are useful for defining these macros:
\HlxPrevUrl, \HlxUpUrl, and \HlxNextUrl return the URL
of the next node in the backwards, upwards, and forwards direction.
(If there is no node in that direction, the macro evaluates to the
empty string.)
\HlxPrevTitle, \HlxUpTitle, and \HlxNextTitle return
the title of these nodes.
\HlxBackUrl and \HlxForwUrl return the URL of the previous
and following node (without looking at their depth)
\HlxBackTitle and \HlxForwTitle return the title of these
nodes.
\HlxThisTitle and \HlxThisUrl return title and URL of the
current node.
\EmptyP{expr}{A}{B} evaluates to A if expr
is not the empty string, to B otherwise.
| | | Customizing the navigation panels | Contents | Index |