Element-by-element recommendations for translators

This section is non-normative.

This topic contains a list of all elements in the base DITA edition. It includes recommendations on how to present the element type to translators, whether the element contents are likely to be suitable for translation, and whether the element has attributes with values that are likely to be suitable for translation. Examples of content that is not suitable for translation include code fragments and mailing addresses.

Notes on the tables below

  • Note that an element might be a block element in one context and an inline element in another. In addition, specialized element types might be rendered in a way that varies from their specialization base. Accordingly, the distinctions presented in the tables are provided only as a guide to known behavior with the base DITA. For element specializations that are not distributed by OASIS, the suggested default is to fall back to the closest ancestor element that is part of the OASIS distribution.
  • For all elements, the @translate attribute overrides the suggested defaults specified in the tables below.
  • Certain block-level elements might appear in the middle of a translation segment. They are considered subflow elements in regard to translation. When located in the middle of a translation segment, these element should not be translated as part of that segment. Whenever possible, such elements should be placed only at sentence boundaries in order to aid translation. The subflow elements in base DITA are <draft-comment>, <fn>, <idex-see>, <index-see-also>, <indexterm>, and <required-cleanup>
  • The <keyword> element (as well as specializations of <keyword>) is an inline, phrase-like element when it appears in the body of a document. It can also appear in the <keywords> element in <topicmeta> (for maps) or in the <prolog> (for topic). When it appears in the <keywords> element, each <keyword> represents an individual segment. In that location, <keyword> is considered a subflow element.

Explanation of column headers

The following list explains the headers for the columns:

Element name
The name of the element.
Specialization base
The element from which the current element is specialized. This column only appears in tables for the domain elements.
Same behavior as specialization base?
Indicates whether the element has the same behaviors in regard to translation as its specialization base. The behaviors are whether the element is formatted as a single block or as an inline element, whether the element represents a complete translatable segment, and whether the element contains translatable content. This column only appears in tables for the domain elements.
Block/inline translation
Specifies whether the element represents a complete translatable segment. The value block indicates that the element is a single segment, while the value inline indicates that the element is part of a larger segment.
Translatable content?
Whether the element contains one or both of the following:
  • Text content that can be translated
  • Child elements that contain content that can be translated
Notes
This column contains any additional information, including the following items.This column only appears in tables when it is needed.
  • Whether the element has any attributes with values that might need translation
  • If specializations of the element might need translation,
  • If the element is a "subflow" element for the purposes of translation

Topic elements

The following table contains information about elements that are available within topics. Some elements are also available in DITA maps.

Element name Block/inline (translation) Translatable content? Notes
<abstract> block yes
<alt> block yes This element is considered a subflow element.
<audience> block yes
<audio> block yes
<author> block yes
<body> block yes
<bodydiv> block yes
<brand> block yes
<category> block yes
<cite> inline yes
<colspec> n/a (empty) n/a (empty)
<component> block yes
<copyrholder> block yes
<copyright> block yes
<copyryear> block yes
<created> block yes
<critdates> block yes
<data> block no Specializations of <data> might contain translatable content.
<dd> block yes
<ddhd> block yes
<desc> block yes
<div> block yes
<dl> block yes
<dlentry> block yes
<dlhead> block yes
<draft-comment> block no This element is considered a subflow element.
<dt> block yes
<dthd> block yes
<entry> block yes
<example> block yes
<fallback> block yes
<featnum> block yes
<fig> block yes
<figgroup> block yes
<fn> block yes This element is considered a subflow element.
<foreign> block yes

The block vs. inline designation for the <foreign> element is likely to change for some specializations.

The <foreign> element might contain DITA elements, such

<desc>, <object>, and <image>, in addition to non-DITA elements. Such elements can contain translatable content; they provide an alternative display if the foreign content cannot be processed.
<image> block when @placement= break, otherwise inline yes
<include> inline yes
<index-see> block yes This element is considered a subflow element.
<index-see-also> block yes This element is considered a subflow element.
<indexterm> block yes This element is considered a subflow element.
<keytext> block yes
<keyword> inline (except when within <keywords> – see note above the table) yes
<keywords> block yes
<li> block yes
<lines> block yes
<link> block yes
<linkinfo> block yes
<linklist> block yes
<linkpool> block yes
<linktext> block yes
<lq> block yes @reftitle can specify translatable content.
<media-source> block n/a
<media-track> block n/a
<metadata> block yes
<no-topic-nesting> n/a (empty) n/a (empty)
<note> block yes @othertype can specify translatable content.
<object> block yes
<ol> block yes
<othermeta> block yes @content can specify translatable content.
<p> block yes
<param> block n/a
<permissions> block yes
<ph> inline yes
<platform> block yes
<pre> block yes
<prodinfo> block yes
<prodname> block yes
<prognum> block yes
<prolog> block yes
<publisher> block yes
<q> inline yes
<related-links> block yes
<required-cleanup> block no This element is considered a subflow element.
<resourceid> block yes
<revised> block yes
<row> block yes
<section> block yes
<series> block yes
<shortdesc> block yes
<simpletable> block yes
<sl> block yes
<sli> block yes
<source> block yes
<stentry> block yes
<sthead> block yes
<strow> block yes
<table> block yes
<tbody> block yes
<term> inline yes
<text> inline yes
<tgroup> block yes
<thead> block yes
<title> block yes
<titlealt> block yes
<tm> inline yes
<topic> block yes
<ul> block yes
<video> block yes
<vrm> block yes
<vrmlist> block yes
<xref> inline yes

