Translating Using Poedit

There are a few different options for translating WordPress, as outlined in the WordPress Codex. For this tutorial, we’re going to use Poedit, an easy to use open source program available for Mac OS X, Windows and UNIX/Linux.

1. Install Poedit.

2. Open Poedit and go to File > New catalog from POT file and select the POT in your theme’s languages folder.

3. A catalog properties box will pop up asking for information about what you are translating. Enter the language you want to translate here.

Enter the language you want to translate along with any other important details and hit “OK.”

 

4. After you hit “OK,” you’ll be asked what you want to name your translation file. The name is important and there’s a particular format you will need to follow. For example, if you’re translating Chinese for China, the file should be name zh_CH.po, and for a Tagalog translation for the Philippines would be tl_PH.po

Each language and country has a specific code you will need to use when saving translation files. This code indicates Tagalog for the Philippines.

Check out the GNU `gettext’ utilities to find your language and country codes.

Save your file in the languages folder of your theme.

5. Now you can start translating your theme. Poedit has a simple and straight forward interface that doesn’t involve a steep learning curve. The space at the top will display all the text ready to translate, and any completed translations will display to the right. The boxes underneath show the source text you’ve selected to translate, your translation and any notes for translators.

It’s easy to cycle through the text and enter your translations.

Translating a line of text is really easy – just select a word or phrase, enter your translation and click “Update.”

6. When you’ve finishing translating, simply save your file. Poedit will automatically create both .po and .mo files in your theme’s languages folder.

7. Now that your theme has been translated, you can upload it to your WordPress install either using FTP or by logging into your WordPress site and uploading your theme by going to Appearance > Themes > Install Themes (after you’ve zipped your theme, of course).

Setting Up Your Translated Theme in WordPress

As English is the default language for WordPress, you will need to play with a little code to force WordPress to use your translated files.

In order to do this, you will need to FTP into your WordPress install and open up the wp_config file and add this line of code:

1	define ('WPLANG', 'zh_CN');

This line specifies Chinese for China, so you’ll need to replace zh_CN with your language and country code.

Adding this line tells WordPress you want to use translation files for Chinese. Since you’ve translated only your theme and not your backend, your site will display in Chinese but your WordPress admin area will continue to display in English.

I’ll cover changing the default language for your WordPress backend in another post as part of this series this week.

Translation Tips

The WordPress Codex offers some solid tips for translation that anyone translating WordPress should keep in mind:

Don’t translate literally, translate organically: Languages have different structures, rhythms, tones, and inflections. Translated text don’t need to be structured the same way as the English ones: take the ideas that are presented and come up with a message that expresses the same thing in a natural way for the target language.

Try to keep the same level of formality (or informality):Try to accomplish the equivalent in the target language, within your cultural context.

Don’t use slang or audience-specific terms: Stay away from colloquialisms and to stick with what you think a new blogger would understand.

Read other software’s localizations in your language: If you get stuck or need direction, try reading through the translations of other popular software to get a feel for how they have tackled translations.