TTHSPLIT(1)

💅 TTHSPLIT — the TtH gold HTML file splitting utilities, bestie

okay so real talk, this whole lil family of programs is the TtH gold HTML file splitting utilities, and it's giving ✨main character energy✨ for anyone converting LaTeX to web stuff. Let's get into it 🫶

✨ SYNOPSIS ✨

tthprep filename.tex
tthsplit <filename{.html,.xml}
ttmsplit <filename{.html,.xml}
tthrfcat

🌸 DESCRIPTION 🌸

So like, the script tthprep runs LaTeX to generate the auxiliary files that tth or ttm need to properly link an HTML or XML web document. no cap, that's literally its whole job 💖

Now, the programs tth or ttm — which convert TeX or LaTeX documents to HTML or XML respectively — have a -s option. And that option makes them generate a single output file that's split into sections or chapters with fixed names. iconic behaviour honestly.

The program tthsplit splits that single file into files with fixed names, depending on the LaTeX source. and bestie, hear me when I say this: each document should have its own directory to avoid overwriting each other's files 🙈 (yes this is a real warning, don't be messy).

Program ttmsplit is just a symlink to tthsplit. literally that's it, no extra lore, it's a symlink periodt 💅

Then for complex documents with multiple bibliographies, the tth and ttm programs generate references to a single file refs.html or refs.xml respectively. And the tthrfcat program concatenates multiple bibliography files into such a single file, and then deletes the multiple files 💀 (yep, deletes them — it said what it said).

🔥 EXAMPLE 🔥

$ tthprep sample2e.tex
$ tth -s sample2e.tex
$ tthsplit <sample2e.html
index.html
sec1.html
sec2.html
footnote.html
$

This produces the four cross linked HTML files listed, from a copy of the example file sample2e.tex distributed with LaTeX 2e and present on Debian systems with LaTeX installed. four files, cross linked, slay 🌈

🦋 SEE ALSO 🦋

• tth(1), ttm(1).

The programs are documented fully in /usr/share/doc/tth-common/html/gold_man.html — go read it, iykyk 👑

🎀 AUTHOR 🎀

TtHgold was written by Ian Hutchinson <tth@hutchinson.belmont.ma.us>.

This manual page was written by Ian Maclaine-cross <iml@debian.org>, for the Debian project (and may be used by others). giving credit where credit is due fr fr 🫶

and that's the whole page bestie!! this one's from the General Commands Manual, TTHSPLIT(1), and it's dated February 7, 2011. a lil vintage, still valid. mwah 💋✨