Chunking
chunk
supported methods
chunk
error recovery
DITA content can be divided or merged into new output documents in different ways, depending on the value of
the chunk attribute.
DITA-OT supports the following chunking methods:
- select-topic
- select-document
- select-branch
- by-topic
- by-document
- to-content
- to-navigation.
When no chunk attribute values are given, no chunking is performed.
For HTML-based transformation types, this is effectively equivalent to select-document and by-document
defaults.
Error recovery:
- When two tokens from the same category are used, no error or warning is thrown.This violates
DITA 1.2 spec.
- When an unrecognized chunking method is used, no error or warning is thrown.
Filtering
revprop
val
filters
duplicate conditions
Error recovery:
- When there are multiple revprop elements with the same val
attribute, no error or warning is thrown
- When multiple prop elements define a duplicate attribute and value combination, attribute default, or
fall-back behavior, the DOTJ007W warning is thrown.
Debugging attributes
debugging
attributes
xtrf
xtrc
xtrf
xtrc
The debug attributes are populated as follows:
- xtrf
- The XML trace filename is used to store the absolute system path of the original source document.
- xtrc
- The XML trace counter stores an element counter with the following format:
element-name ":" integer-counter ";" line-number ":" column-number
Image scaling
images
scaling
If both height and width attributes are given, the image is scaled non-uniformly.
If the scale attribute is not an unsigned integer, no error or warning is thrown during preprocessing.
Map processing
topicref
map processing
When a topicref element that references a map contains child
topicref elements, the DOTX068W error is thrown and the child
topicref elements are ignored.
Link processing
href
link processing
When the value of a hyperlink reference in the href attribute is not a valid URI reference,
the DOTJ054E error is thrown. Depending on the
processing-mode setting, error
recovery may be attempted.
Copy-to processing
shortdesc
copy-to
When the copy-to attribute is specified on a topicref, the content of
the shortdesc element is not used to override the short description of the topic.
Coderef processing
coderef
encoding
When coderef elements are used within code blocks to reference external files with
literal code samples, the system default character set is used as the target file encoding unless a different
character set is explicitly defined via the mechanisms described under
.