Boost logo

Boost :

Subject: Re: [boost] Building Quickbook docs from source code in HTML format
From: John Maddock (jz.maddock_at_[hidden])
Date: 2017-10-31 17:53:48


On 31/10/2017 17:46, Kolya Kosenko via Boost wrote:
> 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.

What does your Jamfile look like, and what's the b2 output when run? 
Maybe do a:

b2 -d2 -a

and report back?

John.

>
> 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.
>
> _______________________________________________
> Unsubscribe & other changes:
> http://lists.boost.org/mailman/listinfo.cgi/boost
>

---
This email has been checked for viruses by AVG.
http://www.avg.com

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