Commit 61455b6e authored by Ralf Treinen's avatar Ralf Treinen

Imported Upstream version 2.28

parent 3e2964c1
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Browser configuration</title>
</head>
......@@ -13,7 +13,7 @@
<hr>
<h2 class="section" id="browser">C.2&#XA0;&#XA0;Browser configuration</h2>
<p>
<a id="hevea_default265"></a><a id="hevea_default266"></a>By default, H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A does not anymore use the <code>FACE=symbol</code>
<a id="hevea_default267"></a><a id="hevea_default268"></a>By default, H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A does not anymore use the <code>FACE=symbol</code>
attribute to the <code>&lt;FONT ...&gt;</code> tag. As a consequence, browser
configuration is no longer needed.</p><p>H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A now extensively outputs Unicode entities.
This first means that H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A targets modern browsers with
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Cutting your document into pieces with HACHA</title>
</head>
......
......@@ -2,10 +2,10 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget">
<title>HEVEA User Documentation
Version&#XA0;2.23
Version&#XA0;2.28
</title>
<link rel="stylesheet" type="text/css" href="manual.css">
</head>
......@@ -13,12 +13,13 @@ Version&#XA0;2.23
<!--HEVEA command line is: ../hevea.opt -fix -exec xxdate.exe -O -o doc/manual.html manual.hva manual.tex -->
<!--HACHA command line is: ../hacha.opt -tocbis -o doc/index.html doc/manual.html -->
<table class="title"><tr><td style="padding:1ex"><h1 class="titlemain">H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A User Documentation<br>
Version&#XA0;2.23</h1><h3 class="titlerest">Luc Maranget<sup><a id="text1" href="#note1">*</a></sup></h3><h3 class="titlerest">March&#XA0;8, 2015</h3></td></tr>
Version&#XA0;2.28</h1><h3 class="titlerest">Luc Maranget<sup><a id="text1" href="#note1">*</a></sup></h3><h3 class="titlerest">December
&#XA0;29, 2015</h3></td></tr>
</table><hr><p>
This manual also exists in
<a href="http://hevea.inria.fr/distri/hevea-2.23-manual.ps.gz">compressed Postscript</a>,
<a href="http://hevea.inria.fr/distri/hevea-2.23-manual.pdf">PDF</a>, and as
a <a href="http://hevea.inria.fr/distri/hevea-2.23-manual.tar.gz">bundle of HTML files</a>.
<a href="http://hevea.inria.fr/distri/hevea-2.28-manual.ps.gz">compressed Postscript</a>,
<a href="http://hevea.inria.fr/distri/hevea-2.28-manual.pdf">PDF</a>, and as
a <a href="http://hevea.inria.fr/distri/hevea-2.28-manual.tar.gz">bundle of HTML files</a>.
</p><hr><blockquote class="abstract"><span class="c022">Abstract: </span>
H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A is a L<sup>A</sup>T<sub>E</sub>X to
html translator.
......
This diff is collapsed.
This diff is collapsed.
This source diff could not be displayed because it is too large. You can view the blob instead.
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Contents</title>
</head>
......
manual001.png

3.09 KB | W: | H:

manual001.png

904 Bytes | W: | H:

manual001.png
manual001.png
manual001.png
manual001.png
  • 2-up
  • Swipe
  • Onion skin
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Tutorial</title>
</head>
......
manual002.png

3.31 KB | W: | H:

manual002.png

1.1 KB | W: | H:

manual002.png
manual002.png
manual002.png
manual002.png
  • 2-up
  • Swipe
  • Onion skin
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>How to get started</title>
</head>
......
manual003.png

2.8 KB | W: | H:

manual003.png

596 Bytes | W: | H:

manual003.png
manual003.png
manual003.png
manual003.png
  • 2-up
  • Swipe
  • Onion skin
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Style files</title>
</head>
......
manual004.png

5.29 KB | W: | H:

manual004.png

3.08 KB | W: | H:

manual004.png
manual004.png
manual004.png
manual004.png
  • 2-up
  • Swipe
  • Onion skin
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>A note on style</title>
</head>
......
manual005.png

2.57 KB | W: | H:

manual005.png

