mjohnson/espeak-ng
1
0
Fork 0
mirror of https://github.com/rhasspy/espeak-ng.git synced 2026-10-31 05:35:35 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: add more details about language vs voice settings

Browse Source
This commit is contained in:
Valdis Vitolins
2020-10-21 22:32:57 +03:00
parent ee6d474e75
commit 52246c4043
1 changed files with 21 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/voices.md
+21 -6
View File
@@ -34,12 +34,16 @@
---------- ----------
A Voice file specifies a language (and possibly a language variant or A voice file specifies a language (and possibly a language variant or
dialect) together with various attributes that affect the 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 Voice files are located in the `espeak-ng-data/` folder, and:
grouped by the [ISO 639-5](https://en.wikipedia.org/wiki/ISO_639-5)
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)
@@ -55,12 +59,19 @@ without the need to specify a voice.
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.
@@ -68,7 +79,11 @@ It selects the default behaviour and characteristics for the language,
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