DocBook: From Syntax to Publication
Table of Contents
Table of Contents
A Little Background
Structured Documentation
Benefits
Technical Challenges
Non-Technical Challenges
Storing Structured Documentation
XML or SGML or ...
OASIS
Evolution
DocBook Markup
Element Classes
"Hierarchy" Elements
Case Study: A Book
Case Study: An Article
Case Study: Reference Pages
"Information Pool" Elements
Case Study: FAQs
Case Study: MediaObjects
Case Study: Function Synopsis
Linking
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 for contractnum
Adding I18N Generated Text
Adding I18N Generated Text (Continued)
S.M.O.P.
Schema Customization
The Role Attribute
Subsets
Extensions
General Form of a Customization Layer
Case Study: Restricting Role on Emphasis
Case Study: Removing Procedures from the DTD
Case Study: Removing Procedures from the RELAX NG Schema
Derived Schemas
SolBook: The Sun Documentation DTD
Simplified DocBook
Websites
Slides
Conclusion
Q&A
Resources