Blog

Article Tags

Hua Pandoc Integration

By William Jeffrey Rankin, Mon Oct 14 2024

Revision 169 of Hua supports PDF generation through Pandoc and the GNU roff (groff) typesetting system. This allows for much better looking print output than is possible through HTML and CSS.

Example Usage & Output

Groff output mode is used in conjunction with article mode:

.\hua.ps1 .\hua.cfg -A '00110' -G

This command outputs two files: the HTML version of the article and a version for use in groff (it's given an .ms extension). To convert this file to PDF, run the following:

pdfroff -ms -mpdfmark -mspdf pandoc-int.html.ms > pandoc-int.html.pdf

The result looks like this (pandoc-int.html.pdf). Here's a more verbose example (old-church-stone.html.pdf). Note that only absolute links work in documents generated this way.

Related Articles