hobsrkm / auto-translate
Auto generate translation JSON files for laravel 10, laravel > 11
Requires
Requires (Dev)
This package is auto-updated.
Last update: 2024-10-19 17:40:19 UTC
README
This package provides a simple way to automatically generate translation JSON files for you, it helps you to generate the missing translation also.
The translation are generated automatically using Google Translations, based on the package stichoza/google-translate-php
and exporting translations string from your source code using the package kkomelin/laravel-translatable-string-exporter
.
Installation
You can install the package via composer:
composer require devaslanphp/auto-translate
Add the package provider into your config/app.php
file:
//... 'providers' => [ // ... \Devaslanphp\AutoTranslate\AutoTranslateProvider::class, ], // ...
REQUIRED: You need to publish the package config file, so you can update the base_locale
and locales
list as needed:
php artisan vendor:publish --tag=auto-translate-config
That's it, you can use the package commands to generate missing translations and automatically translate them using Google Translations
Configuration
The configuration file of this package comes like below:
<?php return [ /* * * Locales managed by auto-translation package, will be used by the * command "auto:translate" to generate a JSON file for each of this * locales, and by the command "translate:missing" to generate their * missing translations * */ 'locales' => [ 'fr', 'ar' ], /* * * The base locale to use when using the command "translate:missing" to * generate missing translations for other JSON files * */ 'base_locale' => 'fr' ];
I think it's well documented, I will let you check it.
Usage
The package provides 2 Artisan commands:
Automatic translations generation
To generate translation JSON files from your source code, you can execute the following command:
php artisan auto:translate
This command will check your configuration auto-translate.locales
to generate for each locale of this list a JSON file based on your source code (@lang()
, __()
, ...) and translate the string into the desired locale based on Google Translations.
Translate missing keys
The package provides also a command to let you generate translations for missing keys based on a specific JSON file (auto-translate.base_locale
.json). To generate missing translation, you only need to execute the following command:
php artisan translate:missing
Credits
License
The MIT License (MIT). Please see License File for more information.