Installing And Using An XML/SGML DocBook Editing Suite

Setting Up A Free XML/SGML DocBook Editing Suite For Windows And Unix/Linux/BSD

Copyright (c) 2002 The University Of Birmingham

Revision History
Revision 0.803/07/2002
Alpha Release
Revision 0.812/07/2002
Beta1 Release
Revision 0.922/07/2002
Beta2 Release
Revision 1.013/10/02
First real release

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.6.1. <itemizedlist>
9.1.6.2. <orderedlist>
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

List of Figures

9.1. Table frame types
9.2. Table alignment types
9.3. morerows example
9.4. Column spanning example
10.1. GVIM screen-shot
10.2. Emacs screen-shot
10.3. ThotBook screen-shot
10.4. EpcEdit screen-shot
10.5. Xeena screen-shot
10.6. Aspell screen-shot