<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
"http://www.w3.org/TR/REC-html40/loose.dtd">
<HTML>
<HEAD>
<META http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<META name="GENERATOR" content="hevea 1.10">
<META name="Author" content="Luc Maranget">
<LINK rel="stylesheet" type="text/css" href="manual.css">
<TITLE>Classes, Packages and Page Styles</TITLE>
</HEAD>
<BODY >
<A HREF="manual026.html"><IMG SRC="previous_motif.gif" ALT="Previous"></A>
<A HREF="manual022.html"><IMG SRC="contents_motif.gif" ALT="Up"></A>
<A HREF="manual028.html"><IMG SRC="next_motif.gif" ALT="Next"></A>
<HR>
<H2 CLASS="section"><A NAME="htoc73">B.5</A>  Classes, Packages and Page Styles</H2><UL>
<LI><A HREF="manual027.html#toc57">Document Class</A>
</LI><LI><A HREF="manual027.html#toc58">Packages and Page Styles</A>
</LI><LI><A HREF="manual027.html#toc59">The Title Page and Abstract</A>
</LI></UL>
<H3 CLASS="subsection"><A NAME="toc57"></A><A NAME="htoc74">B.5.1</A>  Document Class</H3><P>
Both L<sup>A</sup>T<sub>E</sub>X 2є <CODE>\documentclass</CODE> and old L<sup>A</sup>T<sub>E</sub>X
<CODE>\documentstyle</CODE> are accepted.
Their argument <EM>style</EM> is interpreted by attempting to load a
<EM>style</EM><TT>.hva</TT> file.
Presently, only the style files <TT>article.hva</TT>, <TT>seminar.hva</TT>,
<TT>book.hva</TT> and <TT>report.hva</TT> exist, the latter two
being equivalent.</P><P>If one of the recognized styles has already been loaded at the time when
<CODE>\documentclass</CODE> or
<CODE>\documentstyle</CODE> 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<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A as a command
line argument (see <A HREF="manual004.html#otherbase">2.2</A>).</P><P>Conversely, if H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A attempt to load <EM>style</EM><TT>.hva</TT>
fails, then a fatal error is flagged, since it can be sure
that the document cannot be processed.</P><H3 CLASS="subsection"><A NAME="toc58"></A><A NAME="htoc75">B.5.2</A>  Packages and Page Styles</H3><P><A NAME="usepackage"></A></P><P>H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A reacts to
<CODE>\usepackage[</CODE><I>options</I><CODE>]{</CODE><I>pkg</I><CODE>}</CODE> in
the following way:
</P><OL CLASS="enumerate" type=1><LI CLASS="li-enumerate">
The whole
<CODE>\usepackage</CODE> command with its arguments gets echoed to the
<EM>image</EM> file (see <A HREF="manual008.html#imagen">6</A>).
</LI><LI CLASS="li-enumerate">H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A attempt to load file <I>pkg</I><TT>.hva</TT>,
(see section <A HREF="manual041.html#search:path">C.1.1.1</A> on where H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A searches for files).
</LI></OL><P>
Note that H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A will not fail if it cannot load
<I>pkg</I><TT>.hva</TT> and that no warning is issued in that case.</P><P>The H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A distribution contains implementations of some packages,
such as <TT>verbatim</TT>, <TT>colors</TT>, <TT>graphics</TT>, etc.</P><P>In some situations it may not hurt at all if H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A does not
implement a package, for instance H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A does not provide an
implementation for the <TT>fullpage</TT> package.</P><P>Users needing an implementation of a package that is widely used and
available are encouraged to contact the
<A HREF="mailto:Luc.Maranget@inria.fr">author</A>.
Experienced users may find it fun to attempt to write package
implementations by themselves.</P><H3 CLASS="subsection"><A NAME="toc59"></A><A NAME="htoc76">B.5.3</A>  The Title Page and Abstract</H3><P>
All title related commands exist, with the following peculiarities:
</P><UL CLASS="itemize"><LI CLASS="li-itemize">
The argument to the <CODE>\title</CODE><A NAME="@default157"></A> command appears
in the HTML document header. As a consequence, titles should
remain simple. Normal design (as regards H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A) is for
<CODE>\title</CODE> to occur in the document preamble, so that the title
is known at the time when the document header is emitted (while
processing <CODE>\begin{document}</CODE>). However, there are two subtleties.<P>If no <CODE>\title</CODE>
command occurs in document preamble and that one <CODE>\title</CODE>
command appears in the document, then the title is saved into the
<TT>.haux</TT> file for a next run of H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A to put it in the
HTML document header.</P><P>If <CODE>\title</CODE> commands are present both in preamble and after
<CODE>\begin{document}</CODE>, then the former takes precedence.</P></LI><LI CLASS="li-itemize">When not present the date is left empty. The
<CODE>\today</CODE><A NAME="@default158"></A> command generates will work properly
only if <TT>hevea</TT> is invoked with the <CODE>-exec xxdate.exe</CODE>
option. Otherwise <CODE>\today</CODE> generates nothing and a warning is
issued.
</LI></UL><P>The <CODE>abstract</CODE> environment is present is all base styles,
including the <EM>book</EM> style.
The <CODE>titlepage</CODE> environment does nothing.</P><HR>
<A HREF="manual026.html"><IMG SRC="previous_motif.gif" ALT="Previous"></A>
<A HREF="manual022.html"><IMG SRC="contents_motif.gif" ALT="Up"></A>
<A HREF="manual028.html"><IMG SRC="next_motif.gif" ALT="Next"></A>
</BODY>
</HTML>
