texi2html(1)

1TEXI2HTML(1)                General Commands Manual               TEXI2HTML(1)
2
3
4

NAME

6       texi2html - a Texinfo to HTML converter
7

SYNOPSIS

9       texi2html [options] file
10

DESCRIPTION

12       Texi2html  converts  the  given Texinfo file to a set of HTML files. It
13       tries to handle most of the  Texinfo  commands.  It  creates  hypertext
14       links for cross-references, footnotes...
15
16       Texi2html  may furthermore use latex2html to generate HTML (code and/or
17       images) for @math and @iftex tags (see the --l2h option).
18
19       Texi2html creates several files depending on the contents of  the  Tex‐
20       info file and on the chosen options (see FILES).
21
22       The  HTML  files created by texi2html are in general closer to TeX than
23       to Info. Using init files (see the --init-file option), other styles or
24       output formats may be selected.
25

OPTIONS

27       Options may be abbreviated to th shortests unique prefix. The following
28       is only an incomplete list of the available options:
29
30       --help [1|2]
31                   Print usage instructions and list the most  important,  all
32                   relevant,  or  all recognised (including obsolete) command-
33                   line options, and exit.
34
35       --split chapter|section|node
36                   Split the output into several  HTML  files  (one  per  main
37                   chapter/section or node).
38
39       --ifinfo --iftex --ifxml --ifplaintext --ifhtml
40                   Expand @ifinfo, @iftex and @tex, @ifxml and @xml, @ifplain‐
41                   text, @ifhtml and @html regions, and  don't  expand  @ifnot
42                   corresponding regions (default: ifhtml).
43
44       --no-ifinfo --no-iftex --no-ifxml --no-ifplaintext --no-html
45                   Don't  expand @ifinfo, @iftex, @ifxml, @ifplaintext regions
46                   and expand @ifnot corresponding regions.
47
48       -I dir      Append dir to the  directory  list  searched  for  included
49                   files.
50
51       -P dir      Prepend  dir  to  the  directory list searched for included
52                   files.
53
54       --l2h       Use latex2html for content of @math and @tex tags.  Content
55                   must  be  such  that  both, latex and tex, can translate it
56                   correctly. I.e., no tex-only constructs must be used.
57
58       --css-include file
59                   Use css file file.
60
61       --init-file file
62                   Load init file file (see also FILES).
63
64       --document-language lang
65                   Use lang as document language.
66
67       --macro-expand file
68                   output macro expanded source in file.
69
70       --no-menu   Don't show the Texinfo menus; by default they are shown.
71
72       --no-number Don't number the sections.
73
74       --use-nodes Use nodes for sectionning.
75
76       --prefix    Use as prefix for output files, instead of basename.
77
78       --node-files
79                   Produce one file per node for cross references.
80
81       --l2h-l2h prog
82                   Use prog as latex2html program (default latex2html).   Pro‐
83                   gram must be executable.
84
85       --l2h-init file
86                   Use  file  as  latex2html init file. file should be used to
87                   specify  in  which  way  latex2html  handles   mathematical
88                   expressions and formulas.
89
90
91       --l2h-tmp dir
92                   Use  dir  as  tmp dir for latex2html. This directory (resp.
93                   its path) must not contain a dot  (i.e., a ".").
94
95       --l2h-clean remove all intermediate files generated by latex2html (pre‐
96                   vents caching!)
97
98       --l2h-skip  Do  not really run latex2html. Use (kept) files of previous
99                   runs, instead.
100
101       --verbose   Give a verbose output.
102
103       --version   Print version and exit.
104

FILES

106       Initialisation      options       are       read       first       from
107       /usr/share/texi2html/texi2html/Config (the exact location being change‐
108       able with the --datadir=dir option to the configure script), then  from
109       /etc/texi2html/Config  (the  exact  location  being changeable with the
110       --sysconfdir=dir option to the configure script), then  from  ./Config,
111       from $HOME/.texi2html/Config, and from any command-line options includ‐
112       ing --init-file options; with later settings overriding earlier ones.
113
114       By default texi2html my creates the following files (foo being the name
115       of the Texinfo file):
116
117       foo_toc.html    The table of contents (if @contents is present).
118
119       foo.html        The document's contents or the Top element.
120
121       foo_fot.html    The footnotes (if any).
122
123       foo_abt.html    An help section.
124
125       foo_l2h_img*    Images generated by latex2html (if any).
126
127       When  used  with  the --split option, it creates several files (one per
128       chapter or node), named foo_n.html (n being the index of the chapter or
129       node), and the foo.html file contains the Top element.
130
131       Otherwise it creates only one file: foo.html
132

VERSION

134       This is texi2html version 1.82, 4 January 2009.
135

AUTHOR

137       Texi2html  was  originally  written by is Lionel Cons, CERN IT/DIS/OSE,
138       Lionel.Cons@cern.ch.  Over time, many other people around the net  con‐
139       tributed  to  this program.  It was maintained by Olaf Bachmann, obach‐
140       man@mathematik.uni-kl.de, and is now maintained by Derek Price.
141

AVAILABILITY

143       The latest version of this program, as well as support in the  form  of
144       mailing  lists  with  archives,  bug tracking, documentation, and other
145       tools can be found at:       http://www.nongnu.org/texi2html/
146

COPYRIGHT

148       Copyright © 1999-2005  Patrice Dumas <dumas@centre-cired.fr>,
149                               Derek Price <derek@ximbiot.com>,
150                               Adrian Aichner <adrian@xemacs.org>,
151                             & others.
152
153       There is NO warranty.  You may redistribute  this  software  under  the
154       terms  of  the  GNU General Public License.  For more information about
155       these matters, see the file named COPYING.
156

BUGS

166       This man-page is often out-of-date. The info manual should be more  up-
167       to-date.
168
169
170
1717th Edition                     4 January 2009                    TEXI2HTML(1)