--- a/hugo/content/about/supported-languages.md Fri Jul 16 15:34:01 2021 -0500
+++ b/hugo/content/about/supported-languages.md Fri Jul 16 16:23:41 2021 -0500
@@ -7,7 +7,7 @@
The list below contains all the languages Pidgin has been translated into. If
your native language is missing from this list or you've found a translation
-contains errors, you can help us! Take a look at our [tips for translators
-page]({{< ref "development/i18n/tips" >}}).
+contains errors, you can help us! Take a look at our [internationalization]({{< +ref "development/i18n" >}}) page. --- a/hugo/content/development/i18n/_index.md Fri Jul 16 15:34:01 2021 -0500
+++ b/hugo/content/development/i18n/_index.md Fri Jul 16 16:23:41 2021 -0500
@@ -1,6 +1,100 @@
title: Internationalization
date: 2019-01-15T05:58:46.000Z
+ - developer.pidgin.im/wiki/TipsForTranslators lastmod: 2019-01-21T22:34:09.000Z
+Pidgin is used widely across the globe, so having proper +internationalization/translations of the different strings that are displayed in +it is quite important. As no single person can speak all the different languages +in the world, we require the help of our community to help us and take care of +translating Pidgin to the language they know. +## The platforms we use for translations +* Currently Pidgin uses [Transifex](https://www.transifex.com/projects/p/pidgin) + as the platform to manage the translation of the different strings it has. + We do acknowledge that some may be opposed to using Transifex, so even if + that's our preferred way of handling translations you can still choose to + [create a new issue]({{< param "pidginIssuesURL" >}}) and attach your + translation file to it. Please remember to provide your full name, a contact + email address, and the language and country code for the translation you are +* The [translators mailing list](https://lists.pidgin.im/listinfo/translators) + is the recommended channel for translator communications. +## Submitting translations +Our translations are provided by volunteers. To improve consistency and quality +we prefer to have a designated person or group of people maintain each +If Pidgin already has a translation for your language, please contact the +designated translator(s) and ask if you can help. It's possible they are looking +for someone to take over. You can find their email address in Pidgin's +*Help→Translator Information* window. Or, for some languages you can try +contacting the translator(s) via +[Transifex](https://www.transifex.com/projects/p/pidgin/). +If you're unable to contact the designated translator(s) or if Pidgin does not +yet have a translation for your language, email the [translators mailing +list](https://lists.pidgin.im/mailman/listinfo/translators) and ask if anyone is +already working on translating that language. If you are the first one working +on that language, the Pidgin team will guide you on how to set things up in +## Translation statistics +You can see the current translation statistics at +[Transifex](https://www.transifex.com/projects/p/pidgin). Over there you will be +able to find all the languages that Pidgin has been translated to and the +coverage of those translations. +## How translation updates are handled +* Each language will have a current translator assigned to it, a volunteer that + leads the translation effort of the Pidgin strings for this particular +* Current translators are always listed in Pidgin's Translator Information + dialog (*Help → Translator Information* from Pidgin's Buddy List window) by + name, and each translator's e-mail address is included. Because of this, we + need current translators to inform us if their e-mail address changes. +* Translation updates for each language are accepted **only** from its current + translator, except when: + * The current translator wishes to retire from translating Pidgin and has + notified the Pidgin Developers. + * The current translator has not submitted an update for at least one year and + does not respond to inquiries. + * The current translator tells us to accept the update and/or treat a new + translator as a co-maintainer of the translation. + * We become aware through verifiable means that the current translator has + We do this to minimize confusion among users--we've found over time that some + translators will choose different ways to translate a given word or phrase, + which inevitably confuses users. We apologize for any inconvenience this may + cause, but we believe that following these rules makes translations better for + If you find yourself in this situation, use the [translators mailing + list](https://lists.pidgin.im/listinfo/translators) or [contact us]({{< ref + "contact" >}}) so that we can evaluate it and make a decision. +## How translations go from Transifex to Pidgin +If you look at the [Pidgin repository](https://keep.imfreedom.org/pidgin/pidgin) +and browse its contents, you'll find a directory called `po`. In it we store all +the different translations, each one in its own `.po` file. +Once the Pidgin Developers team agrees that a new Pidgin release is almost ready +to go and that no new strings will be added or changed, an email will be sent to +the [translators mailing list](https://lists.pidgin.im/listinfo/translators) +stating so. That way, translators are made aware that they need to check if +strings in the language they maintain need to be updated or added. For more +details on this process, check out our [release process]({{< ref +"development/release-process" >}}) page. --- a/hugo/content/development/i18n/tips.md Fri Jul 16 15:34:01 2021 -0500
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,98 +0,0 @@
----
-title: Tips
-date: 2019-01-15T05:58:46.000Z
- - developer.pidgin.im/wiki/TipsForTranslators
-lastmod: 2019-08-21T04:05:48.000Z
----
-### Can I help translate?
-Yes! Our translations are provided by volunteers. To improve consistency and
-quality we prefer to have a designated person or group of people maintain each
-If Pidgin already has a translation for your language, please contact the
-designated translator(s) and ask if you can help. It's possible they are looking
-for someone to take over. You can find their email address in Pidgin's
-Help→Translator Information window. Or, for some languages you can try
-contacting the translator(s) via
-[Transifex](https://www.transifex.com/projects/p/pidgin/).
-If you're unable to contact the designated translator(s) or if Pidgin does not
-yet have a translation for your language, email the [translators mailing
-list](https://lists.pidgin.im/mailman/listinfo/translators) and ask if anyone
-is already working on translating that language.
-### When should I submit a translation update?
-The translations are shipped with each Pidgin release, so there is no great
-advantage to submitting a translation multiple times during a release cycle. We
-announce a string freeze on the [translators mailing
-list](https://lists.pidgin.im/mailman/listinfo/translators) before each
-release. This is a promise to you that we will not add any new strings or change
-any existing ones. During this time you should finish translating any new
-strings and submit a new translation to us.
-### Where should I submit a translation update?
-The preferred method for submitting updated translations is via
-[Transifex](https://www.transifex.com/projects/p/pidgin/). If you're the
-designated translator for your language then you can request to create a new
-language team for your language in Transifex (and please also send an email to
-the [translators mailing
-list](https://lists.pidgin.im/mailman/listinfo/translators) and let us know!).
-If you're opposed to using Transifex there are two other methods you could use
-to send us translations. These cause slightly more overhead for us, so we try to
- 1. By [creating a new ticket](https://pidgin.im/newissue) and
- attaching your translation file. Please provide your full name, a contact
- email address, and the language and country code for your translation
- 1. Or you can ask a Pidgin developer to give you commit access directly to our
- version control system, then commit the translation yourself. Before you commit
- a translation update, please strip line numbers from the .po file by running
- `XGETTEXT_ARGS=--no-location intltool-update LL`. This makes the diff smaller
- and more human-friendly.
-### Translation Stats and a .pot File
-You can see the current translation statistics at
-https://developer.pidgin.im/l10n/. There is also a link to the nightly version
-of the pidgin.pot at the bottom of the page. The .pot file includes the strings
-from our Windows installer. Providing a full translation of this file
-automatically ensures that Windows users will be able to have a translated
-installer for their convenience.
-### How Pidgin Handles Translation Updates
- * Current translators are always listed in Pidgin's About dialog (Help →
- About from Pidgin's Buddy List window) by name, and each translator's e-mail
- address is included. Because of this, we need current translators to inform
- us if their e-mail address changes.
- * Translation updates for each language are accepted ***only*** from its
- current translator, except when:
- * The current translator has told us he/she wishes to retire from
- * The current translator has not submitted an update for at least one year
- and does not respond to inquiries.
- * The current translator tells us to accept the update and/or treat a new
- translator as a co-maintainer of the translation.
- * We become aware through verifiable means that the current translator has
-In short, this means that if you are not the current translator for a specific
-language, we will not normally accept the translation update from you, except as
-described above. We do this to minimize confusion among users--we've found over
-time that some translators will choose different ways to translate a given word
-or phrase, which inevitably confuses users. We apologize for any inconvenience
-this may cause, but we believe that following these rules makes translations
-* [Transifex](https://www.transifex.com/projects/p/pidgin/)
-* [Translation statistics](https://www.transifex.com/pidgin/pidgin/)
-* [Our translators mailing list](https://lists.pidgin.im/mailman/listinfo/translators)