24.8.1.3 Preventing
the first paragraph format from starting a topic
To prevent DITA2Go from forcing
the first paragraph format in a file to become a topic start:
[DITAOptions]
; ForceStartTopic = Yes (default, make the format of the first para a
; topic start with tag "title" at level 1 and parent "topic"),
or No.
ForceStartTopic = No
If the first paragraph format in a file
is not assigned DITA level 1, or is not implicitly or explicitly
mapped to the <title>
element:
- When
ForceStartTopic=Yes,
DITA2Go forces these settings, overriding any other mapping or
level assignment; as a consequence, all subsequent paragraphs with the
same format in the same file also start topics.
- When
ForceStartTopic=No,
DITA2Go allows the paragraph to produce invalid DITA.
Best practice is to use the default
setting (ForceStartTopic=Yes),
and make sure the first paragraph format in each file is mapped to title and
assigned level 1.
Previous Topic:
24.8.1.2 Identifying
the starting element for glossary topics
Next Topic:
24.8.2 Specifying
the DITA topic type
Parent Topic:
24.8.1 Designating
starting points for DITA topics
Sibling Topics:
24.8.1.1 Identifying
starting elements for non-glossary topics
24.8.1.2 Identifying
the starting element for glossary topics
Table of Contents • Index