This contains a list of all current TC-approved elements, divided
up by module. It describes which are block elements and which are inline,
and lists which elements should be translated by default.
Notes on the tables below
- For specializations, the second column gives the ancestor element, and
the third column gives a quick yes/no guide to indicate whether all behavior
is inherited. If something is not inherited, the change will appear in bold.
- For any specialization not listed below, the default should be to fall
back to the closest listed ancestor.
- The block/inline presentation column indicates whether the element is
formatted as a single block.
- The block/inline translation column indicates whether the element represents
a complete translatable segment. For example, the element <cmd> is presented
inline with other elements, but represents a complete translation segment.
- Items marked as block*** are blocks on their own, but may appear in the
middle of a segment. For example, indexterm, fn, and draft-comment may divide
a sentence in two, but should be treated as blocks, and should not interrupt
the sentence. We recommend that these elements only be placed at sentence
boundaries to aid in translation.
- For all elements, the translate attribute will override the default translation
setting. So, a translation setting of "yes" or "no" in the table below does
not guarantee that an element will always, or never, be translated.
- If an element has translatable attributes, they are listed in the last
column.
topic elements
| Element name |
Specialized from |
Block/Inline (presentation) |
Block/Inline (translation) |
Translatable content? |
Translatable attributes? |
| alt |
N/A |
block |
block |
yes |
|
| audience |
N/A |
block (metadata) |
block |
yes |
|
| author |
N/A |
block (metadata) |
block |
yes |
|
| body |
N/A |
block |
block |
yes |
|
| boolean |
N/A |
inline |
inline |
n/a |
|
| brand |
N/A |
block (metadata) |
block |
yes |
|
| category |
N/A |
block (metadata) |
block |
yes |
|
| cite |
N/A |
inline |
inline |
yes |
|
| colspec |
N/A |
n/a |
n/a |
n/a |
|
| component |
N/A |
block (metadata) |
block |
yes |
|
| copyrholder |
N/A |
block (metadata) |
block |
yes |
|
| copyright |
N/A |
block (metadata) |
block |
yes |
|
| copyryear |
N/A |
block (metadata) |
block |
yes |
|
| created |
N/A |
block (metadata) |
block |
yes |
|
| critdates |
N/A |
block (metadata) |
block |
yes |
|
| dd |
N/A |
block |
block |
yes |
|
| ddhd |
N/A |
block |
block |
yes |
|
| desc |
N/A |
block |
block |
yes |
|
| dl |
N/A |
block |
block |
yes |
|
| dlentry |
N/A |
block |
block |
yes |
|
| dlhead |
N/A |
block |
block |
yes |
|
| draft-comment |
N/A |
block*** |
block |
no |
|
| dt |
N/A |
block |
block |
yes |
|
| dthd |
N/A |
block |
block |
yes |
|
| entry |
N/A |
block |
block |
yes |
|
| example |
N/A |
block |
block |
yes |
|
| featnum |
N/A |
block (metadata) |
block |
yes |
|
| fig |
N/A |
block |
block |
yes |
|
| figgroup |
N/A |
block |
block |
yes |
|
| fn |
N/A |
block*** |
block |
yes |
|
| image |
N/A |
block when @placement=break, otherwise inline |
block when @placement=break, otherwise inline |
yes |
@alt |
| indexterm |
N/A |
block*** |
block |
yes |
|
| indextermref |
N/A |
inline |
n/a |
n/a |
|
| itemgroup |
N/A |
inline |
inline |
yes |
|
| keyword |
N/A |
inline |
inline |
yes |
|
| keywords |
N/A |
block |
block |
yes |
|
| li |
N/A |
block |
block |
yes |
|
| lines |
N/A |
block |
block |
yes |
|
| link |
N/A |
block |
block |
yes |
|
| linkinfo |
N/A |
block |
block |
yes |
|
| linklist |
N/A |
block |
block |
yes |
|
| linkpool |
N/A |
block |
block |
yes |
|
| linktext |
N/A |
block |
block |
yes |
|
| lq |
N/A |
block |
block |
yes |
@reftitle |
| metadata |
N/A |
block (metadata) |
block |
yes |
|
| navtitle |
N/A |
block |
block |
yes |
|
| no-topic-nesting |
N/A |
n/a |
n/a |
n/a |
|
| note |
N/A |
block |
block |
yes |
@othertype |
| object |
N/A |
block |
block |
yes |
@standby |
| ol |
N/A |
block |
block |
yes |
|
| othermeta |
N/A |
block (metadata) |
block |
yes |
@content |
| p |
N/A |
block |
block |
yes |
|
| param |
N/A |
block |
block |
n/a |
|
| permissions |
N/A |
block (metadata) |
block |
yes |
|
| ph |
N/A |
inline |
inline |
yes |
|
| platform |
N/A |
block (metadata) |
block |
yes |
|
| pre |
N/A |
block |
block |
yes |
|
| prodinfo |
N/A |
block (metadata) |
block |
yes |
|
| prodname |
N/A |
block (metadata) |
block |
yes |
|
| prognum |
N/A |
block (metadata) |
block |
yes |
|
| prolog |
N/A |
block (metadata) |
block |
yes |
|
| publisher |
N/A |
block (metadata) |
block |
yes |
|
| q |
N/A |
inline |
inline |
yes |
|
| related-links |
N/A |
block |
block |
yes |
|
| required-cleanup |
N/A |
block*** |
block |
no |
|
| resourceid |
N/A |
block (metadata) |
block |
yes |
|
| revised |
N/A |
block (metadata) |
block |
yes |
|
| row |
N/A |
block |
block |
yes |
|
| searchtitle |
N/A |
block |
block |
yes |
|
| section |
N/A |
block |
block |
yes |
|
| series |
N/A |
block (metadata) |
block |
yes |
|
| shortdesc |
N/A |
block |
block |
yes |
|
| simpletable |
N/A |
block |
block |
yes |
|
| sl |
N/A |
block |
block |
yes |
|
| sli |
N/A |
block |
block |
yes |
|
| source |
N/A |
block (metadata) |
block |
yes |
|
| state |
N/A |
inline |
inline |
yes |
@value |
| stentry |
N/A |
block |
block |
yes |
|
| sthead |
N/A |
block |
block |
yes |
|
| strow |
N/A |
block |
block |
yes |
|
| table |
N/A |
block |
block |
yes |
|
| tbody |
N/A |
block |
block |
yes |
|
| term |
N/A |
inline |
inline |
yes |
|
| tgroup |
N/A |
block |
block |
yes |
|
| thead |
N/A |
block |
block |
yes |
|
| title |
N/A |
block |
block |
yes |
|
| titlealts |
N/A |
block |
block |
yes |
|
| tm |
N/A |
inline |
inline |
yes |
|
| topic |
N/A |
block |
block |
yes |
|
| ul |
N/A |
block |
block |
yes |
|
| vrm |
N/A |
block (metadata) |
block |
yes |
|
| vrmlist |
N/A |
block (metadata) |
block |
yes |
|
| xref |
N/A |
inline |
inline |
yes |
|
map elements
| Element name |
Specialized from |
Block/Inline (presentation) |
Block/Inline (translation) |
Translatable content? |
Translatable attributes? |
| anchor |
N/A |
n/a |
n/a |
n/a |
|
| linktext |
N/A |
block |
block |
yes |
|
| map |
N/A |
block |
block |
yes |
@title |
| navref |
N/A |
n/a |
n/a |
n/a |
|
| relcell |
N/A |
block |
block |
yes |
|
| relcolspec |
N/A |
block |
block |
yes |
|
| relheader |
N/A |
block |
block |
yes |
|
| relrow |
N/A |
block |
block |
yes |
|
| reltable |
N/A |
block |
block |
yes |
|
| searchtitle |
N/A |
block |
block |
yes |
|
| shortdesc |
N/A |
block |
block |
yes |
|
| topicmeta |
N/A |
block |
block |
yes |
|
| topicref |
N/A |
block |
block |
yes |
@navref |
concept elements
| Element name |
Specialized from |
Inherits everything from ancestor? |
Block/Inline (presentation) |
Block/Inline (translation) |
Translatable content? |
Translatable attributes? |
| conbody |
body |
yes |
block |
block |
yes |
|
| concept |
topic |
yes |
block |
block |
yes |
|
reference elements
| Element name |
Specialized from |
Inherits everything from ancestor? |
Block/Inline (presentation) |
Block/Inline (translation) |
Translatable content? |
Translatable attributes? |
| propdesc |
stentry |
yes |
block |
block |
yes |
|
| propdeschd |
stentry |
yes |
block |
block |
yes |
|
| properties |
simpletable |
yes |
block |
block |
yes |
|
| property |
strow |
yes |
block |
block |
yes |
|
| prophead |
sthead |
yes |
block |
block |
yes |
|
| proptype |
stentry |
yes |
block |
block |
yes |
|
| proptypehd |
stentry |
yes |
block |
block |
yes |
|
| propvalue |
stentry |
yes |
block |
block |
yes |
|
| propvaluehd |
stentry |
yes |
block |
block |
yes |
|
| refbody |
body |
yes |
block |
block |
yes |
|
| reference |
topic |
yes |
block |
block |
yes |
|
| refsyn |
section |
yes |
block |
block |
yes |
|
task elements
| Element name |
Specialized from |
Inherits everything from ancestor? |
Block/Inline (presentation) |
Block/Inline (translation) |
Translatable content? |
Translatable attributes? |
| chdesc |
stentry |
yes |
block |
block |
yes |
|
| chdeschd |
stentry |
yes |
block |
block |
yes |
|
| chhead |
sthead |
yes |
block |
block |
yes |
|
| choice |
li |
yes |
block |
block |
yes |
|
| choices |
ul |
yes |
block |
block |
yes |
|
| choicetable |
simpletable |
yes |
block |
block |
yes |
|
| choption |
stentry |
yes |
block |
block |
yes |
|
| choptionhd |
stentry |
yes |
block |
block |
yes |
|
| chrow |
strow |
yes |
block |
block |
yes |
|
| cmd |
ph |
NO |
inline |
block |
yes |
|
| context |
section |
yes |
block |
block |
yes |
|
| info |
itemgroup |
NO |
inline |
block |
yes |
|
| postreq |
section |
yes |
block |
block |
yes |
|
| prereq |
section |
yes |
block |
block |
yes |
|
| result |
section |
yes |
block |
block |
yes |
|
| step |
li |
yes |
block |
block |
yes |
|
| stepresult |
itemgroup |
NO |
inline |
block |
yes |
|
| steps |
ol |
yes |
block |
block |
yes |
|
| steps-unordered |
ul |
yes |
block |
block |
yes |
|
| stepxmp |
itemgroup |
NO |
inline |
block |
yes |
|
| substep |
li |
yes |
block |
block |
yes |
|
| substeps |
ol |
yes |
block |
block |
yes |
|
| task |
topic |
yes |
block |
block |
yes |
|
| taskbody |
body |
yes |
block |
block |
yes |
|
| tutorialinfo |
itemgroup |
NO |
inline |
block |
yes |
|
hi-d elements
| Element name |
Specialized from |
Inherits everything from ancestor? |
Block/Inline (presentation) |
Block/Inline (translation) |
Translatable content? |
Translatable attributes? |
| b |
ph |
yes |
inline |
inline |
yes |
|
| i |
ph |
yes |
inline |
inline |
yes |
|
| sub |
ph |
yes |
inline |
inline |
yes |
|
| sup |
ph |
yes |
inline |
inline |
yes |
|
| tt |
ph |
yes |
inline |
inline |
yes |
|
| u |
ph |
yes |
inline |
inline |
yes |
|
pr-d elements
| Element name |
Specialized from |
Inherits everything from ancestor? |
Block/Inline (presentation) |
Block/Inline (translation) |
Translatable content? |
Translatable attributes? |
| apiname |
keyword |
yes |
inline |
inline |
yes |
|
| codeblock |
pre |
yes |
block |
block |
yes |
|
| codeph |
ph |
yes |
inline |
inline |
yes |
|
| delim |
ph |
yes |
inline |
inline |
yes |
|
| fragment |
figgroup |
yes |
block |
block |
yes |
|
| fragref |
xref |
yes |
inline |
inline |
yes |
|
| groupchoice |
figgroup |
yes |
block |
block |
yes |
|
| groupcomp |
figgroup |
yes |
block |
block |
yes |
|
| groupseq |
figgroup |
yes |
block |
block |
yes |
|
| kwd |
keyword |
yes |
inline |
inline |
yes |
|
| oper |
ph |
yes |
inline |
inline |
yes |
|
| option |
keyword |
yes |
inline |
inline |
yes |
|
| parml |
dl |
yes |
block |
block |
yes |
|
| parmname |
keyword |
yes |
inline |
inline |
yes |
|
| pd |
dd |
yes |
block |
block |
yes |
|
| plentry |
dlentry |
yes |
block |
block |
yes |
|
| pt |
dt |
yes |
block |
block |
yes |
|
| repsep |
ph |
yes |
inline |
inline |
yes |
|
| sep |
ph |
yes |
inline |
inline |
yes |
|
| synblk |
figgroup |
yes |
block |
block |
yes |
|
| synnote |
fn |
yes |
block |
block |
yes |
|
| synnoteref |
xref |
yes |
inline |
inline |
yes |
|
| synph |
ph |
yes |
inline |
inline |
yes |
|
| syntaxdiagram |
fig |
yes |
block |
block |
yes |
|
| var |
ph |
yes |
inline |
inline |
yes |
|
sw-d elements
| Element name |
Specialized from |
Inherits everything from ancestor? |
Block/Inline (presentation) |
Block/Inline (translation) |
Translatable content? |
Translatable attributes? |
| cmdname |
keyword |
yes |
inline |
inline |
yes |
|
| filepath |
ph |
yes |
inline |
inline |
yes |
|
| msgblock |
pre |
yes |
block |
block |
yes |
|
| msgnum |
keyword |
yes |
inline |
inline |
yes |
|
| msgph |
ph |
yes |
inline |
inline |
yes |
|
| systemoutput |
ph |
yes |
inline |
inline |
yes |
|
| userinput |
ph |
yes |
inline |
inline |
yes |
|
| varname |
keyword |
yes |
inline |
inline |
yes |
|
ui-d elements
| Element name |
Specialized from |
Inherits everything from ancestor? |
Block/Inline (presentation) |
Block/Inline (translation) |
Translatable content? |
Translatable attributes? |
| menucascade |
ph |
yes |
inline |
inline |
yes |
|
| screen |
pre |
yes |
block |
block |
yes |
|
| shortcut |
keyword |
yes |
inline |
inline |
yes |
|
| uicontrol |
ph |
yes |
inline |
inline |
yes |
|
| wintitle |
keyword |
yes |
inline |
inline |
yes |
|
ut-d elements
| Element name |
Specialized from |
Inherits everything from ancestor? |
Block/Inline (presentation) |
Block/Inline (translation) |
Translatable content? |
Translatable attributes? |
| area |
figgroup |
yes |
block |
block |
yes |
|
| coords |
ph |
NO |
inline |
inline |
no |
|
| imagemap |
fig |
yes |
block |
block |
yes (can contain translatable alternate text) |
|
| shape |
keyword |
NO |
inline |
inline |
no |
|
mapgroup-d elements
| Element name |
Specialized from |
Inherits everything from ancestor? |
Block/Inline (presentation) |
Block/Inline (translation) |
Translatable content? |
Translatable attributes? |
| topicgroup |
topicref |
yes |
block |
block |
yes |
@navtitle |
| topichead |
topicref |
yes |
block |
block |
yes |
@navtitle |