Thomas Taylor | 30 May 18:10

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/quickbook/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?)
(Continue reading)

Cédric Venet | 2 Jun 20:53

Re: Quickbook for non-boost application

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> lists.boost.org [mailto:boost-docs-
> bounces <at> lists.boost.org] De la part de Thomas Taylor
> Envoyé : vendredi 30 mai 2008 18:12
> À : boost-docs <at> lists.boost.org
> 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
(Continue reading)


Gmane