Installing And Using An XML/SGML DocBook Editing Suite

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