doc.transformers.int_daisy_dtbMigrator.html Maven / Gradle / Ivy
Transformer documentation: int_daisy_dtbMigrator
Transformer documentation: int_daisy_dtbMigrator
Transformer Purpose
Currently, this transformer migrates a valid DAISY 2.02 talking book to a Z39.86-2005 equivalent,
and only this forward migration is documented in this document.
At a later stage, it will also be possible to do a
Z39.86-2005 to DAISY 2.02 talking book backward migration.
Input Requirements
A valid DAISY 2.02 talking book. Please note that no validation of this book is performed before
transformation takes place,
so any problems during transformation or with the result of the process, might be due to
invalid input.
The content document(s) associated with the talking books must comply with the restrictions given for the XHTML to DTBook transformer,
see especially the section Requirements for the canonical form of the XHTML document.
Output
On success
A Z39.86-2005 file set that is hopefully valid. The output is automatically validated, so watch out for error reports.
On error
On error, this transformer will send a fatal message, then throw an exception and abort.
Configuration/Customization
Parameters (tdf)
- input
- Input DTB manifest (NCC, OPF)
- destination
- The output directory
- outputVersion
- The type of DTB to output
- inputType
DETECT, NCC_NCX_ONLY or TEXT.
The type of input DTB in terms of text (NCC/NCX only or Full/Partial Text).
Select DETECT to have an analysis determine the type. If any other value
is selected, it will win and the analysis will not be performed.
Default is DETECT.
- newIdentifier
- A unique identifier of the publication. If this value is set, it will override
and replace the value given in the input DTB. If this value is not set, the
identifier given in input DTB will be used in the output.
- outputCSS
- A CSS to use for output textual content files.
If this value is not set, a default CSS will be used.
- outputResourceFile
- A Resource file to use for output z3986 filesets.
If this value is not set, a default Resource file will be used.
- ncxAddNavLabelAudio
- Whether to create an audio element for each navLabel in the NCX. This
can be costly timewise, and the default behavior is off.
- ncxMinNavLabelAudioLength
- The minimum length (in millisec) for audioclips used in NavLabel elements.
- dtbookTransferNCCMetadata
- Whether to try to transfer metadata from the NCC file to the DTBook content document. The default behavior is not to transfer.
Extended configurability
None
Further development
Dependencies
XSLT 2.0 processor
Author
- Markus Gylling (TPB/DC)
- Brandon Nelson (CNIB)
- Per Sennels (Huseby)
- Linus Ericson (TPB)
Licensing
LGPL