Browse Source

docs: add more details about language vs voice settings

master
Valdis Vitolins 4 years ago
parent
commit
52246c4043
1 changed files with 21 additions and 6 deletions
  1. 21
    6
      docs/voices.md

+ 21
- 6
docs/voices.md View File

@@ -34,12 +34,16 @@

----------

A Voice file specifies a language (and possibly a language variant or
dialect) together with various attributes that affect the
A voice file specifies a language (and possibly a language variant or
dialect or just voice) together with various attributes that affect the
characteristics of the voice quality and how the language is spoken.

Voice files are located in the `espeak-ng-data/voices` directory, and are
grouped by the [ISO 639-5](https://en.wikipedia.org/wiki/ISO_639-5)
Voice files are located in the `espeak-ng-data/` folder, and:

1. if it describes voice with language or dialect, in [lang](../../../tree/master/espeak-ng-data/lang) subfolder;
2. if it describes just voice, in [voices/!v](../../../tree/master/espeak-ng-data/voices/!v) subfolder.

Languages are grouped by the [ISO 639-5](https://en.wikipedia.org/wiki/ISO_639-5)
language family of the language being specified in the voice files.
See also Wikipedia's
[List of language families](https://en.wiktionary.org/wiki/Wiktionary:List_of_families)
@@ -55,12 +59,19 @@ without the need to specify a voice.

name <name>

A name given to this voice.
A mandatory name given to this voice.

### language

A mandatory identifier of the language or the voice. It can have one of
two options:

language <language code> [<priority>]

_or_

language variant

__NOTE:__ This attribute is mandatory and should appear before the other
attributes which are listed below.

@@ -68,7 +79,11 @@ It selects the default behaviour and characteristics for the language,
and sets default values for "phonemes", "dictionary" and other
attributes.

The \<language code\> is a valid
If value for `lanuguage` field is `variant`, then file describes only
phonetic features of the voice and it can be used as a [...+variant](../src/espeak-ng.1.ronn)
option for any language.

If `language` identifies actual language, then \<language code\> should be a valid
[BCP 47](https://en.wikipedia.org/wiki/IETF_language_tag) language tag. The
list of valid tags originate from various standards and have been combined
into the

Loading…
Cancel
Save