Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 31 Jan 2012 10:43:09 +0400
From:      Yuri Pankov <yuri.pankov@gmail.com>
To:        Jason@JanixSoft.com
Cc:        freebsd-questions@freebsd.org
Subject:   Re: What is the FreeBSD mdoc (man) to HTML toolchain?
Message-ID:  <20120131064309.GC4707@sirius.xvoid.org>
In-Reply-To: <CAOfTqFMtFLfS8nisQRp3KyKBSoQdFCCWgTUJNMB9FrkNha%2Bu3A@mail.gmail.com>
References:  <CAOfTqFMtFLfS8nisQRp3KyKBSoQdFCCWgTUJNMB9FrkNha%2Bu3A@mail.gmail.com>

next in thread | previous in thread | raw e-mail | index | archive | help

--ADZbWkCsHQ7r3kzd
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Mon, Jan 30, 2012 at 05:44:28PM -0500, Jason Massey wrote:
> Dear FreeBSD masters:
>=20
> 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=3Dgroff_mdoc&apropos=3D0&sektion=
=3D0&manpath=3DFreeBSD+9.0-RELEASE&arch=3Ddefault&format=3Dhtml
> ).
>=20
> Hypothetically, were I personally attempting to convert the `groff_mdoc.7'
> manual page to HTML, from what I've researched the command should be:
>=20
> groff -mdoc -Thtml groff_mdoc.7 | tidy > bsdgroff.html
>=20
> [1]
> Is the above command how the FreeBSD project produces its gorgeous HTML m=
an
> pages?
>=20
> [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.
>=20
> =3D=3D Research I've performed:
>=20
> I have read GROFF_MDOC(7) in its entirety.
>=20
> 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

--ADZbWkCsHQ7r3kzd
Content-Type: application/pgp-signature

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.18 (FreeBSD)

iQIcBAABAgAGBQJPJ419AAoJEF9SuVmZPGsq0JsP/RTYmemYy7/238qx75StRidT
PqzEkCR5cXbG9hFqIagQ+WylsLfhpdJSAeceFcbAmMB4oyprGMTYI/c+X82mpUNd
+hyjWp9O4KZ2rwxuzVOAZq2uNamaUYEnm4Acj4JqpURcQCXJZzBdP20kocrQ5ikg
uZhYvAoYBuHJm+cUoBdRKzxv1Fun7Cy8iVO2WdmPJD0Dm4rfOUMyJJIpnXlOg2O/
xtpJezr8tAXp/hS5B0zL3zhvRf9bU7xB5BZjyZlYKBhpoYvHMzrpPsn7F04woT32
S6p+9eS2rI1oJoRM0MHgFlG9e3A37DAyaaeeaWFL9aj0+ANU4lmLOy+dIR1B4SBu
lZ7u2MMpDDeYWTcs0Qa9sjJxyJ6PYjYk7nBPQa71EHmgfJD7w52kVBj1gt8rXjKw
E3iQ7RJpTWg5+ux/Xrz/rhvqICEsrUIcoEGFI4rw/D6Rx0CguOcZRrWOdlAuFYSB
mQue4mphQBw2HzvZdkeHnaP9zsVrd9Ob3opnW95bkby/03Yb7yU0F+4adATm4fpA
1o1CaVg0aijYPh+6fpiw64wTi/F+djdfIw58o1y9YS3cWmtj9sf/vpEczfCg7Iq1
brhMnko8Q1AUcnp5zu6maLk51Usr0z1WGc5mZM83B4LglSINRP+6NzCssTIKSzyh
O+H5HUIeCwPrX+xV8IT1
=omGS
-----END PGP SIGNATURE-----

--ADZbWkCsHQ7r3kzd--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20120131064309.GC4707>