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 closer to TeX than to Info.
23

OPTIONS

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

FILES

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

VERSION

131       This is texi2html version 1.77, .
132

AUTHOR

134       Texi2html  was  originally  written by is Lionel Cons, CERN IT/DIS/OSE,
135       Lionel.Cons@cern.ch.  Over time, many other people around the net  con‐
136       tributed  to  this  program.   Its current maintainer is Olaf Bachmann,
137       obachman@mathematik.uni-kl.de.
138

AVAILABILITY

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

COPYRIGHT

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

BUGS

163       This man-page is often out-of-date. The info manual should be more  up-
164       to-date.
165
166
167
1687th Edition                                                       TEXI2HTML(1)