Scribd
Upload
163 views2 pages

Setting Up A DocBook Toolchain

This document provides instructions for setting up a DocBook tool chain for authoring technical documentation. It includes downloading DocBook XML and RELAX NG schema files, DocBook style guides, and stylesheet packages. It also describes installing Saxon XSLT and XInclude processors, Apache FOP for PDF output, and the Tidy HTML cleaner. Customizing oXygen and BBEdit with DocBook support is covered as well. Overall the document is a comprehensive guide for configuring a full DocBook XML authoring and publishing environment.

Uploaded by

wincentc
Copyright
© Attribution Non-Commercial (BY-NC)
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as RTF, PDF, TXT or read online on Scribd
163 views2 pages

Setting Up A DocBook Toolchain

This document provides instructions for setting up a DocBook tool chain for authoring technical documentation. It includes downloading DocBook XML and RELAX NG schema files, DocBook style guides, and stylesheet packages. It also describes installing Saxon XSLT and XInclude processors, Apache FOP for PDF output, and the Tidy HTML cleaner. Customizing oXygen and BBEdit with DocBook support is covered as well. Overall the document is a comprehensive guide for configuring a full DocBook XML authoring and publishing environment.

Uploaded by

wincentc
Copyright
© Attribution Non-Commercial (BY-NC)
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as RTF, PDF, TXT or read online on Scribd
You are on page 1/ 2

How to set up a DocBook tool chain

set up docbook tool chain


http://www.cacr.caltech.edu/projects/pyre/docs/apd.html

Download DocBook XML 4.3


http://www.docbook.org/xml/4.3/index.html
http://www.docbook.org/xml/4.3/docbook-xml-4.3.zip

Download DocBook 5.0 RELAX NG schema


http://docbook.org/xml/5.0b5/rng/docbook.rng

Install into: /usr/local/docbook/xml/4.3/


So that documents can reference: "file:///usr/local/docbook/xml/4.3/docbookx.dtd"

Download DocBook: The Definitive Guide


http://www.docbook.org/tdg/en/
http://www.docbook.org/tdg/en/tdg-en-html-2.0.10.zip
http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/docbook/defguide/en/ (XML sources)

Version 5.0 of The Definitive Guide


http://docbook.org/tdg5/en/tdg5-0.0.16.zip

Customize oXygen: http://docbook.org/docs/howto/


- Add a new scheme association
- Make sure DocBook 5.0 association precedes others

Download BBEdit DocBook tools (these are actually DocBook Lite)


http://www.disobey.com/detergent/code/bbedit/
http://www.disobey.com/detergent/code/bbedit/bbdblite_1.1.sit
http://www.barebones.com/support/bbedit/glossary_library.shtml
http://www.disobey.com/detergent/code/bbedit/bbdblite_1.1.sit

Download stylesheets for XSLT transformation


http://docbook.sourceforge.net/projects/xsl/
http://prdownloads.sourceforge.net/docbook/docbook-xsl-1.67.2.tar.gz?download

Install into /usr/local/docbook-xsl-1.67.2


Make symlink /usr/local/docbook-xsl

http://prdownloads.sourceforge.net/docbook/docbook-dsssl-doc-1.79.tar.gz?download
http://prdownloads.sourceforge.net/docbook/docbook-dsssl-1.79.tar.gz?download
http://prdownloads.sourceforge.net/docbook/website-2.5.0.tar.gz?download
http://prdownloads.sourceforge.net/docbook/docbook-testdocs-1.1.tar.gz?download

Saxon 6.5.3 (latest stable release)


http://saxon.sourceforge.net/#F6.5.3
http://prdownloads.sourceforge.net/saxon/saxon6_5_3.zip

Install into: /usr/local/saxon6_5_3/


Make symlink: /usr/local/saxon/
To perform a transformation:
/usr/bin/java -jar /usr/local/saxon/saxon.jar -o globalization.html globalization.xml /usr/local/docbook-
xsl/xhtml/docbook.xsl

Run XHTML output through Tidy


http://tidy.sourceforge.net/
http://tidy.sourceforge.net/src/tidy_src.tgz

tar xzvf tidy_src.tgz


cd tidy
/bin/sh build/gnuauto/setup.sh
./configure
make
sudo make install

For PDF transformations, need Apache FOP:


http://xml.apache.org/fop/index.html
http://apache.rediris.es/xml/fop/fop-0.20.5-bin.tar.gz
http://apache.rediris.es/xml/fop/fop-0.20.5-src.tar.gz
wget http://apache.rediris.es/xml/fop/fop-0.20.5-src.tar.gz
sudo mv fop-0.20.5 /usr/local/
cd /usr/local
sudo ln -s fop-0.20.5/ fop

Invoke using: /usr/local/fop/fop.sh

For graphics support in PDF:


http://java.sun.com/products/jimi/#
sudo cp JimiProClasses.zip /usr/local/fop/lib/jimi.jar

add to httpd.conf for the appropriate directory:


AddCharset UTF-8 .html

You might also like