DRAFT: This page is still a draft and being actively written. If you find an error, please comment below.

What is Poedit #

Poedit is a free program that you can use to write translations for any software or web site that uses Gettext for localization – like WordPress. WordPress uses PO files for everything: WordPress core, themes and plugins.

With Poedit you can upload a POT file with the original WordPress strings and create a .PO file and .MO files with your translations. Poedit offers a clean and easy to use translations interface and supports plural forms and UTF-8.

 

Top ↑

Download and install Poedit #

Download link: http://poedit.net/download.php

PoEdit Translation Software

Top ↑

Download the official WordPress POT file #

Download the official WordPress POT file

 

Top ↑

Create .po and .mo files #

  • Open the .pot file in Poedit.
  • Go to File → Save as… to save your translations in a .po file. Your file should carry the name of the language you will be translating into. Check the Codex page to give your file the right name: http://codex.wordpress.org/WordPress_in_Your_Language. The name you should use is the combination of the project’s text domain (locate it inside codes) and a short string in parentheses next to a language’s name (e.g. French – Français (fr_FR)). For example, if the text domain is bwp-minify and the translation is French, just name the .po filebwp-minify-fr_FR.
  • PoEdit will automatically compile a .mo file for you when you save your work on the existing .po file. In order to do that, make sure you go to File → Preferences and on the Editor tab check the Automatically compile .mo file on save box.

Top ↑

Translating with poEdit #

The basic translation screen consists of a list of strings for translation and two separate windows for the original string and the translated string.

The process is easy:

  1. Click on a string from the pool
  2. Add the translation in the translation modal (there could be developer notes in the modal on the right, so don’t forget to look for those)
  3. Save your translations

Translated strings are shown next to the original in the pool of strings and you can keep track of your progress in the bottom of the translation screen.

PoEdit Translation Screen

PoEdit Translation Screen

 

Top ↑

Uploading your translations #

[Information on using Poedit as a part of translating WordPress. This page need detailed expansion and screenshots, as well as an introductory paragraph.]

  1. Go to File → Save as… to save your translations in a PO file.
  2. When you are finished translating, go to File → Save as… again to generate the MO file.
  3. Or you can set your Poedit to always compile a MO file when saving changes by clicking File → Preferences and on the Editor tab check the Automatically compile .mo file on save box.