27.5.1 Understanding how split
and extract files are named
When DITA2Go splits a DITA file, the result
is a series of HTML files. If you direct DITA2Go to include a
map-based TOC (see §6.12 Specifying options for maps),
that TOC becomes the first output file. Otherwise, the first topic becomes
the first output file. If you specify a name for the first file, either
via TOC naming or via chunking, DITA2Go uses the name you specify;
in that case an empty file with the name of the original map is left
behind and can be ignored. Do not rename this file, because it
is required for subsequent conversions. DITA2Go names the rest
of the split files, and all extracted files, as follows:
- If there is a copy-to attribute on the
topicref in the map, the attribute value becomes the name of the file.
- If there is no copy-to attribute:
- If chunking is specified, DITA2Go
derives a name from the topic ID of the affected topic.
- If chunking is not specified,
the file gets a name that begins with xx and ends with a three-
or four-digit internally assigned ID number.
Previous Topic: 27.5 Identifying
split and extract files
Next Topic: 27.5.2 Specifying
page titles for split or extract files
Parent Topic: 27.5 Identifying
split and extract files
Sibling Topics:
27.5.2 Specifying
page titles for split or extract files
27.5.3 Supplying
<meta> text for split or extract files