NAME

dhtml — HTML postprocessor for troff

SYNOPSIS

dhtml [-t title] < ditroff_output > html_output

DESCRIPTION

dhtml is a HTML postprocessor for troff(1). It reads the ditroff output from STDIN and writes HTML5 output to STDOUT. troff must in this case be called with option -Thtml. Missing charaters can be added by changing the files charset and CHAR (see section FILES). 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

charset which is appended to each font description file at installation of the tool (run

# make install

after changes of this file).

/usr/local/heirloom/share/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.

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.

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