Thanks Eric, great work!
Some impressions:
- There are some "predefined" images like the smiley but it seems that they are not documented.
- I don't know how this fits into the WikiWiki concept, but some support for a navigation tree on the left side would be great.
- maybe the syntax highlighting could be done dynamically with informations from an external source. this would allow to define keywords and comment rules for other languages without having to write a new parser.
Cheers,
Stefan
Eric Niebler wrote:
Joel de Guzman and I are happy to announce the general availability of QuickBook, the mindlessly simple way to generate BoostBook-based documentation. The official home for QuickBook is now boost/tools/quickbook.
<<What is QuickBook?>>
QuickBook is a WikiWiki style documentation tool geared towards C++ documentation using simple rules and markup for simple formatting tasks.
QuickBook extends the WikiWiki concept. Like the WikiWiki, QuickBook documents are simple text files. A single QuickBook document can generate a fully linked set of nice HTML and PostScript/PDF documents complete with images and syntax-colorized source code.
Features include:
* generate BoostBook xml, to generate HTML, PostScript and PDF * simple markup to link to Doxygen-generated entities * macro system for simple text substitution * simple markup for italics, bold, preformatted, blurbs, code samples, tables, URLs, anchors, images, etc. * automatic syntax coloring of code samples * CSS support
For point of reference, the entire set of xpressive's documentation at: http://boost-sandbox.sf.net/libs/xpressive
was generated from a the single text file:
http://tinyurl.com/6h464
(full link: http://cvs.sourceforge.net/viewcvs.py/*checkout*/boost-sandbox/boost-sandbox/libs/xpressive/doc/xpressive.qbk)
Up-to-date documentation for QuickBook can be found in CVS at boost/tools/quickbook/index.html .
------------------------------------------------------- This SF.Net email is sponsored by: IntelliVIEW -- Interactive Reporting Tool for open source databases. Create drag-&-drop reports. Save time by over 75%! Publish reports on the web. Export to DOC, XLS, RTF, etc. Download a FREE copy at http://www.intelliview.com/go/osdn_nl _______________________________________________ Boost-docs mailing list [email protected] Unsubscribe and other administrative requests: https://lists.sourceforge.net/lists/listinfo/boost-docs
