◇◆
<abbrev> Abbreviation or Acronym
Abbreviation, acronym, or emoticon used in the text of a document, possibly including
an expansion of the acronym.
Usage/Remarks
The <abbrev> element is
intended for marking abbreviations in running text, and not
for the documentation of common abbreviations in a list of
symbols and abbreviated terms.
Although an abbreviation is typically a few capitalized letters (“NIH”,
“WHO”,
“UN”, or
“GAO”),
emoticons (“;-)”) can also be tagged as abbreviations (“smile-wink”).
Linking
The linking attributes (with the standard XLink attributes) may be used to provide a live link to an expansion, definition, or additional
explanation.
Accessibility
Sometimes an <abbrev> needs to be pronounced in a way that is not reflected in its content or its tagging.
The @alt attribute can be used to record the pronunciation for screen readers and other accessibility
devices. For example, the abbreviation “WHO” might be better pronounced as “World
Health Organization” or as “W.H.O.” than as “who”as the word would normally be. The
@alt attribute can also be used to provide the textual interpretation of a
symbol such as an emoticon (for “;-)” use “alt="smile-wink"”).
Attributes
Linking Attributes
xlink:type (fixed value = simple)
Namespaces
xmlns:xlink (fixed value = http://www.w3.org/1999/xlink)
Models and Context
May be contained in
<addr-line>, <alt-title>, <article-title>, <attrib>, <award-id>, <bold>, <code>, <collab>, <comment>, <compl>, <def-head>, <element-citation>, <fixed-case>, <full>, <funding-source>, <intro>, <italic>, <license-p>, <main>, <meta-value>, <mixed-citation>, <monospace>, <named-content>, <overline>, <p>, <preformat>, <roman>, <sans-serif>, <sc>, <see>, <see-also>, <see-also-entry>, <see-entry>, <strike>, <styled-content>, <sub>, <subtitle>, <sup>, <supplement>, <td>, <term>, <term-head>, <th>, <title>, <trans-subtitle>, <trans-title>, <underline>, <verse-line>
Description
Any combination of:
- Text, numbers, or special characters
- <def> Definition
Content Model
<!ELEMENT abbrev (#PCDATA %abbrev-elements;)* >
Expanded Content Model
(#PCDATA | def)*
Tagged Samples
For abbreviation
... <p>... The first time an abbreviation is used in text, it shall be placed in parentheses and shall be preceded by the word or term spelled out in full (for example, circuit (<abbrev>ckt</abbrev>), frequency converter (<abbrev>freq conv</abbrev>), and maximum working pressure (<abbrev>mwp</abbrev>)). ...</p> ...
For acronym
... <list-item> <label>f.</label> <p>Replacement of the DoD Index of Specifications and Standards (<abbrev>DoDISS</abbrev>) with the Acquisition Streamlining and Standardization Information System (<abbrev alt="A.S.S.I.S.T.">ASSIST</abbrev>) database.</p> </list-item> ...