Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Transifex integration and documentation for translations #352

Merged
merged 4 commits into from
Jan 3, 2021
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions .tx/config
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
[main]
host = https://www.transifex.com

[terminator.po-terminator-pot--master]
file_filter = po/<lang>.po
minimum_perc = 0
source_file = po/terminator.pot
source_lang = en
type = PO

3 changes: 2 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
6 changes: 6 additions & 0 deletions RELEASE.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
52 changes: 52 additions & 0 deletions TRANSLATION.md
Original file line number Diff line number Diff line change
@@ -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
Loading