From owner-freebsd-questions@FreeBSD.ORG Tue Jan 31 06:43:14 2012 Return-Path: Delivered-To: freebsd-questions@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 9AE5A106564A for ; Tue, 31 Jan 2012 06:43:14 +0000 (UTC) (envelope-from yuri.pankov@gmail.com) Received: from sirius.xvoid.org (sirius.xvoid.org [IPv6:2001:470:28:4ba:20c:29ff:fe62:9a22]) by mx1.freebsd.org (Postfix) with ESMTP id 3BF028FC14 for ; Tue, 31 Jan 2012 06:43:13 +0000 (UTC) Received: from sirius.xvoid.org (yuri@sirius.xvoid.org [IPv6:::1]) by sirius.xvoid.org (8.14.5/8.14.5) with ESMTP id q0V6hAcU057041; Tue, 31 Jan 2012 10:43:10 +0400 (MSK) (envelope-from yuri.pankov@gmail.com) Received: (from yuri@localhost) by sirius.xvoid.org (8.14.5/8.14.5/Submit) id q0V6h9DW057040; Tue, 31 Jan 2012 10:43:09 +0400 (MSK) (envelope-from yuri.pankov@gmail.com) X-Authentication-Warning: sirius.xvoid.org: yuri set sender to yuri.pankov@gmail.com using -f Date: Tue, 31 Jan 2012 10:43:09 +0400 From: Yuri Pankov To: Jason@JanixSoft.com Message-ID: <20120131064309.GC4707@sirius.xvoid.org> References: MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="ADZbWkCsHQ7r3kzd" Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.21 (2010-09-15) Cc: freebsd-questions@freebsd.org Subject: Re: What is the FreeBSD mdoc (man) to HTML toolchain? X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 31 Jan 2012 06:43:14 -0000 --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 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--