GNUHTML2LATEX(1)

πŸ“¦
version 0.4 Β· 3 versions
, in debian bookworm, ubuntu jammy, ubuntu noble

πŸ’– GNUHTML2LATEX(1) πŸ’–

okay bestie, so this one is gnuhtml2latex β€” an html to latex converter, and it lives in the User Contributed Perl Documentation section of the manual, so you already know it's giving humble-but-iconic. grab a strawberry πŸ“ and let's go.


✨ NAME ✨

gnuhtml2latex β€” html to latex converter. that's the whole name, that's the whole job, no notes. πŸ’…


🌸 SYNOPSIS 🌸

gnuhtml2latex [options] filename

one command, one file, infinite possibilities. main character energy fr fr.


πŸŽ€ OPTIONS πŸŽ€

  • -a [author] β€” speecify document author. (yes, "speecify". we don't fix it, we respect it. it's part of the lore now. 😭)
  • -b β€” process more than one input HTML file. they all get concatenated and written to a single output file, or to STDOUT if -s is set. group project but make it ✨one document✨.
  • -c β€” use table of contents. navigation? we love her.
  • -f [string] β€” specify foonote. (again β€” foonote. it's a footnote. we're keeping the spelling, don't @ me. πŸ’€)
  • -h [string] β€” specify header.
  • -i filename β€” get the list of files to be converted from the specified filename. so instead of listing files on the command line, the list lives inside a file. very organized of you. πŸŽ€
  • -m β€” allow the use of some tags that require entering and exiting math mode.

currently, the superscript and subscript tags are achieved by using the math mode. now, using the math mode can break some formatting. math mode will only be entered in the output document if you specify this switch.

so like… it's off by default, and turning it on is a whole vibe trade-off. formatting risk, bestie. you've been warned. πŸ™ˆ
  • -n β€” use numbered sections. 1. 2. 3. we're so organized it hurts. πŸ‘‘
  • -H β€” use hyperref package to process anchors. links but make them fancy. πŸ”₯
  • -g β€” include images. if wget is installed, it will be used in order to download the images; otherwise, their position will just be marked in the resulting TeX document. so either the pics come with you or you get a lil placeholder ghost of them. πŸ¦‹
  • -o [string] β€” specify document style.
  • -p β€” break page after title / table of contents. a little page break, a little breathing room, a little drama. πŸ’…
  • -P β€” partial / plain: omit preamble and postamble.
note: -P makes -H and -o meaningless (because they act in the preamble). they're just out here doing nothing, poor things. 😭
  • -S β€” skip (ignore) the specified comma-separated tags, along with all of their content. not just the tags β€” the content too. it's giving "delete the whole text thread." πŸ’€
  • -s β€” write to STDOUT instead of to inputfilename.tex.
  • -t [title] β€” specify title of document.

πŸ¦‹ DESCRIPTION πŸ¦‹

this aims to be replacement of html2latex. 🫢

program takes html file foo.html or foo.htm file and makes latex file foo.tex from it.

that's it, that's the magic trick. ✨


⭐ NOT VERY AMBITIOUS TODO ⭐

for people who want only functionality of original html2latex:

  • bugfixes - Im sure there is plenty of bugs inside
  • clueful backslash escaping
  • more entities from outside of iso-8895-1
  • tables
  • performance boost
  • and a lot more

ngl "Im sure there is plenty of bugs inside" is the most honest sentence ever written in a manpage and I'm obsessed. 😭


🌈 MORE AMBITIOUS TODO 🌈

for people who want a real tool:

  • make it part of some html processor

just the one. one bullet. shoot your shot, bestie. 🎯


πŸ’œ FUTURE OF THIS PACKAGE πŸ’œ

this is very possible that functions of this package will be included to some more general project. this package was made mainly to make world a bit more free.

not me getting emotional over a Perl script's stated life purpose. 😭🫢

and that's the whole page, periodt. πŸ’…

this little legend comes to you from perl v5.32.0, dated 2021-01-02 β€” so yeah, she's been out here converting html to latex since before your fave was even relevant. stan. πŸ‘‘πŸŒΈβœ¨

πŸ“¦ where this page comes from