TEXI2HTML(1)

📦
version 5.0 · 8 versions
, in centos-stream 10, centos-stream 9, fedora 43, fedora 44

👑 TEXI2HTML(1) 👑

okay bestie, sit down, hydrate, because we're about to talk about texi2html, from the General Commands Manual, and honestly? it's giving converter core. 💅

✨ NAME ✨

texi2html — a Texinfo to HTML converter. that's it, that's the whole thing, and she serves. 🎀

🦋 SYNOPSIS 🦋

texi2html [options] file

🌸 DESCRIPTION 🌸

so here's the tea, bestie: Texi2html takes the Texinfo file you hand her and turns it into a set of HTML files. she tries to handle most of the Texinfo commands, and she's lowkey amazing at it — she creates hypertext links for cross-references, footnotes... the whole vibe. 🔥

she may furthermore use latex2html to generate HTML (code and/or images) for @math and @iftex tags — that's the --l2h option, more on her later. 👀

Texi2html creates several files depending on the contents of the Texinfo file and on the chosen options (peep the FILES section, it's all there).

the HTML files she makes are, in general, closer to TeX than to Info. and if you want other styles or output formats? use init files (see the --init-file option) and she'll switch it up for you. periodt. 💜

💖 OPTIONS 💖

okay so quick PSA: options may be abbreviated to th shortests unique prefix. and this is only an incomplete list of the available options — she's got more where that came from. 🙈
  • --help [1|2] — print usage instructions and list the most important, all relevant, or all recognised (including obsolete) command-line options, and exit. yes, she'll also tell you about the obsolete ones, iconic behaviour honestly. 👑
  • --split chapter|section|node — split the output into several HTML files (one per main chapter/section or node). divide and conquer, slay.
  • --ifinfo --iftex --ifxml --ifplaintext --ifhtml — expand @ifinfo, @iftex and @tex, @ifxml and @xml, @ifplaintext, @ifhtml and @html regions, and don't expand @ifnot corresponding regions (default: ifhtml).
  • --no-ifinfo --no-iftex --no-ifxml --no-ifplaintext --no-html — don't expand @ifinfo, @iftex, @ifxml, @ifplaintext regions and expand @ifnot corresponding regions. flip the whole thing, why not.
  • -I dir — append dir to the directory list searched for included files.
  • -P dir — prepend dir to the directory list searched for included files. (yes, prepend. she goes first now. main character energy. ✨)
  • --l2h — use latex2html for content of @math and @tex tags. content must be such that both, latex and tex, can translate it correctly. i.e., no tex-only constructs must be used. respect the rules bestie, she's strict about this one. 😭
  • --css-include file — use css file file. cute her up. 🎀
  • --init-file file — load init file file (see also FILES).
  • --document-language lang — use lang as document language.
  • --macro-expand file — output macro expanded source in file.
  • --no-menu — don't show the Texinfo menus; by default they are shown.
  • --no-number — don't number the sections.
  • --use-nodes — use nodes for sectionning. (yes, that's how it's spelled in the original, we keep it verbatim fr fr 💅)
  • --prefix — use as prefix for output files, instead of basename.
  • --node-files — produce one file per node for cross references.
  • --l2h-l2h prog — use prog as latex2html program (default latex2html). program must be executable. no executable, no vibes.
  • --l2h-init file — use file as latex2html init file. file should be used to specify in which way latex2html handles mathematical expressions and formulas.
  • --l2h-tmp dir — use dir as tmp dir for latex2html. this directory (resp. its path) must not contain a dot (i.e., a "."). > like, genuinely must not. not a single . in there. she will not be okay about it. 💀
  • --l2h-clean — remove all intermediate files generated by latex2html (prevents caching!). big dramatic warning, she means it. 😤
  • --l2h-skip — do not really run latex2html. use (kept) files of previous runs, instead.
  • --verbose — give a verbose output. she will talk. 🗣️
  • --version — print version and exit.

🧚 FILES 🧚

initialisation options are read first from /usr/share/texi2html/Config (the exact location being changeable with the --datadir=dir option to the configure script), then from /etc/texi2html/Config (the exact location being changeable with the --sysconfdir=dir option to the configure script), then from ./Config, from $HOME/.texi2html/Config, and from any command-line options including --init-file options; with later settings overriding earlier ones. later settings win, always, no exceptions. 👑

by default texi2html my creates the following files (foo being the name of the Texinfo file):

  • foo_toc.html — the table of contents (if @contents is present).
  • foo.html — the document's contents or the Top element.
  • foo_fot.html — the footnotes (if any).
  • foo_abt.html — an help section.
  • foo_l2h_img* — images generated by latex2html (if any).

when used with the --split option, it creates several files (one per chapter or node), named foo_n.html (n being the index of the chapter or node), and the foo.html file contains the Top element. 🌈

otherwise it creates only one file: foo.html. just the one. simple. clean. minimal. 💅

⭐ VERSION ⭐

this is texi2html version 5.0, 30 June 2010. vintage, but make it fashion. 🎀

🫶 AUTHOR 🫶

Texi2html was originally written by is Lionel Cons, CERN IT/DIS/OSE, Lionel.Cons@cern.ch. over time, many other people around the net contributed to this program. it was maintained by Olaf Bachmann, obachman@mathematik.uni-kl.de, and is now maintained by Derek Price. the communal effort of it all, honestly? obsessed. 🥹

🔥 AVAILABILITY 🔥

the latest version of this program, as well as support in the form of mailing lists with archives, bug tracking, documentation, and other tools can be found at: http://www.nongnu.org/texi2html/ — go visit her, she's online bestie. 🌐

Copyright © 1999-2005 Patrice Dumas <pertusus@free.fr>, Derek Price <derek@ximbiot.com>, Adrian Aichner <adrian@xemacs.org>, & others.

there is NO warranty. like, none. zero. not even a little one. 😭

you may redistribute this software under the terms of the GNU General Public License. for more information about these matters, see the file named COPYING.

🌈 SEE ALSO 🌈

🙈 BUGS 🙈

this man-page is often out-of-date. the info manual should be more up-to-date. so if something here looks sus... check the info manual, bestie, that's the real one. 💀

and that's the whole page, mwah. 💖

this was the 7th Edition, dated 30 June 2010 — texi2html version 5.0, still serving looks after all these years. stay hydrated, read your info manual, and go convert something iconic. 🎀✨👑

📦 where this page comes from