DocBook: From Syntax to Publication

Table of Contents

Table of Contents
About DocBook
About Norman Walsh
A Little Background
Structured Documentation
Benefits
Technical Challenges
Non-Technical Challenges
Storing Structured Documentation
XML or SGML or …
OASIS
Evolution
DocBook V5.0
Design Goals
Big Picture Changes
DocBook Markup
Element Classes
"Information Pool" Elements
Inlines
Inline Examples
Inline Categories
Linking
Paragraphs
Examples, Figures, Tables, …
Graphics
MediaObject Example
Mediaobject Semantics
Verbatim environments
Admonitions
Lists
Definition or “Variable” Lists
Simple Lists
Special Purpose Markup
FAQs
Function Synopsis
"Hierarchy" Elements
A DocBook 4 Book
A DocBook 5 Book
An Article
Reference Pages
Publishing
DocBook to …
XSLT
DocBook XSL Stylesheets
DocBook to HTML
Transforming to HTML
DocBook to PDF
Transforming to PDF
Stylesheet Customization
XSL Customizations
Easy: Setting Parameters
Easy Parameters
Pretty Easy: A Customization Layer
Customization Skeleton
Customization Example 1
Customization Example 2
A Little Harder
Changing Title Pages
Updating the Title Page Template
Incorporate it into a customization layer
Write a template for contractnum
Uh, but what about internationalization?
Write an I18N-friendly template
I18N: Put it in the Stylesheet
I18N: Handle the label
S.M.O.P. (Simple Matter of Programming)
Schema Customization
The Role Attribute
Subsets
Extensions
DTD Customization Layer
RELAX NG Customization Layer
Restricting Role on Emphasis (DTD)
Restricting Role on Emphasis (RELAX NG)
Removing Procedures from the DTD
Removing Procedures (RELAX NG)
Derived Schemas
SolBook: The Sun Documentation DTD
Simplified DocBook
Websites
Slides
DITA?
Conclusions
Resources
Q&A
DocBook V5.0: The Gory Details
What's Changed