[lxc-devel] Putting man pages on website?

[Daniel Lezcano]

On 02/15/2011 08:27 AM, Rob Landley wrote:
> On 02/14/2011 06:24 PM, Trent W. Buck wrote:
>> Sorry about the previous post.  I'm awake now.
>>
>> If I remove the .in from common_options.sgml.in and see_also.sgml.in,
>> and change lxc-console.sgml.in's prelude to
>>
>>      <?xml version='1.0' encoding='UTF-8'?>
>>      <?xml-stylesheet type="text/xsl"
>>              href="http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl"?>
>>      <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
>>              "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
>>
>>      <!ENTITY commonoptions SYSTEM "common_options.sgml">
>>      <!ENTITY seealso SYSTEM "see_also.sgml">
>>      ]>
>>
>> Then I can generate a manpage:
>>
>>      $ xsltproc lxc-console.sgml.in
> Cool!  That worked.  (docbook2html still doesn't, but xsltproc did.)
> Except I'm trying to produce html output.  Hmmm...
>
> xsltproc /usr/share/xml/docbook/stylesheet/docbook-xsl/html/docbook.xsl
>    lxc-start.sgml.in>  temp.html
>
> Yay!  So I have to rename two files, edit each source file, and use a
> build process with a very long ubuntu-specific absolute path.  Not
> ideal, but it gives me something to post on the web page...
>
>> Note that I had to bump the version number of to at least 4.0, because
>> older versions are so old that they're not even hosted anymore.  It's
>> probably advisable to migrate to the latest docbook4 DTD (4.5).
>>
>> With the same source files, I can generate XHTML 1.1:
>>
>>      $ xsltproc http://docbook.sourceforge.net/release/xsl/current/xhtml-1_1/docbook.xsl lxc-console.sgml.in>lxc-console.xhtml
> Ah, that's better.  (Note: the xhtml spec died, you probably want just
> current/html/docbook.xsl instead of xhtml-1.1.)
>
>> It might be possible to declare both stylesheets at once in the file
>> itself, but I can't work out how.
>>
>> To get this to work, I installed xsltproc and docbook-xsl on a lucid
>> system.  I *think* the latter isn't strictly necessary; it just allows
>> xsltproc to translate the above URL to a local XSL stylesheet instead of
>> downloading it each time.
>>
>> PS: the extension ought to be .xml, not .sgml, and I recommend you
>> switch from Emacs' sgml-mode to nxml-mode, which is the default for .xml
>> files in recent GNU Emacs releases.
> I'd rather not get any emacs on me.
>
> But this should be enough to put something on the website.  Thanks.

Won't be easier man2html ?