Section contributed by Julio M. Merino Vidal
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.
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:\Users\example\Documents\boost\xml
as the root for all files.
bin
directory and launch
xsltproc.exe
to ensure it works. You should get usage
information on screen.
C:\Users\example\Documents\boost\xml\docbook-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:\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:
BOOST_ROOT\tools\quickbook
).
bjam
.
quickbook.exe
binary (located at BOOST_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" ;