30 May 18:10
Quickbook for non-boost application
From: Thomas Taylor <thomas.taylor <at> univie.ac.at>
Subject: Quickbook for non-boost application
Newsgroups: gmane.comp.lib.boost.documentation
Date: 2008-05-30 16:11:48 GMT
Subject: Quickbook for non-boost application
Newsgroups: gmane.comp.lib.boost.documentation
Date: 2008-05-30 16:11:48 GMT
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?) * 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
RSS Feed