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



---------- ----------


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. 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. language family of the language being specified in the voice files.
See also Wikipedia's See also Wikipedia's
[List of language families](https://en.wiktionary.org/wiki/Wiktionary:List_of_families) [List of language families](https://en.wiktionary.org/wiki/Wiktionary:List_of_families)


name <name> name <name>


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


### language ### language


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

language <language code> [<priority>] language <language code> [<priority>]


_or_

language variant

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


and sets default values for "phonemes", "dictionary" and other and sets default values for "phonemes", "dictionary" and other
attributes. 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 [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 list of valid tags originate from various standards and have been combined
into the into the

Loading…
Cancel
Save