README

Extracts translations from PHP files, Twig templates and JavaScripts files.

This Drupal translation extractor stands on the shoulders of giants:

• https://www.drupal.org/project/potx
• https://www.drupal.org/project/translation_extractor
• https://symfony.com/doc/current/translation.html#extracting-translation-contents-and-updating-catalogs-automatically

Installation

composer require --dev itk-dev/drupal_translation_extractor:^1.0
drush pm:install drupal_translation_extractor

Use

The main entrypoint is the drupal_translation_extractor:translation:extract Drush command. This command is basically Symfony's translation:extract console command with a few changes and additions outlined below.

A new argument has been added:

source The source path to extract translations from. For convenience, module:«name» and theme:«name» can be used in the value and will be expanded to the full path to the module and/or theme respectively, i.e. module:my_custom_module will be expanded to web/modules/custom/my_custom_module, say.

A new option has been added:

--output The output path. The value can use these placeholders:

Example

Running

drush drupal_translation_extractor:translation:extract da --dump-messages --force module:my_modules --output=%source/translation/%module.%locale.po

will find translations in all PHP, Twig and JavaScript files in the web/modules/custom/my_module directory and write the result to web/modules/custom/my_module/translation/my_module.da.po.

Note

Much of the code in this module is stolen frombased on Symfony components and therefore we do not use Drupal coding standards.

Footnotes

1. Matching placeholders used the Locale module (cf. locale.api.php). ↩ ↩²