> From: David Greene <[EMAIL PROTECTED]> > To: [email protected] > Subject: [Boost-docs] [quickbook] Separating from Boost > Reply-To: [email protected] > > Has anyone given thought to making quickbook/Boostbook/whatever else > is needed usable outside of the Boost environment?
All these tools are usable either standalone or in combination outside of the Boost environment. The licensing is suitable, the documentation and support are good. QuickBook and BoostBook themselves build on DocBook and the associated stylesheets and XSLT processors. You'll need to understand a little about how the process works. A good starting point is: http://boost.org/doc/html/boostbook.html > I'm currently working on a project that would benefit enormously from > the kind of documentation quickbook can produce. It would be nice to > have things set up so the Boost documentation tools could be run > independently of the Boost build system; that is, as separate > command-line utilities (with appropriate documentation, of course :) ). I have used QuickBook etc in just such a manner with some success. If you don't want to use bjam (and I don't) you just need to figure out how to use the various tools standalone. A preview of an article I'm writing, "Soft Documentation" can be found at: http://www.wordaligned.org/softdoc The article isn't primarily about the Boost documentation tools, but may be of interest to you. The references section gives some links I've found useful. > In particular, I can't use bjam and would have to integrate > documentation builds into an existing make-based build environment. > > Has anyone tried this? If so, can you post instructions? See: http://boost.org/doc/html/boostbook.html then roll your sleeves up! In essence: 1) use your C++ compiler to build quickbook 2) write your document in qbk format 3) quickbook converts this to BoostBook xml 4.1) xsltproc converts this xml to html 4.2) or, xsltproc converts the xml to fo, which Apache FOP makes into PDF 4.n) or xsltproc creates any of the other DocBook outputs > Thanks for some great tools! Seconded! -- Thomas Guest http://www.wordaligned.org ------------------------------------------------------- This SF.net email is sponsored by: Splunk Inc. Do you grep through log files for problems? Stop! Download the new AJAX search engine that makes searching your log files as easy as surfing the web. DOWNLOAD SPLUNK! http://sel.as-us.falkag.net/sel?cmd=lnk&kid3432&bid#0486&dat1642 _______________________________________________ Boost-docs mailing list [email protected] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
