Screenshot of potx

Translation Template Extractor (potx) provides a web based and Drush-integrated Gettext translation template extractor interface for Drupal as well as a reusable API to look for translatable strings and translatability errors.

Do you need to use this tool?

This tool is used under the hood at http://localize.drupal.org/ to serve as a parsing machine for Drupal.org project releases. If you intend to contribute to Drupal interface translations on https://localize.drupal.org/, there is no need to use this tool, it is integrated there seamlessly. It is possible to export translation templates for drupal.org project releases there without using this tool. Join a translation team to export and contribute to in-progress translations.

You need this project if you are in need of translation template source files directly from your locally running projects, especially custom projects or if you want to debug and verify your custom code for software translatability.

Using with Drush

Use the potx drush command to generate translation templates from local source code. Examples:

  • Extract translatable strings from applicable files in current directory and write to single output file: drush potx
  • Extract translatable strings from applicable files of example module: drush potx--modules=example
  • Extract translatable strings from only this one file in example.module: drush potx --files=sites/all/modules/example/example.module

Using the user interface

A simple user interface is exposed on the admin/config/regional/translate/extract page (the Extract tab on the User interface translation page).

Template extraction may require extensive amounts of memory, if extraction fails, try raising the memory limit.

Project information

Releases