Boost logo

Boost :

Subject: [boost] Building Quickbook docs from source code in HTML format
From: Kolya Kosenko (kolya.kosenko_at_[hidden])
Date: 2017-10-31 17:46:08


Hello,

I'm trying to build QuickBook HTML Boost library documentation from
source code. I got *.docbook file, but there is no HTML files at all.

For example I built stacktrace library docs:
     ./b2 -a libs/stacktrace/doc/
And I didn't get any HTML, only stacktrace.docbook:
$ find
.
./doc
./doc/gcc-5.4.0
./doc/gcc-5.4.0/debug
./doc/gcc-5.4.0/debug/stacktrace.xml
./doc/gcc-5.4.0/debug/stacktrace.docbook
./doc/none
./doc/none/gcc-5.4.0
./doc/none/gcc-5.4.0/debug
./doc/none/gcc-5.4.0/debug/autodoc-xml
./doc/none/gcc-5.4.0/debug/autodoc-xml/classboost_1_1stacktrace_1_1basic__stacktrace.xml
./doc/none/gcc-5.4.0/debug/autodoc-xml/dir_3516969ce87a02a0560c741857e33749.xml
./doc/none/gcc-5.4.0/debug/autodoc-xml/dir_c8984f1860c11f62f47abb6761e46c1e.xml
./doc/none/gcc-5.4.0/debug/autodoc-xml/combine.xslt
./doc/none/gcc-5.4.0/debug/autodoc-xml/stacktrace_2stacktrace_8hpp.xml
./doc/none/gcc-5.4.0/debug/autodoc-xml/classboost_1_1stacktrace_1_1frame.xml
./doc/none/gcc-5.4.0/debug/autodoc-xml/compound.xsd
./doc/none/gcc-5.4.0/debug/autodoc-xml/index.xsd
./doc/none/gcc-5.4.0/debug/autodoc-xml/stacktrace__fwd_8hpp.xml
./doc/none/gcc-5.4.0/debug/autodoc-xml/index.xml
./doc/none/gcc-5.4.0/debug/autodoc-xml/stacktrace_8hpp.xml
./doc/none/gcc-5.4.0/debug/autodoc-xml/namespaceboost_1_1stacktrace.xml
./doc/none/gcc-5.4.0/debug/autodoc-xml/namespaceboost_1_1stacktrace_1_1detail.xml
./doc/none/gcc-5.4.0/debug/autodoc-xml/namespaceboost.xml
./doc/none/gcc-5.4.0/debug/autodoc-xml/dir_72bdf9838375a891eaf35cbacea5f7be.xml
./doc/none/gcc-5.4.0/debug/autodoc-xml/frame__decl_8hpp.xml
./doc/none/gcc-5.4.0/debug/autodoc-xml/frame_8hpp.xml
./doc/none/gcc-5.4.0/debug/autodoc-xml/safe__dump__to_8hpp.xml
./doc/none/gcc-5.4.0/debug/autodoc-xml.doxyfile
./doc/none/gcc-5.4.0/debug/autodoc-xml.xml-dir
./doc/none/gcc-5.4.0/debug/autodoc-xml.boostbook
./doc/none/gcc-5.4.0/debug/autodoc-xml.doxygen

But I need something like this:
http://www.boost.org/doc/libs/1_65_1/doc/html/stacktrace.html
I have used quickbook install instructions for Ubuntu:
http://www.boost.org/doc/libs/1_65_1/doc/html/quickbook/install.html#quickbook.install.linux
It looks like docbook to html conversion is required using some xsl file
but I don't know how to do it and what files are used.
There is some XSL files in boost/tools/boostbook/xsl folder but I don't
know how to use it with b2 build.

PS. I have installed xsltproc, docbook-xsl, docbook-xml packages.
$ cat ~/user-config.jam
using boostbook ;

using xsltproc ;

using boostbook
     : /usr/share/xml/docbook/stylesheet/nwalsh
     : /usr/share/xml/docbook/schema/dtd/4.2
     ;

using doxygen ;

-----
Regards,
Kolya.


Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk