The <linktext> element provides
the literal label or line of text for a link. In most cases, the text
of a link can be resolved during processing by cross reference with
the target resource. Use the <linktext> element
only when the target cannot be reached, such as when it is a peer
or external link, or when the target is local but not
in DITA format. When used inside a topic, it is used
as the text for the specified link; when used within a map, it is
used as the text for generated links that point to the specified topic.
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 |
|---|
| topic (base), map (base), classifyMap, subjectScheme, learningAssessment, learningBookmap, learningContent, learningMap, learningOverview, learningPlan, learningSummary |
( text data or data or data-about or foreign or unknown or keyword or term or ph or b or i or sup or sub or tt or u) (any number) |
| topic (technical content), map (technical content), concept, ditabase, glossary, glossentry, glossgroup, reference, task, bookmap |
( text data or data or data-about or foreign or unknown or keyword or apiname or option or parmname or cmdname or msgnum or varname or wintitle or term or abbreviated-form or ph or b or i or sup or sub or tt or u or codeph or synph or filepath or msgph or systemoutput or userinput or menucascade or uicontrol) (any number) |
| machineryTask |
( text data or data or data-about or foreign or unknown or keyword or wintitle or term or ph or b or i or sup or sub or tt or u or menucascade or uicontrol) (any number) |
Contained by
| Doctype |
Content model |
|---|
| topic (base), topic (technical content), concept, ditabase, glossary, glossentry, glossgroup, reference, task (strict), task (general), machineryTask, learningAssessment, learningContent, learningOverview, learningPlan, learningSummary |
link |
| map (base), map (technical content), classifyMap, subjectScheme, learningMap |
topicmeta |
| bookmap, learningBookmap |
topicmeta, bookmeta |
Inheritance
"-
topic/linktext " when used in topics, and "- map/linktext " when used
in maps.
Example
<link href="tzover.htm#accsqlj">
<linktext>Accessing relational data with SQLJ</linktext>
</link>
Attributes
| Name |
Description |
Data Type |
Default Value |
Required? |
| 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 |
|
|
|