I. DocBook Element Reference

Table of Contents

*:* — Any element from almost any namespace
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 componentV5.0
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 extendedlinkV5.0
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 collaborators
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 — A raw entry in a bibliography
bibliography — A bibliography
biblioid — An identifier for a documentV5.0
bibliolist — A wrapper for a list of bibliography entries
bibliomisc — Untyped bibliographic information
bibliomixed — A cooked 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
buildtarget — Target of a buildV5.2
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 publicationV5.0
danger — An admonition set off from the text indicating hazardous situationV5.2
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) — A limited span of emphasized text
emphasis (db.emphasis) — Emphasized text
entry — A cell in a table
entrytbl — A subtable appearing in place of an entry in a table
enumidentifier — The identifier of a value an enumerated type can takeV5.2
enumitem — A value an enumerated type can take and its descriptionV5.2
enumitemdescription — The description of a value an enumerated type can takeV5.2
enumname — The name of an enumerationV5.2
enumsynopsis — The syntax summary for an enumerated-type definitionV5.2
enumvalue — The value an enumerated type can takeV5.2
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 linkV5.0
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 — A given name of a person
firstterm (db._firstterm) — The first occurrence of a term, with limited contentV5.1
firstterm (db.firstterm) — The first occurrence of a term
footnote — A footnote
footnoteref — A cross reference to a footnote (a footnote mark)
foreignphrase (db._foreignphrase) — A limited word or phrase in a language other than the primary language of the documentV5.1
foreignphrase (db.foreignphrase) — A word or phrase in a language other than the primary language of the document
formalgroup — A group of formal objects, for example subfiguresV5.2
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
givenname — The given name of a personV5.1
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 (db._glossterm) — A glossary termV5.1
glossterm (db.glossterm) — A glossary term
group (db.group) — A group of elements in a cmdsynopsis
group (db.group.methodparam) — A group of method parametersV5.1
group (db.group.paramdef) — A group of parametersV5.1
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 blockV5.0
info (db.titleforbidden.info) — A wrapper for information about a component or other block without a titleV5.0
info (db.titleonly.info) — A wrapper for information about a component or other block with only a titleV5.0
info (db.titleonlyreq.info) — A wrapper for information about a component or other block with only a required titleV5.0
info (db.titlereq.info) — A wrapper for information about a component or other block with a required titleV5.0
informalequation — A displayed mathematical equation without a title
informalexample — A displayed example without a title
informalfigure — A untitled figure
informaltable (db.html.informaltable) — An HTML table without a title
informaltable (db.cals.informaltable) — A 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 extendedlinkV5.0
macrodef — A macro name and its return typeV5.2
macroname — The name of a macro (a code-generating function)V5.2
macroprototype — The prototype of a macro (code-generating function)V5.2
macrosynopsis — The syntax summary for a macro definition (code-generating function)V5.2
manvolnum — A reference volume number
markup — A string of formatting markup in text that is to be represented literally
mathphrase — A mathematical phrase 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
meta (db.meta.content) — A generic metadata elementV5.2
meta (db.meta.empty) — A generic metadata elementV5.2
methodname — The name of a method
methodparam — Parameters to a method
methodsynopsis — A syntax summary for a method
mml:* — Any element from the MathML namespace
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
multimediaparam — Application specific parameters for a media playerV5.1
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 metadataV5.0
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 person's name that is not a first name, surname, or lineage
package — A software or application package
packagesynopsis — The syntax summary for a package definitionV5.2
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 metadataV5.0
personblurb — A short description or note about a person
personname — The personal name of an individual
phone — A telephone number
phrase (db._phrase) — A limited span of text
phrase (db.phrase) — A 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 (db._quote) — A limited inline quotationV5.1
quote (db.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
result — A wrapper for identifying the results of a procedure or stepV5.1
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
specializedtemplate — The specialization of a template identifier, in the generic programming senseV5.2
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 H₂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², the mathematical notation for x multiplied by itself)
surname — An inherited or family name; in western cultures the last name
svg:* — Any element from the SVG namespace
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
synopsisinfo — Information supplementing synopsisV5.2
systemitem — A system-related item or term
table (db.html.table) — A formal (captioned) HTML table in a document
table (db.cals.table) — A formal table in a document
tag — A component of XML (or SGML) markupV5.0
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.html.tbody) — A wrapper for the rows of an HTML table or informal HTML table
tbody (db.cals.tbody) — A wrapper for the rows of a table or informal table
td — A table entry in an HTML table
template — The definition of a template, in the generic programming senseV5.2
templatename — The identifier for a template, in the generic programming senseV5.2
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.html.tfoot) — A table footer consisting of one or more rows in an HTML table
tfoot (db.cals.tfoot) — A table footer consisting of one or more rows
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.html.thead) — A table header consisting of one or more rows in an HTML table
thead (db.cals.thead) — A table header consisting of one or more rows
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 contentsV5.0
tocentry — A component title in a table of contents
token — A unit of information
topic — A modular unit of documentation not part of any particular narrative flowV5.1
tr — A row in an HTML table
trademark — A trademark
type — The classification of a value
typedefname — The name of a type aliasV5.2
typedefsynopsis — The syntax summary for a type-alias definitionV5.2
union — The definition of a union of types, which may be more than a nameV5.2
unionname — The name of a union of typesV5.2
unionsynopsis — The syntax summary for a union-of-types definitionV5.2
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

This reference describes every element in DocBook V5.0.

1. Organization of Reference Pages

The description of each element in this reference is divided into the following sections:

Synopsis

Provides a quick synopsis of the element. The content of the synopsis varies according to the nature of the element described, but may include any or all of the following sections:

Content Model

Describes the content model of the element, the mixture of things that it can contain. See Section 1.1, “Understanding Content Models”.

Attributes

Provides a synopsis of the attributes on the element. For brevity, common attributes are described only once, in this introduction. Likewise, common linking attributes are described once.

Additional Constraints

Provides a synopsis of any additional constraints on the element. These constraints are expressed using Schematron in the RELAX NG grammar.

Description

Describes the semantics of the element.

Processing expectations: Summarizes specific formatting expectations of the element. Many processing expectations are influenced by attribute values. Be sure to consult the description of element attributes as well.
Future changes: Identifies changes that are scheduled for future versions of the schema. These changes are highlighted because they involve some backward incompatibility that may make currently valid DocBook documents no longer valid under the new version.

Attributes

Describes the semantics of each attribute.

See Also

Lists similar or related elements.

Examples

Provides examples of proper usage for the element. Generally, the smallest example required to reasonably demonstrate the element is used. In many cases, a formatted version of the example is also shown.

All of the examples in the book are valid according to the RELAX NG grammar.

Formatted examples are indicated using a vertical bar.

1.1. Understanding Content Models

Each element synopsis begins with a description of its content model. Content models are the way that grammars describe the name, number, and order of other elements that may be used inside an element.

1.1.1. Content models and validity

A validator uses the content models to determine if a given document is valid. In order for a document to be valid, the content of every element in the document must match the content model for that element.

In practical terms, match means that it must be possible to expand the content model until it exactly matches the sequence of elements in the document.

For example, consider the content model of the epigraph:

epigraph ::= (info?^{db.titleforbidden.info}, attribution?,(literallayout | Paragraph elements)+)

Does the following example match that content model?

  |<epigraph>
  |<para>Some text</para>
  |</epigraph>

Yes, it is valid because the following expansion of the content model exactly matches the actual content: choose zero occurrences of info, choose zero occurrences of attribution, choose the alternative para from the Paragraph elements choice, and choose to let the one or more match once.

By the same token, this example is not valid because there is no expansion of the content model that can match it:

  |<epigraph>
  |<para>Some text</para>
  |<attribution>John Doe</attribution>
  |</epigraph>

2. Common Attributes

There are many common attributes that occur on every DocBook element. They are summarized here for brevity and to make the additional attributes that occur on many elements stand out.

Name Type

*:* text

annotations text

dir

Enumeration:

ltr

rtl

lro

rlo

remap text

revisionflag

Enumeration:

changed

added

deleted

off

role text

trans:idfixup

Enumeration:

none

suffix

auto

trans:linkscope

Enumeration:

user

local

near

global

trans:suffix text

version text

xml:base anyURI

xml:id ID

xml:lang text

xreflabel text

*:*

Any attribute in any other explicit namespace. Any number of attributes that are in an explicit namespace other than the DocBook, XML, XLink, or transclusion namespaces are allowed.

annotations

Identifies one or more annotations that apply to this element.

dir

Identifies the direction of text in an element.

ltr: Left-to-right text
rtl: Right-to-left text
lro: Left-to-right override
rlo: Right-to-left override

remap

Provides the name or similar semantic identifier assigned to the content in some previous markup scheme.

revisionflag

Identifies the revision status of the element.

changed: The element has been changed.
added: The element is new (has been added to the document).
deleted: The element has been deleted.
off: Explicitly turns off revision markup for this element.

role

Provides additional, user-specified classification for an element.

While role is a common attribute in the sense that it occurs on all DocBook elements, customizers will find that it is not part of any of the “common attribute” patterns. It is parameterized differently because it is useful to be able to subclass role independently on different elements.

trans:idfixup

The transclusion ID fixup strategy.

none: No ID fixup strategy
suffix: ID fixup by concatenating suffixes
auto: ID fixup by creating unique values

trans:linkscope

The transclusion link scope adjustment.

user: No link scope adjustments are made
local: The link scopes are adjusted with the suffix property
near: The link scopes are adjusted based on proximity
global: The link scopes are adjusted based on document order

trans:suffix

The transclusion suffix to use when the suffix ID fixup strategy is employed.

version

Specifies the DocBook version of the element and its descendants.

xml:base

Specifies the base URI of the element and its descendants.

xml:id

Identifies the unique ID value of the element.

xml:lang

Specifies the natural language of the element and its descendants.

xreflabel

Provides the text that is to be generated for a cross reference to the element.

2.1. Common Effectivity Attributes

