Step 2 - Installing on a Debian-type system |
Some distributions may come with packagess for Jade and most of the packages that are needed for DocBook operation are not KDE-specific. Your distribution's packages are most likely out of date and will not include the right version of the DocBook DTD or the latest version of the style sheets. Furthermore, you may have to tinker quite a bit to successfully add the KDE customizations to another distribution. Therefore, we highly recommend you uninstall any previous installation before reinstalling according to the directions given in the next sections.
To determine what is already on your system, simply type:
dpkg -l | grep jade dpkg -l | grep docbook dpkg -l | grep sgml
at the command line.
If one of these commands returns a line of text, look at the first character of the line. If that letter is an 'i', then remove it using the instruction:
dpkg -r <packagename>
If the first letter is another character, that package is not currently installed.
NOTE: There are often a lot of dependent packages for these docbook tools. You will need to remove all the depencancies before you remove the main package. It is often easiest to start at the bottom of the list given in next section, and work your way up, rather than from the top down (you will have fewer dependency problems).
The docbook tools rely on a program called tetex to be able to print documentation. To determine if tetex is installed on your system, simply type:
dpkg -l | grep tetex
Make sure your version of tetex is greater than 0.9.
If the package is not installed, you can install the package from your debian CD, or from http://packages.debian.org.
Install the RPM files using the following command-line instruction:
rpm -ih --nodeps <filename>.rpm
For example:
rpm -ih --nodeps sgml-common-0.3-1.noarch.rpm
Install the packages in the following order:
sgml-common
jade
jadetex
docbook-dtd31-sgml
docbook-style-dsssl
docbook-utils
Yes, I know, there are many converters out there to convert RPM packages to .deb packages, but I have encountered some problems using those. If anyone is interested in creating .deb packages (and maintaing them), please contact e.bischoff@noos.fr.
Now the basic tools are installed, you must add the KDE specific stuff.
Click on
Step 3 - installing the KDE-specific stuff
to move to the next page, or return to the main page.