How to contribute to Plone core translations

Description

How to contribute to the Plone translations.

Introduction

You need to have write access to https://github.com/collective/plone.app.locales to be able to commit your translation directly. You can also update a po file online and make a pull request.

Updating translations for Plone 4.2

To do.

Updating translations for Plone 4.3

If you want to test your latest translation with unreleased packages containing i18n fixes for Plone 5, get the buildout like this:

git clone -b 4.2 git://github.com/plone/buildout.coredev.git
cd buildout.coredev
python2.7 bootstrap.py
bin/buildout -c experimental/i18n.cfg
rm .mr.developer.cfg
ln -s experimental/.mr.developer.cfg
bin/instance fg

To update the buildout later:

git pull
bin/develop up -f

To update your translation, you can go there:

cd src/plone.app.locales/plone/app/locales/

Here you have the following directories:

  • locales used for core Plone translations.
  • locales-addons used for some addons packages.
  • locales-future used for Plone 5 packages. The po files can change really often. The translations will normally be merged to the locales directory when Plone 5 will be released. This directory is not included in plone.app.locales 4.x releases. For developers: if you want to add a Plone 5 package to this directory, you can add it to the plone5 variable in experimental/i18n.cfg, don’t forget to add a line in [sources] if it’s missing.

Open the po file with poedit, kbabel or any other i18n tool. For example for French:

poedit locales/fr/LC_MESSAGES/plone.po

Please do a git pull before editing a po file to be sure you have the latest version.

Committing directly (commit access)

You can commit your translation from this locales directory:

git commit -a -m "Updated French translation"
git push

Creating a pull request (no commit access)

If you do not have commit access on GitHub collective group. you can do the following:

Login to GitHub. Go to GitHub plone.app.locales

Press Fork. Now GitHub creates a copy of plone.app.locales package for you.

Then on your computer in plone.app.locales do a special git push to your own repository:

git push git@github.com:YOURUSERNAMEHERE/plone.app.locales.git

Go to GitHub https://github.com/YOURUSERNAME/plone.app.locales

Press button Create Pull request. Fill it in.

The request will appear for plone.app.locales authors. If it does not get merged in timely manner, poke people on the #plone IRC channel or the mailing list below (sometimes requests go unnoticed).

Support

Please ask questions on the plone-i18n mailing-list.