Prev Up Next
Go backward to 10.1 Siteinit, Init, and other packages
Go up to 10 Controlling Hyperlatex
Go forward to 10.3 Customizing the navigation panels

10.2 Splitting into nodes and menus

Normally, the HTML output for your document document.tex are created in files document_?.html in the same directory. You can change both the name of these files as well as the directory using the two commands \htmlname and \htmldirectory in the preamble of your source file:
  \htmldirectory{directory}
  \htmlname{basename}
The actual files created by Hyperlatex are called
directory/basename.html, directory/basename_1.html, directory/basename_2.html,
and so on. The filename can be changed for individual nodes using the \xname command.

Hyperlatex automatically partitions the document into several nodes. This is done based on the LaTeX sectioning. The section commands \chapter, \section, \subsection, \subsubsection, \paragraph, and \subparagraph are assigned levels 0 to 5.

The counter htmldepth determines at what depth separate nodes are created. The default setting is 4, which means that sections, subsections, and subsubsections are given their own nodes, while paragraphs and subparagraphs are put into the node of their parent subsection. You can change this by putting

  \setcounter{htmldepth}{depth}
in the preamble. A value of 0 means that the full document will be stored in a single file.

The individual nodes of an HTML document are linked together using hyperlinks. Hyperlatex automatically places buttons on every node that link it to the previous and next node of the same depth, if they exist, and a button to go to the parent node.

Furthermore, Hyperlatex automatically adds a menu to every node, containing pointers to all subsections of this section. (Here, "section" is used as the generic term for chapters, sections, subsections, ....) This may not always be what you want. You might want to add nicer menus, with a short description of the subsections. In that case you can turn off the automatic menus by putting

  \setcounter{htmlautomenu}{0}
in the preamble. On the other hand, you might also want to have more detailed menus, containing not only pointers to the direct subsections, but also to all subsubsections and so on. This can be achieved by using
  \setcounter{htmlautomenu}{depth}
where depth is the desired depth of recursion. The default behavior corresponds to a depth of 1.
Otfried Schwarzkopf, September 2, 1997

Prev Up Next