Table of Contents

• I. Setting Up Your System To Author DocBook Documents
  • 1. Introduction
    • 1.1  Introduction
    • 1.2  SGML vs XML
    • 1.3  Preliminary Requirements
    • 1.4  About this guide
  • 2. Installing And Configuring An SGML DocBook Authoring System For Windows
    • 2.1  Overview Of Required Tools
    • 2.2  Setting Up Environment Variables
    • 2.3  Install OpenJade
      • 2.3.1  Windows
      • 2.3.2  Unix/Linux/BSD
    • 2.4  Setup SGML_CATALOG_FILES environment variable
    • 2.5  Install The SGML DocBook DTD
    • 2.6  Install The ISO-Entities
    • 2.7  Install The SGML DocBook Stylesheets
    • 2.8  Install TeX
      • 2.8.1  Windows
      • 2.8.2  Unix/Linux/BSD
    • 2.9  Install JadeTeX
    • 2.10  Install Ghostscript and GhostView
      • 2.10.1  Windows
      • 2.10.2  Unix/Linux/BSD
    • 2.11  Install The Custom Style-Sheets
  • 3. Installing And Configuring An XML DocBook System For Windows
    • 3.1  Introduction
    • 3.2  Installing the JAVA Runtime Environment
    • 3.3  libxml
      • 3.3.1  Windows
      • 3.3.2  Linux/Unix/BSD
    • 3.4  Install Saxon
      • 3.4.1  Setup Catalog Resolver
    • 3.5  FOP
      • 3.5.1  Install Jimi
    • 3.6  DocBook DTD
      • 3.6.1  Catalog Files
    • 3.7  XSL StyleSheets
      • 3.7.1  Custom StyleSheets
  • 4. Using The SGML Tools
    • 4.1  About this chapter
    • 4.2  Validating an SGML DocBook Document with onsgmls
    • 4.3  Using OpenJade to convert SGML DocBook source to an intermediate TeX format
    • 4.4  Using OpenJade to convert SGML DocBook source to (single file)HTML
    • 4.5  Using OpenJade to convert SGML DocBook source to (Chunked) HTML
    • 4.6  Using openjade to convert SGML DocBook source to RTF
    • 4.7  Using jadetex to convert (openjade created) TeX to DVI
    • 4.8  Using JadeTeX to convert (openjade created)TeX to PDF
    • 4.9  Using dvipsto convert DVI to PS
    • 4.10  Using osx to convert SGML DocBook source to an XML tree
    • 4.11  Using the custom DSSSL stylesheets
  • 5. Using the XML Tools
    • 5.1  About this chapter
    • 5.2  Using xmllint to validate an XML DocBook document
    • 5.3  Using xsltproc to generate (Single file)XHTML output from an XML Docbook document
    • 5.4  Using xsltproc to generate XHTML(Segmented) output from an XML Docbook document
    • 5.5  Using xsltproc to generate FO output from an XML Docbook document
    • 5.6  Using xsltproc to generate HTMLhelp output from XML Docbook source
    • 5.7  Using xsltproc to generate Javahelp output from XML Docbook source
    • 5.8  Using Saxon to generate (Single file) HTML output from XML DocBook source
    • 5.9  Using Saxon to generate (Single file) XHTML output from XML DocBook source
    • 5.10  Using Saxon to generate FO output from XML Docbook source
    • 5.11  Using FOP to generate PDF output from XSL FO input
    • 5.12  Using pdfxmltex to generate PDF output from XSL FO input
    • 5.13  General Usage
  • 6. Using The SGML Tools To Process XML DocBook Documents
    • 6.1  About This Chapter
    • 6.2  Using onsgsmls to validate XML DocBook documents
    • 6.3  Using openjade to convert XML DocBook to (segmented) HTML
    • 6.4  Using openjade to convert XML DocBook to (single file) HTML
    • 6.5  Using openjade to convert from XML DocBook to intermediate TeX format
    • 6.6  Using openjade to convert from XML DocBook to RTF
    • 6.7  Using jadetex to convert from (openjade created) intermediate TeX format to DVI
    • 6.8  Using JadeTeX to convert (openjade created)TeX to PDF
    • 6.9  Using dvips to convert from DVI to PS
• II. Introduction To Authoring DocBook Documents
  • 7. Creating An SGML DocBook Document
    • 7.1  Declaring the document type
    • 7.2  The use of PUBLIC identifiers in SGML
    • 7.3  The use of SYSTEM identifiers in SGML
    • 7.4  An SGML DocBook article template
    • 7.5  An SGML DocBook book template
  • 8. Creating an XML DocBook document
    • 8.1  Declaring The Document Type
    • 8.2  The use of PUBLIC and SYSTEM identifiers in XML
    • 8.3  Creating an XML DocBook document
      • 8.3.1  An article template
      • 8.3.2  An example XML DocBook Book
  • 9. DocBook Document Examples
    • 9.1  Common DocBook Elements
      • 9.1.1  <para>
      • 9.1.2  <programlisting>
      • 9.1.3  Entities for special characters
      • 9.1.4  <screen>
      • 9.1.5  <ulink>
      • 9.1.6  Lists
      • 9.1.7  Some common inline elements
    • 9.2  Including Images
    • 9.3  Tables
  • 10. Auxiliary Tools for DocBook Authoring
    • 10.1  Editors
      • 10.1.1  VI/VIM/GVIM
      • 10.1.2  Emacs
      • 10.1.3  ThotBook
      • 10.1.4  EpcEdit
      • 10.1.5  Xeena
      • 10.1.6  The rest
    • 10.2  Spell Checking
      • 10.2.1  Aspell
  • 11. References
    • 11.1  Internet Resources Used