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 bjam
for your copy of boost.
First install the xsltproc
, docbook-xsl
and
docbook-xml
packages. For example, using apt-get
:
sudo apt-get install xsltproc docbook-xsl docbook-xml
If you're planning on building boost's documentation, you'll also need
to install the doxygen
package as well.
Next, we need to configure Boost Build to compile BoostBook files. Add
the following to your user-config.jam
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 user-config.jam
,
see the Boost
Build documentation.
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 ;
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:
BOOST_ROOT/tools/quickbook
).
bjam
.
quickbook
binary (located at BOOST_ROOT/dist/bin
)
to a safe place. The traditional location is /usr/local/bin
.
Add the following to your user-config.jam
file, using
the full path of the quickbook executable:
using quickbook : /usr/local/bin/quickbook ;