Download and Installation
db2qthelp is a Python script. To run it, you must have Python installed. If you have not installed Python, yet, please read instructions on installing Python first (see below).
Assuming that you are interested in DocBook, you are probably aware of xsltproc as a processing tool. In case your DocBook document is not yet converted, you will need xsltproc. Please see below for a brief information about installing xsltproc.
Installing db2qthelp
The current version is db2qthelp-0.4.0.
You have different options for installing db2qthelp.
Installing from PyPi
You may install db2qthelp using
python -m pip install db2qthelp
This will install db2qthelp as a script that may be directly called on the command line. The PyPi version only includes the (executable) source code and files needed to run it. You may consider building a virtual environment, first.
You may then run db2qthelp using
db2qthelp
Cloning the repository
You may clone the repository which is available at db2qthelp's github page.
git clone https://github.com/dkrajzew/db2qthelp.git
cd db2qthelp
You may then run db2qthelp using
python db2qthelp/db2qthelp.py
Please note that the current repository version may contain an in-between version with new, undescribed, or even buggy behavior. You should rather use a recent release version.
Download the latest release
Besides, you may download the current release here:
You will get the complete copy of the repository which you have to decompress. A folder named db2qthelp-0.4.0 will be generated.
You may run db2qthelp using
python db2qthelp/db2qthelp.py
Installing Python
Python is an interpreted programming language. For running db2qthelp and other scripts written in Python you have to install Python itself, first.
For installing Python, use an installer for your system from https://www.python.org.
You should as well install pip, a package manager for Python. After installing Python, you should be able to install pip using:
python get-pip.py
You may upgrade pip using:
pip install --upgrade pip
Installing xsltproc
xsltproc is an XSLT processor included in libxslt. There is gitlab libxslt repository and a libxslt release downloads page.
On Ubuntu Linux you should be able to install xsltproc using
sudo apt-get install xsltproc
On Windows, I got my xsltproc and need libraries from Igor Zlatkovic's website. Please note that you need libxslt, iconc, libxml2, and zlib. I collected them in a single folder…
Some further notes
You should add both, xsltproc folder as well as the folder your Qt binaries reside in to the path. On Windows (of course, depending on the location on your system):
set PATH=%PATH%;D:\libs\Qt\5.15.2\msvc2019\bin;D:\z_dev\docbook\libxslt-1.1.26.win32\bin
And you should set the XML_CATALOG_FILES to point to the catalog.xml file of your DocBook xsl catalogue.
set XML_CATALOG_FILES=D:\z_dev\docbook\docbook-xsl-1.79.2\catalog.xml