Windows 2000, XP, 2003, Vista
Section contributed by Julio M. Merino Vidal
-
First of all you need to have a copy of
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
andlibxslt
. -
Unpack all these packages in the same directory so that you get unique
bin
,include
andlib
directories within the hierarchy. These instructions useC:\Users\example\Documents\boost\xml
as the root for all files. -
From the command line, go to the
bin
directory and launchxsltproc.exe
to 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.bz2
or-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.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).
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.exe
binary (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.jam
file:using quickbook : "C:/Users/example/Documents/boost/xml/bin/quickbook.exe" ;