The Crash Course to DocBook

Chapter 1. Introduction

1.1. About this Booklet

This booklet was meant as a tutorial that can give you an introduction on how to use all the power and effectiveness of DocBook. It aims at getting you introduced to this matter in the shortest delay, hence then name of "Crash-course to DocBook".

Even if you have never used either DocBook or other markup languages (like LinuxDoc) before, you should be able to become proficient in it just by reading through this guide and using the online or the paper version of [DocBook - The Definitive Guide] published by O'Reilly & Associates.

Note

Please note that this crash course is designed to be used along with, not instead of, the DocBook Reference. There are a number of cases where it is much easier to refer to the reference rather than trying to rehash what it already covers. Use this guide to understand what DocBook is about and to have a general overview on how to use those tags.

This tutorial will teach you enough DocBook to write basic documentation. You will learn:

In appendix, one can find a short description of the Emacs psgml mode.

This material comes from the fusion of three documents:

Many parts of this document were borrowed from the "DocBook 3.0 Reference" by Eve Maler of ArborText, Inc. and Terry Allen of Fujitsu Software Corporation. The parts of this document that were borrowed from the Reference are Copyright 1992, 1993, 1994, 1995, 1996, 1997 by HaL Computer Systems, Inc., O'Reilly & Associates, Inc., Fujitsu Software Corporation, and ArborText, Inc.