The “DAISY 2.02 to EPUB 3” script will convert a DAISY 2.02 DTB (Digital Talking Book) into an EPUB 3 publication.
This page describes the steps, comments and issues related to this transformation.
This command will create two entries in the output directory. One is a folder called “epub”, which is a temporary directory created by the converter. The second is the resulting EPUB 3 file. The EPUB 3 file is given a name based on the dc:identifier and dc:title metadata elements from the original NCC; “dc:identifier - dc:title.epub”.
Outline
The high-level conversion workflow is as follows:
Get the SMIL-based reading order from the NCC
Load all the SMILs and upgrade them to EPUB 3 Media Overlays
Extract content document references from each SMIL
Make a content-based reading order
Load all the content documents, upgrade them to EPUB 3 Content Documents
If mediaoverlay = ‘true’
Rearrange the Media Overlays to match the Content Documents
Get all referenced audio, images, etc.
Make the EPUB 3 Navigation Document based on the NCC
Make the EPUB 3 Package Document
Store the EPUB 3 Publication in a OCF ZIP Container
Errors
This is a list of defined errors for this script. Each error has a unique error code for easy identification.
PDE01: href must be a valid URI. In practice this simply means that the path must be prefixed with “file://”, and in Windows, all directory separators () must be replaced with forward slashes (/).
PDE02: output must be a valid URI. In practice this simply means that the path must be prefixed with “file://”, and in Windows, all directory separators () must be replaced with forward slashes (/).
PDE03: When given, mediaoverlay must be either “true” (default) or “false”.
PDE04: When given, compatibility-mode must be either “true” (default) or “false”.