The <glossPartOfSpeech> element identifies the part
of speech for the preferred and alternate terms. Alternate terms must
have the same part of speech as the preferred term because all terms
in the glossentry topic designate the same subject. If the part of
speech isn't specified, the default is a noun for the standard enumeration.
Note: The standard enumeration is extensible or replaceable.
If validation is required, the enumeration should be validated by
means of the DITA Controlled Values mechanism or through processing
rather than validated as an XML enumeration.
Contains
Note: These models represent only the default document types distributed by OASIS.
Actual content models will differ with each new document type.
Doctype |
Content model |
ditabase, glossary, glossentry, glossgroup |
no content |
Contained by
Doctype |
Content model |
ditabase, glossary, glossentry, glossgroup |
glossBody |
Inheritance
-
topic/data concept/data glossentry/glossPartOfSpeech
Example
Figure 1. The
glossary term "USB flash drive" with additional information
<glossentry id="usbfd">
<glossterm>USB flash drive</glossterm>
<glossdef>A small portable drive.</glossdef>
<glossBody>
<glossPartOfSpeech value="noun"/>
<glossUsage>Do not provide in upper case (as in "USB Flash
Drive") because that suggests a trademark.</glossUsage>
<glossAlt>
<glossAcronym>UFD</glossAcronym>
<glossUsage>Explain the acronym on first occurrence.</glossUsage>
</glossAlt>
<glossAlt id="memoryStick">
<glossSynonym>memory stick</glossSynonym>
<glossUsage>This is a colloquial term.</glossUsage>
</glossAlt>
<glossAlt>
<glossAbbreviation>stick</glossAbbreviation>
<glossStatus value="prohibited"/>
<glossUsage>This is too colloquial.</glossUsage>
<glossAlternateFor href="#usbfd/memoryStick"/>
</glossAlt>
<glossAlt>
<glossAbbreviation>flash</glossAbbreviation>
<glossStatus value="prohibited"/>
<glossUsage>This short form is ambiguous.</glossUsage>
</glossAlt>
</glossBody>
</glossentry>
Attributes
Name |
Description |
Data Type |
Default Value |
Required? |
name |
Defines a unique name for the object. |
CDATA |
#IMPLIED |
No |
datatype |
Describes the type of data contained in the value attribute
or within the data element. A typical use of datatype will be the identifying
URI for an XML Schema datatype. |
CDATA |
#IMPLIED |
No |
value |
Specifies the part of speech for the term defined within
this glossentry topic. |
CDATA |
#IMPLIED |
No |
href |
Provides a reference to a resource. See
The href attribute for detailed information
on supported values and processing implications. |
CDATA |
#IMPLIED |
No |
format |
The format attribute identifies the format of the resource
being referenced. See
The format attribute for details on
supported values. |
CDATA |
#IMPLIED |
No |
type |
Describes the target of a reference. See
The type attribute for detailed information
on supported values and processing implications. |
CDATA |
#IMPLIED |
No |
scope |
The scope attribute identifies the closeness of the
relationship between the current document and the target resource. See
The scope attribute for more information on
values. |
(local | peer | external |
-dita-use-conref-target) |
#IMPLIED |
No |
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 |
|
|
|