Step 1 - Downloading the KDE documentation tools |
To get a complete set of docbook tools installed, you must download two different sets of files:
The first part is the basic DocBook tools.
The second part is the KDE customization for DocBook.
(Because this server is quite busy, you might want to use the list of mirrors found at: http://www.kde.org/mirrors.html.)
You will find RPM packages already compiled for your processor (in the subdirectory "i386" or "ppc"), and other packages that do not depend on a specific architecture (in the subdirectory "noarch").
You will need to download at least these packages:
sgml-common: Basic SGML resources and tools;
jade: the SGML parser and DSSSL engine;
docbook-dtd31-sgml: the SGML document type definition for DocBook version 3.1;
docbook-style-dsssl: the style sheets for HTML or TeX rendering;
jadetex: a set of macros that are needed by the TeX files generated by the tools, needed for PostScript, RTF or PDF output;
perl-SGMLSpm: support of SGML for the perl language;
docbook-utils: The scripts helping you to maipulate all the rest.
You may also want another (optional) package:
psgml: adds-on to the Emacs text editor, for easier doc writing;
All those packages are RPM format; this does not prevent you from installing them on a Debian distribution, as explained in next step.
The second part of your download contains the up to date customizations that KDE places on the standard docbook tools.
The KDE-specific stuff is located in the directory ksgmltools/ of the kdelibs package.
The kdelibs package can be found at: ftp://ftp.kde.org/pub/kde/unstable/CVS/snapshots/current
(or, again, if too busy, on one of its mirrors.)
Your distribution probably already has the kdelibs package, but it's likely that the binary script named "kdb2html" it includes does not know about the location of the DocBook-tools catalogs (since the basic DocBook tools were probably not installed at the time kdelibs was compiled). This explains why you probably have to recompile and reinstall the kdelibs.
You have now downloaded everything you need to install the docbook tools.
Now you are ready to install the tools. Determine which type of system you have (if you are in doubt, try RedHat-like first), and choose the appropriate link below.
Step 2 - Installing the basic DocBook tools
or return to the main page.