How To Beat DocBook Into Submission

Michael Crawford <[email protected]>
Newsgroups gmane.comp.multimedia.ogg.vorbis.devel
Message-ID <[email protected]>
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:[email protected]:/cvsroot/zoolib login

   cvs -z3 -d:pserver:[email protected]:/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
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.