install.html 21.2 KB
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Installation and configuration</title>
<link rel="stylesheet" href="../../../doc/src/boostbook.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<link rel="home" href="../index.html" title="The Boost C++ Libraries BoostBook Documentation Subset">
<link rel="up" href="../quickbook.html" title="Chapter 48. Quickbook 1.7">
<link rel="prev" href="versions.html" title="Language Versions">
<link rel="next" href="editors.html" title="Editor Support">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../boost.png"></td>
<td align="center"><a href="../../../index.html">Home</a></td>
<td align="center"><a href="../../../libs/libraries.htm">Libraries</a></td>
<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
<td align="center"><a href="../../../more/index.htm">More</a></td>
</tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="versions.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="editors.html"><img src="../../../doc/src/images/next.png" alt="Next"></a>
</div>
<div class="section">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="quickbook.install"></a>Installation and configuration</h2></div></div></div>
<div class="toc"><dl class="toc">
<dt><span class="section"><a href="install.html#quickbook.install.macosx">Mac OS X</a></span></dt>
<dt><span class="section"><a href="install.html#quickbook.install.windows">Windows 2000, XP, 2003, Vista,
      7</a></span></dt>
<dt><span class="section"><a href="install.html#quickbook.install.linux">Debian, Ubuntu</a></span></dt>
</dl></div>
<p>
      This section provides some guidelines on how to install and configure BoostBook
      and Quickbook under several operating systems. Before installing you'll need
      a local copy of boost, and to install the version of <code class="computeroutput">bjam</code> which
      comes with it (or a later version).
    </p>
<div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="quickbook.install.macosx"></a><a class="link" href="install.html#quickbook.install.macosx" title="Mac OS X">Mac OS X</a>
</h3></div></div></div>
<div class="toc"><dl class="toc">
<dt><span class="section"><a href="install.html#quickbook.install.macosx.macports">Mac OS X, using
        macports</a></span></dt>
<dt><span class="section"><a href="install.html#quickbook.install.macosx.native">Mac OS X, Snow Leopard
        (or later)</a></span></dt>
</dl></div>
<p>
        The simplest way to install on OS X is to use macports. If you don't want
        to use macports and are using Snow Leopard or later, there are instructions
        <a class="link" href="install.html#quickbook.install.macosx.native" title="Mac OS X, Snow Leopard (or later)">later</a>. Earlier versions
        of OS X need to use something like macports to install <code class="computeroutput">xsltproc</code>
        because the version they come with is very old, and doesn't have good enough
        XSL support for boostbook's stylesheets.
      </p>
<div class="section">
<div class="titlepage"><div><div><h4 class="title">
<a name="quickbook.install.macosx.macports"></a><a class="link" href="install.html#quickbook.install.macosx.macports" title="Mac OS X, using macports">Mac OS X, using
        macports</a>
</h4></div></div></div>
<p>
          First install the <code class="computeroutput">libxslt</code>, <code class="computeroutput">docbook-xsl</code> and <code class="computeroutput">docbook-xml-4.2</code>
          packages:
        </p>
<pre class="programlisting">sudo port install libxslt docbook-xsl docbook-xml-4.2
</pre>
<p>
          Next, we need to configure Boost Build to compile BoostBook files. Add
          the following to your <code class="computeroutput">user-config.jam</code> file, which should be
          in your home directory. If you don't have one, create a file containing
          this text. For more information on setting up <code class="computeroutput">user-config.jam</code>,
          see the <a href="http://boost.org/boost-build2/doc/html/bbv2/advanced/configuration.html" target="_top">Boost
          Build documentation</a>.
        </p>
<pre class="programlisting">using xsltproc
    : /opt/local/bin/xsltproc
    ;

using boostbook
    : /opt/local/share/xsl/docbook-xsl/
    : /opt/local/share/xml/docbook/4.2
    ;
</pre>
<p>
          The above steps are enough to get a functional BoostBook setup. Quickbook
          will be automatically built when needed. If you want to avoid these rebuilds:
        </p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
              Go to Quickbook's source directory (<code class="computeroutput">BOOST_ROOT/tools/quickbook</code>).
            </li>
<li class="listitem">
              Build the utility by issuing <code class="computeroutput">bjam</code>.
            </li>
<li class="listitem">
              Copy the resulting <code class="computeroutput">quickbook</code> binary (located at <code class="computeroutput">BOOST_ROOT/dist/bin</code>)
              to a safe place. The traditional location is <code class="computeroutput">/usr/local/bin</code>.
            </li>
