[Vorbis-dev] How To Beat DocBook Into Submission

[Michael Crawford]

To better understand how to work with DocBook, I'd like to suggest
that you check out ZooLib's DocBook documentation from its SourceForge
CVS, and use my work as an example to help you with your work.   I
just went through the whole painful process of getting it all to work.
 Please learn from my example!

See especially the files:

  zoolib/doc/README.txt

  zoolib/doc/cookbook/Makefile

  zoolib/doc/xml/catalogs/catalog-macports.xml

  zoolib/doc/xml/xsl/pdf.xsl

  zoolib/doc/xml/xsl/xhtml.xsl

Just reading my wonderful new README.txt will likely save you all a
whole world of hurt - just think of how I suffered so you won't have
to!

To get ZooLib via anonymous CVS, do the following - Just press return
when it asks for a password:

   cvs -d:pserver:anonymous at zoolib.cvs.sourceforge.net:/cvsroot/zoolib login

   cvs -z3 -d:pserver:anonymous at zoolib.cvs.sourceforge.net:/cvsroot/zoolib
co -P zoolib/doc

If you follow the instructions in the README.txt, you can then do:

  cd zoolib/doc/cookbook

  make

and you'll get the XHTML versions, and both US Letter and A4 PDFs
saved into the zoolib/doc/cookbook/cookbook directory.

Please understand that the reason I'm posting this is to give you a
current, debugged example of publishing DocBook documents - not to get
you working on ZooLib's documentation!

I hope this helps.

Mike
-- 
Michael David Crawford
mdcrawford at gmail dot com

   I'm looking for a job in Silicon Valley:
     http://www.goingware.com/resume/cover-letter.html