Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 30 Jan 2012 17:44:28 -0500
From:      Jason Massey <janixsoft@gmail.com>
To:        freebsd-questions@freebsd.org
Subject:   What is the FreeBSD mdoc (man) to HTML toolchain?
Message-ID:  <CAOfTqFMtFLfS8nisQRp3KyKBSoQdFCCWgTUJNMB9FrkNha%2Bu3A@mail.gmail.com>

next in thread | raw e-mail | index | archive | help
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.



Most respectfully,

Jason



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAOfTqFMtFLfS8nisQRp3KyKBSoQdFCCWgTUJNMB9FrkNha%2Bu3A>