Language reference : Technical content architecture : Glossary elements : Glossentry elements : glossSurfaceForm
The <glossSurfaceForm> element specifies an unambiguous presentation of the <glossterm> that may combine multiple forms. The surface form is suitable to introduce the term in new contexts.
The <glossSurfaceForm> element is most often used for terms that also specify the <glossAcronym> element. In that case it contains the term in a manner that introduces both the term and the acronym, so that later references to the term may be replaced with the acronym alone. See the <abbreviated-form> element for a full description of how the surface form is used together with acronyms.
Note: These models represent only the default document types distributed by OASIS. Actual content models will differ with each new document type.
Content model
ditabase, glossary, glossentry, glossgroup
( text data or keyword or apiname or option or parmname or cmdname or msgnum or varname or wintitle or term or abbreviated-form or tm) (any number)
Contained by
Content model
ditabase, glossary, glossentry, glossgroup
- topic/p concept/p glossentry/glossSurfaceForm
Example 258. Example
<glossentry id="abs">
<glossterm>Anti-lock Braking System</glossterm>
<glossSurfaceForm>Anti-lock Braking System (ABS)</glossSurfaceForm>
This glossentry topic defines "Anti-lock Braking System (ABS)" provides an unambiguous way to render the primary term "Anti-lock Braking System". The <abbreviated-form> explains how the <glossSurfaceForm> element affects references to this topic.
Data Type
Default Value
univ-atts attribute group (includes select-atts, id-atts, and localization-atts groups)
A set of related attributes, described in univ-atts attribute group
global-atts attribute group (xtrf, xtrc)
A set of related attributes, described in global-atts attribute group
class, outputclass
Common attributes described in Other common DITA attributes