mirror of
https://github.com/rhasspy/espeak-ng.git
synced 2026-11-20 19:21:57 +00:00
docs: issue #647 create docs/contribution.md and update other documents
This commit is contained in:
@@ -0,0 +1,54 @@
|
||||
# Contribution Guide
|
||||
|
||||
- [Simple steps for your feedback](#simple-steps-for-your-feedback)
|
||||
- [Steps for your contribution](#steps-for-your-contribution)
|
||||
|
||||
## Simple steps for your feedback
|
||||
|
||||
<a class="anchor" id="simplestep1">1. As eSpeak NG is open source software, you can get it working from many different sources, some of which may provide quite
|
||||
old version. Before registering new issue, test that issue can be reproduced with latest development version at
|
||||
[eSpeak NG online](https://odo.lv/Espeak) site.
|
||||
|
||||
<a class="anchor" id="simlestep2">2. Review known [eSpeak NG issues](https://github.com/espeak-ng/espeak-ng/issues), particularly about
|
||||
[languages](https://github.com/espeak-ng/espeak-ng/labels/languages%2Fpronunciation) and add your comments
|
||||
on existing issues. If necessary add new issue as described [here](https://help.github.com/en/articles/creating-an-issue).
|
||||
|
||||
<a class="anchor" id="simlestep3">3. Look at and subscribe to [eSpeakNG mailing list](https://groups.io/g/espeak-ng)
|
||||
to view and discuss other related topics.
|
||||
|
||||
## Steps for your contribution
|
||||
<a class="anchor" id="step1">1. Get familiar with [additive speech synthesis](https://en.wikipedia.org/wiki/Additive_synthesis).
|
||||
|
||||
<a class="anchor" id="step2">2. Create fork of [espeak-ng](https://github.com/espeak-ng/espeak-ng) repository as it is described [here](https://help.github.com/en/articles/fork-a-repo).
|
||||
|
||||
<a class="anchor" id="step3">3. [Clone](https://help.github.com/en/articles/cloning-a-repository) and set up your development environment [on your computer](building.md) , or clone it [online](https://odo.lv/EspeakGuide).
|
||||
|
||||
<a class="anchor" id="step4">4. Get familiar with [text to phoneme translation](dictionary.md) and how to [add or improve language](add_language.md).
|
||||
|
||||
<a class="anchor" id="step5">5. Get familiar with [voice files](voices.md) and [phoneme tables](phontab.md) configuration files.
|
||||
|
||||
<a class="anchor" id="step6">6. Make your improvements (i.e. additions or modifications) and check your project with `make check` command. Fix issues if necessary.
|
||||
|
||||
<a class="anchor" id="step7">7. If you contribute to an existing language, find language maintainer in language configuration file located in `espeak-ng-data/lang` folder[<sup>1</sup>](#1) and ask him to review your changes. If you can't find language maintainer, you can review list of all contributors[<sup>2</sup>](#2) and contact them. You can also volunteer to become language maintainer just by updating language configuration file.
|
||||
|
||||
<a class="anchor" id="step8">8. [Push your changes to GitHub](https://help.github.com/en/articles/pushing-commits-to-a-remote-repository) and create [pull request](https://help.github.com/en/articles/creating-a-pull-request). You can also send changed files by email to [eSpeakNG mailing list](https://groups.io/g/espeak-ng) (but then inlusion of them may take more time).
|
||||
|
||||
<a class="anchor" id="step9">9. Wait for feedback of current espeak-ng maintainers[<sup>3</sup>](#3).
|
||||
|
||||
<a class="anchor" id="step10">10. If you feel ready to take responsibility, ask existing maintainers to become promoted as a maintainer of the project.
|
||||
|
||||
----
|
||||
|
||||
<a class="anchor" id="1"></a>1. You can get list of all language maintainers with following commands in your `espeak-ng` folder:
|
||||
|
||||
```
|
||||
cd espeak-ng-data;grep -ri -A2 -B2 maintainer *
|
||||
```
|
||||
|
||||
<a class="anchor" id="2"></a>2. You can get list of all contributors with following commands in your `espeak-ng` folder:
|
||||
|
||||
```
|
||||
git log --pretty="%an %ae%n%cn %ce" | sort|uniq -c|sort -nr
|
||||
```
|
||||
<a class="anchor" id="3"></a>3. Currently eSpeak NG is maintained only by volunteers in their free time, therefore expected reaction time is one, two weeks.
|
||||
|
||||
+5
-3
@@ -1,12 +1,14 @@
|
||||
# eSpeak NG: Speech Synthesizer
|
||||
# eSpeak NG online documentation
|
||||
|
||||
- User Guide
|
||||
- [espeak-ng Command Line](../src/espeak-ng.1.ronn)
|
||||
- [speak-ng Command Line](../src/speak-ng.1.ronn)
|
||||
- [Supported Languages](languages.md)
|
||||
- [SSML and HTML Support](markup.md)
|
||||
- [Contributor Guide](contributing.md)
|
||||
- [Building eSpeak NG](building.md)
|
||||
- Creating and Editing Languages and Voices
|
||||
- [Adding or Improving a Language](add_language.md)
|
||||
- [Adding or Improving a Language](add_language.md)
|
||||
- [Text to Phoneme Translation](dictionary.md)
|
||||
- [Numbers](numbers.md)
|
||||
- [Voice Files](voices.md)
|
||||
@@ -15,10 +17,10 @@
|
||||
- [Intonation](intonation.md)
|
||||
- Phonemes
|
||||
- [Phoneme Features and the International Phonetic Alphabet](phonemes.md)
|
||||
- [Phoneme Model](phoneme_model.md)
|
||||
- [Kirshenbaum (ASCII-IPA) Transcription Scheme](phonemes/kirshenbaum.md)
|
||||
- [X-SAMPA Transcription Scheme](phonemes/xsampa.md)
|
||||
- [Conlang X-SAMPA Transcription Scheme](phonemes/cxs.md)
|
||||
- [Phoneme Model](phoneme_model.md)
|
||||
- Pronunciation Guides
|
||||
- [English](languages/gmw/en.md)
|
||||
- [License](../COPYING)
|
||||
|
||||
Reference in New Issue
Block a user