DocBook Demystification HOWTO

Eric Raymond


Revision History
Revision v1.12002-10-01Revised by: esr
Correct inadvertent misrepresentation of FSF's position. Added pointer to the DocBook FAQ.
Revision v1.02002-09-20Revised by: esr
Initial version.

This HOWTO attempts to clear the fog and mystery surrounding the DocBook markup system and the tools that go with it. It is aimed at authors of technical documentation for open-source projects hosted on Linux, but should be useful for people composing other kinds on other Unixes as well.

Table of Contents
1. Introduction
2. Why care about DocBook at all?
3. Structural markup: a primer
4. Document Type Definitions
5. Other DTDs
6. The DocBook toolchain
7. Who are the projects and the players?
8. Migration tools
9. Editing tools
10. Related standards and practices
11. SGML and SGML-Tools
11.1. DocBook SGML
11.2. Why SGML DocBook is dead
11.3. SGML-Tools
12. References