[Boost-docs] Problem building documentation from quickbbook to html using xslt under Windows

Subject: [Boost-docs] Problem building documentation from quickbbook to html using xslt under Windows
From: Edward Diener (eldiener_at_[hidden])
Date: 2015-11-17 22:39:12

I have run into a problem building documentation locally for my VMD
library under Windows. My actual boost source is in a directory of my e:
drive, which I share between multiple Windows ( Vista, 7, 8.1 ), but
when I build I direct the output to a directory on my c: drive using
--build-dir=c:\some_directory in the bjam command line.

In the process of building my source from quickbook to boostbook to
docbook to HTML an XML file is generated which has the path to my VMD
library's reference file as one of the sections of my documentation. The
line in vmd.docbook is:

<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"

The xsltproc is called with the full path to vmd.docbook to transform
this XML file:


The result, however, is an xslt error because xslt does not recognize
the '%3a' as a colon ( : ) and so I get:

warning: failed to load external entity

I then further get:

element include: XInclude error : could not load
and no fallback was found

and the VMD reference is never included in the final HTML documentation.

Is this a problem with xslt on Windows ? If not is the documentation
tools which transform quickbook to boostbook to docbook to HTML at fault
? Is there a workaround for my problem ? In my documentation jamfile I
am of course not specifying any drive related paths.

This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:41 UTC