DocBook Demystification HOWTO

Eric Raymond


           
        

Copyright

Permission is granted to copy, distribute and/or modify this document under the terms of the Creative Commons Attribution License, version 2.0.

Revision History
Revision v1.62010-09-14esr
Major update. dblatex actually works for PDF production. Describe asciidoc.
Revision v1.52006-10-13esr
Major update. Getox seems to be dead, FOP a bit further along.
Revision v1.42004-10-28esr
Minor update and license change.
Revision v1.32004-02-27esr
Add pointers to two editors.
Revision v1.22003-02-17esr
Reorder to defer references to SGML until after it has been introduced.
Revision v1.12002-10-01esr
Correct inadvertent misrepresentation of FSF's position. Added pointer to the DocBook FAQ.
Revision v1.02002-09-20esr
Initial version.

Abstract

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. asciidoc
8. Who are the projects and the players?
9. Migration tools
10. Editing tools
11. Hints and tricks
12. Related standards and practices
13. SGML and SGML-Tools
13.1. DocBook SGML
13.2. SGML tools
13.3. Why SGML DocBook is dead
13.4. SGML-Tools
14. References