The DITA Style Guide by Tony Self

Author:Tony Self
Language: eng
Format: epub

Titles and headings

Titles are used in a number of mark-up structures in DITA. Titles are a mix of content and metadata. The mark-up in titles should be kept as simple as possible, and workarounds to achieve specific formatting outcomes should not be used.

A title is not the same as a heading. A title is usually considered part of the content (and is typically rendered in the output as a heading), but it also has a role as a metadata container. For example, the title might be used as the basis for link text, outside the context of its topic. In that context, mark-up such as a footnote (fn) or cross-reference (xref) wouldn’t make any sense.

A number of mark-up structures in DITA have titles, including: map

topic

table

data

link list

syntax diagram

figure

section

example

Download

Copyright Disclaimer:
This site does not store any files on its server. We only index and link to content provided by other sites. Please contact the content providers to delete copyright contents if any and email us, we'll remove relevant links or contents immediately.