To install boost doc toolchain, you need to install b2 build toolchain, the doc file of which can be found in this pack.
xsl is provided by docbook-xsl
dtd is provided by docbook-xml
docbook-xsl and docbook-xml are the xsl and dtd 's package names on q4os linux, they might have different package names on different linux distributions, you should find them for yourself.
docbook-xsl and docbook-xml are most likely already installed on your system. If not, install them.
$ su - # apt install docbook-xsl docbook-xml xsltproc
The full path of xsl dir must contain common/common.xsl .
$ dpkg -L docbook-xsl | ugrep 'common/common.xsl' /usr/share/xml/docbook/stylesheet/docbook-xsl/common/common.xsl /usr/share/xml/docbook/stylesheet/docbook-xsl/slides/common/common.xsl
Not choose the slides one, choose this:
/usr/share/xml/docbook/stylesheet/docbook-xsl/common/common.xsl
Now remove the last part /common/common.xsl, we get:
/usr/share/xml/docbook/stylesheet/docbook-xsl
We can call it docbook-xsl-dir path for b2 build, write it down, it will be used laterly.
The full path of dtd dir must contain docbookx.dtd .
$ dpkg -L docbook-xml | ugrep 'docbookx.dtd' /usr/share/xml/docbook/schema/dtd/4.0/docbookx.dtd /usr/share/xml/docbook/schema/dtd/4.1.2/docbookx.dtd /usr/share/xml/docbook/schema/dtd/4.2/docbookx.dtd /usr/share/xml/docbook/schema/dtd/4.3/docbookx.dtd /usr/share/xml/docbook/schema/dtd/4.4/docbookx.dtd /usr/share/xml/docbook/schema/dtd/4.5/docbookx.dtd
The version 4.2 is proved working by me, so we choose the path:
/usr/share/xml/docbook/schema/dtd/4.2/docbookx.dtd
Now remove the last part /docbookx.dtd from the path, we get:
/usr/share/xml/docbook/schema/dtd/4.2
We can call it docbook-dtd-dir path for b2 build, write it down, it will be used laterly.
boostbook can be found in boost source code, copy it only: copy it to your operating system's shared location.
For example, I copy boostbook to /sand/share/boostbook and then use /sand/share/boostbook as the shared location.
$ cd <BOOST-SOURCE-ROOT>/tools $ su # cp -rf boostbook /sand/share/
Now /sand/share/boostbook is the boostbook location.
quickbook must be compiled from the quickbook source code in boost source code, then a binary file quickbook will be generated, we only need that binary file quickbook.
$ cd <BOOST-SOURCE-ROOT>/tools/quickbook/build $ b2 -q -j7
Then, quickbook will be generated at <BOOST-SOURCE-ROOT>/dist/bin/quickbook, just copy it to your system bin path.
For example, I copy it to /sand/bin/quickbook, and my /sand/bin is already added to PATH environment variable.
$ cd <BOOST-SOURCE-ROOT>/dist/bin $ su # cp ./quickbook /sand/bin/
To check if quickbook and its PATH work, type quickbook to run it:
$ quickbook
Final configure appending to /etc/site-config.jam :
using quickbook : /sand/bin/quickbook ; using boostbook : /usr/share/xml/docbook/stylesheet/docbook-xsl : /usr/share/xml/docbook/schema/dtd/4.2 : /sand/share/boostbook ;
Setup quickbook, the second parameter of "using quickbook" is the quickbook binary path; If its path can be found at commandline, the second parameter can be left empty.
Setup boostbook:
The second parameter of "using boostbook" is the docbook-xsl-dir path, we have already found it as described in the beginning of this doc, just copy the path value string to /etc/site-config.jam .
The third parameter of "using boostbook" is the docbook-dtd-dir path, we have already found it as described in the beginning of this doc, just copy the path value string to /etc/site-config.jam .
The fourth paramter of "using boostbook" is the boostbook path.
Boost Home - Boostbook and quickbook are copyrighted by Boost Software.
________________________________________