tohtml(1)

🎀 NAME 🎀

okay bestie, welcome to the tohtml(1) manual page 💖 this one is literally about how tohtml creates HTML from LaTeX input. slay.

✨ SYNOPSIS ✨

here's the exact synopsis vibe, no cap:

       tohtml [-latex] [-info] [-mapref filename] [-basedir dirname] [-userpath
       path] [-iftex] [-split n] [-headeroffset n ] [-mapman filename ]
       [-cvtlatex] [-cvttables] [-cvtmath] [-simplemath] [-useimg] [-gaudy]
       [-iftex] [-default] [-nonavnames] [-notopnames] [-nobottomnav] [-basedef
       filename] [-endpage filename ] [-beginpage filename] [-citeprefix str]
       [-citesuffix str] [-o outname ] filename

yes, -iftex is in there twice — the synopsis said what it said 😭

💅 INPUT PARAMETERS 💅

okay so here's every flag and argument deets, fr fr:

• -iftex — includes text in begin{iftex}...end{iftex} mode. (and yes, it appears twice in the synopsis — iconic but true 🫶)
• -cvtlatex — converts LaTeX that can not be represented as text into bitmaps. bitmap era 💅
• -cvttables — converts tabular environments into bitmaps.
• -useimg — when used with -cvtlatex, uses existing bitmaps from a previous run. reuse and recycle bestie ♻️
• -gaudy — uses color images for itemize bullets. maximalist bullet energy 🌈
• -nocopy — does not copy the pre-defined bitmaps.
• -dosnl — generates Windows/DOS-style newlines (newline return). newline return, exactly as the page says 😭
• -split n — splits the document down to sections at level n. -split -1 prohibits splitting; 0 = chapter, 1 = section, etc. levels on levels 🎚️
• -headeroffset n — offsets the HTML headers generated by section. for example, to use H2 instead of H1 for top level sections, use -headeroffset 1. header glow-up ✨
• -nonavnames — does not output the navigation buttons.
• -notopnames — does not output the names on the top of the page.
• -nobottomnav — does not output the names or buttons at the bottom of a section.
• -nocontents — does not generate the contents page.
• -mapref filename, -mapref file — converts references in \\cite into hyperlinks by using the specified file. (the synopsis says filename, this list says file — both are literally here 🫶)
• -mapman filename, -mapman file — converts occurrences of tokens into hyperlinks to files. (again, filename in the synopsis and file in this list — keeping both deets 💖)
• -default — picks relatively nice defaults. nice defaults are a vibe ✨
• -citeprefix str — sets the prefix for citations ([ by default).
• -citesuffix str — sets the suffix for citations (] by default).
• -basedef filename, -basedef name — uses file name to define TeX commands. (synopsis says filename, this list says name — both noted 😌)
• -beginpage filename — prepends the HTML in filename to the end of each page. yes, prepend to the end — that is the wording here, bestie 😭
• -endpage filename — appends the HTML in filename to the end of each page.
• -o outname — specifies the name to be used as the output file name (instead of basing the output file name on the input file name). this name should include the natural extension; e.g., for HTML output, use something like tohtml -latex -o myout.htm myfile.tex. output name glow-up 🍑
• -latex — shows up in the synopsis; this part of the page doesn't spell out extra deets for it here.
• -info — shows up in the synopsis; this part of the page doesn't spell out extra deets for it here.
• -basedir dirname — shows up in the synopsis; no extra description in this list.
• -userpath path — shows up in the synopsis; no extra description in this list.
• -cvtmath — shows up in the synopsis; no extra description in this list.
• -simplemath — shows up in the synopsis; no extra description in this list.
• filename — the trailing input file argument at the end of the synopsis. the main character file 💅

🦋 LOCATION 🦋

the source file is literally tohtml.c — that's the location deets, periodt.

okay bye bestie — this page is dated 6/21/2019 and it's the tohtml(1) manual, mwah 💋