4. How do I get DocBook?
 | This is for Debian systems only. Users of other GNU/Linux distributions should consult the LDP-Author-Guide. |
4.1. The DTD
The DocBook DTD describes which elements are allowed in a DocBook SGML file.
Install the package docbook.
4.2. The DSSSL stylesheets
The DSSSL (Document Style and Semantics Specification Language) stylesheets describe how the output should be formatted, e.g. what font to use, line spacing, etc..
Install the package docbook-stylesheets.
You also need the file www.linuxdoc.org/authors/tools/ldp.dsl. Place it in /usr/lib/sgml/stylesheet/dsssl/linuxdoc/ldp.dsl on your local system.
Once you have the file, you will need to do some editing of the first few lines based on the location of your DocBook DSSSL files.
Open up /usr/lib/sgml/stylesheet/dsssl/linuxdoc/ldp.dsl in your favourite text editor. You should see something like this:
1 <!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [ 2 <!ENTITY % html "IGNORE"> 3 <![%html;[ 4 <!ENTITY % print "IGNORE"> 5 <!ENTITY docbook.dsl SYSTEM "docbook.dsl" CDATA dsssl> 6 ]]> 7 <!ENTITY % print "INCLUDE"> 8 <![%print;[ 9 <!ENTITY docbook.dsl SYSTEM "docbook.dsl" CDATA dsssl> 10 ]]> 11 ]> |
Change the first "docbook.dsl" to read /usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/html/docbook.dsl and the second to read /usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/print/docbook.dsl. The start of the file should now look like this:
1 <!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [ 2 <!ENTITY % html "IGNORE"> 3 <![%html;[ 4 <!ENTITY % print "IGNORE"> 5 <!ENTITY docbook.dsl SYSTEM "/usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/html/docbook.dsl" CDATA dsssl> 6 ]]> 7 <!ENTITY % print "INCLUDE"> 8 <![%print;[ 9 <!ENTITY docbook.dsl SYSTEM "/usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/print/docbook.dsl" CDATA dsssl> 10 ]]> 11 ]> |
4.3. The tools
You need some tools to export the SGML to other formats.
Install the packages jade, jadetex and cygnus-stylesheets. You will also need my ndb2html wrapper, which is available on my home page.
4.4. Quick command line
This command line should install all the packages for you:
apt-get install docbook docbook-stylesheets jade jadetex cygnus-stylesheets
but you will still need my wrapper (unless you are brave), and the LDP stylesheet at www.linuxdoc.org/authors/tools/ldp.dsl.
4.5. Installing ndb2html
The file ndb2html.tar.gz contains two files: a shell script wrapper for jade (ndb2html) and a man page (ndb2html.1)
ndb2html should be installed somewhere on your PATH, preferably /usr/local/bin
ndb2html.1 should be placed in /usr/local/man/man1.
4.6. Other useful packages
You might find the packages docbook-doc and docbook-stylesheets-doc useful.