Commit c1d9f8c3 authored by Ralf Treinen's avatar Ralf Treinen

Imported Upstream version 1.07

parents
<!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=ISO-8859-1">
<META name="GENERATOR" content="hevea 1.07">
<META name="Author" content="Luc Maranget">
<TITLE>
Browser configuration
</TITLE>
</HEAD>
<BODY TEXT=black BGCOLOR=white>
<A HREF="manual044.html"><IMG SRC ="previous_motif.gif" ALT="Previous"></A>
<A HREF="manual043.html"><IMG SRC ="contents_motif.gif" ALT="Up"></A>
<A HREF="manual046.html"><IMG SRC ="next_motif.gif" ALT="Next"></A>
<HR>
<TABLE CELLPADDING=0 CELLSPACING=0 WIDTH="100%">
<TR><TD BGCOLOR="#2de52d"><DIV ALIGN=center><TABLE>
<TR><TD><FONT SIZE=5><B><A NAME="htoc135">C.2</A></B></FONT></TD>
<TD WIDTH="100%" ALIGN=center><FONT SIZE=5><B>Browser configuration</B></FONT></TD>
</TR></TABLE></DIV></TD>
</TR></TABLE><A NAME="browser"></A>
<A NAME="@default150"></A>
By default, H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A uses
the <CODE>FACE=symbol</CODE> attribute to the <CODE>&lt;FONT ...&gt;</CODE> tag.
This attribute is non-standard in HTML-3.2 and is now standard (and
already deprecated) in HTML-4.0 <BR>
<BR>
The symbol font is the one available on the Linux Red Hat
distribution and seems to be present on many Unix installations.
A good way to know whether your browser can show H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A symbols or
not is
comparing figure&nbsp;<A HREF="manual006.html#xfd">1</A> and the web page located at
<TT><A HREF="http://pauillac.inria.fr/~maranget/hevea//doc/symbol.html">symbol.html</A></TT>.<BR>
<BR>
<EM>Microsoft Explorer</EM> displays the symbol font by default.<BR>
<BR>
By default, <EM>Netscape Communicator</EM> does not display symbol fonts
as intended by H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A.
On an Unix system, the following procedure instructs
<EM>Netscape Communicator</EM> to do so:
<UL><LI>
Add the following line to your <TT>.Xdefaults</TT> file:
<PRE>
Netscape*documentFonts.charset*adobe-fontspecific: iso-8859-1
</PRE><LI>Issue a <CODE>xrdb .Xdefaults</CODE> command.
<LI>Restart <EM>Netscape</EM>.
<LI>Furthermore, be carefull to enable using document fonts
while disabling dynamic fonts&nbsp;: select the
Edit/Preference/Appearance/Fonts menu, and then check the appropriate
box, which should be something like "Use document-specified fonts".
</UL>
On a Macintosh,
choose <B>Western (Mac Roman)</B> in the item <B>Document&nbsp;Encoding</B>
from the <EM>Preferences</EM> menu. This will work only if the document
does not contain iso-latin1 characters above 127. That is, this will
work only with documents that are generated by H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A with the
<TT>-noiso</TT> option enabled (see section&nbsp;<A HREF="manual044.html#heveaoptions">C.1.1.4</A>).<BR>
<BR>
More details on browser configuration can be found at
<TT><A HREF="http://hutchinson.belmont.ma.us/tth/Xfonts.html">http://hutchinson.belmont.ma.us/tth/Xfonts.html</A></TT>
(A page from Ian Hutchinson's <TT>tth</TT> documentation).
In particular the <EM>Simple fix</EM> of the <TT>.Xdefaults</TT> file
above does not seem to work on <EM>Mozilla 4.78</EM>, and you should
rely on the more complicated fix described in the web page.<BR>
<BR>
More details on symbol fonts can be found
in section&nbsp;<A HREF="manual006.html#symbols">3.2.2</A> of this manual.
In particular, note that symbol fonts may be completely avoided with
the <CODE>-nosymb</CODE> option.<BR>
<BR>
<HR>
<A HREF="manual044.html"><IMG SRC ="previous_motif.gif" ALT="Previous"></A>
<A HREF="manual043.html"><IMG SRC ="contents_motif.gif" ALT="Up"></A>
<A HREF="manual046.html"><IMG SRC ="next_motif.gif" ALT="Next"></A>
</BODY>
</HTML>
This diff is collapsed.
<HTML>
<HEAD>
<TITLE>Free Document Dissemination Licence - V1</TITLE>
</HEAD>
<BODY>
<B>Free Document Dissemination Licence</B> -- FDDL version 1
<P> This document may be freely read, stored, reproduced,
disseminated, translated or quoted by any means and on any medium
provided the following conditions are met:
<UL>
<LI>
every reader or user of this document acknowledges that he his aware
that no guarantee is given regarding its contents, on any account, and
specifically concerning veracity, accuracy and fitness for any
purpose;
<LI>
no modification is made other than cosmetic, change of representation
format, translation, correction of obvious syntactic errors, or as
permitted by the clauses below;
<LI>
comments and other additions may be inserted, provided they clearly
appear as such; translations or fragments must clearly refer to an
original complete version, preferably one that is easily accessed
whenever possible;
<LI>
translations, comments and other additions must be dated and their
author(s) must be identifiable (possibly via an alias);
<LI>
this licence is preserved and applies to the whole document with
modifications and additions (except for brief quotes), independently
of the representation format;
<LI>
whatever the mode of storage, reproduction or dissemination, anyone
able to access a digitized version of this document must be able to
make a digitized copy in a format directly usable, and if possible
editable, according to accepted, and publicly documented, public
standards;
<LI>
redistributing this document to a third party requires simultaneous
redistribution of this licence, without modification, and in
particular without any further condition or restriction, expressed or
implied, related or not to this redistribution. In particular, in case
of inclusion in a database or collection, the owner or the manager of
the database or the collection renounces any right related to this
inclusion and concerning the possible uses of the document after
extraction from the database or the collection, whether alone or in
relation with other documents.
</UL>
Any incompatibility of the above clauses with legal, contractual or
judiciary decisions or constraints implies a corresponding limitation
of reading, usage, or redistribution rights for this document, verbatim
or modified.
<P>
<SMALL>
<A HREF="http://pauillac.inria.fr/~lang/licence/v1/lldd.html">Version fran&ccedil;aise : LLDD</A>
</SMALL>
</BODY>
</HTML>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
"http://www.w3.org/TR/REC-html40/loose.dtd">
<HTML>
<HEAD><TITLE>HEVEA User Documentation
Version 1.07</TITLE>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<META name="GENERATOR" content="hevea 1.07">
<META name="Author" content="Luc Maranget">
</HEAD>
<BODY TEXT=black BGCOLOR=white>
<!--HEVEA command line is: ../hevea.byte -fix -fix -exec xxdate.exe -O manual.hva manual.tex -->
<!--HACHA command line is: ../hacha.byte -tocbis manual.html -->
<BR>
<DIV ALIGN=center><TABLE CELLPADDING=10>
<TR><TD BGCOLOR="#00cc00"><DIV ALIGN=center>
<FONT SIZE=8><B>
H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A User Documentation<BR>
Version&nbsp;1.07</B></FONT><BR>
<BR>
<B><FONT SIZE=5>
Luc Maranget<SUP><A NAME="text1" HREF="manual001.html#note1">*</A></SUP></FONT><BR>
<FONT SIZE=5>
October 2, 2003</FONT></B></DIV></TD>
</TR></TABLE></DIV><BR>
<BR>
<BR>
<BR>
<BR>
<BR>
<HR>
This manual also exists in
<A HREF="ftp://ftp.inria.fr/INRIA/moscova/hevea/hevea-1.07-manual.ps.gz">compressed Postscript</A>,
<A HREF="ftp://ftp.inria.fr/INRIA/moscova/hevea/hevea-1.07-manual.pdf">PDF</A>, and as
a <A HREF="ftp://ftp.inria.fr/INRIA/moscova/hevea/hevea-1.07-manual.tar.gz">bundle of HTML files</A>.
<HR>
<BLOCKQUOTE><B>Abstract: </B>
H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A is a L<sup>A</sup>T<sub>E</sub>X to
HTML translator.
The input language is a fairly complete subset of L<sup>A</sup>T<sub>E</sub>X&nbsp;2<FONT FACE=symbol>e</FONT> (old
L<sup>A</sup>T<sub>E</sub>X style is also accepted) and the
output language is HTML that is (hopefully) correct with respect to
version 4.0 transitional.<BR>
<BR>
Exotic symbols are translated into symbols
pertaining to the symbol font of the HTML browser, using the
now standard <CODE>FACE</CODE> attribute of the <CODE>FONT</CODE> tag.
This allows the translation to HTML of quite a lot of the symbols used in
L<sup>A</sup>T<sub>E</sub>X.<BR>
<BR>
H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A understands L<sup>A</sup>T<sub>E</sub>X macro definitions. Simple user style
files are understood with little or no modifications.
Furthermore, H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A customization is done by writing L<sup>A</sup>T<sub>E</sub>X code.<BR>
<BR>
H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A is written in Objective Caml, as many lexers. It is
quite fast and flexible.
Using H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A it is possible to translate large documents such
as manuals, books, etc. very quickly. All documents are
translated as one single HTML file. Then, the output file can be cut into
smaller files, using the companion program H<FONT SIZE=2><sup>A</sup></FONT>C<FONT SIZE=2><sup>H</sup></FONT>A.<BR>
<BR>
H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A can also be instructed to output plain text or info files.<BR>
<BR>
Information on H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A is available at <TT><A HREF="http://pauillac.inria.fr/~maranget/hevea/">http://pauillac.inria.fr/~maranget/hevea/</A></TT>.
</BLOCKQUOTE>
<UL>
<LI><A HREF="manual002.html">Table of Contents</A>
</UL>
<BR>
<BR>
This document consists in three parts, a tutorial introduction, a
reference manual and some practical information. The latter part
includes a small <A HREF="manual051.html#@index">index</A>.
<BR>
<BR>
<UL>
<LI><A HREF="manual003.html">Tutorial</A>
<LI><A HREF="manual015.html">Reference manual</A>
<LI><A HREF="manual043.html">Practical information</A>
</UL>
<!--FOOTER-->
<HR SIZE=2><BLOCKQUOTE><EM>This document was translated from L<sup>A</sup>T<sub>E</sub>X by
<A HREF="http://pauillac.inria.fr/~maranget/hevea/index.html">H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A and H<FONT SIZE=2><sup>A</sup></FONT>C<FONT SIZE=2><sup>H</sup></FONT>A</A>.
</EM></BLOCKQUOTE>
</BODY>
</HTML>
This diff is collapsed.
manual001.gif

347 Bytes

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
"http://www.w3.org/TR/REC-html40/loose.dtd">
<HTML>
<HEAD><TITLE>Notes</TITLE>
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<META name="GENERATOR" content="hevea 1.07">
<META name="Author" content="Luc Maranget">
</HEAD>
<BODY TEXT=black BGCOLOR=white>
<HR WIDTH="50%" SIZE=1><DL><DT><FONT SIZE=5><A NAME="note1" HREF="index.html#text1">*</A></FONT><DD>Inria Rocquencourt -- BP 105, 78153 Le
Chesnay Cedex. <TT><A HREF="mailto:Luc.Maranget@inria.fr">Luc.Maranget@inria.fr</A></TT>
</DL>
</BODY></HTML>
manual002.gif

471 Bytes

This diff is collapsed.
manual003.gif

185 Bytes

<!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=ISO-8859-1">
<META name="GENERATOR" content="hevea 1.07">
<META name="Author" content="Luc Maranget">
<TITLE>
Tutorial
</TITLE>
</HEAD>
<BODY TEXT=black BGCOLOR=white>
<A HREF="manual002.html"><IMG SRC ="previous_motif.gif" ALT="Previous"></A>
<A HREF="index.html"><IMG SRC ="contents_motif.gif" ALT="Up"></A>
<A HREF="manual015.html"><IMG SRC ="next_motif.gif" ALT="Next"></A>
<HR>
<DIV ALIGN=center><TABLE CELLPADDING=10>
<TR><TD BGCOLOR="#00cc00"><DIV ALIGN=center><FONT SIZE=6><B><A NAME="htoc1">Part&nbsp;A</A><BR>
Tutorial</B></FONT></DIV></TD>
</TR></TABLE></DIV>
<A NAME="usermanual"></A>
<UL>
<LI><A HREF="manual004.html">How to get started</A>
<LI><A HREF="manual005.html">Style files</A>
<UL>
<LI><A HREF="manual005.html#toc1">Standard base styles</A>
<LI><A HREF="manual005.html#toc2">Other base styles</A>
<LI><A HREF="manual005.html#toc3">Other style files</A>
</UL>
<LI><A HREF="manual006.html">A note on style</A>
<UL>
<LI><A HREF="manual006.html#toc4">Spacing, Paragraphs</A>
<LI><A HREF="manual006.html#toc5">Math mode</A>
<LI><A HREF="manual006.html#toc6">Warnings</A>
<LI><A HREF="manual006.html#toc7">Commands</A>
<LI><A HREF="manual006.html#toc8">Style choices</A>
</UL>
<LI><A HREF="manual007.html">How to detect and correct errors</A>
<UL>
<LI><A HREF="manual007.html#toc9">H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A does not know a macro</A>
<LI><A HREF="manual007.html#toc10">H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A incorrectly interprets a macro</A>
<LI><A HREF="manual007.html#toc11">H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A crashes</A>
</UL>
<LI><A HREF="manual008.html">Making H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A and L<sup>A</sup>T<sub>E</sub>X both happy</A>
<UL>
<LI><A HREF="manual008.html#toc12">File loading</A>
<LI><A HREF="manual008.html#toc13">The <TT>hevea</TT> package</A>
<LI><A HREF="manual008.html#toc14">Comments</A>
</UL>
<LI><A HREF="manual009.html">With a little help from L<sup>A</sup>T<sub>E</sub>X</A>
<UL>
<LI><A HREF="manual009.html#toc15">The <I>image</I> file</A>
<LI><A HREF="manual009.html#toc16">A toy example</A>
<LI><A HREF="manual009.html#toc17">Including Postscript images</A>
<LI><A HREF="manual009.html#toc18">Using filters</A>
</UL>
<LI><A HREF="cutname.html">Cutting your document into pieces with H<FONT SIZE=2><sup>A</sup></FONT>C<FONT SIZE=2><sup>H</sup></FONT>A</A>
<UL>
<LI><A HREF="cutname.html#toc19">Simple usage</A>
<LI><A HREF="cutname.html#toc20">Advanced usage</A>
<LI><A HREF="cutname.html#toc21">More Advanced Usage</A>
</UL>
<LI><A HREF="manual012.html">Generating HTML constructs</A>
<UL>
<LI><A HREF="manual012.html#toc22">High-Level Commands</A>
<LI><A HREF="manual012.html#toc23">More on included images</A>
<LI><A HREF="manual012.html#toc24">The <TT>rawhtml</TT> environment</A>
<LI><A HREF="manual012.html#toc25">Internal macros</A>
<LI><A HREF="manual012.html#toc26">Examples</A>
</UL>
<LI><A HREF="manual013.html">Customizing H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A</A>
<UL>
<LI><A HREF="manual013.html#toc27">Simple changes</A>
<LI><A HREF="manual013.html#toc28">Changing defaults for type-styles</A>
<LI><A HREF="manual013.html#toc29">Changing the interface of a command</A>
<LI><A HREF="manual013.html#toc30">Checking the optional argument within a command</A>
<LI><A HREF="manual013.html#toc31">Changing the Format of Images</A>
</UL>
<LI><A HREF="manual014.html">Other output formats</A>
<UL>
<LI><A HREF="manual014.html#toc32">Text</A>
<LI><A HREF="manual014.html#toc33">Info</A>
</UL>
</UL>
<BR>
<BR>
<HR>
<A HREF="manual002.html"><IMG SRC ="previous_motif.gif" ALT="Previous"></A>
<A HREF="index.html"><IMG SRC ="contents_motif.gif" ALT="Up"></A>
<A HREF="manual015.html"><IMG SRC ="next_motif.gif" ALT="Next"></A>
</BODY>
</HTML>
<!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=ISO-8859-1">
<META name="GENERATOR" content="hevea 1.07">
<META name="Author" content="Luc Maranget">
<TITLE>
How to get started
</TITLE>
</HEAD>
<BODY TEXT=black BGCOLOR=white>
<A HREF="manual003.html"><IMG SRC ="contents_motif.gif" ALT="Up"></A>
<A HREF="manual005.html"><IMG SRC ="next_motif.gif" ALT="Next"></A>
<HR>
<TABLE CELLPADDING=0 CELLSPACING=0 WIDTH="100%">
<TR><TD BGCOLOR="#2de52d"><DIV ALIGN=center><TABLE>
<TR><TD><FONT SIZE=5><B><A NAME="htoc2">1</A></B></FONT></TD>
<TD WIDTH="100%" ALIGN=center><FONT SIZE=5><B>How to get started</B></FONT></TD>
</TR></TABLE></DIV></TD>
</TR></TABLE><A NAME="getstarted"></A>
Assume that you have a file, ``<TT>a.tex</TT>'', written in L<sup>A</sup>T<sub>E</sub>X, using the
<EM>article</EM>, <EM>book</EM> or <EM>report</EM> style. Then,
translation
is achieved by issuing the command:
<PRE>
# hevea a.tex
</PRE>Probably, you will get some warnings. If
H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A does not crash, just ignore them for the moment
(Section&nbsp;<A HREF="manual007.html#trouble">4</A> explains how to correct errors).<BR>
<BR>
If everything goes fine, this will produce a new file,
``<TT>a.html</TT>'', which you can visualize through a HTML browser.
If <TT>a.tex</TT> contains math symbols you need to instruct your
browser to use symbol fonts (see section&nbsp;<A HREF="browser.html#browser">C.2</A>).<BR>
<BR>
If you wish to experiment H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A on small L<sup>A</sup>T<sub>E</sub>X source fragments,
then launch H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A without arguments. H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A will read its
standard input and print the translation on its standard output.
For instance:
<PRE>
# hevea
$x \in {\cal E}$
^D
&lt;I&gt;x&lt;/I&gt; &lt;FONT FACE=symbol&gt;&lt;/FONT&gt; &lt;FONT COLOR=red&gt;&lt;I&gt;E&lt;/I&gt;&lt;/FONT&gt;
</PRE>
You can find some more elaborate <A HREF="http://pauillac.inria.fr/~maranget/hevea//examples/index.html">examples</A> in the on-line
documentation.<BR>
<BR>
<HR>
<A HREF="manual003.html"><IMG SRC ="contents_motif.gif" ALT="Up"></A>
<A HREF="manual005.html"><IMG SRC ="next_motif.gif" ALT="Next"></A>
</BODY>
</HTML>
This diff is collapsed.
This diff is collapsed.
manual007.gif

447 Bytes

This diff is collapsed.
manual008.gif

603 Bytes

This diff is collapsed.
This diff is collapsed.
<!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=ISO-8859-1">
<META name="GENERATOR" content="hevea 1.07">
<META name="Author" content="Luc Maranget">
<TITLE>
Answers
</TITLE>
</HEAD>
<BODY TEXT=black BGCOLOR=white>
<H5>Quiz answers</H5><A NAME="answers"></A>
<OL type=1><LI>
Black is black.
<LI>White is white.
<LI>Dylan is Dylan.
</OL>
</BODY>
</HTML>
This diff is collapsed.
This diff is collapsed.
<!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=ISO-8859-1">
<META name="GENERATOR" content="hevea 1.07">
<META name="Author" content="Luc Maranget">
<TITLE>
Other output formats
</TITLE>
</HEAD>
<BODY TEXT=black BGCOLOR=white>
<A HREF="manual013.html"><IMG SRC ="previous_motif.gif" ALT="Previous"></A>
<A HREF="manual003.html"><IMG SRC ="contents_motif.gif" ALT="Up"></A>
<HR>
<TABLE CELLPADDING=0 CELLSPACING=0 WIDTH="100%">
<TR><TD BGCOLOR="#2de52d"><DIV ALIGN=center><TABLE>
<TR><TD><FONT SIZE=5><B><A NAME="htoc42">10</A></B></FONT></TD>
<TD WIDTH="100%" ALIGN=center><FONT SIZE=5><B>Other output formats</B></FONT></TD>
</TR></TABLE></DIV></TD>
</TR></TABLE><UL>
<LI><A HREF="manual014.html#toc32">Text</A>
<LI><A HREF="manual014.html#toc33">Info</A>
</UL>
<A NAME="alternative"></A>
It is possible to translate L<sup>A</sup>T<sub>E</sub>X file into other formats than
HTML. There are two such formats: plain text and info files.
This enables producing postscript,
HTML, plain text and info manuals from one (L<sup>A</sup>T<sub>E</sub>X) input file.<BR>
<BR>
<A NAME="toc32"></A><TABLE CELLPADDING=0 CELLSPACING=0 WIDTH="100%">
<TR><TD BGCOLOR="#66ff66"><DIV ALIGN=center><TABLE>
<TR><TD><FONT SIZE=4><B><A NAME="htoc43">10.1</A></B></FONT></TD>
<TD WIDTH="100%" ALIGN=center><FONT SIZE=4><B>Text</B></FONT></TD>
</TR></TABLE></DIV></TD>
</TR></TABLE>
The L<sup>A</sup>T<sub>E</sub>X file is processed and converted into a plain text
formatted file. It allows some pretty-printing in plain text.<BR>
<BR>
To translate into text, invoke H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A as follow:
<PRE>
# hevea -text [-w &lt;width&gt;] myfile.tex
</PRE>Then, H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A produces <TT>myfiles.txt</TT> a plain text translation
of <TT>myfile.tex</TT>.<BR>
<BR>
Additionally, the optional argument <TT>-w &lt;number&gt;</TT> sets the
width of the output for text formatting. By default, The text will be
72&nbsp;characters wide.<BR>
<BR>
Nearly every environments have been translated, included lists and tables.
The support is nearly the same as in HTML, excepted in some cases
described hereafter.<BR>
<BR>
Most style changes are ignored, because it is hardly
possible to render them in plain text. Thus, there are no italics,
bold fonts, underlinings, nor size change or colors...
The only exception is for the verbatim environment
that puts the text inside quotes, to distinguish it more easily.<BR>
<BR>
Tables with borders are rendered in the same spirit as in L<sup>A</sup>T<sub>E</sub>X.
Thus for instance, it is possible to get vertical lines between some
columns only.
Table rendering can be poor in case of line overflow.
The only way to correct this (apart from changing the tables
themselves) is to adjust the formatting width, using the
the <TT>-w</TT> command line option.<BR>
<BR>
For now, maths are not supported at all in text mode. You can get very weird
results with in-text mathematical formulas.
Of course, simple expressions such as subscripts remains readable.
For instance, <I>x</I><FONT SIZE=2><SUP>2</SUP></FONT> will be rendered as <CODE>x^2</CODE>, but <FONT FACE=symbol SIZE=4>ò</FONT><FONT SIZE=2><SUB>0</SUB><SUP>1</SUP></FONT><I>f</I>(<I>x</I>)<I>dx</I> will
yield something like : <CODE>int01f(x)dx</CODE>.<BR>
<BR>
<A NAME="toc33"></A><TABLE CELLPADDING=0 CELLSPACING=0 WIDTH="100%">
<TR><TD BGCOLOR="#66ff66"><DIV ALIGN=center><TABLE>
<TR><TD><FONT SIZE=4><B><A NAME="htoc44">10.2</A></B></FONT></TD>
<TD WIDTH="100%" ALIGN=center><FONT SIZE=4><B>Info</B></FONT></TD>
</TR></TABLE></DIV></TD>
</TR></TABLE>
The file format info is also supported.
Info files are text files with limited hypertext links, they
can be read by using <EM>emacs</EM> info mode or the
<TT>info</TT> program.
Please note that H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A translates plain L<sup>A</sup>T<sub>E</sub>X to info, and not
TeXinfo.<BR>
<BR>
You can translate your L<sup>A</sup>T<sub>E</sub>X files into info file(s) as follows:
<PRE>
# hevea -info [-w &lt;width&gt;] myfile.tex
</PRE>Then, H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A produces the file <TT>myfile.info</TT>, an info
translation of <TT>myfile.tex</TT>.
However, if the resulting file is too large, it is cut into pieces
automatically,
and <TT>myinfo.info</TT> now contains references for all
the nodes in the others files, which are named <TT>myfile.info-1</TT>,
<TT>myfile.info-2</TT>,...<BR>
<BR>
The optional argument <CODE>-w</CODE> has the same meaning as for text output.<BR>
<BR>
The text will be organized in nodes that follow
the pattern of L<sup>A</sup>T<sub>E</sub>X sectioning
commands. Menus are created to navigate through the sections easily<BR>
<BR>
A table of content is produced automatically.
References, indexes and footnotes are supported, as they are in
HTML&nbsp;mode.
However, the info format only allows pointers to info nodes,
i.e., in H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A case, to sectional units.
As a consequence all cross references lead to sectional unit headers.<BR>
<BR>
<HR>
<A HREF="manual013.html"><IMG SRC ="previous_motif.gif" ALT="Previous"></A>
<A HREF="manual003.html"><IMG SRC ="contents_motif.gif" ALT="Up"></A>
</BODY>
</HTML>
<!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=ISO-8859-1">
<META name="GENERATOR" content="hevea 1.07">
<META name="Author" content="Luc Maranget">
<TITLE>
Reference manual
</TITLE>
</HEAD>
<BODY TEXT=black BGCOLOR=white>
<A HREF="manual003.html"><IMG SRC ="previous_motif.gif" ALT="Previous"></A>
<A HREF="index.html"><IMG SRC ="contents_motif.gif" ALT="Up"></A>
<A HREF="manual043.html"><IMG SRC ="next_motif.gif" ALT="Next"></A>
<HR>
<DIV ALIGN=center><TABLE CELLPADDING=10>
<TR><TD BGCOLOR="#00cc00"><DIV ALIGN=center><FONT SIZE=6><B><A NAME="htoc45">Part&nbsp;B</A><BR>
Reference manual</B></FONT></DIV></TD>
</TR></TABLE></DIV>
<A NAME="referencemanual"></A><BR>
<BR>
<BR>
This part follows the pattern of the L<sup>A</sup>T<sub>E</sub>X reference
manual&nbsp;[<CITE><A HREF="manual050.html#latex">L<sup>A</sup>T<sub>E</sub>X</A>, Appendix&nbsp;C</CITE>].<BR>
<BR>
<UL>
<LI><A HREF="manual016.html">Commands and Environments</A>
<UL>
<LI><A HREF="manual016.html#toc34">Command Names and Arguments</A>
<LI><A HREF="manual016.html#toc35">Environments</A>
<LI><A HREF="manual016.html#toc36">Fragile Commands</A>
<LI><A HREF="manual016.html#toc37">Declarations</A>
<LI><A HREF="manual016.html#toc38">Invisible Commands</A>
<LI><A HREF="manual016.html#toc39">The <TT>\\</TT> Command</A>
</UL>
<LI><A HREF="manual017.html">The Structure of the Document</A>
<LI><A HREF="manual018.html">Sentences and Paragraphs</A>
<UL>
<LI><A HREF="manual018.html#toc40">Spacing</A>
<LI><A HREF="manual018.html#toc41">Paragraphs</A>
<LI><A HREF="manual018.html#toc42">Footnotes</A>
<LI><A HREF="manual018.html#toc43">Accents and special symbols</A>
</UL>
<LI><A HREF="manual019.html">Sectioning</A>
<UL>
<LI><A HREF="manual019.html#toc44">Sectioning commands</A>
<LI><A HREF="manual019.html#toc45">The Appendix</A>
<LI><A HREF="manual019.html#toc46">Table of Contents</A>
<LI><A HREF="manual019.html#toc47">Use H<FONT SIZE=2><sup>A</sup></FONT>C<FONT SIZE=2><sup>H</sup></FONT>A</A>
</UL>
<LI><A HREF="manual020.html">Classes, Packages and Page Styles</A>
<UL>
<LI><A HREF="manual020.html#toc48">Document Class</A>
<LI><A HREF="manual020.html#toc49">Packages and Page Styles</A>
<LI><A HREF="manual020.html#toc50">The Title Page and Abstract</A>
</UL>
<LI><A HREF="manual021.html">Displayed Paragraphs</A>
<UL>
<LI><A HREF="manual021.html#toc51">Quotation and Verse</A>
<LI><A HREF="manual021.html#toc52">List-Making environments</A>
<LI><A HREF="manual021.html#toc53">The <TT>list</TT> and <TT>trivlist</TT>
environments</A>
<LI><A HREF="manual021.html#toc54">Verbatim</A>
</UL>
<LI><A HREF="manual022.html">Mathematical Formulas</A>
<UL>
<LI><A HREF="manual022.html#toc55">Math Mode Environment</A>
<LI><A HREF="manual022.html#toc56">Common Structures</A>
<LI><A HREF="manual022.html#toc57">Mathematical symbols</A>
<LI><A HREF="manual022.html#toc58">Putting one thing above the other</A>
<LI><A HREF="manual022.html#toc59">Spacing</A>
<LI><A HREF="manual022.html#toc60">Changing Style</A>
</UL>
<LI><A HREF="manual023.html">Definitions, Numbering</A>
<UL>
<LI><A HREF="manual023.html#toc61">Defining Commands</A>
<LI><A HREF="manual023.html#toc62">Defining Environments</A>
<LI><A HREF="manual023.html#toc63">Theorem-like Environments</A>
<LI><A HREF="manual023.html#toc64">Numbering</A>
<LI><A HREF="manual023.html#toc65">The <TT>ifthen</TT> Package</A>
</UL>
<LI><A HREF="manual024.html">Figures and Other Floating Bodies</A>
<LI><A HREF="manual025.html">Lining It Up in Columns</A>
<UL>
<LI><A HREF="manual025.html#toc66">The <TT>tabbing</TT> Environment</A>
<LI><A HREF="manual025.html#toc67">The <TT>array</TT> and <TT>tabular</TT>
environments</A>
</UL>
<LI><A HREF="manual026.html">Moving Information Around</A>
<UL>
<LI><A HREF="manual026.html#toc68">Files</A>
<LI><A HREF="manual026.html#toc69">Cross-References</A>
<LI><A HREF="manual026.html#toc70">Bibliography and Citations</A>
<LI><A HREF="manual026.html#toc71">Splitting the Input</A>
<LI><A HREF="manual026.html#toc72">Index and Glossary</A>
<LI><A HREF="manual026.html#toc73">Terminal Input and Output</A>
</UL>
<LI><A HREF="manual027.html">Line and Page Breaking</A>
<UL>
<LI><A HREF="manual027.html#toc74">Line Breaking</A>
<LI><A HREF="manual027.html#toc75">Page Breaking</A>
</UL>
<LI><A HREF="manual028.html">Lengths, Spaces and Boxes</A>
<UL>
<LI><A HREF="manual028.html#toc76">Length</A>
<LI><A HREF="manual028.html#toc77">Space</A>
<LI><A HREF="manual028.html#toc78">Boxes</A>
</UL>
<LI><A HREF="manual029.html">Pictures and Colors</A>
<UL>
<LI><A HREF="manual029.html#toc79">The <TT>picture</TT> environment and the <TT>graphics</TT>
Package</A>
<LI><A HREF="manual029.html#toc80">The <TT>color</TT> Package</A>
</UL>
<LI><A HREF="manual030.html">Font Selection</A>
<UL>
<LI><A HREF="manual030.html#toc81">Changing the Type Style</A>
<LI><A HREF="manual030.html#toc82">Changing the Type Size</A>
<LI><A HREF="manual030.html#toc83">Special Symbols</A>
</UL>
<LI><A HREF="manual031.html">Extra Features</A>
<UL>
<LI><A HREF="manual031.html#toc84">Accents in maths</A>
<LI><A HREF="manual031.html#toc85">TeX macros</A>
<LI><A HREF="manual031.html#toc86">Command Definition inside Command Definition</A>
<LI><A HREF="manual031.html#toc87">Date and time</A>
<LI><A HREF="manual031.html#toc88">Fancy sectioning commands</A>
<LI><A HREF="manual031.html#toc89">H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A as a Back-End for VideoC</A>
</UL>
<LI><A HREF="manual032.html">Implemented Packages</A>