3  Sections

The command \title may be used to title the entire document.

\title{The Odyssey} 

You can use \\ to insert linebreaks in a multiline \title.

If you wish a different ``external'' title for the Web document, use \externaltitle. TeX will ignore \externaltitle.

For Plain TeX documents, TeX2page will set the title where \title is called. In LaTeX, however, \title merely stores the title; the command that actually prints the title is \maketitle. The LaTeX commands \author and \date can be used to pass additional information to \maketitle. If \date isn't specified, TeX2page, like LaTeX, will use \today.

TeX2page recognizes the following sectioning commands: \section, \subsection, \subsubsection, \paragraph, and \subparagraph. Usage:

\section{The Princess at the River} 

The sectioning commands are numbered, and can be cross-referenced using labels (section 6). Unnumbered sections can created by affixing `*' to the sectioning command, eg,

\section*{The Princess at the River} 

Section heads may be collected into a table of contents (section 6.3).

The section number is a dotted number that reflects the section's depth. Eg, the second \subsubsection in the fourth \subsection of the third \section is numbered ``3.4.2''.

TeX2page recognizes subsections deeper than \subparagraph (depth = 5), although it does not provide the \sub...subsection or \sub...paragraph macro at these depths. To specify a section at depth n, use \sectiond{n}. Thus, \subsection is merely a convenient abbreviation for \sectiond{2}.

The command \chapter can also be used, and is useful for book-length documents. Following LaTeX convention, \chapters are considered to be at depth 0. \chapter causes a page break (section 3.1) and typesets the header more prominently than \section. \chapter* produces unnumbered chapter headings.

The command \appendix causes subsequent top-level (ie, depth = 0 if \chapters are used, depth = 1 otherwise) headings to be identified alphabetically rather than numerically.

3.1  Producing several HTML pages

Typically, TeX2page produces a single HTML page for the entire document. There are a couple of exceptions: The \chapter command will start a new HTML page. For some documents, you may want to split the document into pages at your own discretion.

As in TeX, use the commands \eject, \supereject, or \dosupereject to force a page break. (It is advisable to place a \vfill before \eject so the DVI document doesn't cause the pre-\eject text to increase its interparagraph space unsightlily in order to fill the physical page.) LaTeX users can additionally use \pagebreak, \newpage, \clearpage, \cleardoublepage.

Each of the resulting pages has a navigation bar at the top and at the bottom that let you travel quickly to the first, previous, or next page. If the document has a table of contents or an index, buttons for these are also embedded in the navigation bar. Eg,