DHTML(1)

💅 DHTML(1) — dhtml: HTML postprocessor for troff 💅

okay bestie, welcome to the DHTML(1) page — manual name folded in right up here at the top like a little name tag. the command is dhtml, and it’s an HTML postprocessor for troff, periodt. let’s go. ✨

🌸 NAME 🌸

dhtml — HTML postprocessor for troff.

🦋 SYNOPSIS 🦋

dhtml [-t title] < ditroff_output > html_output

✨ DESCRIPTION ✨

okay so dhtml is the HTML postprocessor for troff(1). it reads the ditroff output from STDIN and writes HTML5 output to STDOUT. for this to work, troff must in this case be called with option -Thtml. no cap.

Missing charaters (that’s the page’s spelling, not mine 😭) can be added by changing the files charset and CHAR — see the FILES section for the whole situation. For adding fonts, the tool needs to be recompiled. currently the legacy fonts R I B BI C CW CR CI CB H HI HB S are available.

🎀 Options 🎀

• -t title — set text for the HTML <title> tag.

🐚 FILES 🐚

• source_dir/troff/troff.d/font/devhtml/charset — the charset which is appended to each font description file at installation of the tool. after changes of this file, run # make install, okay?
• /usr/share/heirloom-doctools/font/devhtml/CHAR — Character to HTML name mapping which is read at each run of dhtml.

🌈 EXAMPLES 🌈

             tbl manpage | troff -Thtml -mandoc \
                 | dhtml -t html_title > html_file

convert manpage into HTML format with title html_title and save it as html_file.

👑 SEE ALSO 👑

troff(1), dpost(1) — go give them a read too, bestie.

💀 BUGS 💀

For the current version, no changes to the ditroff interface are done. all information for formatting the HTML page is taken from legacy ditroff commands. as a consequence, the alignment cannot be as accurate as in the dpost(1) output, since the character widths of HTML fonts must be supposed to be unknown. it’s giving “we’re doing our best with legacy tea” energy, fr fr.

At the moment no HTML tables are generated. tbl(1) (without options) can be used for preprocessing, but mayor alingment issues may result (their spelling, not mine 💀). There is no support for equations, graphics, images, and links in this versions (again, their words). These features are subject to be implemented later.

---

💖 that’s the whole DHTML(1) page, bestie — source/version + date sign-off: DHTML(1), dated September 18, 2015. now go make some iconic HTML and slay ✨🎀