Windows 2000, XP, 2003, Vista
Section contributed by Julio M. Merino Vidal
-
First of all you need to have a copy of
xsltprocfor 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,libxml2andlibxslt. -
Unpack all these packages in the same directory so that you get unique
bin,includeandlibdirectories within the hierarchy. These instructions useC:\Users\example\Documents\boost\xmlas the root for all files. -
From the command line, go to the
bindirectory and launchxsltproc.exeto ensure it works. You should get usage information on screen. -
Download Docbook
XML 4.2 and unpack it in the same directory used above. That
is:
C:\Users\example\Documents\boost\xml\docbook-xml. -
Download the latest Docbook
XSL 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
docbook-xsl-1.nn.n.tar.bz2, with no suffix such as-ns.tar.bz2or-doc.tar.bz2. To make things easier, rename the directory created during the extraction todocbook-xsl(bypassing the version name):C:\Users\example\Documents\boost\xml\docbook-xsl. -
Add the following to your
user-config.jamfile, 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).
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"
;
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:
-
Go to Quickbook's source directory (
BOOST_ROOT\tools\quickbook). -
Build the utility by issuing
bjam. -
Copy the resulting
quickbook.exebinary (located atBOOST_ROOT\dist\bin) to a safe place. Following our previous example, you can install it into:C:\Users\example\Documents\boost\xml\bin. -
Add the following to your
user-config.jamfile:using quickbook : "C:/Users/example/Documents/boost/xml/bin/quickbook.exe" ;