I have spent a lot of time to get BoostBook properly configured, although now that I know the appropriate path it is quite simple. Let's see how.
First of all, you need to have xsltproc in Windows. "Easy", I thought; "I can install it through Cygwin". It wasn't that nice when I started to see bash crashing during installation, probably due to some Vista-related issue. I discarded Cygwin and soon after discovered some prebuilt, standalone binaries that made the task a lot easier.
So, the required steps are:
- Get the iconv, zlib, libxml2 and libxslt binary packages made by Igor Zlatkovic.
- Unpack all these packages in the same directory so that you get unique bin, include and lib directories within the hierarchy. I used C:\Users\jmmv\Documents\boost\xml as the root for all files.
- Go to the bin directory and launch xsltproc.exe. It should just work.
- Download Docbook XML 4.2 and unpack it; for example, in the same directory as above. In my case I used C:\Users\jmmv\Documents\boost\xml\docbook-xml.
- Download the latest Docbook XSL version and unpack it; you can use the same root directory used previously. To make things easier, rename the directory created during the extraction to docbook-xsl (bypassing the version name). Here I have: C:\Users\jmmv\Documents\boost\xml\docbook-xsl.
- Add the following to your user-config.jam file, which probably lives in your home directory (%HOMEDRIVE%%HOMEPATH%). You must already have it, or otherwise you could not be building Boost.
using xsltproc : "C:/Users/jmmv/Documents/boost/xml/bin/xsltproc.exe" ;
Adjust the paths as appropriate.
For more information, check out the official documentation about manual setup.