document
environment. We will use the term node for the
individual HTML files.) You may want to experiment a bit with
this manual. You'll find that every
\section
and \subsection
command starts a new node. The HTML node of a section that contains subsections contains a menu whose
entries lead you to the subsections. Furthermore, every HTML node has
three buttons: Next, Previous, and Up.
The Next button leads you to the next section at the same level. That means that if you are looking at the node for the section "Getting started," the Next button takes you to "Conditional Compilation," not to "Preparing an input file" (the first subsection of "Getting started"). If you are looking at the last subsection of a section, there will be no Next button, and you have to go Up again, before you can step further. This makes it easy to browse quickly through one level of detail, while only delving into the lower levels when you become interested. (It is possible to change this default behavior.)
If you look at this manual, you'll find
that there is one special node that acts as the entry point to the
manual, and as the parent for all its sections. This node is called
the top node. Everything between the \topnode
command and
the first \section
(or \chapter
command, if you are not using
the article class) goes into the top node. Hyperlatex ignores
all the text between \
begin{document}
and \topnode
--use this
area to create the title information for your printed document. The
\topnode
command takes a single argument, which is displayed as the
heading of your top node. You can leave it empty (for instance if you
start the top node with an image).
An HTML file needs a title. This title must be set in
the preamble(1) of your document using the
\htmltitle
command. You should use something not too
long, but meaningful. (The HTML title is often displayed by browsers
in the window header, and is used in history lists or bookmark files.)
The title you specify is used directly for the top node of your
document. The other nodes get a title composed of this and the section
heading.
It is common practice
to put a short notice at the end of every HTML node, with a reference
to the author and possibly the date of creation. You can do this by
using the \htmladdress
command in the preamble, like
this:
\htmladdress{otfried@postech.vision.ac.kr}