B.5  Classes, Packages and Page Styles

• Document Class
• Packages and Page Styles
• The Title Page and Abstract

B.5.1  Document Class

Both L^AT_EX 2є \documentclass and old L^AT_EX \documentstyle are accepted. Their argument style is interpreted by attempting to load a style.hva file. Presently, only the style files article.hva, seminar.hva, book.hva and report.hva exist, the latter two being equivalent.

If one of the recognized styles has already been loaded at the time when \documentclass or \documentstyle is executed, then no attempt to load a style file is made. This allows to override the document style file by giving one of the four recognized style files of H^EV^EA as a command line argument (see 2.2).

Conversely, if H^EV^EA attempt to load style.hva fails, then a fatal error is flagged, since it can be sure that the document cannot be processed.

B.5.2  Packages and Page Styles

H^EV^EA reacts to \usepackage[options]{pkg} in the following way:

1. The whole \usepackage command with its arguments gets echoed to the image file (see 6).
2. H^EV^EA attempt to load file pkg.hva, (see section C.1.1.1 on where H^EV^EA searches for files).

Note that H^EV^EA will not fail if it cannot load pkg.hva and that no warning is issued in that case.

The H^EV^EA distribution contains implementations of some packages, such as verbatim, colors, graphics, etc.

In some situations it may not hurt at all if H^EV^EA does not implement a package, for instance H^EV^EA does not provide an implementation for the fullpage package.

Users needing an implementation of a package that is widely used and available are encouraged to contact the author. Experienced users may find it fun to attempt to write package implementations by themselves.

B.5.3  The Title Page and Abstract

All title related commands exist, with the following peculiarities:

• The argument to the \title command appears in the html document header. As a consequence, titles should remain simple. Normal design (as regards H^EV^EA) is for \title to occur in the document preamble, so that the title is known at the time when the document header is emitted (while processing \begin{document}). However, there are two subtleties.

  If no \title command occurs in document preamble and that one \title command appears in the document, then the title is saved into the .haux file for a next run of H^EV^EA to put it in the html document header.

  If \title commands are present both in preamble and after \begin{document}, then the former takes precedence.

• When not present the date is left empty. The \today command generates will work properly only if hevea is invoked with the -exec xxdate.exe option. Otherwise \today generates nothing and a warning is issued.

The abstract environment is present is all base styles, including the book style. The titlepage environment does nothing.