Get Going With DocBook

Notes for Hackers

Mark Galassi

Cygnus Solutions
documentation in progress

Table of Contents
What is this?
A tutorial for hacker–writers
An example of how to use DocBook structure
Not an example for all situations
Get going
Hello, world
A slightly more complex example
From here on
A tour of some DocBook features
Global markups
Books
Articles
Examples and screen snapshots
Examples involving plain text
Describing GUIs
Code samples
Describing an API
Tables
Reference things
Concepts
Your world view
Markup based on content
Explanation of SGML–related terms
SGML — a framework for defining markup languages
What about the appearnace on output media?
How you should structure your documents
Structure of a book
Structure of a chapter
Structure of sections
DocBook Resources
SGML entities
BASIC STRUCTURE OF AN SGML DOCUMENT
USING ENTITIES TO CONNECT OTHER FILES
IDENTIFYING FILES WITH FORMAL PUBLIC IDS
USING ENTITIES FOR SHARED TEXT
USING MARKED SECTIONS TO HANDLE CONDITIONAL CONTENT
Emacs PSGML mode tips
Obtaining and installing DocBook tools
UNIX
Win32
FrameMaker+SGML
Glossary