|
The 2003 O'Reilly Open Source Convention brings together
open source experts, developers, and users to learn, discuss,
and present the latest developments in open source software.
It has several tracks, all of which are open to all attendees:
- Perl
- Python
- PHP
- Apache
- XML
- Applications
- MySQL and PostgreSQL
- Ruby
More
on the Convention ...
The tutorial DocBook for Open Source Projects is designed
for open source developers who need to document their project.
DocBook is an ideal tool for open source projects because
it is itself an open source publishing system. DocBook is
currently used by a large number of open source projects,
making it a de facto standard for open source documentation.
This tutorial will help developers get up to speed on writing
DocBook files and processing them into HTML and print output.
Tutorial attendees will get sufficient information to set
up DocBook tools that integrate with other programming tools,
enabling them to treat the project documentation as part of
their software development process.
|
|
Tutorial Outline
- What is DocBook?
- Why use DocBook?
- Output formats
- Great free publishing tools
- DocBook is not ...
- Learning curve
- Best for ...
- DocBook for open source projects
- Who uses DocBook?
- DocBook community
- What do you need?
- DTDs
- LiveDTD
- Writing tools
- Validation tools
- Stylesheets - two kinds
- XSL processing tools
- Print output
- XSLT processors
- XSL-FO processors
- DSSSL processing tools
- XML vs. SGML
- XSL vs. DSSSL
- XSL vs. DSSSL in print
- Writing DocBook
- DocBook document
- Three classes of elements
- Hierarchy elements
- Book hierarchy elements
- Section hierarchy
- Article - alternative to book
- Block elements
- Block examples
- More block elements
- Text display elements
- Program listing example
- Formal displays
- Graphics
- mediaobject example
- Inline elements
- Technical inlines
- Cross references
- Cross reference with xref
- External cross references
- Man page example
- Man page example cont.
- Writing reference
- Generating output
- DSSSL stylesheets
- Processing with DSSSL
- DSSSL command line
- DSSSL with XML files
- DSSSL wrappers
- DocBook XSL stylesheets
- XSL output formats
- Customizable
- Stylesheet subdirectories
- Support subdirectories
- Main stylesheet files
- Installing XSLT processor
- Using xsltproc
- Using Saxon
- Generating PDF with FOP
- File not found …
- XML catalog
- Using parameters
- Parameter example
- Customization driver file
- Driver file content
- Customization example
- Generated text
- Customize generated text
- Special features
- Glossaries
- Bibliographies
- Indexes
- Special processing
- Profiling
- Modular documentation
- Olinking
- Prepackaged customizations
- DocBook toolkits
- For more information
|
Feedback