Map elements

The following table contains information about the elements that are defined in the map module.

Element name Block/inline (translation) Translatable content?
<map> block yes
<navref> n/a (empty) n/a (empty)
<relcell> block yes
<relcolspec> block yes
<relheader> block yes
<relrow> block yes
<reltable> block yes
<shortdesc> block yes
<topicmeta> block yes
<topicref> block yes
<ux-window> n/a (empty) n/a (empty)

Alternative title domain elements (alternativetitles-d)

There are no translatable attributes or other special considerations for elements in this domain. With the exception of the <subtitle> element, all elements represent metadata.

Element name Specialization base Same behavior as specialization base? Block/inline (translation) Translatable content?
<linktitle> <titlealt> yes block yes
<navtitle> <titlealt> yes block yes
<searchtitle> <titlealt> yes block yes
<subtitle> <titlealt> yes block yes
<titlehint> <titlealt> yes block yes

Emphasis domain elements (emphasis-d)

There are no translatable attributes or other special considerations for elements in this domain.

Element name Specialization base Same behavior as specialization base? Block/inline (translation) Translatable content?
<em> <ph> yes inline yes
<strong> <ph> yes inline yes

Hazard statement domain elements (hazard-d)

There are no translatable attributes or other special considerations for elements in this domain.

Element name Specialization base Same behavior as specialization base? Block/inline (translation) Translatable content?
<consequence> <div> yes block yes
<hazardstatement> <note> yes block yes
<hazardsymbol> <image> yes block when @placement= break, otherwise inline yes
<howtoavoid> <div> yes block yes
<messagepanel> <div> yes block yes
<typeofhazard> <div> yes block yes

Highlight domain elements (hi-d)

There are no translatable attributes or other special considerations for elements in this domain.

Element name Specialization base Same behavior as specialization base? Block/inline (translation) Translatable content?
<b> <ph> yes inline yes
<line-through> <ph> yes inline yes
<i> <ph> yes inline yes
<overline> <ph> yes inline yes
<sub> <ph> yes inline yes
<sup> <ph> yes inline yes
<tt> <ph> yes inline yes
<u> <ph> yes inline yes

Utilities domain elements (ut-d)

There are no translatable attributes for elements in this domain.

Element name Specialization base Same behavior as specialization base? Block/inline (translation) Translatable content? Notes
<area> <figgroup> yes block yes
<coords> <ph> no inline no
<imagemap> <fig> yes block yes This element can contain translatable alternate text.
<shape> <keyword> no inline no
<sort-as> <data> no block yes This element is considered a subflow element.

DITAVALref domain elements (ditavalref-d)

Element name Specialization base Same behavior as specialization base? Block/inline (translation) Translatable content?
<ditavalmeta> <topicmeta> yes block yes
<ditavalref> <topicref> yes block yes
<dvrKeyscopePrefix> <data> yes block no
<dvrKeyscopeSuffix> <data> yes block no
<dvrResourcePrefix> <data> yes block no
<dvrResourceSuffix> <data> yes block no

Map group domain elements (mapgroup-d)

There are no translatable attributes or other special considerations for elements in this domain.

Element name Specialization base Same behavior as specialization base? Block/inline (translation) Translatable content?
<keydef> <topicref> yes block yes
<mapref> <topicref> yes block yes
<mapresources> <topicref> yes block yes
<topicgroup> <topicref> yes block yes
<topichead> <topicref> yes block yes

DITAVAL elements

There are no translatable attributes in the DITAVAL element set. The only element that directly contains translatable text is <alt-text>.

Element name Block/inline (translation) Translatable content?
<alt-text> block yes
<endflag> block yes
<prop> block yes
<revprop> block yes
<startflag> block yes
<style-conflict> n/a (empty) n/a (empty element)
<val> block yes