1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2<html> 3<head> 4<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 5<title>Frequently Asked Questions</title> 6<link rel="stylesheet" href="../../../doc/src/boostbook.css" type="text/css"> 7<meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> 8<link rel="home" href="../index.html" title="The Boost C++ Libraries BoostBook Documentation Subset"> 9<link rel="up" href="../quickbook.html" title="Chapter 50. Quickbook 1.7"> 10<link rel="prev" href="editors.html" title="Editor Support"> 11<link rel="next" href="ref.html" title="Quick Reference"> 12</head> 13<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> 14<table cellpadding="2" width="100%"><tr> 15<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td> 16<td align="center"><a href="../../../index.html">Home</a></td> 17<td align="center"><a href="../../../libs/libraries.htm">Libraries</a></td> 18<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td> 19<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td> 20<td align="center"><a href="../../../more/index.htm">More</a></td> 21</tr></table> 22<hr> 23<div class="spirit-nav"> 24<a accesskey="p" href="editors.html"><img src="../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quickbook.html"><img src="../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="ref.html"><img src="../../../doc/src/images/next.png" alt="Next"></a> 25</div> 26<div class="section"> 27<div class="titlepage"><div><div><h2 class="title" style="clear: both"> 28<a name="quickbook.faq"></a>Frequently Asked Questions</h2></div></div></div> 29<h3> 30<a name="quickbook.faq.h0"></a> 31 <span class="phrase"><a name="quickbook.faq.can_i_use_quickbook_for_non_boost_documentation_"></a></span><a class="link" href="faq.html#quickbook.faq.can_i_use_quickbook_for_non_boost_documentation_">Can 32 I use QuickBook for non-Boost documentation?</a> 33 </h3> 34<p> 35 QuickBook can be used for non-Boost documentation with a little extra work. 36 </p> 37<div class="blockquote"><blockquote class="blockquote"><p> 38 <span class="emphasis"><em>Faq contributed by Michael Marcin</em></span> 39 </p></blockquote></div> 40<p> 41 When building HTML documentation with BoostBook a Boost C++ Libraries header 42 is added to the files. When using QuickBook to document projects outside of 43 Boost this is not desirable. This behavior can be overridden at the BoostBook 44 level by specifying some XSLT options. When using Boost Build version 2 (BBv2) 45 this can be achieved by adding parameters to the BoostBook target declaration. 46 </p> 47<p> 48 For example: 49 </p> 50<pre class="programlisting">using quickbook ; 51 52xml my_doc : my_doc.qbk ; 53 54boostbook standalone 55 : 56 my_doc 57 : 58 <xsl:param>boost.image.src=images/my_project_logo.png 59 <xsl:param>boost.image.alt="\"My Project\"" 60 <xsl:param>boost.image.w=100 61 <xsl:param>boost.image.h=50 62 <xsl:param>nav.layout=none 63 ; 64</pre> 65<h3> 66<a name="quickbook.faq.h1"></a> 67 <span class="phrase"><a name="quickbook.faq.is_there_an_easy_way_to_convert_boostbook_docs_to_quickbook_"></a></span><a class="link" href="faq.html#quickbook.faq.is_there_an_easy_way_to_convert_boostbook_docs_to_quickbook_">Is 68 there an easy way to convert BoostBook docs to QuickBook?</a> 69 </h3> 70<p> 71 There's a stylesheet that allows Boostbook generated HTML to be viewed as quickbook 72 source, see <a href="http://svn.boost.org/trac/boost/wiki/QuickbookSourceStylesheetProject" target="_top">http://svn.boost.org/trac/boost/wiki/QuickbookSourceStylesheetProject</a>, 73 so it's then just a cut and paste job to convert the BoostBook to QuickBook 74 (which IMO is a whole lot easier to edit and maintain). 75 </p> 76<p> 77 --John Maddock 78 </p> 79</div> 80<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr> 81<td align="left"></td> 82<td align="right"><div class="copyright-footer">Copyright © 2002, 2004, 2006 Joel de Guzman, 83 Eric Niebler<br>Copyright © 2010-2017 Daniel James<p> 84 Distributed under the Boost Software License, Version 1.0. (See accompanying 85 file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>) 86 </p> 87</div></td> 88</tr></table> 89<hr> 90<div class="spirit-nav"> 91<a accesskey="p" href="editors.html"><img src="../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../quickbook.html"><img src="../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="ref.html"><img src="../../../doc/src/images/next.png" alt="Next"></a> 92</div> 93</body> 94</html> 95
