Get Going With DocBook
Notes for Hackers
Mark Galassi
Cygnus Solutions
Copyright
© 1998 by Mark Galassi
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
Next >>>
What is this?