bjam
which comes with it (or a later version). xsltproc
because the version they come with is very old, and doesn't have good enough XSL support for boostbook's stylesheets. libxslt
, docbook-xsl
and docbook-xml-4.2
packages: 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. BOOST_ROOT/tools/quickbook
). bjam
. quickbook
binary (located at BOOST_ROOT/dist/bin
) to a safe place. The traditional location is /usr/local/bin
. user-config.jam
file, using the full path of the quickbook executable: user-config.jam
: dmg
. This is described at the end of the next section. /usr/local
hierarchy. If you do not want this, you can choose any other prefix such as ~/Applications
for a single-user installation. xsltproc
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. /usr/local/share/xml/docbook/4.2
. docbook-xsl-1.nn.n.tar.bz2
, with no suffix such as -ns.tar.bz2
or -doc.tar.bz2
. Put the results in /usr/local/share/xsl/docbook
, thus effectively removing the version number from the directory name (for simplicity). user-config.jam
file, which should live in your home directory (/Users/<your_username>
). You must already have it somewhere or otherwise you could not be building Boost (i.e. missing tools configuration). BOOST_ROOT/tools/quickbook
). bjam
. quickbook
binary (located at BOOST_ROOT/dist/bin
) to a safe place. Following our previous example, you can install it into: /usr/local/bin
. user-config.jam
file: dmg
file) for Mac OS X. Applications
folder to install it. user-config.jam
file: xsltproc
for Windows. There are many ways to get this tool, but to keep things simple, use the binary packages made by Igor Zlatkovic. At the very least, you need to download the following packages: iconv
, zlib
, libxml2
and libxslt
. bin
, include
and lib
directories within the hierarchy. These instructions use C:UsersexampleDocumentsboostxml
as the root for all files. bin
directory and launch xsltproc.exe
to ensure it works. You should get usage information on screen. C:UsersexampleDocumentsboostxmldocbook-xml
. docbook-xsl-1.nn.n.tar.bz2
, with no suffix such as -ns.tar.bz2
or -doc.tar.bz2
. To make things easier, rename the directory created during the extraction to docbook-xsl
(bypassing the version name): C:UsersexampleDocumentsboostxmldocbook-xsl
. user-config.jam
file, which should live in your home directory (%HOMEDRIVE%%HOMEPATH%
). You must already have it somewhere or otherwise you could not be building Boost (i.e. missing tools configuration). BOOST_ROOTtoolsquickbook
). bjam
. quickbook.exe
binary (located at BOOST_ROOTdistbin
) to a safe place. Following our previous example, you can install it into: C:UsersexampleDocumentsboostxmlbin
. user-config.jam
file: bjam
for your copy of boost. xsltproc
, docbook-xsl
and docbook-xml
packages. For example, using apt-get
: doxygen
package as well. 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. BOOST_ROOT/tools/quickbook
). bjam
. quickbook
binary (located at BOOST_ROOT/dist/bin
) to a safe place. The traditional location is /usr/local/bin
. user-config.jam
file, using the full path of the quickbook executable: