    |
DocBook: The Definitive Guide 0.0.25 for DocBook V5.0 (Alpha) |
| |
DocBook: The Definitive Guide 0.0.25 for DocBook V5.0 (Alpha) |
termdef — An inline definition of a term
termdef ::= ![[-]](graphics/down.gif)
![[+]](graphics/right.gif)
abbrevacronymcorefdateemphasis (db.emphasis)firsttermfootnotefootnoterefforeignphraseglosstermphrase (db.phrase)quotesubscriptsuperscriptwordasword
altanchorannotationbibliorefindexterm (db.indexterm.endofrange)indexterm (db.indexterm.singular)indexterm (db.indexterm.startofrange)inlinemediaobjectlinkolinkremarksubscriptsuperscriptxrefA termdef is an inline term definition. Some styles of documentation collect all terms together in a glossary of some sort, but another style is to place the definitions inline.
The glossary and glosslist elements support the former style, termdef the latter.
Every term should have an xml:id attribute to uniquely identify it. The content of the termdef is the definition of the term. Often it is valuable to word the definition so that it will stand alone, in case it becomes useful to extract all the terms into a separate glossary in addition to having them defined in line.
Every termdef must contain exactly one firstterm[7] The firstterm identifies the actual term defined by the termdef.
Common attributes and common linking attributes.
Specifies the base form of the term, the one that appears in the glossary. This allows adjectival, plural, and other variations of the term to appear in the element. The element content is the default base form.
Specifies the string by which the element's content is to be sorted; if unspecified, the content is used
These elements contain termdef: bridgehead, caption (db.html.caption), citation, citetitle, classsynopsisinfo, computeroutput, emphasis (db.emphasis), entry, firstterm, funcsynopsisinfo, glosssee, glossseealso, glossterm, html:button, html:label, html:legend, link, literallayout, member, olink, orgdiv, para, phrase (db.phrase), primary, primaryie, programlisting, quote, refdescriptor, refentrytitle, refname, refpurpose, screen, secondary, secondaryie, see, seealso, seealsoie, seeie, seg, segtitle, simpara, subtitle, synopsis, td, term, termdef, tertiary, tertiaryie, th, title, titleabbrev, tocentry, userinput.
The following elements occur in termdef: text, abbrev, accel, acronym, alt, anchor, annotation, application, author, biblioref, citation, citebiblioid, citerefentry,
citetitle, classname, code, command, computeroutput, constant, coref, database, date, editor, email, emphasis (db.emphasis), envar,
errorcode, errorname, errortext, errortype, exceptionname, filename, firstterm, footnote, footnoteref, foreignphrase, function, glossterm, guibutton,
guiicon, guilabel, guimenu, guimenuitem, guisubmenu, hardware, html:button, html:fieldset, html:input, html:label, html:select, html:textarea, indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), initializer, inlineequation, inlinemediaobject, interfacename, jobtitle, keycap, keycode, keycombo, keysym, link, literal, markup, menuchoice, methodname,
modifier, mousebutton, nonterminal, olink, ooclass, ooexception, oointerface, option, optional, org, orgname, package, parameter, person, personname, phrase (db.phrase), productname, productnumber, prompt, property, quote, remark, replaceable, returnvalue, shortcut, subscript, superscript, symbol, systemitem, tag, termdef, token, trademark,
type, uri, userinput, varname, wordasword, xref.
<article xmlns="http://docbook.org/ns/docbook"
xmlns:xlink='http://www.w3.org/1999/xlink'>
<title>termdef</title>
<para>This paragraph contains an inline term definition.
<termdef xml:id="dt-xml-processor">A
software module called an <firstterm>XML processor</firstterm> is used
to read XML documents and provide access to their content and
structure.</termdef> The definition comes from
<link xlink:href="http://www.w3.org/TR/REC-xml">the XML Recommendation</link>.
</para>
</article>
This paragraph contains an inline term definition. [Definition: A software module called an XML processor is used to read XML documents and provide access to their content and structure.] The definition comes from the XML Recommendation.
| |
|
|
| term | |
tertiary |