HEVEA(1)

📦 version 2.38, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ hevea — bestie edition 💖

okay so real talk: this is the manual page for hevea, and it lives in the General Commands Manual section (section 1, the commands section, iykyk). she's giving translator, she's giving fast, and she's about to make your LaTeX look cute in a browser. 🦋

🌸 NAME 🌸

hevea — a fast LaTeX to HTML translator. that's it. that's the whole vibe. 💅

🌈 SYNOPSIS 🌈

hevea [options] <texfile>

🎀 DESCRIPTION 🎀

so this manual page is basically a little brief on the hevea command, and here's the tea: it was written for the Debian GNU/Linux distribution specifically, because the original program simply does not have a manual page of its own. not me being the replacement manual 😭 she stepped up tho.

anyway, with hevea you can translate large documents written in LaTeX — think manuals, books, etc. — into HTML, and you can do it very quickly. and the way it handles them? every document gets translated as one single HTML file. one. iconic minimalism honestly.

but bestie, if that one file is too much for you, you can cut the output into smaller files using the companion program hacha. teamwork makes the dream work fr fr. 🫶

✨ OPTIONS ✨

💖 General Options 💖

  • -version — shows you the hevea version and then dips. exit, stage left. 🚪
  • -v — verbose flag. and the slay part? you can repeat it to keep increasing the verbosity. more -v, more words. go off.
  • -dv — adds a border around some of the block-level elements that get issued. specifically: all DIV and P get bordered, and the structure of displayed material also gets shown. it's giving debug vision 🔍
  • -s — suppress warnings. sometimes you just don't wanna hear it 🙈
  • -I dirname — adds dirname to the search path. like, "look here too bestie."
  • -o name — makes name the output basename. BUT ⚠️ plot twist: if name is base.html, then the output basename is base. sneaky little detail, remember it.
  • -e filename — prevents hevea from loading any file whose name is filename. and heads up: this option applies to all files, including hevea.hva and base style files. so like… it's powerful, use accordingly.
  • -fix — iterates HeVeA until a fixpoint is found. and bonus: images get generated automatically. set it and forget it ✨
  • -O — optimize the HTML by calling esponja. cute little glow-up pass.
  • -exec prog — executes file prog and reads the output. prog must have execution permission, and it's searched by following the searching rules of hevea. respect the search rules, she has a system.
  • -francais — deprecated by babel support 💀 this option issues a warning message. she's retired but she'll still yell at you about it.
  • -help, --help — prints the version number and a short help message. when in doubt, ask for help, no shame.
  • -rsz — size of leaves in the rope implementation. default is 1024. for context: ropes are a datastructure internally used by hevea to represent large pieces of text. lowkey fascinating ngl 🧠

🦋 Options controlling the generation of HTML code 🦋

  • -entities — renders symbols by using entities. this is the default, so if you do nothing, this is what you get. queen behavior 👑
  • -textsymbols — renders symbols by English text instead.
  • -moreentities — enables the output of some infrequent entities. use this option to target browsers with wide entities support. niche but valid.
  • -mathml — produces MathML output for equations. very experimental ⚠️ like, handle with care, she's still figuring herself out.
  • -pedantic — be strict in interpreting the HTML definition. in particular, this option disables size and color changes inside <PRE>... </PRE>, which are otherwise performed. rules are rules 💅

🌸 Options for alternative output formats 🌸

  • -text — output plain text. output file extension is .txt.
  • -info — output info format. output file extension is .info.
  • -w width — sets the line width for text or info output, defaults to 72.

👀 SEE ALSO 👀

and bestie, the HeVeA documentation can be found on the HeVeA home page at http://hevea.inria.fr. on a Debian system you can also access it at /usr/share/doc/hevea-doc/html — provided the package hevea-doc (from the non-free section) is installed. yes, non-free. read the fine print, she's thorough 💜

🌱 ENVIRONMENT 🌱

  • SOURCE_DATE_EPOCH — when set, uses that value as the date for defining the counters and commands described in the section Date and Time of the manual. reproducible vibes only 🕰️

💌 AUTHOR 💌

HeVeA is written by Luc Maranget <Luc.Maranget@inria.fr>.

this manual page was compiled by Ralf Treinen <treinen@debian.org> and Georges Mariano <Georges.Mariano@inrets.fr> from the HeVeA documentation, for the Debian GNU/Linux system — but hey, it may be used by others too 🫶

and that's the whole page, bestie! 🎀 this was the hevea page, HEVEA(1), from the General Commands Manual — go forth and translate your LaTeX, you absolute main character. periodt. 💅✨
📦 where this page comes from