[lxc-devel] Putting man pages on website?

[Rob Landley]

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.

Rob