Skip to content

Implementation-dependent features

For certain features, the DITA specification allows conforming processors to choose between different implementation alternatives. In these cases, there may be differences in behavior when DITA content is handled by different processors. DITA-OT supports implementation-specific features by applying one or more of the permissible processing approaches.

Chunking

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.

Note: 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.
  • When an unrecognized chunking method is used, no error or warning is thrown.

Filtering

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

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

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

When a topicref element that references a map contains child topicref elements, the DOTX068W error is thrown and the child topicref elements are ignored.

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

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

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 Character set definition.