javidalpe/laravel-localization-automation

Translate your Laravel localization files using third party services

Automatically translate your lang files

This package translates your Laravel localization files automatically using a third party service. Currently only supports DeepL., _(*1)

This package only works with 'Short Keys' approach, _(*2)

Installation

You can install the package via composer:, _(*3)

composer require --dev javidalpe/laravel-localization-automation

If you're on Laravel 5.4 or earlier, you'll need to add the following to your config/app.php:, _(*4)

'providers' => [
    ...
    Javidalpe\LaravelLocalizationAutomation\LaravelLocalizationAutomationServiceProvider::class,
];

Usage

This command translates all your files in /lang/{from}/ directory and create the new ones in /lang/{to}/ directory., _(*5)

php artisan localization:translate {from} {to} {--provider=deepl}

Example using default provider:, _(*6)

php artisan localization:translate es fr

Example using custom provider:, _(*7)

php artisan localization:translate es fr --provider=deepl

Known issues

The command will fail on: 1. Lemmas with HTML inside. php \\Wrong 'welcome.greetings' => '<strong>Hey!</strong>', \\Good 'welcome.greetings' => 'Hey!', 2. Lemmas with placeholders different from Laravel. ```php \Wrong 'welcome.greetings' => 'Hey {{name}}!', \Good 'welcome.greetings' => 'Hey!', 3. URLs. Fix these URLs manually., _(*8)

Supported Languages

Deeply

DeepL(y) supports these languages:, _(*9)

DeepL says they will add more languages in the future, such as Chinese and Russian., _(*10)

How it works

1. Foreach file in /lang/{from}/ directory.
2. Foreach lemma in file.
3. Split pluralization lemmas.
4. Replace each Laravel place-holder with temp string.
5. Translate the lemma using the provider.
6. Undo replacement.
7. Assembly all lemmas in new files at /lang/{to}/ directory.

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-translation-service)
3. Commit your changes (git commit -am 'Added translation service')
4. Push to the branch (git push origin my-new-translation-service)
5. Create new Pull Request

Add a new translation service

1. Create a new class inside /src/TranslationServices. Implements TranslationServiceStrategy.
2. Add this class to TranslationServiceStrategyFactory.
3. Update this `README.md file.

Credits

• DeepL GmbH: https://www.deepl.com/
• Chris Konnertz: https://github.com/chriskonnertz/DeepLy

License

The MIT License (MIT). Please see License File for more information., _(*11)