Chasing Documentation's Holy Grail

Toward Single-Source Publishing Using DocBook XML

Dan York

Mitel Networks CorporationNetwork Server Solutions Group(formerly e-smith, inc.)

<dyork@Lodestar2.com> (personal address)

Copyright © 2001 Dan York

November 8, 2001

1. Agenda
2. Introduction
- 2.1 Chasing the Holy Grail
- 2.2 What is DocBook?
- 2.3 DocBook History
- 2.4 Who uses DocBook?
- 2.5 DocBook Strengths
- 2.6 DocBook Weaknesses
3. Examples
- 3.1 Example - Book
- 3.2 Example - Article
- 3.3 Sections
- 3.4 Sections - continued
- 3.5 List - Itemized
- 3.6 List - Ordered
- 3.7 List - Variable
- 3.8 Image - Simple
- 3.9 Image - Complex
- 3.10 Tables
- 3.11 Figures and Examples
- 3.12 Admonitions
- 3.13 Character Formatting
- 3.14 Verbatim Text
- 3.15 Links
- 3.16 Indexing
- 3.17 Miscellaneous
- 3.18 Example - Q&A
- 3.19 Example - Reference Page
4. Stylesheets
- 4.1 Standard stylesheets
- 4.2 XSL Stylesheets - Output
- 4.3 DSSL Stylesheets - Output
- 4.4 Customization Layers
- 4.5 Example - Generating HTML
- 4.6 Example - Generating PDF
5. Tools
- 5.1 Editing
- 5.2 Validation
- 5.3 HTML - Saxon
- 5.4 HTML - Xalan
- 5.5 HTML - libxslt
- 5.6 Print - FOP
- 5.7 Print - PassiveTeX
- 5.8 SGML Tools
- 5.9 SGML Tools, cont'd
- 5.10 Commercial Tools
- 5.11 Other Tools
- 5.12 Automation
- 5.13 Version Control
6. Extensions
- 6.1 Slides Doctype
- 6.2 Website Doctype
7. Conclusion
- 7.1 So have we reached the Holy Grail?
- 7.2 Resources
- 7.3 Resources, cont'd
- 7.4 Questions?