Scribd Logo
Upload

Welcome to Scribd!

  • Setting Up A DocBook Toolchain

    Uploaded by

    wincentc
    22 views2 pages
    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.

    Original Description:

    Original Title

    Setting Up a DocBook Toolchain

    Copyright

    © Attribution Non-Commercial (BY-NC)

    Available Formats

    RTF, PDF, TXT or read online from Scribd

    Did you find this document useful?

    Is this content inappropriate?

    Report this Document
    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.

    Copyright:

    Attribution Non-Commercial (BY-NC)
    Download as RTF, PDF, TXT or read online from Scribd
    Flag for inappropriate content
    22 views2 pages

    Setting Up A DocBook Toolchain

    Uploaded by

    wincentc
    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.

    Copyright:

    Attribution Non-Commercial (BY-NC)
    Download as RTF, PDF, TXT or read online from Scribd
    Flag for inappropriate content
    of 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