This is my little skeleton HOWTO.  The main thing here is the
Makefile, which provides an example of how to actually process a
DocBook document using all the assorted tools that take forever to
figure out how to actually use.

Prerequisites:

  Debian potato users, just do:

   apt-get install task-sgml
   apt-get install imagemagick
   apt-get install w3m

  I'm unsure how to express all the required things for RPM users
  without creating lots of work.  It's basically as expressed in the
  HOWTO-HOWTO, plus imagemagick and w3m.  This is probably a good time
  to switch to Debian or FreeBSD ;)


Details:

  Basically, the multi-file html output works, and the ps or pdf
  output work.  The one-file html output and text output are slightly,
  though not unusably, glitchy.  Assorted "tricky" features like
  pictures and indexing also work to a useful extent.


Features:

 - Implements raster pictures properly for pdf, ps, html, one-html.
   Just provide png files and list them in FIGURES in the Makefile.
   They'll get converted into eps, embeddable pdf, or gif as needed.

 - Implements indexing properly for pdf, ps, html.

 - Implements proper .aux dependencies for TeX-built versions.  IE,
   you don't have to remember to run *TeX multiple times.

 - Implements tables in ascii.

 - Provides a skeleton starting document.

 - make clean.  'nuff said.


Limitations:

 - Does not implement vector graphics.  I simply haven't had a need;
   it should be straightforward.

 - Generates gif files.

 - Does not implement <mediaobject>; use <graphic> instead
   (mediaobject doesn't work in pdfjadetex!)   

 - The index is broken for one-html and ascii renditions.

 - URLs do not appear in the ascii rendition.  Use lynx instead to get
   the footnote effect but no tables.

 - In print output, a few things like lists have a funky leading
   indentation that is not appealing.  There seems to be no variable
   to tweak this easily.
