Penguin
Recent Changes
Blame: texi2html(1)
EditPageHistoryDiffInfoLikePages
Annotated edit history of texi2html(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 TEXI2HTML
2 !!!TEXI2HTML
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 FILES
8 VERSION
9 AUTHOR
10 AVAILABILITY
11 COPYRIGHT
12 SEE ALSO
13 BUGS
14 ----
15 !!NAME
16
17
18 texi2html - a Texinfo to HTML converter
19 !!SYNOPSIS
20
21
22 __texi2html [[options] file__
23 !!DESCRIPTION
24
25
26 ''Texi2html'' converts the given Texinfo file to a set of
27 HTML files. It tries to handle most of the Texinfo commands.
28 It creates hypertext links for cross-references,
29 footnotes...
30
31
32 It also tries to add links from a reference to its
33 corresponding entry in the bibliography (if any). It may
34 also handle a glossary (see the __-glossary__
35 option).
36
37
38 ''Texi2html'' may furthermore use latex2html to generate
39 HTML (code and/or images) for @math and @iftex tags (see the
40 __-l2h__ option).
41
42
43 ''Texi2html'' creates several files depending on the
44 contents of the Texinfo file and on the chosen options (see
45 FILES).
46
47
48 The HTML files created by ''texi2html'' are closer to TeX
49 than to Info.
50 !!OPTIONS
51
52
53 Options may be abbreviated to th shortests unique prefix.
54 The following is only an incomplete list of the available
55 options:
56
57
58 __-help [[1|2]__
59
60
61 Print usage instructions and list the most important, all
62 relevant, or all recognised (including obsolete)
63 command-line options, and exit.
64
65
66 __-expand info|tex|none__
67
68
69 Expand @ifinfo, or @iftex, or sections (default:
70 info)
71
72
73 __-glossary__
74
75
76 Use the section named 'Glossary' to build a list of terms
77 and put links in the HTML document from each term toward its
78 definition.
79
80
81 __-I__ ''dir''
82
83
84 Look also in ''dir'' to find included files.
85
86
87 __-menu__
88
89
90 Show the Texinfo menus; by default they are
91 ignored.
92
93
94 __-number__
95
96
97 Number the sections.
98
99
100 __-split chapter|section__
101
102
103 Split the output into several HTML files (one per main
104 chapter/section).
105
106
107 __-l2h__ Use latex2html for content of @math and @tex
108 tags. Content must be such that both, latex and tex, can
109 translate it correctly. I.e., no tex-only constructs must be
110 used.
111
112
113 __-l2h_l2h__ ''prog''
114
115
116 Use ''prog'' as latex2html program (default
117 ''latex2html''). Program must be executable.
118
119
120 __-l2h_init__ ''file''
121
122
123 Use ''file'' as latex2html init file. ''file'' should
124 be used to specify in which way latex2html handles
125 mathematical expressions and formulas.
126
127
128 Note that latex2html locates (and uses) init-files in the
129 following order (provided they exist): (1) global init file
130 (usually in latex2html source dir) (2)
131 $HOME/.latex2html_init (3) ./.latex2html_init (4) init file
132 given on command line.
133
134
135 __-l2h_tmp__ ''dir''
136
137
138 Use ''dir'' as tmp dir for latex2html. This directory
139 (resp. its path) must not contain a dot (i.e., a
140 ''
141
142
143 __-l2h_clean__
144
145
146 remove all intermediate files generated by latex2html
147 (prevents caching!)
148
149
150 __-l2h_skip__
151
152
153 Do not really run latex2html. Use (kept) files of previous
154 runs, instead.
155
156
157 __-Verbose__
158
159
160 Give a verbose output.
161
162
163 __-version__
164
165
166 Print version and exit.
167 !!FILES
168
169
170 Initialisation options are read first from /etc/texi2htmlrc
171 (the exact location being changeable with the
172 --sysconfdir=''dir'' option to the configure script),
173 then from $HOME/.texi2htmlrc, then any command-line options
174 including -init_file options; with later settings overriding
175 earlier ones.
176
177
178 By default ''texi2html'' creates the following files (foo
179 being the name of the Texinfo file):
180
181
182 __foo_toc.html__
183
184
185 The table of contents.
186
187
188 __foo.html__ The document's contents.
189
190
191 __foo_foot.html__
192
193
194 The footnotes (if any).
195
196
197 __foo_l2h_img*__
198
199
200 Images generated by latex2html (if any).
201
202
203 When used with the __-split__ option, it creates several
204 files (one per chapter or node), named __foo_n.html__ (n
205 being the index of the chapter or node), instead of the
206 single __foo.html__ file.
207
208
209 Otherwise it creates only one file:
210 __foo.html__
211 !!VERSION
212
213
214 This is ''texi2html'' version 1.65,
215 2000-04-18.
216 !!AUTHOR
217
218
219 Texi2html was originally written by is Lionel Cons, CERN
220 IT/DIS/OSE, Lionel.Cons@cern.ch. Over time, many other
221 people around the net contributed to this program. Its
222 current maintainer is Olaf Bachmann,
223 obachman@mathematik.uni-kl.de.
224 !!AVAILABILITY
225
226
227 http://www.mathematik.uni-kl.de/~obachman/Texi2html/Distrib
228 !!COPYRIGHT
229
230
231 Copyright 1999, 2000 Free Software Foundation, Inc. There is
232 NO warranty. You may redistribute this software under the
233 terms of the GNU General Public License. For more
234 information about these matters, see the file named
235 COPYING.
236 !!SEE ALSO
237
238
239 GNU Texinfo Documentation Format
240 http://texinfo.org/texi2html/
2 perry 241 World Wide Web (WWW), !HyperText Markup Language (HTML)
1 perry 242 http://www.w3.org
243 LaTeX2HTML
244 http://www-dsed.llnl.gov/files/programs/unix/latex2html
245 !!BUGS
246
247
248 This man-page is not up-to-date and there exists no
249 up-to-date documentation, yet. Until it exists, see the
250 beginning of the texi2html.init file for remarks about
251 command-line options and configurations.
252
253
254 A row of a mutlicolumn table has to be in one
255 line.
256
257
258 The generated HTML output is syntactically pretty
259 bad.
260
261
262 TeX specific commands (normally enclosed in @iftex) will be
263 passed over unmodified, unless latex2html is
264 enabled.
265 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.