NewbieDoc Docbook Guide

Jesse Goerz

         jwgoerz@users.sourceforge.net
         

This document is intended to help new doc writers learn the basics of writing SGML documents. Once you have become familiar with this tutorial please read the document standards guide. Copyright © 2001, 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.


Revision History
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.

Table of Contents
1. Introduction
1.1. Why SGML?
1.2. What you need to install
1.3. Using the custom stylesheets
2. The basic SGML document
2.1. General structure of SGML
3. Article Headers
4. Sections
5. Paragraphs
6. URL's or links
7. Lists
8. Examples
9. Tables
10. Programlisting and Screens
11. Admonitions
12. Callouts
13. CDATA
14. Character Entities
15. Citations
16. Graphics