diff --git a/docs/add_language.html b/docs/add_language.html index 7b400844..8bce53f4 100644 --- a/docs/add_language.html +++ b/docs/add_language.html @@ -22,15 +22,14 @@ syllables within words. Some languages are easier than others. I expect most are

  • Improve the sounds of the phonemes. It may be that a phoneme should sound different depending on adjacent sounds, or whether it's at the start or the end of a word, between vowels, etc. This may consist of making small adjustments to vowel and diphthong quality, or adjusting the strength of consonants. Bigger changes may be recording new or replacement consonant sounds, or even writing program code to implement new types of sounds. -

  • Marking some common words in the dictionary that should be unstressed (words such as "the", "is"), or should be preceded -by a short pause (such as "and", "but"), or have other attributes, in order to make the speech flow better. +

  • Some common words should be added to the dictionary (the *_list file for the language) with an "unstressed" attribute (eg. in English, words such as "the", "is", "had", "my", "she", "of", "in", "some"), or should be preceded +by a short pause (such as "and", "but", "which"), or have other attributes, in order to make the speech flow better.

  • Improve the rhythm of the speech by adjusting the relative lengths of vowels in different contexts, eg. stressed/unstressed syllable, or depending on the following phonemes. This is important for making the speech sound good for the language.

  • Identify or implement new functions in the program to improve the speech, or to deal with characteristics of the language which are not currently implemented. For example, a different intonation module. -If you are interested in working on a language, please contact me to set up the initial data and to -discuss the features of the language. +If you are interested in working on a language, please contact me so that I can set up the initial data and discuss the features of the language.

    For most of the eSpeak voices, I do not speak or understand the language, and I do not know how it should sound. I can only make improvements as a result of feedback from speakers of that language. If you want to help to improve a language, listen carefully and try to identify individual errors, either in the spelling-to-phoneme translation, the position of stressed syllables within words, or the sound of phonemes, or problems with rhythm and vowel lengths.

    @@ -90,11 +89,11 @@ marked as "unstressed" in order to make the speech flow better. These words generally include articles (eg: a, the, this, that), auxillary verbs (eg: is, have, will, can, may), pronouns and possessive adjectives (eg: he, his), some common prepositions (eg: -of, to, in, of), some common conjunctions (eg. and, or, if)., some +of, to, in, of), some common conjunctions (eg. and, or, if), some common adverbs and adjectives (eg. any, already)

    $pause Some words should be marked to have a short pause before then, in order to produce natural pauses in long sentences. -These include conjunctions (eg. and, or, but, however) and perhaps +These include conjunctions (eg. and, or, but, however, which) and perhaps some prepositions.

    6.4 Voice File

    @@ -122,12 +121,8 @@ language code and the required options in SetTranslator(). However, this may not be necessary during testing because most of the options can also be set from the voice file in espeak-data/voices.

    -

    If necessary, you can define a new -translator class for a language, and select this in the -SetTranslator() function. This inherits the standard functions -from the base translator class, but allows you to replace these where -needed by new functions which are written specially for this -language.

    + + \ No newline at end of file diff --git a/docs/commands.html b/docs/commands.html index 8e3ee35c..3e2f27fd 100644 --- a/docs/commands.html +++ b/docs/commands.html @@ -99,6 +99,10 @@ of 190. Range 80 to 390.
    Word gap. This option inserts a pause between words. The value is the length of the pause, in units of 10 mS (at the default speed of 170 wpm).

    +-h or --help
    +
    The first line of output gives the eSpeak version number. +

    +

    -k <integer>
    Indicate words which begin with capital letters.

    1   eSpeak uses a click sound to indicate when a word starts with a capital letter, or double click if word is all capitals.

    @@ -164,6 +168,14 @@ Compile the pronunciation rule and dictionary lookup data from their source file

    The same as --compile, but source line numbers from the *_rules file are included. These are included in the rules trace when the -X option is used.

    +

    --path [="<directory path>"]
    +
    +Specifies the directory which contains the espeak-data directory. +

    +

    --phonout [="<filename>"]
    +
    +If specified, mbrola phoneme data, and also the output from -x and -X options is written to this file, rather than stdout. +

    --punct [="<characters>"]
    Speaks the names of punctuation characters when they are encountered in the text. If <characters> are given, then only those listed punctuation characters are spoken, eg. --punct=".,;?" @@ -190,8 +202,10 @@ If the -m option is used to indicate marked-up text, then HTML can be spoken dir
    Phoneme Input
    As well as plain text, phoneme mnemonics can be used in the text input to espeak. They are enclosed within double square brackets. Spaces are used to separate words and all stressed syllables must be marked explicitly.

    -   eg:   espeak -v en [[D,Is Iz sVm f@n'EtIk t'Ekst 'InpUt]]

    - ("This is some phonetic text input"). +   eg:   espeak -v en "[[D,Is Iz sVm f@n'EtIk t'Ekst 'InpUt]]"

    + This command will speak: "This is some phonetic text input". + + diff --git a/docs/dictionary.html b/docs/dictionary.html index 22034028..a7fc0957 100644 --- a/docs/dictionary.html +++ b/docs/dictionary.html @@ -73,7 +73,7 @@ The utility 'phonemes' are: It is not necessary to specify the stress of every syllable. Stress markers are only needed in order to change the effect of the language's default stress rule.

    -The phonemes which are used to represent a language's sounds are based on the Kirshenbaum ascii character representation of the International Phonetic Alphabet www.kirshenbaum.net/IPA/ascii-ipa.pdf +The phonemes which are used to represent a language's sounds are based loosely on the Kirshenbaum ascii character representation of the International Phonetic Alphabet www.kirshenbaum.net/IPA/ascii-ipa.pdf

     

    4.3 Pronunciation Rules

    @@ -94,7 +94,7 @@ The rules are organized in groups, each starting with a ".group" line: A group for other characters which don't have their own group.

    .L<nn>
    - Defines a group of letter sequences, any of which can match with Lnn in a post rule (see below). nn is a 2 digit decimal number in the range 01 to 20. eg:

    + Defines a group of letter sequences, any of which can match with Lnn in a post rule (see below). nn is a 2 digit decimal number in the range 01 to 25. eg:

    .L01 b bl br pl pr

    .replace
    @@ -249,7 +249,7 @@ Note, that matching characters in the <pre> part do not affect the syllabl T - Only use this rule if the word in found in the *_list file with the $alt1 attribute. + Only use this rule if the word in found in the *_list file with the $alt attribute. # @@ -352,6 +352,7 @@ or to run them together, pronounced as a single word or to give them a flag when they occur together 
        (such as)    sVtS||a2z   $pause	   // precede with a pause
    +Hyphenated words in the <language>_list  file must also be enclosed within brackets, because the two parts are considered as separate words.

    4.4.2 Special characters in <phoneme string>: