Command line tool for translate Gettext with Google Translator API or DeepL API
Potrans it's PHP command line tool for automatic translation of Gettext PO file with Google Translator or DeepL Translator.
bin/potrans google --help
Description:
Translate PO file with Google Translator API
Usage:
google [options] [--] <input> [<output>]
Arguments:
input Input PO file path
output Output PO, MO files directory [default: "~/Downloads"]
Options:
--from=FROM Source language (default: en) [default: "en"]
--to=TO Target language (default: cs) [default: "cs"]
--force Force re-translate including translated sentences
--wait=WAIT Wait between translations in milliseconds [default: false]
--credentials=CREDENTIALS Path to Google Credentials file [default: "./credentials.json"]
--project=PROJECT Google Cloud Project ID [default: project_id from credentials.json]
--location=LOCATION Google Cloud Location [default: "global"]
--translator[=TRANSLATOR] Path to custom translator instance
--cache|--no-cache Load from cache or not
-h, --help Display help for the given command. When no command is given display help for the list command
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi|--no-ansi Force (or disable --no-ansi) ANSI output
-n, --no-interaction Do not ask any interactive question
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
Follow command will translate whole content of tests/example-cs_CZ.po
from English (default) to Czech language (default):
bin/potrans google tests/example-cs_CZ.po ~/Downloads \
--credentials=your-credentials-file.json
You can also change source and target language with --form
and --to
parametters:
bin/potrans google tests/example-cs_CZ.po ~/Downloads \
--credentials=your-credentials-file.json \
--from=en \
--to=de
Google Translate API pricing is based on usage. Translation usage is calculated in millions of characters (M), where 1 M = 10^6 characters. For more information, see the Pricing FAQ.
You can watch it here:
bin/potrans deepl --help
Description:
Translate PO file with DeepL Translator API
Usage:
deepl [options] [--] <input> [<output>]
Arguments:
input Input PO file path
output Output PO, MO files directory [default: "~/Downloads"]
Options:
--from=FROM Source language (default: en) [default: "en"]
--to=TO Target language (default: cs) [default: "cs"]
--force Force re-translate including translated sentences
--wait=WAIT Wait between translations in milliseconds [default: false]
--apikey=APIKEY Deepl API Key
--translator[=TRANSLATOR] Path to custom translator instance
--cache|--no-cache Load from cache or not
-h, --help Display help for the given command. When no command is given display help for the list command
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi|--no-ansi Force (or disable --no-ansi) ANSI output
-n, --no-interaction Do not ask any interactive question
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
bin/potrans deepl tests/example-cs_CZ.po ~/Downloads --apikey=123456
DeepL translator API pricing is based on monthly subscription. There is max. 500,000 characters/month for free.
For more information visit https://www.deepl.com/pro-api
composer require --dev om/potrans
If you need to use a custom translator that behaves differently than the original translator.
You have the option to use the --translator
parameter like follow:
./bin/potrans deepl ./tests/example-cs_CZ.po ~/Downloads \
--translator=path/to/my/CustomTranslator.php \
--apikey=123456
PHP file should contain implementation of Translator
interface and should return new instance:
<?php
class CustomTranslator implements \potrans\translator\Translator {
// TODO add your code
}
return new CustomTranslator();
You can find an example custom translator in the file DeepLTranslatorEscaped.php
curl -s http://getcomposer.org/installer | php
composer install
for install all dependenciesFor more information about Composer visit: https://getcomposer.org
If you had "command not found: potrans"
return, just run the command like this: php bin/potrans
and will run without problems.
You may encounter a problem caused by cURL like follow:
cURL error 60: SSL certificate problem: unable to get local issuer certificate (see https://curl.haxx.se/libcurl/c/libcurl-errors.html)
There is missing issuer certificate cacert.pem
file and curl won't verify SSL requests:
/usr/local/etc/cacert.pem
php.ini
with following:curl.cainfo = "/usr/local/etc/cacert.pem"
openssl.cafile = "/usr/local/etc/cacert.pem"
You can verify it with phpinfo()
or php --info
. Read more detailed instruction here.