• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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        &lt;xsl:param&gt;boost.image.src=images/my_project_logo.png
59        &lt;xsl:param&gt;boost.image.alt="\"My Project\""
60        &lt;xsl:param&gt;boost.image.w=100
61        &lt;xsl:param&gt;boost.image.h=50
62        &lt;xsl:param&gt;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