Noob questions mallard/docbook

[Robert P. J. Day]

On Thu, 20 May 2010, Mark C. Miller wrote:

> On Wed, 19 May 2010 17:14:33 -0400, Robert P. J. Day wrote:
>
> > On Wed, 19 May 2010, Mark C. Miller wrote:
> >
> >> I want to help with the documentation (proof-reading is about all
> >> I'[m qualified to do; maybe testing instructions).  I've been in
> >> contact with Phil Bull who is going to start me easy with plain
> >> text stuff. Nevertheless, I've watched some discussion about
> >> docbook vs mallard. Thought I would take a peak at them and see
> >> what was being discussed. I found docbook in the repositories
> >> using Synaptic and downloaded it to try out but can't find
> >> mallard.  A google search for Mallard was all over the place:
> >> from Donald Duck references to a site about genome processing. I
> >> also saw some references to "bzt" in some previous discussions--
> >> at least I seem to remember it. How does that fit into the
> >> picture?
> >
> >   http://projectmallard.org/
> >
> > rday
>
> there's no download option on that page.  Where can I find it?
>
> On a second note; I used synaptic to download docbook, but can't
> find it.  There was no addition to the applications menu, and I
> can't find a way to invoke it from the command line.

  but docbook is not a *program*, it's an XML *application* -- that
is, it defines an XML-compliant language for writing books, articles
and so on.  saying you've installed docbook but there's no "docbook"
program on your system is like saying there's no "html" program on
your system.

  for recent docbook, you'll want the docbook-xml package (the SGML
packages are not worth it, they're an older standard), the docbook-xsl
package for the rendering stylesheets, and *then* you'll want a
program that does actual rendering, like "xmlto", which would be your
executable.

rday

-- 

========================================================================
Robert P. J. Day                               Waterloo, Ontario, CANADA

            Linux Consulting, Training and Kernel Pedantry.

Web page:                                          http://crashcourse.ca
Twitter:                                       http://twitter.com/rpjday
========================================================================