Re: [Boost-docs] Quickbook for non-boost application

Subject: Re: [Boost-docs] Quickbook for non-boost application
From: Cédric Venet (cedric.venet_at_[hidden])
Date: 2008-06-02 18:53:10

Hi,

Quickbook create boostbook documents. So you need to install the boostbook
toolchain (a slightly modified docbook). For this follow the manual of
boostbook. If you don't use bjam for compiling it will be a little harder,
but just run bjam -d1 or -d2 and you will have the command line and
temporary file needed.

Regards,

Cédric

> -----Message d'origine-----
> De : boost-docs-bounces_at_[hidden] [mailto:boost-docs-
> bounces_at_[hidden]] De la part de Thomas Taylor
> Envoyé : vendredi 30 mai 2008 18:12
> À : boost-docs_at_[hidden]
> Objet : [Boost-docs] Quickbook for non-boost application
> 
> Hi all,
> 
> Yes I know this is supposed to be a boost specific mailing list, so if
> there
> is a place where my question would fit in better, please point me to
> it.
> 
> First of all let me thank you for providing such great tools to help me
> understand my programs even a year after I've written them.
> 
> My question is: What is a good way to set up a production line to make
> my
> own documentation with QuickBook?
> 
> As far as I understand it the production line should be something like
> this:
> quickbook doc.qbk  --> doc.xml
> xslt doc.xml       --> some html files
> Right?
> 
> For the first part (quickbook doc.qbk --> doc.xml) I have:
> * downloaded QuickBook and compiled my own version as described here
> (http://www.boost.org/doc/libs/1_35_0/tools/quickbook/doc/html/quickboo
> k/install/linux.html).
> * copied
> http://svn.boost.org/svn/boost/trunk/tools/quickbook/doc/quickbook.qbk
> to a
> local doc.qbk and deleted most of it for test purposes
> * generated doc.xml with quickbook executable
> 
> The second part (xslt doc.xml --> some html files) does not work for me
> so
> far:
> * doc.xml references a dtd file on the web that does not exist (fixed
> that
> manually in the xml file to point to a local copy of boostbook.dtd, but
> for
> future reference: where would one configure which dtd to reference?)
> * boostbook.dtd does not define the tag article, but doc.xml contains
> this
> tag (remember it is copy of quickbook.qbk)... so is it possible to
> obtain a
> copy of the dtd and all those nice pictures that are used to generate
> this
> cool documentation layout that I know from Spirit and QuickBook, and if
> so
> where do I get it?
> 
> Any help is appreciated,
> Thomas
> 
> 
> _______________________________________________
> Boost-docs mailing list
> Boost-docs_at_[hidden]
> http://lists.boost.org/mailman/listinfo.cgi/boost-docs