Skip to content

Latest commit

 

History

History
97 lines (67 loc) · 2.72 KB

README.md

File metadata and controls

97 lines (67 loc) · 2.72 KB
Raw

Translala

Your new toolbox to manage your (Symfony/Laravel/Other) projects translations. It provide commands to translate your missing translations, detect commons translations, report translations stats and detect dead translations.

It can also be integrated in your CI process.

Availables commands:

  • Stats command
  • Common command
  • Dead command
  • Health command (CI Process)
  • Translation command

Availables Files format:

  • Yaml
  • Php
  • Json

Install

Grab the translala.phar and move it to your bin.

$ git clone [email protected]:Translala/translala.git && cp translala/build/translala.phar /usr/local/bin/translala

Configure your project

Here is what a complete .translation.yml file look like. You can add many path for each of your translation path. The translala report are dumped in your export path.

master_language: fr
languages:
    - en
    - fr
    - da

paths:
    - ./app/Resources/translations/
    - ./resources/lang/en/
    - ./src/AcmeBundle/Resources/translations/

export_path: /tmp

api:
    google: my_very_secret_api_key

project_path: ./


health:
    fr: 100
    en: 95
    da: 70

master_language is the locale of reference for your project.

languages list of locales your project have to manage.

paths are filepaths where your translations file are stored.

export_path is the directory where Translala dump your reports

Stats command

translala translala:project:stats --config ./app/Resources/translations/.translation.yml

The stats command report project stats about translations achievements.

Common command

translala translala:project:common --config ./app/Resources/translations/.translation.yml

Do you have a different translation key for each "save" buttons of your form? With many locales, it can have a significant cost.

Dead command

translala translala:project:dead --config ./app/Resources/translations/.translation.yml

This search each translations keys in your project to help you find dead key.

Health command

translala translala:health:status --config ./app/Resources/translations/.translation.yml

Check percentage of missing translation for each locale. Return an exit code if check fail. Made for CI process.

Translation command

translala translala:project:translate --config ./app/Resources/translations/.translation.yml

Using php-translation it translate missing or empty keys for each locale in each file.

Contribution

Feel free to remove array manipulation, fix typo and create new file parser with a PR ;)