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.3

If you want to test your latest translation with unreleased packages containing i18n fixes for Plone 4, 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.