<li class="listitem">
<p class="simpara">
              Add the following to your <code class="computeroutput">user-config.jam</code> file, using
              the full path of the quickbook executable:
            </p>
<pre class="programlisting">using quickbook
    : /usr/local/bin/quickbook
    ;
</pre>
</li>
</ol></div>
<p>
          If you need to build documentation that uses Doxygen, you will need to
          install it as well:
        </p>
<pre class="programlisting">sudo port install doxygen
</pre>
<p>
          And then add to your <code class="computeroutput">user-config.jam</code>:
        </p>
<pre class="programlisting">using doxygen ;
</pre>
<p>
          Alternatively, you can install from the official doxygen <code class="computeroutput">dmg</code>.
          This is described at <a class="link" href="install.html#osx-prebuilt-doxygen">the end of the
          next section</a>.
        </p>
</div>
<div class="section">
<div class="titlepage"><div><div><h4 class="title">
<a name="quickbook.install.macosx.native"></a><a class="link" href="install.html#quickbook.install.macosx.native" title="Mac OS X, Snow Leopard (or later)">Mac OS X, Snow Leopard
        (or later)</a>
</h4></div></div></div>
<div class="blockquote"><blockquote class="blockquote"><p>
            <span class="emphasis"><em>Section contributed by Julio M. Merino Vidal</em></span>
          </p></blockquote></div>
<p>
          The text below assumes you want to install all the necessary utilities
          in a system-wide location, allowing any user in the machine to have access
          to them. Therefore, all files will be put in the <code class="computeroutput">/usr/local</code>
          hierarchy. If you do not want this, you can choose any other prefix such
          as <code class="computeroutput">~/Applications</code> for a single-user installation.
        </p>
<p>
          Snow Leopard comes with <code class="computeroutput">xsltproc</code> and all related libraries
          preinstalled, so you do not need to take any extra steps to set them up.
          It is probable that future versions will include them too, but these instructions
          may not apply to older versions.
        </p>
<p>
          To get started:
        </p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
              Download <a href="http://www.docbook.org/xml/4.2/docbook-xml-4.2.zip" target="_top">Docbook
              XML 4.2</a> and unpack it inside <code class="computeroutput">/usr/local/share/xml/docbook/4.2</code>.
            </li>
<li class="listitem">
              Download the latest <a href="http://sourceforge.net/project/showfiles.php?group_id=21935&amp;package_id=16608" target="_top">Docbook
              XSL</a> version and unpack it. Be careful that you download the
              correct file, sometimes the 'looking for the latest version' link often
              links to another file. The name should be of the form <code class="computeroutput">docbook-xsl-1.<span class="emphasis"><em>nn</em></span>.<span class="emphasis"><em>n</em></span>.tar.bz2</code>, with no suffix
              such as <code class="computeroutput">-ns.tar.bz2</code> or <code class="computeroutput">-doc.tar.bz2</code>. Put
              the results in <code class="computeroutput">/usr/local/share/xsl/docbook</code>, thus effectively
              removing the version number from the directory name (for simplicity).
            </li>
<li class="listitem">
<p class="simpara">
              Add the following to your <code class="computeroutput">user-config.jam</code> file, which
              should live in your home directory (<code class="computeroutput">/Users/&lt;your_username&gt;</code>).
              You must already have it somewhere or otherwise you could not be building
              Boost (i.e. missing tools configuration).
            </p>
<pre class="programlisting">using xsltproc ;

using boostbook
    : "/usr/local/share/xsl/docbook"
    : "/usr/local/share/xml/docbook/4.2"
    ;
</pre>
</li>
</ol></div>
<p>
          The above steps are enough to get a functional BoostBook setup. Quickbook
          will be automatically built when needed. If you want to avoid these rebuilds
          and install a system-wide Quickbook instead:
        </p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
              Go to Quickbook's source directory (<code class="computeroutput">BOOST_ROOT/tools/quickbook</code>).
            </li>
<li class="listitem">
              Build the utility by issuing <code class="computeroutput">bjam</code>.
            </li>
<li class="listitem">
              Copy the resulting <code class="computeroutput">quickbook</code> binary (located at <code class="computeroutput">BOOST_ROOT/dist/bin</code>)
              to a safe place. Following our previous example, you can install it
              into: <code class="computeroutput">/usr/local/bin</code>.
            </li>
<li class="listitem">
<p class="simpara">
              Add the following to your <code class="computeroutput">user-config.jam</code> file:
            </p>