The common attributes include a collection of effectivity attributes. These attributes are available for authors to identify to whom a particular element applies. Effectivity attributes are often used for profiling: building documents that contain information only relevant to a particular audience.

For example, a section might be identified as available only to readers with a top-secret security clearance or a paragraph might be identified as affecting only users running the implementation provided by a particular vendor.

Name	Type
`arch`	text
`audience`	text
`condition`	text
`conformance`	text
`os`	text
`outputformat`	text
`revision`	text
`security`	text
`userlevel`	text
`vendor`	text
`wordsize`	text

arch

Designates the computer or chip architecture to which the element applies.

audience

Designates the intended audience to which the element applies, for example, system administrators, programmers, or new users.

condition

provides a standard place for application-specific effectivity.

Many DocBook users observed that in order to add an effectivity condition that was unique to their environment required abusing the semantics of one of the existing attributes, or adding their own, making their customization an extension rather than a subset. Thecondition attribute is a general-purpose effectivity attribute with no specified semantics.

Thecondition attribute provides a standard place for application-specific effectivity.

conformance

Indicates standards conformance characteristics of the element.

These characteristics are application-specific; DocBook provides no default semantics.

os

Indicates the operating system to which the element is applicable.

outputformat

Indicates the output format (for example, print or epub) to which the element applies.

revision

Indicates the editorial revision to which the element belongs.

security

Indicates something about the security level associated with the element to which it applies.

userlevel

Indicates the level of user experience for which the element applies.

vendor

Indicates the computer vendor to which the element applies.

wordsize

Indicates the word size (width in bits) of the computer architecture to which the element applies.

The names of the effectivity attributes are suggestive of several classes of common effectivity information. The semantically neutral condition attribute was added to give authors a place to put values that don’t fit neatly into one of the other alternatives.

In authoring environments where many different kinds of effectivity information are required, it’s not uncommon to see local extensions that add new attributes. It’s also not uncommon to see attributes used without regard to the class of information suggested by the name.

2.2. Common RDFa Lite Attributes

The RDFa Lite attributes incorporate support for RDFa into DocBook.

Name	Type
`prefix`	text
`property`	text
`resource`	text
`typeof`	text
`vocab`	anyURI

prefix: The RDFa Lite prefix.
property: The RDFa Lite property.
resource: The RDFa Lite resource.
typeof: The RDFa Lite typeof.
vocab: The RDFa Lite vocab.

See RDFa Lite 1.1 for more details about the RDFa Lite attributes.

2.3. Common Transclusion Attributes

The transclusion attributes incorporate support for DocBook transclusion.

Name	Type

See DocBook Transclusion for more details about the transclusion attributes.

3. Common Linking Attributes

The following attributes occur on all elements that can be the start of a link. They are summarized here once for brevity and to make the additional attributes that occur on many elements stand out.

Name Type

linkend/linkends IDREF/IDREFS

xlink:actuate

Enumeration:

onLoad

onRequest

other

none

xlink:arcrole anyURI

xlink:from NMTOKEN

xlink:href anyURI

xlink:label NMTOKEN

xlink:role anyURI

xlink:show

Enumeration:

new

replace

embed

other

none

xlink:title text

xlink:to NMTOKEN

xlink:type text

linkend/linkends

Points to an internal link target by identifying the value of its xml:id attribute.

xlink:actuate

Identifies the XLink actuate behavior of the link.

onLoad: An application should traverse to the ending resource immediately on loading the starting resource.
onRequest: An application should traverse from the starting resource to the ending resource only on a post-loading event triggered for the purpose of traversal.
other: The behavior of an application traversing to the ending resource is unconstrained by this specification. The application should look for other markup present in the link to determine the appropriate behavior.
none: The behavior of an application traversing to the ending resource is unconstrained by this specification. No other markup is present to help the application determine the appropriate behavior.

xlink:arcrole

Identifies the XLink arcrole of the link.

xlink:from

Specifies the XLink traversal-from.

xlink:href

Identifies a link target with a URI.

xlink:label

Specifies the XLink label.

xlink:role

Identifies the XLink role of the link.

DocBook uses the XLink role value http://docbook.org/xlink/role/olink to identify linking elements with OLink semantics. That means the part of xlink:href before the number sign (#) is to be interpreted as equivalent to the olink targetdoc attribute value, and the part after the number sign as the olink targetptr attribute value.

xlink:show

Identifies the XLink show behavior of the link.

new: An application traversing to the ending resource should load it in a new window, frame, pane, or other relevant presentation context.
replace: An application traversing to the ending resource should load the resource in the same window, frame, pane, or other relevant presentation context in which the starting resource was loaded.
embed: An application traversing to the ending resource should load its presentation in place of the presentation of the starting resource.
other: The behavior of an application traversing to the ending resource is unconstrained by XLink. The application should look for other markup present in the link to determine the appropriate behavior.
none: The behavior of an application traversing to the ending resource is unconstrained by this specification. No other markup is present to help the application determine the appropriate behavior.

xlink:title

Identifies the XLink title of the link.

xlink:to

Specifies the XLink traversal-to.

xlink:type

Identifies the XLink link type.