366 Bytes | W: | H:

manual005.png
manual005.png
manual005.png
manual005.png
  • 2-up
  • Swipe
  • Onion skin
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>How to detect and correct errors</title>
</head>
......
manual006.png

8.92 KB | W: | H:

manual006.png

6.69 KB | W: | H:

manual006.png
manual006.png
manual006.png
manual006.png
  • 2-up
  • Swipe
  • Onion skin
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Making HEVEA and LATEX both happy</title>
</head>
......
manual007.png

3.36 KB | W: | H:

manual007.png

1.13 KB | W: | H:

manual007.png
manual007.png
manual007.png
manual007.png
  • 2-up
  • Swipe
  • Onion skin
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>With a little help from LATEX</title>
</head>
......
manual008.png

3.16 KB | W: | H:

manual008.png

970 Bytes | W: | H:

manual008.png
manual008.png
manual008.png
manual008.png
  • 2-up
  • Swipe
  • Onion skin
manual009.png

5.16 KB | W: | H:

manual009.png

2.94 KB | W: | H:

manual009.png
manual009.png
manual009.png
manual009.png
  • 2-up
  • Swipe
  • Onion skin
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Answers</title>
</head>
......
manual010.png

6.92 KB | W: | H:

manual010.png

4.69 KB | W: | H:

manual010.png
manual010.png
manual010.png
manual010.png
  • 2-up
  • Swipe
  • Onion skin
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>A cut subsubsection</title>
</head>
......
manual011.png

8.92 KB | W: | H:

manual011.png

6.69 KB | W: | H:

