NewbieDoc Docbook Guide

Jesse Goerz

         jwgoerz@users.sourceforge.net
         

Revision History
Revision v2.122 November 2002Revised by: jwg
Updated for new makefiles.
Revision v2.02 May 2002Revised by: jee
Edited, added a few paragraphs, fact-checking, etc. I must say, this was an absolute joy to edit. There were very few errors, or things I had to look up. And I got it in just under a year of its last edit. Good, we're moving along. Once again, the version has been bumped to v2.0 to match CVS and peg for release.
Revision v0.504 May 2001Revised by: jwg
How to use newbiedoc custom stylesheet, <callouts>, new method for using <programlisting> and <screen> tags.
Revision v0.421 April 2001Revised by: jwg
Updated license information, sgmltools-lite added, and spelling corrections.
Revision v0.31 April 2001Revised by: jwg
First draft complete. Request for comments.

This document is intended to help new doc writers learn the basics of writing SGML documents. Copyright © 2001, 2002, Jesse Goerz, NewbieDoc project. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license can be found at the Free Software Foundation.


Table of Contents
1. Introduction
1.1. Why SGML?
2. Setting up your authoring environment
2.1. What you need to install
2.2. Directory structure
2.3. Using the project's makefiles
3. The basic SGML document
3.1. General structure of SGML
4. Article Headers
5. Sections
6. Paragraphs
7. URL's or links
8. Lists
9. Examples
10. Tables
11. Programlisting and Screens
12. Admonitions
13. Callouts
14. CDATA
15. Character Entities
16. Citations
17. Graphics
A. References
A.1. Docbook: The definitive guide
B. sgmltools
B.1. Using the custom stylesheets