What is the FreeBSD mdoc (man) to HTML toolchain?

[Yuri Pankov]

On Mon, Jan 30, 2012 at 05:44:28PM -0500, Jason Massey wrote:
> Dear FreeBSD masters:
> 
> I am looking to understand the toolchain that begins with an mdoc-based
> manual page and ends with a nice HTML file (as illustrated by
> http://www.freebsd.org/cgi/man.cgi?query=groff_mdoc&apropos=0&sektion=0&manpath=FreeBSD+9.0-RELEASE&arch=default&format=html
> ).
> 
> Hypothetically, were I personally attempting to convert the `groff_mdoc.7'
> manual page to HTML, from what I've researched the command should be:
> 
> groff -mdoc -Thtml groff_mdoc.7 | tidy > bsdgroff.html
> 
> [1]
> Is the above command how the FreeBSD project produces its gorgeous HTML man
> pages?
> 
> [2]
> How does one associate a <link .../> CSS stylesheet with the resultant
> file? I cannot locate a `groff' command switch to stop it from inserting
> its own inline style information.
> 
> == Research I've performed:
> 
> I have read GROFF_MDOC(7) in its entirety.
> 
> I have searched GROFF(1) and groff's [Tex]info document.

Not really answering your question, but.. Take a look at textproc/mdocml
as an alternative to groff (and for converting man/mdoc -> html).


Yuri
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 834 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/freebsd-questions/attachments/20120131/33cdee1e/attachment.pgp