diff --git a/README.md b/README.md index 8d500b9e..d82d80cc 100644 --- a/README.md +++ b/README.md @@ -65,7 +65,8 @@ Any help is welcome with the Terminator project. * [Open issues for bugs or enhancements](https://github.com/gnome-terminator/terminator/issues/new) * [Join our chat room on gitter.im for general questions](https://gitter.im/gnome-terminator/community) -* +* [Help translating Terminator](TRANSLATION.md) + You can find old bugs and questions in the launchpad project, but please don't post anything new there. * https://answers.launchpad.net/terminator diff --git a/RELEASE.md b/RELEASE.md index ff1c5e5a..99bc0660 100644 --- a/RELEASE.md +++ b/RELEASE.md @@ -26,6 +26,12 @@ dos2unix CHANGELOG.md Check and review CHANGELOG.md for the expected result. +## Review and update translations + +Check for open pull-requests by Transifex or pull the files manually. + +See [TRANSLATION](TRANSLATION.md). + ## Update AUTHORS This will make sure we mention everyone that has contributed to Terminator. diff --git a/TRANSLATION.md b/TRANSLATION.md new file mode 100644 index 00000000..8a6c9e12 --- /dev/null +++ b/TRANSLATION.md @@ -0,0 +1,52 @@ +# Translation + +Terminator has been translated to multiple languages and locales, but there is always +work to do, so everyone is welcome to help and contribute. + +You can find all translations under the `po` directory, which will be compiled and +installed with Terminator. + +Translations are managed on Transifex [transifex.com/terminator], +anyone is free to join the project and start translating. + +You should read the [Getting Started as a Translator] guide. + +_Questions or problems?_ Please reach out on [Gitter] or [open an issue]. + +## Updating POT + +The POT file is the template for all translations and is generated from the Python +source code. + + cd po/ + ./genpot.sh + git diff terminator.pot + +To generate and handle POT and PO files, you will need at least `gettext` and `intltool` installed. + +Usually the POT file is automatically synced to Transifex, but it can be manually pushed: + + tx push --source + +## Updating Translations + +Transifex is configured to automatically open a pull-request when a language has been +fully translated. A manual update is always possible and might be useful when preparing +a release. + + tx pull --all + +You can also push translations changed outside of Transifex back to the service: + + tx push --translations --language XX + +## External Documentation + +* [Getting Started as a Translator] +* [Transifex CLI Client](https://docs.transifex.com/client/introduction) +* [Documentation Overview](https://docs.transifex.com/) + +[Gitter]: https://gitter.im/gnome-terminator/community +[open an issue]: https://github.com/gnome-terminator/terminator/issues/new/choose +[transifex.com/terminator]: https://www.transifex.com/terminator/terminator/dashboard/ +[Getting Started as a Translator]: https://docs.transifex.com/getting-started-1/translators