Transforms a ZedAI (DAISY 4 XML) document into an EPUB 3 publication.
Top-level sections in the ZedAI become separate HTML files in the resulting EPUB, and are further split up if they exceed the given maximum size.
-1
Must be a space separated list of URIs, absolute or relative to the input.
Style sheets specified through this option are called “user style sheets”. Style sheets can also be attached to the source document. These are referred to as “author style sheets”. They can be linked (using an ‘xml-stylesheet’ processing instruction or a ‘link’ element), embedded (using a ‘style’ element) and/or inlined (using ‘style’ attributes). Only author styles that apply to “speech” media are taken into account.
All style sheets are applied at once, but the order in which they are specified has an influence on the cascading order. Author styles take precedence over user styles.
Must be a space separated list of URIs, absolute or relative to the input.
Lexicons can also be attached to the source document, using a ‘link’ element.
PLS lexicons allow you to define custom pronunciations of words. It is meant to help TTS processors deal with ambiguous abbreviations and pronunciation of proper names. When a word is defined in a lexicon, the processor will use the provided pronunciation instead of the default rendering.
The syntax of a PLS lexicon is defined in Pronunciation Lexicon Specification (PLS) Version 1.0, extended with regular expression matching. To enable regular expression matching, add the “regex” attribute, as follows:
<lexicon xmlns="http://www.w3.org/2005/01/pronunciation-lexicon" version="1.0"
alphabet="ipa" xml:lang="en">
<lexeme regex="true">
<grapheme>([0-9]+)-([0-9]+)</grapheme>
<alias>between $1 and $2</alias>
</lexeme>
</lexicon>
The regex feature works only with alias-based substitutions. The regex syntax used is that from XQuery 1.0 and XPath 2.0.
Whether or not the regex attribute is set to “true”, the grapheme matching can be made more accurate by specifying the “positive-lookahead” and “negative-lookahead” attributes:
<lexicon version="1.0" xmlns="http://www.w3.org/2005/01/pronunciation-lexicon"
alphabet="ipa" xml:lang="en">
<lexeme>
<grapheme positive-lookahead="[ ]+is">SB</grapheme>
<alias>somebody</alias>
</lexeme>
<lexeme>
<grapheme>SB</grapheme>
<alias>should be</alias>
</lexeme>
<lexeme xml:lang="fr">
<grapheme positive-lookahead="[ ]+[cC]ity">boston</grapheme>
<phoneme>bɔstøn</phoneme>
</lexeme>
</lexicon>
Graphemes with “positive-lookahead” will match if the beginning of what follows matches the “position-lookahead” pattern. Graphemes with “negative-lookahead” will match if the beginning of what follows does not match the “negative-lookahead” pattern. The lookaheads are case-sensitive while the grapheme contents are not.
The lexemes are matched in this order:
Within these categories, lexemes are matched in the same order as they appear in the lexicons.
p:system-property('d:org.daisy.pipeline.tts.default-lexicon')
The TTS log contains a great deal of additional information that is not present in the main job log and that is helpful for troubleshooting. Most of the log entries concern particular chunks of text of the input document.
The default can be changed using the
org.daisy.pipeline.tts.log
property.
true
or false
p:system-property('d:org.daisy.pipeline.tts.log')
true
or false
false
Usage: dp2 [GLOBAL_OPTIONS] zedai-to-epub3 [OPTIONS] Options:
--source source | Input ZedAI. |
--tts-config tts-config | Configuration file for text-to-speech. |
--_:chunk-size [_:chunk-size] | Chunk size (default: -1 ) |
--_:stylesheet [_:stylesheet] | Style sheets (default: ) |
--lexicon [lexicon] | Lexicons (default: p:system-property('d:org.daisy.pipeline.tts.default-lexicon') ) |
--include-tts-log [include-tts-log] | Enable TTS log (default: p:system-property('d:org.daisy.pipeline.tts.log') ) |
--audio [audio] | Enable text-to-speech (default: false ) |
-o,--output [OUTPUT] | Path where to store the results. This option is mandatory when the job is not executed in the background |
-z,--zip | Write the output to a zip file rather than to a folder |
-n,--nicename [NICENAME] | Set job's nice name |
-r,--priority [PRIORITY] | Set job's priority (high|medium|low) |
-q,--quiet | Do not print the job's messages |
-p,--persistent | Delete the job after it is executed |
-b,--background | Sends the job and exits |