A Practical Introduction to DocBook

Deb Richardson

Open Source Writers Group

            deb@oswg.org
         

Revision History
Revision 0.1 Nov 14 1999 Revised by: dlr
Initial, incomplete, draft

A practical introduction to using DocBook, written with the new user in mind. Over time, this will grow to include a task-based tag reference and many more examples.


Table of Contents
1. Copyright and Licensing
2. Introduction
3. Tools
3.1. Authoring tools
3.2. Processing tools - DocBook Tools
3.2.1. Getting DocBook Tools
3.2.2. Installing DocBook Tools
3.2.3. Using DocBook Tools
4. Getting Started
5. Step by Step Example
5.1. Step 1: Including the Document Type Declaration
5.2. Step 2: Adding a "root" element
5.3. Step 3: Adding an article header
5.4. Step 4: Adding a first level sectioin
5.5. Step 5: Adding subsections and sub-subsections
6. Element Reference
6.1. Article header elements
6.1.1. Article header
6.1.2. Article title
6.1.3. Author information
6.1.4. Revision information
6.1.5. Article abstract
6.2. Marking up code, filenames, commands, and the like
6.2.1. Code samples
6.2.2. Filenames and directories
6.2.3. Commands
7. Wrap-up & Further References
8. Other DocBook Resources
8.1. Online Resources
8.2. Offline Resources

1. Copyright and Licensing

Copyright (c) 1999 by Deb Richardson. This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v0.4 (8 June 1999) or later (the latest version of which is available at http://www.opencontent.org/openpub/).

The current "master" copy of this document can be obtained through the Open Source Writers Group website at http://www.oswg.org.