titleabbrev

titleabbrev — The abbreviation of a title.

Synopsis

titleabbrev ::=

Zero or more of:
- text
- html:button
- html:fieldset
- html:input
- html:label
- html:select
- html:textarea
- Bibliography inlines
- Computer-output inlines
- Graphic inlines
  - inlinemediaobject
- Linking inlines
  - link (db.link)
  - xref
- Markup inlines
  - email
  - literal
- Operating system inlines
- Product inlines
  - trademark
- Publishing inlines
  - abbrev
  - acronym
  - emphasis
  - footnote
  - footnoteref
  - phrase (db.phrase)
  - quote
- Technical inlines
- Ubiquitous inlines
- User-input inlines

Attributes

Common attributes and common linking attributes.

Description

A titleabbrev holds an abbreviated version of a title. One common use of titleabbrev is for the text used in running headers or footers, when the proper title is too long to be used conveniently.

Titles are so common, and so often the only “info” elements associated with their parent, that they (title, subtitle, and titleabbrev) are allowed outside the info element. This is a tradeoff favoring author convenience over a small amount of additional complexity in processing. However, the title elements must either all be outside of the info wrapper or all inside, you cannot have some outside and some inside.

Processing expectations

May be formatted inline or as a displayed block, depending on context. Abbreviated titles are usually used only in specific contexts, such as headers and footers, and are suppressed everywhere else.

Parents

These elements contain titleabbrev: abstract, appendix, bibliodiv, bibliography, bibliomixed, bibliomset, blockquote, example, figure, head, info (db.info), info (db.titleonly.info), info (db.titleonlyreq.info), info (db.titlereq.info), itemizedlist, legalnotice, note, orderedlist, personblurb, revhistory, section, sidebar, table (db.cals.table), variablelist.

Children

The following elements occur in titleabbrev: text, abbrev, acronym, author, citetitle, command, computeroutput, editor, email, emphasis, filename, footnote, footnoteref, html:button, html:fieldset, html:input, html:label, html:select, html:textarea, inlinemediaobject, link (db.link), literal, option, orgname, personname, phrase (db.phrase), quote, rddl:resource, replaceable, subscript, superscript, systemitem, trademark, userinput, xref.

Examples

 1 |<chapter xmlns='http://docbook.org/ns/docbook'>
   |<info>
   |  <title>How to Configure the Menu Subsystem
   |  of the Graphical User Interface</title>
 5 |  <titleabbrev>Configuring Menus</titleabbrev>
   |</info>
   | 
   |<para>Actual content.
   |</para>
10 |</chapter>