Transformer documentation: int_daisy_mixedContentNormalizer

Transformer Purpose

• Normalize mixed content models as a step towards making the text nodes of an xml document suitable for a DTB context.
• Optionally add synchronization marker attributes that indicate positions in the XML document that would server well as SMIL text targets.

Input Requirements

Any XML document. The normalization process can be specialized and optimized for particular namespaces; however, the routine can be applied to arbitrary namespaces as well, albeit with non-predictable results.

Encounters of namespaces unrecognized to the normalizer will yield a warning: support for new namespaces are given an XML configuration file, see extended configurability

Output

On success

An XML document with any mixed content siblings normalized by means of inserted "wrapper" elements.

On error

On error, this transformer will send a fatal message, then throw an exception and abort.

Configuration/Customization

Parameters (tdf)

input

Input XML file

output

Output XML file; can be same as input file

addSyncPoints

Whether to add sync point marker attributes

implementation

name of implementation to use, defaults to dom.

Extended configurability

Customizing the DOM-based normalizers behavior

The xml file int_daisy_mixedContentNormalizer/dom/DOMConfig.xml contains per-namespace configuraton options. See inline comments for further details.

Further development

Dependencies

Apache Xerces, or any DOM3LS compliant parser.

Author

Markus Gylling

Licensing

LGPL