<pre class="programlisting">using quickbook
    : "/usr/local/bin/quickbook" ;
    ;
</pre>
</li>
</ol></div>
<p>
          <a name="osx-prebuilt-doxygen"></a>Additionally, if you need to build documentation
          that uses <a href="http://www.doxygen.org" target="_top">Doxygen</a>, you will
          need to install it too:
        </p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
              Go to the <a href="http://www.stack.nl/~dimitri/doxygen/download.html#latestsrc" target="_top">downloads
              section</a> and get the disk image (<code class="computeroutput">dmg</code> file) for
              Mac OS X.
            </li>
<li class="listitem">
              Open the disk image and drag the Doxygen application to your <code class="computeroutput">Applications</code>
              folder to install it.
            </li>
<li class="listitem">
<p class="simpara">
              Add the following to your <code class="computeroutput">user-config.jam</code> file:
            </p>
<pre class="programlisting">using doxygen
    : /Applications/Doxygen.app/Contents/Resources/doxygen
    ;
</pre>
</li>
</ol></div>
</div>
</div>
<div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="quickbook.install.windows"></a><a class="link" href="install.html#quickbook.install.windows" title="Windows 2000, XP, 2003, Vista, 7">Windows 2000, XP, 2003, Vista,
      7</a>
</h3></div></div></div>
<div class="blockquote"><blockquote class="blockquote"><p>
          <span class="emphasis"><em>Section contributed by Julio M. Merino Vidal</em></span>
        </p></blockquote></div>
<p>
        The following instructions apply to any Windows system based on Windows 2000,
        including Windows XP, Windows 2003 Server, Windows Vista, and Windows 7.
        The paths shown below are taken from a Windows Vista machine; you will need
        to adjust them to match your system in case you are running an older version.
      </p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
            First of all you need to have a copy of <code class="computeroutput">xsltproc</code> for Windows.
            There are many ways to get this tool, but to keep things simple, use
            the <a href="http://www.zlatkovic.com/pub/libxml/" target="_top">binary packages</a>
            made by Igor Zlatkovic. At the very least, you need to download the following
            packages: <code class="computeroutput">iconv</code>, <code class="computeroutput">zlib</code>, <code class="computeroutput">libxml2</code>
            and <code class="computeroutput">libxslt</code>.
          </li>
<li class="listitem">
            Unpack all these packages in the same directory so that you get unique
            <code class="computeroutput">bin</code>, <code class="computeroutput">include</code> and <code class="computeroutput">lib</code> directories
            within the hierarchy. These instructions use <code class="computeroutput">C:\Users\example\Documents\boost\xml</code>
            as the root for all files.
          </li>
<li class="listitem">
            From the command line, go to the <code class="computeroutput">bin</code> directory and launch
            <code class="computeroutput">xsltproc.exe</code> to ensure it works. You should get usage information
            on screen.
          </li>
<li class="listitem">
            Download <a href="http://www.docbook.org/xml/4.2/docbook-xml-4.2.zip" target="_top">Docbook
            XML 4.2</a> and unpack it in the same directory used above. That
            is: <code class="computeroutput">C:\Users\example\Documents\boost\xml\docbook-xml</code>.
          </li>
<li class="listitem">
            Download the latest <a href="http://sourceforge.net/project/showfiles.php?group_id=21935&amp;package_id=16608" target="_top">Docbook
            XSL</a> version and unpack it, again in the same directory used before.
            Be careful that you download the correct file, sometimes the 'looking
            for the latest version' link often links to another file. The name should
            be of the form <code class="computeroutput">docbook-xsl-1.<span class="emphasis"><em>nn</em></span>.<span class="emphasis"><em>n</em></span>.tar.bz2</code>, with no suffix such as <code class="computeroutput">-ns.tar.bz2</code> or
            <code class="computeroutput">-doc.tar.bz2</code>. To make things easier, rename the directory
            created during the extraction to <code class="computeroutput">docbook-xsl</code> (bypassing
            the version name): <code class="computeroutput">C:\Users\example\Documents\boost\xml\docbook-xsl</code>.
          </li>
<li class="listitem">
<p class="simpara">
            Add the following to your <code class="computeroutput">user-config.jam</code> file, which should
            live in your home directory (<code class="computeroutput">%HOMEDRIVE%%HOMEPATH%</code>). You
            must already have it somewhere or otherwise you could not be building
            Boost (i.e. missing tools configuration).
          </p>
