Transformer documentation: se_tpb_syncpointNormalizer

Transformer Purpose

This transformer performs synchronization point normalization on a XML document. It is used as a step in the Narrator transformer chain, making sure each synchronization point in a DTBook file is contained in its own XML element. For example, the transformer inserts <span> elements around the text nodes before and after an inline <pagenum> element.

Input Requirements

The transformer has only been tested with DTBook documents created while running the Narrator transfomer chain. While the transformer is able to detect the document type and use different configuration files, there is only support for DTBook documents having sentence level markup.

Output

On success

A document where each synchronization point is a separate XML element, making it possible to represent each synchronization point as a fragment i SMIL.

On error

On error, this transformer will throw an exception and abort execution.

Configuration/Customization

Parameters (tdf)

input

The input XML document.

output

The output XML document.

Further development

• Support for compound XML documents.
• Support for different synchronization levels (word, sentence, paragraph, level).

Dependencies

The transformer uses StAX for XML processing.

Author

Linus Ericson, TPB

Licensing

LGPL