1. Preface
         1. Why Read This Book?
         2. This Book's Audience
         3. Organization of This Book
         4. Conventions Used in This Book
         5. Using Code Examples
         6. Safari® Books Online
         7. How to Contact Us
         8. Acknowledgments
         I. Introduction
         1. Getting Started with DocBook
         1. A Short DocBook History
         1.1. The HaL and O’Reilly Era
         1.2. The Davenport Era
         1.3. The OASIS Era
         2. DocBook V5.0
         2.1. What’s New in DocBook V5.0?
         3. Finally in a Namespace
         3.1. Namespace Usage Policy
         4. Relaxing with DocBook
         5. Why Switch to DocBook V5.0?
         6. Schema Jungle
         6.1. Where to Get the Schemas
         6.2. DocBook Documentation
         7. Backward Compatibility
         2. Creating DocBook Documents
         1. Making an XML Document
         1.1. An XML Declaration
         1.2. A Document Type Declaration
         1.3. An Internal Subset
         1.4. The Document (or Root) Element
         2. Physical Divisions: Breaking a Document into Separate Files
         3. Logical Divisions: The Categories of Elements in DocBook
         3.1. Sets
         3.2. Books
         3.3. Components
         3.4. Sections
         3.5. Meta-Information
         3.6. Block Elements
         3.7. Inline Elements
         4. Roots: Starting Your DocBook Document
         5. Making a DocBook Book
         6. Making a Chapter
         7. Making an Article
         8. Making a Reference Page
         9. Making Front and Back Matter
         9.1. Making an Index
         9.2. Making a Glossary
         9.3. Making a Bibliography
         3. Validating DocBook Documents
         1. ID/IDREF Constraints and Validation
         2. Validating Your Documents
         3. Understanding Validation Errors
         3.1. Character Data Not Allowed Here
         3.2. Misspelled Start Tag
         3.3. Out-of-Context Start Tag
         4. Publishing DocBook Documents
         1. A Survey of Stylesheet Languages
         1.1. Stylesheet Examples
         2. Using XSL to Publish DocBook Documents
         5. Customizing DocBook
         1. Should You Do This?
         2. If You Change DocBook, It’s Not DocBook Anymore!
         2.1. Namespace and Version
         2.2. Public Identifiers
         3. Customization Layers
         3.1. RELAX NG Syntax
         3.2. DocBook Schema Structure
         3.3. The General Structure of Customization Layers
         4. Writing, Testing, and Using a Customization Layer
         4.1. Deciding What to Change
         4.2. Deciding How to Change a Customization Layer
         4.3. Using Your Customization Layer
         4.4. Testing Your Work
         5. Removing Elements
         5.1. Removing msgset
         5.2. Removing Computer Inlines
         5.3. Removing Synopsis Elements
         5.4. Removing Sectioning Elements
         5.5. Removing Admonitions from Table Entries
         6. Removing Attributes
         6.1. Subsetting the Common Attributes
         7. Adding Elements
         8. Adding Attributes
         9. Other Modifications
         9.1. Changing the Contents of the role Attribute
         9.2. Adding a Value to an Enumerated Attribute
         II. Reference
         I. DocBook Element Reference
         abbrev - An abbreviation, especially one followed by a period
         abstract - A summary
         accel - A graphical user interface (GUI) keyboard shortcut
         acknowledgements - Acknowledgements of a book or other component
         acronym - An often pronounceable word made from the initial (or selected) letters of a name or phrase
         address - A real-world address, generally a postal address
         affiliation - The institutional affiliation of an individual
         alt - A text-only annotation, often used for accessibility
         anchor - A spot in the document
         annotation - An annotation
         answer - An answer to a question posed in a QandASet
         appendix - An appendix in a Book or Article
         application - The name of a software program
         arc - An XLink arc in an extendedlink
         area (db.area) - A region defined for a Callout in a graphic or code example
         area (db.area.inareaset) - A region defined for a Callout in a graphic or code example
         areaset - A set of related areas in a graphic or code example
         areaspec - A collection of regions in a graphic or code example
         arg - An argument in a CmdSynopsis
         article - An article
         artpagenums - The page numbers of an article as published
         attribution - The source of a block quote or epigraph
         audiodata - Pointer to external audio data
         audioobject - A wrapper for audio data and its associated meta-information
         author - The name of an individual author
         authorgroup - Wrapper for author information when a document has multiple authors or collabarators
         authorinitials - The initials or other short identifier for an author
         bibliocoverage - The spatial or temporal coverage of a document
         bibliodiv - A section of a Bibliography
         biblioentry - An entry in a Bibliography
         bibliography - A bibliography
         biblioid - An identifier for a document
         bibliolist - A wrapper for a list of bibliography entries
         bibliomisc - Untyped bibliographic information
         bibliomixed - An entry in a Bibliography
         bibliomset - A cooked container for related bibliographic information
         biblioref - A cross-reference to a bibliographic entry
         bibliorelation - The relationship of a document to another
         biblioset - A raw container for related bibliographic information
         bibliosource - The source of a document
         blockquote - A quotation set off from the main text
         book - A book
         bridgehead - A free-floating heading
         callout - A called out description of a marked Area
         calloutlist - A list of callout s
         caption (db.caption) - A caption
         caption (db.html.caption) - An HTML table caption
         caution - A note of caution
         chapter - A chapter, as of a book
         citation - An inline bibliographic reference to another published work
         citebiblioid - A citation of a bibliographic identifier
         citerefentry - A citation to a reference page
         citetitle - The title of a cited work
         city - The name of a city in an address
         classname - The name of a class, in the object-oriented programming sense
         classsynopsis - The syntax summary for a class definition
         classsynopsisinfo - Information supplementing the contents of a ClassSynopsis
         cmdsynopsis - A syntax summary for a software command
         co - The location of a callout embedded in text
         code - An inline code fragment
         col - Specifications for a column in an HTML table
         colgroup - A group of columns in an HTML table
         collab - Identifies a collaborator
         colophon - Text at the back of a book describing facts about its production
         colspec - Specifications for a column in a table
         command - The name of an executable program or other software command
         computeroutput - Data, generally text, displayed or presented by a computer
         confdates - The dates of a conference for which a document was written
         confgroup - A wrapper for document meta-information about a conference
         confnum - An identifier, frequently numerical, associated with a conference for which a document was written
         confsponsor - The sponsor of a conference for which a document was written
         conftitle - The title of a conference for which a document was written
         constant - A programming or system constant
         constraint - A constraint in an EBNF production
         constraintdef - The definition of a constraint in an EBNF production
         constructorsynopsis - A syntax summary for a constructor
         contractnum - The contract number of a document
         contractsponsor - The sponsor of a contract
         contrib - A summary of the contributions made to a document by a credited source
         copyright - Copyright information about a document
         coref - A cross reference to a co
         country - The name of a country
         cover - Additional content for the cover of a publication
         database - The name of a database, or part of a database
         date - The date of publication or revision of a document
         dedication - The dedication of a book or other component
         destructorsynopsis - A syntax summary for a destructor
         edition - The name or number of an edition of a document
         editor - The name of the editor of a document
         email - An email address
         emphasis (db.emphasis) - Emphasized text
         emphasis (db._emphasis) - A limited span of emphasized text
         entry - A cell in a table
         entrytbl - A subtable appearing in place of an Entry in a table
         envar - A software environment variable
         epigraph - A short inscription at the beginning of a document or component
         equation - A displayed mathematical equation
         errorcode - An error code
         errorname - An error name
         errortext - An error message.
         errortype - The classification of an error message
         example - A formal example, with a title
         exceptionname - The name of an exception
         extendedlink - An XLink extended link
         fax - A fax number
         fieldsynopsis - The name of a field in a class definition
         figure - A formal figure, generally an illustration, with a title
         filename - The name of a file
         firstname - The first name of a person
         firstterm - The first occurrence of a term
         footnote - A footnote
         footnoteref - A cross reference to a footnote (a footnote mark)
         foreignphrase - A word or phrase in a language other than the primary language of the document
         formalpara - A paragraph with a title
         funcdef - A function (subroutine) name and its return type
         funcparams - Parameters for a function referenced through a function pointer in a synopsis
         funcprototype - The prototype of a function
         funcsynopsis - The syntax summary for a function definition
         funcsynopsisinfo - Information supplementing the FuncDefs of a FuncSynopsis
         function - The name of a function or subroutine, as in a programming language
         glossary - A glossary
         glossdef - A definition in a GlossEntry
         glossdiv - A division in a Glossary
         glossentry - An entry in a Glossary or GlossList
         glosslist - A wrapper for a list of glossary entries
         glosssee - A cross-reference from one glossentry to another
         glossseealso - A cross-reference from one GlossEntry to another
         glossterm - A glossary term
         group - A group of elements in a CmdSynopsis
         guibutton - The text on a button in a GUI
         guiicon - Graphic and/or text appearing as a icon in a GUI
         guilabel - The text of a label in a GUI
         guimenu - The name of a menu in a GUI
         guimenuitem - The name of a terminal menu item in a GUI
         guisubmenu - The name of a submenu in a GUI
         hardware - A physical part of a computer system
         holder - The name of the individual or organization that holds a copyright
         honorific - The title of a person
         imagedata (db.imagedata) - Pointer to external image data
         imagedata (db.imagedata.mathml) - A MathML expression in a media object
         imagedata (db.imagedata.svg) - An SVG drawing in a media object
         imageobject - A wrapper for image data and its associated meta-information
         imageobjectco - A wrapper for an image object with callouts
         important - An admonition set off from the text
         index - An index to a book or part of a book
         indexdiv - A division in an index
         indexentry - An entry in an index
         indexterm (db.indexterm.endofrange) - Identifies the end of a range associated with an indexed term
         indexterm (db.indexterm.singular) - A wrapper for an indexed term
         indexterm (db.indexterm.startofrange) - A wrapper for an indexed term that covers a range
         info (db.info) - A wrapper for information about a component or other block
         info (db.titleforbidden.info) - A wrapper for information about a component or other block without a title
         info (db.titleonly.info) - A wrapper for information about a component or other block with only a title
         info (db.titleonlyreq.info) - A wrapper for information about a component or other block with only a required title
         info (db.titlereq.info) - A wrapper for information about a component or other block with a required title
         informalequation - A displayed mathematical equation without a title
         informalexample - A displayed example without a title
         informalfigure - A untitled figure
         informaltable (db.cals.informaltable) - A table without a title
         informaltable (db.html.informaltable) - An HTML table without a title
         initializer - The initializer for a FieldSynopsis
         inlineequation - A mathematical equation or expression occurring inline
         inlinemediaobject - An inline media object (video, audio, image, and so on)
         interfacename - The name of an interface
         issuenum - The number of an issue of a journal
         itemizedlist - A list in which each entry is marked with a bullet or other dingbat
         itermset - A set of index terms in the meta-information of a document
         jobtitle - The title of an individual in an organization
         keycap - The text printed on a key on a keyboard
         keycode - The internal, frequently numeric, identifier for a key on a keyboard
         keycombo - A combination of input actions
         keysym - The symbolic name of a key on a keyboard
         keyword - One of a set of keywords describing the content of a document
         keywordset - A set of keywords describing the content of a document
         label - A label on a Question or Answer
         legalnotice - A statement of legal obligations or requirements
         lhs - The left-hand side of an EBNF production
         lineage - The portion of a person's name indicating a relationship to ancestors
         lineannotation - A comment on a line in a verbatim listing
         link - A hypertext link
         listitem - A wrapper for the elements of a list item
         literal - Inline text that is some literal value
         literallayout - A block of text in which line breaks and white space are to be reproduced faithfully
         locator - An XLink locator in an extendedlink
         manvolnum - A reference volume number
         markup - A string of formatting markup in text that is to be represented literally
         mathphrase - A mathematical phrase, an expression that can be represented with ordinary text and a small amount of markup
         mediaobject - A displayed media object (video, audio, image, etc.)
         member - An element of a simple list
         menuchoice - A selection or series of selections from a menu
         methodname - The name of a method
         methodparam - Parameters to a method
         methodsynopsis - A syntax summary for a method
         modifier - Modifiers in a synopsis
         mousebutton - The conventional name of a mouse button
         msg - A message in a message set
         msgaud - The audience to which a message in a message set is relevant
         msgentry - A wrapper for an entry in a message set
         msgexplan - Explanatory material relating to a message in a message set
         msginfo - Information about a message in a message set
         msglevel - The level of importance or severity of a message in a message set
         msgmain - The primary component of a message in a message set
         msgorig - The origin of a message in a message set
         msgrel - A related component of a message in a message set
         msgset - A detailed set of messages, usually error messages
         msgsub - A subcomponent of a message in a message set
         msgtext - The actual text of a message component in a message set
         nonterminal - A non-terminal in an EBNF production
         note - A message set off from the text
         olink - A link that addresses its target indirectly
         ooclass - A class in an object-oriented programming language
         ooexception - An exception in an object-oriented programming language
         oointerface - An interface in an object-oriented programming language
         option - An option for a software command
         optional - Optional information
         orderedlist - A list in which each entry is marked with a sequentially incremented label
         org - An organization and associated metadata
         orgdiv - A division of an organization
         orgname - The name of an organization
         otheraddr - Uncategorized information in address
         othercredit - A person or entity, other than an author or editor, credited in a document
         othername - A component of a persons name that is not a first name, surname, or lineage
         package - A software or application package
         pagenums - The numbers of the pages in a book, for use in a bibliographic entry
         para - A paragraph
         paramdef - Information about a function parameter in a programming language
         parameter - A value or a symbolic reference to a value
         part - A division in a book
         partintro - An introduction to the contents of a part
         person - A person and associated metadata
         personblurb - A short description or note about a person
         personname - The personal name of an individual
         phone - A telephone number
         phrase (db.phrase) - A span of text
         phrase (db._phrase) - A limited span of text
         pob - A post office box in an address
         postcode - A postal code in an address
         preface - Introductory matter preceding the first chapter of a book
         primary - The primary word or phrase under which an index term should be sorted
         primaryie - A primary term in an index entry, not in the text
         printhistory - The printing history of a document
         procedure - A list of operations to be performed in a well-defined sequence
         production - A production in a set of EBNF productions
         productionrecap - A cross-reference to an EBNF production
         productionset - A set of EBNF productions
         productname - The formal name of a product
         productnumber - A number assigned to a product
         programlisting - A literal listing of all or part of a program
         programlistingco - A program listing with associated areas used in callouts
         prompt - A character or string indicating the start of an input field in a computer display
         property - A unit of data associated with some part of a computer system
         pubdate - The date of publication of a document
         publisher - The publisher of a document
         publishername - The name of the publisher of a document
         qandadiv - A titled division in a QandASet
         qandaentry - A question/answer set within a QandASet
         qandaset - A question-and-answer set
         question - A question in a QandASet
         quote - An inline quotation
         refclass - The scope or other indication of applicability of a reference entry
         refdescriptor - A description of the topic of a reference page
         refentry - A reference page (originally a UNIX man-style reference page)
         refentrytitle - The title of a reference page
         reference - A collection of reference entries
         refmeta - Meta-information for a reference entry
         refmiscinfo - Meta-information for a reference entry other than the title and volume number
         refname - The name of (one of) the subject(s) of a reference page
         refnamediv - The name, purpose, and classification of a reference page
         refpurpose - A short (one sentence) synopsis of the topic of a reference page
         refsect1 - A major subsection of a reference entry
         refsect2 - A subsection of a refsect1
         refsect3 - A subsection of a refsect2
         refsection - A recursive section in a refentry
         refsynopsisdiv - A syntactic synopsis of the subject of the reference page
         releaseinfo - Information about a particular release of a document
         remark - A remark (or comment) intended for presentation in a draft manuscript
         replaceable - Content that may or must be replaced by the user
         returnvalue - The value returned by a function
         revdescription - A extended description of a revision to a document
         revhistory - A history of the revisions to a document
         revision - An entry describing a single revision in the history of the revisions to a document
         revnumber - A document revision number
         revremark - A description of a revision to a document
         rhs - The right-hand side of an EBNF production
         row (db.entrytbl.row) - A row in a table
         row (db.row) - A row in a table
         sbr - An explicit line break in a command synopsis
         screen - Text that a user sees or might see on a computer screen
         screenco - A screen with associated areas used in callouts
         screenshot - A representation of what the user sees or might see on a computer screen
         secondary - A secondary word or phrase in an index term
         secondaryie - A secondary term in an index entry, rather than in the text
         sect1 - A top-level section of document
         sect2 - A subsection within a Sect1
         sect3 - A subsection within a Sect2
         sect4 - A subsection within a Sect3
         sect5 - A subsection within a Sect4
         section - A recursive section
         see - Part of an index term directing the reader instead to another entry in the index
         seealso - Part of an index term directing the reader also to another entry in the index
         seealsoie - A See also entry in an index, rather than in the text
         seeie - A See entry in an index, rather than in the text
         seg - An element of a list item in a segmented list
         seglistitem - A list item in a segmented list
         segmentedlist - A segmented list, a list of sets of elements
         segtitle - The title of an element of a list item in a segmented list
         seriesvolnums - Numbers of the volumes in a series of books
         set - A collection of books
         setindex - An index to a set of books
         shortaffil - A brief description of an affiliation
         shortcut - A key combination for an action that is also accessible through a menu
         sidebar - A portion of a document that is isolated from the main narrative flow
         simpara - A paragraph that contains only text and inline markup, no block elements
         simplelist - An undecorated list of single words or short phrases
         simplemsgentry - A wrapper for a simpler entry in a message set
         simplesect - A section of a document with no subdivisions
         spanspec - Formatting information for a spanned column in a table
         state - A state or province in an address
         step - A unit of action in a procedure
         stepalternatives - Alternative steps in a procedure
         street - A street address in an address
         subject - One of a group of terms describing the subject matter of a document
         subjectset - A set of terms describing the subject matter of a document
         subjectterm - A term in a group of terms describing the subject matter of a document
         subscript - A subscript (as in H2 O, the molecular formula for water)
         substeps - A wrapper for steps that occur within steps in a procedure
         subtitle - The subtitle of a document
         superscript - A superscript (as in x^2, the mathematical notation for x multiplied by itself)
         surname - A family name; in western cultures the last name
         symbol - A name that is replaced by a value before processing
         synopfragment - A portion of a CmdSynopsis broken out from the main body of the synopsis
         synopfragmentref - A reference to a fragment of a command synopsis
         synopsis - A general-purpose element for representing the syntax of commands or functions
         systemitem - A system-related item or term
         table (db.cals.table) - A formal table in a document
         table (db.html.table) - A formal (captioned) HTML table in a document
         tag - A component of XML (or SGML) markup
         task - A task to be completed
         taskprerequisites - The prerequisites for a task
         taskrelated - Information related to a task
         tasksummary - A summary of a task
         tbody (db.cals.entrytbl.tbody) - A wrapper for the rows of a table or informal table
         tbody (db.cals.tbody) - A wrapper for the rows of a table or informal table
         tbody (db.html.tbody) - A wrapper for the rows of an HTML table or informal HTML table
         td - A table entry in an HTML table
         term - The word or phrase being defined or described in a variable list
         termdef - An inline definition of a term
         tertiary - A tertiary word or phrase in an index term
         tertiaryie - A tertiary term in an index entry, rather than in the text
         textdata - Pointer to external text data
         textobject - A wrapper for a text description of an object and its associated meta-information
         tfoot (db.cals.tfoot) - A table footer consisting of one or more rows
         tfoot (db.html.tfoot) - A table footer consisting of one or more rows in an HTML table
         tgroup - A wrapper for the main content of a table, or part of a table
         th - A table header entry in an HTML table
         thead (db.cals.entrytbl.thead) - A table header consisting of one or more rows
         thead (db.cals.thead) - A table header consisting of one or more rows
         thead (db.html.thead) - A table header consisting of one or more rows in an HTML table
         tip - A suggestion to the user, set off from the text
         title - The text of the title of a section of a document or of a formal block-level element
         titleabbrev - The abbreviation of a title
         toc - A table of contents
         tocdiv - A division in a table of contents
         tocentry - A component title in a table of contents
         token - A unit of information
         tr - A row in an HTML table
         trademark - A trademark
         type - The classification of a value
         uri - A Uniform Resource Identifier
         userinput - Data entered by the user
         varargs - An empty element in a function synopsis indicating a variable number of arguments
         variablelist - A list in which each entry is composed of a set of one or more terms and an associated description
         varlistentry - A wrapper for a set of terms and the associated description in a variable list
         varname - The name of a variable
         videodata - Pointer to external video data
         videoobject - A wrapper for video data and its associated meta-information
         void - An empty element in a function synopsis indicating that the function in question takes no arguments
         volumenum - The volume number of a document in a set (as of books in a set or articles in a journal)
         warning - An admonition set off from the text
         wordasword - A word meant specifically as a word and not representing anything else
         xref - A cross reference to another part of the document
         year - The year of publication of a document
         *:* - Any element from almost any namespace
         mml:* - Any element from the MathML namespace
         svg:* - Any element from the SVG namespace
         III. Appendixes
         A. Installation
         1. Installing DocBook
         1.1. Installing the DocBook Schemas
         1.2. XML Catalogs and DocBook
         1.3. Installing the DocBook Stylesheets
         B. DocBook Variants and Future Directions
         1. DocBook Variants
         2. Future Directions
         2.1. DocBook Assembly Mechanism
         C. Resources
         1. Latest Versions of DocBook Schemas
         2. DocBook and XML Resources on the Web
         3. Introductory Material on the Web
         4. References and Technical Notes on the Web
         5. World Wide Web Consortium (W3C) Recommendations
         6. Related Standards
         7. Internet RFCs
         8. Books and Printed Resources
         9. XML Tools
         D. Interchanging DocBook Documents
         E. GNU Free Documentation License
         Glossary
         Index
      · · · · · ·     (
收起)