Pootle Synchronization Plugin

Plugin source location: <serge_root>/lib/Serge/Sync/Plugin/TranslationService/pootle.pm

This plugin provides integration with Pootle — a free open-source online translation server software.

IMPORTANT: This pluginis kept for historical reasons; Pootle open-source project is no longer maintained by the open-source community, so for new installations we recommend using Zing.

On push-ts sync step, Serge will tell Pootle to scan generated translation files and update its internal translation database so that the new content becomes available for translation online. Respectively, on pull-ts sync step, Serge will tell Pootle to synchronize all the translations back into translation files.

When working with Pootle, use the serialize_po serializer for translation interchange files.

Communication between Serge and Pootle is performed by the means of running Pootle's command-line API tool (the script is called manage.py). Note that this means that Pootle must be installed on the same machine as Serge. Please refer to Serge + Pootle configuration guide for more information.

Each configuration file in Serge represents a single translation project, and maps to a single specific project in Pootle. The typical workflow is this:

  1. Install Pootle and set it up that it's root directory with .po files is e.g. /var/serge/po/
  2. Create a new Serge configuration file (let's call it my_project.serge) for your translation project so that it generates .po files under /var/serge/po/my_project/ (see Configuration File Reference, jobs → ... → ts_file_path parameter)
  3. Run serge localize my_project.serge to make sure everything works; after this step, you get .po files in your output directory
  4. Go to Pootle and add a new project with my_project code; Pootle will automatically know that its files are located under /var/serge/po/my_project/ folder
  5. Edit your Serge configuration file to add a sync/ts section (see the example below), and specify my_project as a value for project_id parameter
  6. Run serge push-ts my_project.serge to push your translations into Pootle for the first time, then go to Pootle's translation UI and see if everything works as expected

Later you will run serge sync continuously against this configuration file, which will perform the two-way sync between Serge and Pootle among other synchronization/localization steps. See Localization Cycle for more information.