manual011.png
manual011.png
manual011.png
manual011.png
  • 2-up
  • Swipe
  • Onion skin
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Another cut subsubsection</title>
</head>
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>A cut subsubsection</title>
</head>
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Another cut subsubsection</title>
</head>
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>A cut subsubsection</title>
</head>
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Another cut subsubsection</title>
</head>
......
......@@ -3,7 +3,7 @@
<head><title>Notes</title>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
</head>
<body>
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Generating html constructs</title>
</head>
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Support for style sheets</title>
</head>
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Customising HEVEA</title>
</head>
......@@ -137,10 +137,9 @@ This can be achieved as follows:
<h3 class="subsection" id="sec93">10.5&#XA0;&#XA0;Changing the format of images</h3>
<p>
<a id="hevea_default129"></a>
<a id="hevea_default130"></a>
<a id="hevea_default131"></a>
<a id="hevea_default132"></a>
<a id="hevea_default130"></a><a id="hevea_default131"></a><a id="hevea_default132"></a>
<a id="hevea_default133"></a>
<a id="hevea_default134"></a>
Semi-automatic generation of included images is described in
section&#XA0;<a href="manual008.html#imagen">6</a>.
Links to included images are generated by the <code>\imageflush</code>
......@@ -154,7 +153,7 @@ It suffices to invoke <span class="c013">hevea</span> as:
</p><div class="flushleft">
<span class="c013">#&#XA0;hevea&#XA0;gif.hva</span>&#XA0;<span class="c018">doc.tex</span>
</div><p>
Then <span class="c013">imagen</span> must be run with option <a id="hevea_default134"></a><span class="c013">-gif</span>:
Then <span class="c013">imagen</span> must be run with option <a id="hevea_default135"></a><span class="c013">-gif</span>:
</p><div class="flushleft">
<span class="c013">#&#XA0;imagen&#XA0;-gif</span>&#XA0;<em>doc</em>
</div><p>A convenient alternative is to invoke <span class="c013">hevea</span> as:
......@@ -162,10 +161,28 @@ Then <span class="c013">imagen</span> must be run with option <a id="hevea_defau
<span class="c013">#&#XA0;hevea&#XA0;-fix&#XA0;gif.hva</span>&#XA0;<span class="c018">doc.tex</span>
</div><p>
Then <span class="c013">hevea</span> will invoke <span class="c013">imagen</span> with the appropriate
option when it thinks images need to be rebuild.</p>
option when it thinks images need to be rebuild.
An even more convenient alternative is to load <span class="c013">gif.hva</span>
from within document source, for instance with the <code>\usepackage</code>
command.</p><p>H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A also provides support for the alternative SVG image file format.
As for GIF images, it is more convenient to use option <span class="c013">-fix</span>
to combine <span class="c013">hevea</span> and <span class="c013">imagen</span> invocations:
</p><div class="flushleft">
<span class="c013">#&#XA0;hevea&#XA0;-fix&#XA0;svg.hva</span>&#XA0;<span class="c018">doc.tex</span>
</div><p>
Notice that <span class="c013">imagen</span> production chain of SVG images always
call <span class="c013">pdflatex</span>, even when <em>not</em> given
the <a href="manual041.html#imagenoptions"><span class="c013">-pdf</span> command-line option</a>.
Hence the source code of images must be processable
by <span class="c013">pdflatex</span>. This precludes using <span class="c013">latex</span>-only packages
such as pstricks for instance.</p><p>As not all browsers display SVG images, <span class="c013">hevea</span> and
<span class="c013">imagen</span> are bit special:
<span class="c013">imagen</span> produces both PNG<sup><a id="text9" href="#note9">8</a></sup> and SVG&#XA0;images; while <span class="c013">hevea</span> offers both image sources,
letting client browser select the most appropriate one by the means of
teh <code>srcset</code> attribute of the <code>img</code> element.</p>
<h3 class="subsection" id="sec94">10.6&#XA0;&#XA0;Storing images in a separate directory</h3>
<p>
<a id="hevea_default135"></a>
<p>
<a id="hevea_default136"></a>
By redefining the <code>\heveaimagedir</code> command, users can specify a
directory for images.
More precisely, if the following redefinition occurs in the document
......@@ -175,7 +192,7 @@ preamble.
</div><p>
Then, all links to images in the produced html file will be as
&#X201C;<span class="c018">dir</span>/&#X2026;&#X201D;.
Then <span class="c013">imagen</span> must be invoked with option&#XA0;<a id="hevea_default136"></a><span class="c013">-
Then <span class="c013">imagen</span> must be invoked with option&#XA0;<a id="hevea_default137"></a><span class="c013">-
todir</span>:
</p><div class="flushleft">
<span class="c013">#&#XA0;imagen&#XA0;-todir</span>&#XA0;<span class="c018">dir</span>&#XA0;<em>doc</em>
......@@ -184,18 +201,20 @@ As usual, <span class="c013">hevea</span> will invoke <span class="c013">imagen<
appropriate option, provided it is passed the <span class="c013">-fix</span> option.</p>
<h3 class="subsection" id="imagen-source">10.7&#XA0;&#XA0;Controlling <span class="c013">imagen</span> from document source</h3>
<p>
<a id="hevea_default137"></a>
<a id="hevea_default138"></a>
The internal command
<code>\@addimagenopt{</code><span class="c018">option</span><code>}</code> add
the text <span class="c018">option</span> to <span class="c013">imagen</span> command-line options, when
launched automatically by <span class="c013">hevea</span> (<em>i.e.</em> when
<span class="c013">hevea</span> is given the <a id="hevea_default138"></a><span class="c013">-fix</span> command-line option).</p><p>For instance, to instruct <span class="c013">hevea</span>/<span class="c013">imagen</span> to
<span class="c013">hevea</span> is given the <a id="hevea_default139"></a><span class="c013">-fix</span> command-line option).</p><p>For instance, to instruct <span class="c013">hevea</span>/<span class="c013">imagen</span> to
reduce all images by a factor of &#X221A;<span style="text-decoration:overline">2</span>, it suffices to state:
</p><div class="flushleft">
<span class="c013">%HEVEA</span><code>\@addimagenopt{-mag 707}</code>
</div><p>
See section&#XA0;<a href="manual041.html#imagenusage">C.1.5</a> for the list of command-line options
accepted by <span class="c013">imagen</span>.</p>
<hr class="ffootnoterule"><dl class="thefootnotes"><dt class="dt-thefootnotes">
<a id="note9" href="#text9">8</a></dt><dd class="dd-thefootnotes"><div class="footnotetext">or GIF, if <span class="c013">gif.hva</span> is loaded</div></dd></dl>
<hr>
<a href="manual019.html"><img src="previous_motif.gif" alt="Previous"></a>
<a href="manual002.html"><img src="contents_motif.gif" alt="Up"></a>
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Other output formats</title>
</head>
......@@ -40,7 +40,7 @@ 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 id="hevea_default139"></a><span class="c013">-w</span> command-line option.</p><p>For now, maths are not supported at all in text mode. You can get very weird
the <a id="hevea_default140"></a><span class="c013">-w</span> 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, <span class="c018">x</span><sup>2</sup> will be rendered as <code>x^2</code>, but &#X222B;<sub>0</sub><sup>1</sup><span class="c018">f</span>(<span class="c018">x</span>)<span class="c018">dx</span> will
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Reference manual</title>
</head>
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Commands and Environments</title>
</head>
......@@ -23,7 +23,7 @@
<p>L<sup>A</sup>T<sub>E</sub>X comments that start with &#X201C;<code>%</code>&#X201D; and end at end of line are ignored and produce no output.
Usually, H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A ignore such comments. However, H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A processes
text that follows &#X201C;<code>%HEVEA</code>&#X201D; and some other comments have a specific meaning to it (see
section&#XA0;<a href="manual007.html#comments">5.3</a>).</p><p><a id="hevea_default140"></a>
section&#XA0;<a href="manual007.html#comments">5.3</a>).</p><p><a id="hevea_default141"></a>
Command names follow strict L<sup>A</sup>T<sub>E</sub>X syntax. That is, apart from
<code>#</code>, <code>$</code>, <code>~</code>, <code>_</code> and <code>^</code>, they either are
&#X201C;<code>\</code>&#X201D; followed by a single non-letter character or
......@@ -48,8 +48,8 @@ recognized and processed as &#XE9;cole <span class="c018">a</span><sub>1</sub> a
By contrast, <code>a^\mbox{...}</code> is not recognized
and must be written <code>a^{\mbox{...}}</code>.</p><p>Also note that, by contrast with L<sup>A</sup>T<sub>E</sub>X, comments are parsed during
argument scanning, as an important consequence brace nesting is also
checked inside comments.</p><p><a id="hevea_default141"></a>
<a id="hevea_default142"></a>
checked inside comments.</p><p><a id="hevea_default142"></a>
<a id="hevea_default143"></a>
With respect to previous versions,
H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A has been improved as regards emulation of complicated
argument passing. That is,
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>The Structure of the Document</title>
</head>
......@@ -25,8 +25,8 @@ arguments to H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</
As a consequence, command and environment definitions that
occur before <code>\begin{document}</code> are performed.
and they remain
valid during all the processing.</p><p><a id="hevea_default143"></a>
<a id="hevea_default144"></a>
valid during all the processing.</p><p><a id="hevea_default144"></a>
<a id="hevea_default145"></a>
In particular one can define a <em>header</em> and a <em>footer</em>, by using the
<code>\htmlhead</code> and <code>\htmlfoot</code> commands in the preamble.
Those commands register their argument as the header and the footer of
......@@ -39,10 +39,10 @@ For instance, to append a copyright notice at the end of all the html
pages, it suffices to invoke the <code>\htmlfoot</code> command as follows
in the document preamble:
</p><pre class="verbatim">\htmlfoot{\copyright to me}
</pre><p><a id="hevea_default145"></a>
<a id="hevea_default146"></a>
</pre><p><a id="hevea_default146"></a>
<a id="hevea_default147"></a>
<a id="hevea_default148"></a><a id="metadef"></a>
<a id="hevea_default148"></a>
<a id="hevea_default149"></a><a id="metadef"></a>
The <code>\htmlhead</code> command cannot be used for changing anything outside of
the html document body, there are specific commands for doing this.
Those command must be used in the document preamble.
......@@ -61,7 +61,7 @@ following declaration occurs before <code>\begin{document}</code>:
of the whole document by issuing the following redefinition in
the document preamble:
</p><pre class="verbatim">\renewcommand{\@htmlargs}{lang=en}
</pre><p><a id="hevea_default149"></a><a id="hevea_default150"></a>
</pre><p><a id="hevea_default150"></a><a id="hevea_default151"></a>
<a id="exlet"></a>Similarly, some elements can be inserted into the output file
<code>head</code> element by redefining the <code>\@meta</code> command
(Such elements typically are <code>meta</code>, <code>link</code>, etc.).
......@@ -78,7 +78,7 @@ author information as follows:
<code>\oldmeta</code> before being redefined and how <code>\oldmeta</code> is
invoked in the new definition of <code>\@meta</code>.
Namely, simply overriding the old definition of <code>\@meta</code> would
imply not outputting default meta-information.</p><p><a id="hevea_default151"></a>
imply not outputting default meta-information.</p><p><a id="hevea_default152"></a>
The <code>\@charset</code> command holds the value of the (html) document character
set. By default, this value is <span class="c013">US-ASCII</span>.
In previous versions of H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A, one could change the
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Sentences and Paragraphs</title>
</head>
......@@ -20,8 +20,8 @@
</li></ul>
<h3 class="subsection" id="sec109">B.3.1&#XA0;&#XA0;Spacing</h3>
<p>
<a id="hevea_default152"></a>
<a id="hevea_default153"></a>
<a id="hevea_default154"></a>
Generally speaking, spaces (and single newline characters) in the
source are echoed in the output. Browser then manage with spaces and
line-breaks. Following L<sup>A</sup>T<sub>E</sub>X behaviour, spaces after commands are
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Classes, Packages and Page Styles</title>
</head>
......@@ -35,7 +35,7 @@ fails, then a fatal error is flagged, since it can be sure
that the document cannot be processed.</p>
<h3 class="subsection" id="sec120">B.5.2&#XA0;&#XA0;Packages and Page Styles</h3>
<p><a id="usepackage"></a>
<a id="hevea_default158"></a>
<a id="hevea_default159"></a>
H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A reacts to
<code>\usepackage[</code><span class="c018">options</span><code>]{</code><span class="c018">pkg</span><code>}</code> in
the following way:
......@@ -59,7 +59,7 @@ implementations by themselves.</p>
<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 id="hevea_default159"></a> command appears
The argument to the <code>\title</code><a id="hevea_default160"></a> command appears
in the html&#XA0;document header. As a consequence, titles should
remain simple. Normal design (as regards H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A) is for
<code>\title</code> to occur in the document preamble, so that the title
......@@ -70,7 +70,7 @@ command appears in the document, then the title is saved into the
<span class="c013">.haux</span> file for a next run of H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A to put it in the
html&#XA0;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 id="hevea_default160"></a> command generates will work properly
<code>\today</code><a id="hevea_default161"></a> command generates will work properly
only if <span class="c013">hevea</span> is invoked with the <code>-exec xxdate.exe</code>
option. Otherwise <code>\today</code> generates nothing and a warning is
issued.
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Displayed Paragraphs</title>
</head>
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Mathematical Formulae</title>
</head>
......@@ -78,7 +78,7 @@ is issued.</p><p>An attempt is made to render all ellipsis constructs (<code>\ld
strange for the latter two.</p>
<h3 class="subsection" id="sec130">B.7.3&#XA0;&#XA0;Square Root</h3>
<p>
<a id="hevea_default161"></a><a id="hevea_default162"></a>
<a id="hevea_default162"></a><a id="hevea_default163"></a>
The n<sup>th</sup> root command <code>\sqrt</code> is supported only for n=3,4, thanks to the existence of Unicode characters for the same. For the others, we shift to fractional exponents, in which case, the <code>\sqrt</code> command is
defined as follows:
</p><pre class="verbatim">\newcommand{\sqrt}[3][2]{\left(#2\right)^{1/#1}}
......@@ -112,14 +112,14 @@ as follows:
</table></td></tr>
</table>
<h3 class="subsection" id="sec131">B.7.4&#XA0;&#XA0;Unicode and mathematical symbols</h3>
<p><a id="hevea_default163"></a></p><p>The support for unicode symbols offered by modern browsers allows to
<p><a id="hevea_default164"></a></p><p>The support for unicode symbols offered by modern browsers allows to
translate almost all math symbols correctly.</p><p>Log-like functions and variable sized-symbols are recognized and their
subscripts and superscripts are put where they should in display mode.
Subscript and superscript placement can be changed using the
<code>\limits</code> and <code>\nolimits</code> commands.
Big delimiters are also handled.</p>
<h3 class="subsection" id="sec132">B.7.5&#XA0;&#XA0;Putting one thing above/below/inside</h3>
<p><a id="hevea_default164"></a><a id="hevea_default165"></a><a id="hevea_default166"></a>
<p><a id="hevea_default165"></a><a id="hevea_default166"></a><a id="hevea_default167"></a>
The commands <code>\stackrel</code>, <code>\underline</code> and <code>\overline</code>
are recognized.
They produce sensible output in display mode.
......@@ -131,16 +131,16 @@ These macros perform the following default actions
</dd><dt class="dt-description"><span class="c014">\textunderline</span></dt><dd class="dd-description"> Underlines its argument, using the
<code>U</code> text-level element.
</dd><dt class="dt-description"><span class="c014">\textoverline</span></dt><dd class="dd-description"> Overlines using style-sheets (used <span class="c013">&lt;SPAN&gt;</span> with a top border).
</dd></dl><p><a id="hevea_default167"></a> The command <code>\boxed</code> works well both in display and normal math mode. Input of the form <code>\boxed{\frac{\pi}{2}}</code> produces <span class="textboxed">&#X3C0;/2</span> in normal math, and
</dd></dl><p><a id="hevea_default168"></a> The command <code>\boxed</code> works well both in display and normal math mode. Input of the form <code>\boxed{\frac{\pi}{2}}</code> produces <span class="textboxed">&#X3C0;/2</span> in normal math, and
</p><table class="display dcenter"><tr class="c035"><td class="dcell"><table class="boxed"><tr><td><table class="display"><tr><td class="dcell c027">&#X3C0;</td></tr>
<tr><td class="hbar"></td></tr>
<tr><td class="dcell c027">2</td></tr>
</table></td></tr>
</table></td></tr>
</table><p>
in display-math mode. The commands <code>\bigl,\bigr</code> etc. <a id="hevea_default168"></a>are also rendered well. Some examples can be found <a href="../examples/random-math.html">here</a>.</p>
in display-math mode. The commands <code>\bigl,\bigr</code> etc. <a id="hevea_default169"></a>are also rendered well. Some examples can be found <a href="../examples/random-math.html">here</a>.</p>
<h3 class="subsection" id="sec133">B.7.6&#XA0;&#XA0;Math accents</h3>
<p><a id="hevea_default169"></a>
<p><a id="hevea_default170"></a>
Math accents that have coresponding text accents
(<code>\hat</code>, <code>\tilde</code>, etc.) are
handled<a id="mathaccents"></a> by default. They in fact act as the
......@@ -225,7 +225,7 @@ There are a few exceptions: line &#X201C;accents&#X201D;:
</table>
<h3 class="subsection" id="sec134">B.7.7&#XA0;&#XA0;Spacing</h3>
<p><a id="spacemathref"></a>
<a id="hevea_default170"></a>
<a id="hevea_default171"></a>
By contrast with L<sup>A</sup>T<sub>E</sub>X, space in the input matters in math mode.
One or more spaces are translated to one space.
Furthermore,
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Definitions, Numbering</title>
</head>
......@@ -20,9 +20,9 @@
</li><li><a href="manual030.html#sec141">The <span class="c013">ifthen</span> Package</a>
</li></ul>
<h3 class="subsection" id="sec137">B.8.1&#XA0;&#XA0;Defining Commands</h3>
<p><a id="usermacro"></a></p><p><a id="hevea_default171"></a>
<a id="hevea_default172"></a>
<p><a id="usermacro"></a></p><p><a id="hevea_default172"></a>
<a id="hevea_default173"></a>
<a id="hevea_default174"></a>
H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A understands command definitions given in L<sup>A</sup>T<sub>E</sub>X style. Such
definitions are made using
<code>\newcommand</code>, <code>\renewcommand</code> and <code>\providecommand</code>.
......@@ -71,7 +71,7 @@ the <span class="c018">calc</span> package that makes using T<sub>E</sub>X style
useless in most situations (see section&#XA0;<a href="manual-packages.html#calc">B.17.3</a>).</p>
<h3 class="subsection" id="sec141">B.8.5&#XA0;&#XA0;The <span class="c013">ifthen</span> Package</h3>
<p><a id="ifthen"></a>
<a id="hevea_default174"></a>
<a id="hevea_default175"></a>
The <span class="c013">ifthen</span> package is partially supported.
The one unsupported construct is the
<code>\lengthtest</code> test expression, which is
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Figures and Other Floating Bodies</title>
</head>
......@@ -20,7 +20,7 @@ horizontal rules.</p><p>Captions and cross referencing are handled.
However captions are not moved at end of figures: instead, they appear
where the <code>\caption</code> commands occur in source code.
The <code>\suppressfloats</code> command does nothing and the
figure related counters (such as <code>topnumber</code>) exist but are useless.</p><p><a id="hevea_default175"></a><a id="hevea_default176"></a><a id="hevea_default177"></a></p><div class="fmarginpar marginparright">Marginal notes go in the right margin by default.</div><div class="fmarginpar marginparleft">To get marginal notes in the left margin, use
figure related counters (such as <code>topnumber</code>) exist but are useless.</p><p><a id="hevea_default176"></a><a id="hevea_default177"></a><a id="hevea_default178"></a></p><div class="fmarginpar marginparright">Marginal notes go in the right margin by default.</div><div class="fmarginpar marginparleft">To get marginal notes in the left margin, use
<span class="c013">\reversemaginpar</span>.</div><p>
Marginal notes are handled in an H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A specific way.
By default, all notes go in the right margin.
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Lining It Up in Columns</title>
</head>
......
......@@ -2,7 +2,7 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="generator" content="hevea 2.23">
<meta name="generator" content="hevea 2.28">
<meta name="Author" content="Luc Maranget"><link rel="stylesheet" type="text/css" href="manual.css">
<title>Moving Information Around</title>
</head>
......@@ -56,11 +56,11 @@ Again, several runs of H<span class="c015"><sup>E</sup></span>V<span class="c015
</dd></dl><p>H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A does not fail when it cannot find an auxiliary file.
When another run of H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A is needed, a warning is issued,
and it is user&#X2019;s responsibility to rerun H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A.
However, the convenient <a id="hevea_default178"></a><span class="c013">-fix</span> command-line option instructs
However, the convenient <a id="hevea_default179"></a><span class="c013">-fix</span> command-line option instructs
H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A to rerun itself, until it believes it has reached stable state.</p>
<h3 class="subsection" id="cross-reference">B.11.2&#XA0;&#XA0;Cross-References<a id="cross"></a></h3>
<p>
<a id="hevea_default179"></a><a id="hevea_default180"></a>
<a id="hevea_default180"></a><a id="hevea_default181"></a>
The L<sup>A</sup>T<sub>E</sub>X commands <code>\label</code> and <code>\ref</code> are changed by H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A
into html anchors and local links, using the &#X201C;<code>a</code>&#X201D; element.
Additionally, numerical references to sectional units, figures,
......@@ -151,19 +151,19 @@ notice that loading the <span class="c013">.hbbl</span> file has priority over
loading the <span class="c013">.bbl</span> file.</p>
<h3 class="subsection" id="sec151">B.11.4&#XA0;&#XA0;Splitting the Input</h3>
<p>
<a id="hevea_default181"></a>
<a id="hevea_default182"></a>
The <code>\input</code> and <code>\include</code> commands exist and they perform
exactly the same operation of searching (and then processing) a file,
whose name is given as an argument.
See section&#XA0;<a href="manual041.html#comline">C.1.1.1</a> on how H<span class="c015"><sup>E</sup></span>V<span class="c015"><sup>E</sup></span>A searches files.
However, in the case of the <code>\include</code> command, the file is
searched only when previously given as an argument to
the <code>\includeonly</code> command.</p><p><a id="hevea_default182"></a>
the <code>\includeonly</code> command.</p><p><a id="hevea_default183"></a>
Note the following features:
</p><ul class="itemize"><li class="li-itemize">