Sophie

Sophie

distrib > Mandriva > 2010.0 > i586 > media > contrib-release > by-pkgid > e8b7ce893d130f732758286a15c74b5e > files > 44

hevea-1.10-4mdv2010.0.i586.rpm

<!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>Other output formats</TITLE>
</HEAD>
<BODY >
<A HREF="manual020.html"><IMG SRC="previous_motif.gif" ALT="Previous"></A>
<A HREF="manual002.html"><IMG SRC="contents_motif.gif" ALT="Up"></A>
<HR>
<H2 CLASS="section"><A NAME="htoc52">11</A>&#XA0;&#XA0;Other <A NAME="alternative"></A>output formats</H2><UL>
<LI><A HREF="manual021.html#toc41">Text</A>
</LI><LI><A HREF="manual021.html#toc42">Info</A>
</LI></UL>
<P>
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.</P><H3 CLASS="subsection"><A NAME="toc41"></A><A NAME="htoc53">11.1</A>&#XA0;&#XA0;Text</H3><P>
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.</P><P>To translate into text, invoke H<FONT SIZE=2><sup>E</sup></FONT>V<FONT SIZE=2><sup>E</sup></FONT>A as follow:
</P><PRE CLASS="verbatim"># hevea -text [-w &lt;width&gt;] myfile.tex
</PRE><P>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>.</P><P>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&#XA0;characters wide.</P><P>Nearly every environment has been translated, included lists and tables.
The support is nearly the same as in HTML, excepted in some cases
described hereafter.</P><P>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&#X2026;
The only exception is for the verbatim environment
that puts the text inside quotes, to distinguish it more easily.</P><P>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 <A NAME="@default140"></A><TT>-w</TT> command-line option.</P><P>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><SUP>2</SUP> will be rendered as <CODE>x^2</CODE>, but &#X222B;<SUB>0</SUB><SUP>1</SUP><I>f</I>(<I>x</I>)<I>dx</I> will
yield something like : <CODE>int01f(x)dx</CODE>.</P><H3 CLASS="subsection"><A NAME="toc42"></A><A NAME="htoc54">11.2</A>&#XA0;&#XA0;Info</H3><P>
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.</P><P>You can translate your L<sup>A</sup>T<sub>E</sub>X files into info file(s) as follows:
</P><PRE CLASS="verbatim"># hevea -info [-w &lt;width&gt;] myfile.tex
</PRE><P>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>,&#X2026;</P><P>The optional argument <CODE>-w</CODE> has the same meaning as for text output.</P><P>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</P><P>A table of content is produced automatically.
References, indexes and footnotes are supported, as they are in
HTML&#XA0;mode.
However, the info format only allows pointers to info nodes,
<EM>i.e.</EM> 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.</P><HR>
<A HREF="manual020.html"><IMG SRC="previous_motif.gif" ALT="Previous"></A>
<A HREF="manual002.html"><IMG SRC="contents_motif.gif" ALT="Up"></A>
</BODY>
</HTML>