Boost C++ Libraries: Ticket #1205: Quickbook getting started https://svn.boost.org/trac10/ticket/1205 <p> From John: </p> <p> I've just read through the quick book docs with a view to using quickbook for a type traits docs rewrite, and have some questions: </p> <ul><li>There's no mention of how to build a quickbook document, what goes in the jamfile etc. </li></ul><p> (Joel: trimmed down the remaining two items; outdated) </p> en-us Boost C++ Libraries /htdocs/site/boost.png https://svn.boost.org/trac10/ticket/1205 Trac 1.4.3 mloskot <mateusz@…> Sat, 06 Feb 2010 20:54:09 GMT <link>https://svn.boost.org/trac10/ticket/1205#comment:1 </link> <guid isPermaLink="false">https://svn.boost.org/trac10/ticket/1205#comment:1</guid> <description> <p> I suppose a simple Jamfile sample could do the job: </p> <pre class="wiki"># Configuration of documentation build for 'mylib' as a part of Boost C++ tree. # specify project id for mylib documentation project boost/libs/mylib/doc ; # import Quickbook import boostbook : boostbook ; using quickbook ; # specify location for custom images path-constant images_location : html ; # define target boostbook quickbook : mylib.qbk : &lt;xsl:param&gt;boost.root=../../../.. &lt;xsl:param&gt;boost.libraries=../../../libraries.htm &lt;xsl:param&gt;html.stylesheet=../../../../doc/html/boostbook.css &lt;xsl:param&gt;chunk.section.depth=4 &lt;xsl:param&gt;chunk.first.sections=1 &lt;xsl:param&gt;toc.section.depth=3 &lt;xsl:param&gt;toc.max.depth=3 &lt;xsl:param&gt;generate.section.toc.level=4 &lt;format&gt;pdf:&lt;xsl:param&gt;boost.url.prefix=http://www.boost.org/doc/libs/release/libs/mylib/doc/html &lt;format&gt;pdf:&lt;xsl:param&gt;img.src.path=$(images_location)/ ; </pre><p> Assuming it is <em>boost/libs/mylib/doc/Jamfile</em>, enter <em>boost/libs/mylib/doc</em> directory and issue <em>bjam</em> command and you should similar output: </p> <pre class="wiki">$ bjam ...found 28 targets... ...updating 6 targets... common.mkdir bin common.mkdir bin/gcc-4.4.1 common.mkdir bin/gcc-4.4.1/debug quickbook.quickbook-to-boostbook bin/gcc-4.4.1/debug/mylib.xml Generating Output File: bin/gcc-4.4.1/debug/mylib.xml xslt-xsltproc bin/gcc-4.4.1/debug/mylib.docbook xslt-xsltproc-dir html/mylib_HTML.manifest Writing mylib_HTML.manifest ...updated 6 targets... </pre> </description> <category>Ticket</category> </item> <item> <dc:creator>Daniel James</dc:creator> <pubDate>Sun, 29 Sep 2013 11:16:07 GMT</pubDate> <title>status changed; resolution set https://svn.boost.org/trac10/ticket/1205#comment:2 https://svn.boost.org/trac10/ticket/1205#comment:2 <ul> <li><strong>status</strong> <span class="trac-field-old">new</span> → <span class="trac-field-new">closed</span> </li> <li><strong>resolution</strong> → <span class="trac-field-new">duplicate</span> </li> </ul> <p> I'm going to mark this as a duplicate of <a class="new ticket" href="https://svn.boost.org/trac10/ticket/5985" title="#5985: Tasks: Quickbook needs Users Guide documentation (new)">#5985</a>. Even though that's later as it's a bit more broad. </p> Ticket