summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-LaTeX2HTML.html
blob: 76afb0b8aaac78c2319587cbab80e9cf135f203c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
<head>
<title>UK TeX FAQ -- question label LaTeX2HTML</title>
</head><body>
<h3>Conversion from (La)TeX to HTML</h3>
<p/>TeX and LaTeX are well suited to producing electronically publishable
documents. However, it is important to realize the difference
between page layout and functional markup. TeX is capable of
extremely detailed page layout; HTML is not, because HTML is a
functional markup language not a page layout language. HTML&#8217;s exact
rendering is not specified by the document that is published but is, to
some degree, left to the discretion of the browser. If you require your
readers to see an exact replication of what your document looks like
to you, then you cannot use HTML and you must use some other
publishing format such as PDF. That is true for any HTML
authoring tool.
<p/>TeX&#8217;s excellent mathematical capabilities remain a challenge in the
business of conversion to HTML.  There are only two generally
reliable techniques for generating mathematics on the web: creating
bitmaps of bits of typesetting that can&#8217;t be translated, and using
symbols and table constructs.  Neither technique is entirely
satisfactory.  Bitmaps lead to a profusion of tiny files, are slow to
load, and are inaccessible to those with visual disabilities.  The
symbol fonts offer poor coverage of mathematics, and their use
requires configuration of the browser.  The future of mathematical
browsing may be brighter &#8212; see

<a href="FAQ-mathml.html">future Web technologies</a>.
<p/>For today, possible packages are:
<dl>
<dt><i>LaTeX2HTML</i><dd>a <i>Perl</i> script package that
  supports LaTeX only, and generates mathematics (and other
  &#8220;difficult&#8221; things) using bitmaps.  The original version was
  written by Nikos Drakos for Unix systems, but the package now sports
  an illustrious list of co-authors and is also available for Windows
  systems.  Michel Goossens and Janne Saarela published a detailed
  discussion of <i>LaTeX2HTML</i>, and how to tailor it, in
  <i>TUGboat</i> 16(2).
<p/>  A mailing list for users may be found via
  <a href="http://tug.org/mailman/listinfo/latex2html">http://tug.org/mailman/listinfo/latex2html</a>
<dt><i>TtH</i><dd>a compiled program that supports either LaTeX
  or Plain TeX, and uses the font/table technique for representing
  mathematics.  It is written by Ian Hutchinson, using
  <i>flex</i>.  The distribution consists of a single C
  source (or a compiled executable), which is easy to install and very
  fast-running.
<dt><i>TeX4ht</i><dd>a compiled program that supports either
  LaTeX or Plain TeX, by processing a DVI file; it uses
  bitmaps for mathematics, but can also use other technologies where
  appropriate.  Written by Eitan Gurari, it parses the DVI
  file generated when you run (La)TeX over your file with
  <i>tex4ht</i>&#8217;s macros included.  As a result, it&#8217;s pretty
  robust against the macros you include in your document, and it&#8217;s
  also pretty fast.
<dt><i>plasTeX</i><dd>a Python-based LaTeX document processing
    framework.  It gives DOM-like access to a LaTeX document, as
    well as the ability to generate mulitple output formats
    (e.g. HTML, DocBook, tBook, etc.).
<dt><i>TeXpider</i><dd>a commercial program from
  <a href="FAQ-commercial.html">Micropress</a>, which is
  described on <a href="http://www.micropress-inc.com/webb/wbstart.htm">http://www.micropress-inc.com/webb/wbstart.htm</a>;
  it uses bitmaps for equations.
<dt><i>Hevea</i><dd> a compiled program that supports LaTeX
  only, and uses the font/table technique for equations (indeed its
  entire approach is very similar to <i>TtH</i>).  It is written
  in Objective CAML by Luc Maranget.  <i>Hevea</i> isn&#8217;t
  archived on CTAN; details (including download points) are
  available via <a href="http://pauillac.inria.fr/~maranget/hevea/">http://pauillac.inria.fr/~maranget/hevea/</a>
</dl>
An interesting set of samples, including conversion of the same text
by the four free programs listed above, is available at
<a href="http://www.mayer.dial.pipex.com/samples/example.htm">http://www.mayer.dial.pipex.com/samples/example.htm</a>; a linked
page gives lists of pros and cons, by way of comparison.
<p/>The World Wide Web Consortium maintains a list of &#8220;filters&#8221; to
HTML, with sections on (La)TeX and BibTeX &#8212; see
<a href="http://www.w3.org/Tools/Word_proc_filters.html">http://www.w3.org/Tools/Word_proc_filters.html</a>
<dl>
<dt><tt><i>latex2html</i></tt><dd>Browse <a href="http://mirror.ctan.org/support/latex2html">support/latex2html</a>; <a href="http://mirror.ctan.org//help/Catalogue/entries/latex2html.html">catalogue entry</a>
<dt><tt><i>plasTeX</i></tt><dd>Browse <a href="http://mirror.ctan.org/support/plastex">support/plastex</a>; <a href="http://mirror.ctan.org//help/Catalogue/entries/plastex.html">catalogue entry</a>
<dt><tt><i>tex4ht</i></tt><dd><a href="http://mirror.ctan.org/obsolete/support/TeX4ht/tex4ht-all.zip">obsolete/support/TeX4ht/tex4ht-all.zip</a>; <a href="http://mirror.ctan.org//help/Catalogue/entries/tex4ht.html">catalogue entry</a> (but see <a href="http://tug.org/tex4ht/">http://tug.org/tex4ht/</a>)
<dt><tt><i>tth</i></tt><dd><a href="http://mirror.ctan.org/support/tth/dist.zip">support/tth/dist</a> (or <a href="http://mirror.ctan.org/support/tth/dist/">browse the directory</a>); <a href="http://mirror.ctan.org/help/Catalogue/entries/tth.html">catalogue entry</a>
</dl>
<p/><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=LaTeX2HTML">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=LaTeX2HTML</a>
</body>