DocBook 5: The Definitive Guide
1st Edition
Published on 20. April 2010
552 pages
978-1-4493-9134-8 (ISBN)
Description
If you need a reliable tool for technical documentation, this clear and concise reference will help you take advantage of DocBook, the popular XML schema originally developed to document computer and hardware projects. DocBook 5.0 has been expanded and simplified to address documentation needs in other fields, and it's quickly becoming the tool of choice for many content providers.DocBook 5: The Definitive Guide is the complete, official documentation of DocBook 5.0. You'll find everything you need to know to use DocBook 5.0's features-including its improved content model-whether you're new to DocBook or an experienced user of previous versions.Learn how to write DocBook XML documentsUnderstand DocBook 5.0's elements and attributes, and how they fit togetherDetermine whether your documents conform to the DocBook schemaLearn about options for publishing DocBook to various output formatsCustomize the DocBook schema to meet your needsGet additional information about DocBook editing and processing
More details
Other editions
Additional editions
Norman Walsh Edited by Richard L. Hamilton
DocBook 5: The Definitive Guide
The Official Documentation for DocBook
Book
06/2010
1st Edition
O'Reilly
€47.00
Shipment within 10-20 days
Content
- Intro
- Table of Contents
- Preface
- Why Read This Book?
- This Book's Audience
- Organization of This Book
- Conventions Used in This Book
- Using Code Examples
- Safari® Books Online
- How to Contact Us
- Acknowledgments
- Part I. Introduction
- Chapter 1. Getting Started with DocBook
- A Short DocBook History
- The HaL and O'Reilly Era
- The Davenport Era
- The OASIS Era
- DocBook V5.0
- What's New in DocBook V5.0?
- Renamed and removed elements
- Linking and cross-referencing
- Uniform info elements
- Required title and version attributes
- Additional constraints
- Table of contents
- Constraint definitions using Schematron
- Accessibility
- Finally in a Namespace
- Relaxing with DocBook
- Why Switch to DocBook V5.0?
- Schema Jungle
- Where to Get the Schemas
- DocBook Documentation
- Backward Compatibility
- Chapter 2. Creating DocBook Documents
- Making an XML Document
- An XML Declaration
- A Document Type Declaration
- An Internal Subset
- The Document (or Root) Element
- Physical Divisions: Breaking a Document into Separate Files
- Logical Divisions: The Categories of Elements in DocBook
- Sets
- Books
- Components
- Sections
- Meta-Information
- Block Elements
- Block versus inline elements
- Lists
- Admonitions
- Line-specific environments
- Examples, figures, and tables
- Paragraphs
- Equations
- Graphics and media
- Questions and answers
- Procedures and tasks
- Synopses
- Miscellaneous block elements
- Inline Elements
- Traditional publishing inlines
- Cross-references
- Markup
- Mathematics
- User interfaces
- Programming languages and constructs
- Operating systems
- General purpose
- Roots: Starting Your DocBook Document
- Making a DocBook Book
- Making a Chapter
- Making an Article
- Making a Reference Page
- Making Front and Back Matter
- Making an Index
- Marking index terms
- Printing an index
- Making a Glossary
- Making a Bibliography
- Chapter 3. Validating DocBook Documents
- ID/IDREF Constraints and Validation
- Validating Your Documents
- Understanding Validation Errors
- Character Data Not Allowed Here
- Misspelled Start Tag
- Out-of-Context Start Tag
- Chapter 4. Publishing DocBook Documents
- A Survey of Stylesheet Languages
- Stylesheet Examples
- CSS stylesheet
- XSL stylesheet
- XQuery
- Using XSL to Publish DocBook Documents
- Chapter 5. Customizing DocBook
- Should You Do This?
- If You Change DocBook, It's Not DocBook Anymore!
- Namespace and Version
- Public Identifiers
- Customization Layers
- RELAX NG Syntax
- DocBook Schema Structure
- The General Structure of Customization Layers
- Writing, Testing, and Using a Customization Layer
- Deciding What to Change
- Deciding How to Change a Customization Layer
- Using Your Customization Layer
- Testing Your Work
- Removing Elements
- Removing msgset
- Removing Computer Inlines
- Removing Synopsis Elements
- Removing Sectioning Elements
- Removing Admonitions from Table Entries
- Removing Attributes
- Subsetting the Common Attributes
- Adding Elements
- Adding Attributes
- Other Modifications
- Changing the Contents of the role Attribute
- Adding a Value to an Enumerated Attribute
- Part II. Reference
- DocBook Element Reference
- abbrev
- abstract
- accel
- acknowledgements
- acronym
- address
- affiliation
- alt
- anchor
- annotation
- answer
- appendix
- application
- arc
- area (db.area.inareaset)
- area (db.area)
- areaset
- areaspec
- arg
- article
- artpagenums
- attribution
- audiodata
- audioobject
- author
- authorgroup
- authorinitials
- bibliocoverage
- bibliodiv
- biblioentry
- bibliography
- biblioid
- bibliolist
- bibliomisc
- bibliomixed
- bibliomset
- biblioref
- bibliorelation
- biblioset
- bibliosource
- blockquote
- book
- bridgehead
- callout
- calloutlist
- caption (db.caption)
- caption (db.html.caption)
- caution
- chapter
- citation
- citebiblioid
- citerefentry
- citetitle
- city
- classname
- classsynopsis
- classsynopsisinfo
- cmdsynopsis
- co
- code
- col
- colgroup
- collab
- colophon
- colspec
- command
- computeroutput
- confdates
- confgroup
- confnum
- confsponsor
- conftitle
- constant
- constraint
- constraintdef
- constructorsynopsis
- contractnum
- contractsponsor
- contrib
- copyright
- coref
- country
- cover
- database
- date
- dedication
- destructorsynopsis
- edition
- editor
- emphasis (db._emphasis)
- emphasis (db.emphasis)
- entry
- entrytbl
- envar
- epigraph
- equation
- errorcode
- errorname
- errortext
- errortype
- example
- exceptionname
- extendedlink
- fax
- fieldsynopsis
- figure
- filename
- firstname
- firstterm
- footnote
- footnoteref
- foreignphrase
- formalpara
- funcdef
- funcparams
- funcprototype
- funcsynopsis
- funcsynopsisinfo
- function
- glossary
- glossdef
- glossdiv
- glossentry
- glosslist
- glosssee
- glossseealso
- glossterm
- group
- guibutton
- guiicon
- guilabel
- guimenu
- guimenuitem
- guisubmenu
- hardware
- holder
- honorific
- imagedata (db.imagedata.mathml)
- imagedata (db.imagedata.svg)
- imagedata (db.imagedata)
- imageobject
- imageobjectco
- important
- index
- indexdiv
- indexentry
- indexterm (db.indexterm.endofrange)
- indexterm (db.indexterm.singular)
- indexterm (db.indexterm.startofrange)
- info (db.info)
- info (db.titleforbidden.info)
- info (db.titleonly.info)
- info (db.titleonlyreq.info)
- info (db.titlereq.info)
- informalequation
- informalexample
- informalfigure
- informaltable (db.cals.informaltable)
- informaltable (db.html.informaltable)
- initializer
- inlineequation
- inlinemediaobject
- interfacename
- issuenum
- itemizedlist
- itermset
- jobtitle
- keycap
- keycode
- keycombo
- keysym
- keyword
- keywordset
- label
- legalnotice
- lhs
- lineage
- lineannotation
- link
- listitem
- literal
- literallayout
- locator
- manvolnum
- markup
- mathphrase
- mediaobject
- member
- menuchoice
- methodname
- methodparam
- methodsynopsis
- modifier
- mousebutton
- msg
- msgaud
- msgentry
- msgexplan
- msginfo
- msglevel
- msgmain
- msgorig
- msgrel
- msgset
- msgsub
- msgtext
- nonterminal
- note
- olink
- ooclass
- ooexception
- oointerface
- option
- optional
- orderedlist
- org
- orgdiv
- orgname
- otheraddr
- othercredit
- othername
- package
- pagenums
- para
- paramdef
- parameter
- part
- partintro
- person
- personblurb
- personname
- phone
- phrase (db._phrase)
- phrase (db.phrase)
- pob
- postcode
- preface
- primary
- primaryie
- printhistory
- procedure
- production
- productionrecap
- productionset
- productname
- productnumber
- programlisting
- programlistingco
- prompt
- property
- pubdate
- publisher
- publishername
- qandadiv
- qandaentry
- qandaset
- question
- quote
- refclass
- refdescriptor
- refentry
- refentrytitle
- reference
- refmeta
- refmiscinfo
- refname
- refnamediv
- refpurpose
- refsect1
- refsect2
- refsect3
- refsection
- refsynopsisdiv
- releaseinfo
- remark
- replaceable
- returnvalue
- revdescription
- revhistory
- revision
- revnumber
- revremark
- rhs
- row (db.entrytbl.row)
- row (db.row)
- sbr
- screen
- screenco
- screenshot
- secondary
- secondaryie
- sect1
- sect2
- sect3
- sect4
- sect5
- section
- see
- seealso
- seealsoie
- seeie
- seg
- seglistitem
- segmentedlist
- segtitle
- seriesvolnums
- set
- setindex
- shortaffil
- shortcut
- sidebar
- simpara
- simplelist
- simplemsgentry
- simplesect
- spanspec
- state
- step
- stepalternatives
- street
- subject
- subjectset
- subjectterm
- subscript
- substeps
- subtitle
- superscript
- surname
- symbol
- synopfragment
- synopfragmentref
- synopsis
- systemitem
- table (db.cals.table)
- table (db.html.table)
- tag
- task
- taskprerequisites
- taskrelated
- tasksummary
- tbody (db.cals.entrytbl.tbody)
- tbody (db.cals.tbody)
- tbody (db.html.tbody)
- td
- term
- termdef
- tertiary
- tertiaryie
- textdata
- textobject
- tfoot (db.cals.tfoot)
- tfoot (db.html.tfoot)
- tgroup
- th
- thead (db.cals.entrytbl.thead)
- thead (db.cals.thead)
- thead (db.html.thead)
- tip
- title
- titleabbrev
- toc
- tocdiv
- tocentry
- token
- tr
- trademark
- type
- uri
- userinput
- varargs
- variablelist
- varlistentry
- varname
- videodata
- videoobject
- void
- volumenum
- warning
- wordasword
- xref
- year
- mml:*
- svg:*
- *:*
- Part III. Appendixes
- Appendix A. Installation
- Installing DocBook
- Installing the DocBook Schemas
- XML Catalogs and DocBook
- Installing and setting up the DocBook XML catalog
- Getting the ISO entity sets
- Installing the DocBook Stylesheets
- Appendix B. DocBook Variants and Future Directions
- DocBook Variants
- Future Directions
- DocBook Assembly Mechanism
- Appendix C. Resources
- Latest Versions of DocBook Schemas
- DocBook and XML Resources on the Web
- Introductory Material on the Web
- References and Technical Notes on the Web
- World Wide Web Consortium (W3C) Recommendations
- Related Standards
- Internet RFCs
- Books and Printed Resources
- XML Tools
- Appendix D. Interchanging DocBook Documents
- Appendix E. GNU Free Documentation License
- Glossary
- Index