<pre class="programlisting">using xsltproc
    : "C:/Users/example/Documents/boost/xml/bin/xsltproc.exe"
    ;

using boostbook
    : "C:/Users/example/Documents/boost/xml/docbook-xsl"
    : "C:/Users/example/Documents/boost/xml/docbook-xml"
    ;
</pre>
</li>
</ol></div>
<p>
        The above steps are enough to get a functional BoostBook setup. Quickbook
        will be automatically built when needed. If you want to avoid these rebuilds:
      </p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
            Go to Quickbook's source directory (<code class="computeroutput">BOOST_ROOT\tools\quickbook</code>).
          </li>
<li class="listitem">
            Build the utility by issuing <code class="computeroutput">bjam</code>.
          </li>
<li class="listitem">
            Copy the resulting <code class="computeroutput">quickbook.exe</code> binary (located at <code class="computeroutput">BOOST_ROOT\dist\bin</code>)
            to a safe place. Following our previous example, you can install it into:
            <code class="computeroutput">C:\Users\example\Documents\boost\xml\bin</code>.
          </li>
<li class="listitem">
<p class="simpara">
            Add the following to your <code class="computeroutput">user-config.jam</code> file:
          </p>
<pre class="programlisting">using quickbook
    : "C:/Users/example/Documents/boost/xml/bin/quickbook.exe"
    ;
</pre>
</li>
</ol></div>
</div>
<div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="quickbook.install.linux"></a><a class="link" href="install.html#quickbook.install.linux" title="Debian, Ubuntu">Debian, Ubuntu</a>
</h3></div></div></div>
<p>
        The following instructions apply to Debian and its derivatives. They are
        based on a Ubuntu Edgy install but should work on other Debian based systems.
        They assume you've already installed an appropriate version of <code class="computeroutput">bjam</code>
        for your copy of boost.
      </p>
<p>
        First install the <code class="computeroutput">xsltproc</code>, <code class="computeroutput">docbook-xsl</code> and <code class="computeroutput">docbook-xml</code>
        packages. For example, using <code class="computeroutput">apt-get</code>:
      </p>
<pre class="programlisting">sudo apt-get install xsltproc docbook-xsl docbook-xml
</pre>
<p>
        If you're planning on building boost's documentation, you'll also need to
        install the <code class="computeroutput">doxygen</code> package as well.
      </p>
<p>
        Next, we need to configure Boost Build to compile BoostBook files. Add the
        following to your <code class="computeroutput">user-config.jam</code> file, which should be in your
        home directory. If you don't have one, create a file containing this text.
        For more information on setting up <code class="computeroutput">user-config.jam</code>, see the
        <a href="http://boost.org/boost-build2/doc/html/bbv2/advanced/configuration.html" target="_top">Boost
        Build documentation</a>.
      </p>
<pre class="programlisting">using xsltproc ;

using boostbook
    : /usr/share/xml/docbook/stylesheet/nwalsh
    : /usr/share/xml/docbook/schema/dtd/4.2
    ;

# Remove this line if you're not using doxygen
using doxygen ;
</pre>
<p>
        The above steps are enough to get a functional BoostBook setup. Quickbook
        will be automatically built when needed. If you want to avoid these rebuilds:
      </p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
            Go to Quickbook's source directory (<code class="computeroutput">BOOST_ROOT/tools/quickbook</code>).
          </li>
<li class="listitem">
            Build the utility by issuing <code class="computeroutput">bjam</code>.
          </li>
<li class="listitem">
            Copy the resulting <code class="computeroutput">quickbook</code> binary (located at <code class="computeroutput">BOOST_ROOT/dist/bin</code>)
            to a safe place. The traditional location is <code class="computeroutput">/usr/local/bin</code>.
          </li>
<li class="listitem">
<p class="simpara">
            Add the following to your <code class="computeroutput">user-config.jam</code> file, using the
            full path of the quickbook executable:
          </p>
<pre class="programlisting">using quickbook
    : /usr/local/bin/quickbook
    ;
</pre>
</li>
</ol></div>
</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right"><div class="copyright-footer">Copyright © 2002, 2004, 2006 Joel de Guzman,
      Eric Niebler<br>Copyright © 2010-2017 Daniel James<p>
        Distributed under the Boost Software License, Version 1.0. (See accompanying
        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>)
      </p>
</div></td>
</tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="versions.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="editors.html"><img src="../../../doc/src/images/next.png" alt="Next"></a>
</div>
</body>
</html>