silverstripe / tx-translator
本包的最新版本(1.2.0)没有可用的许可信息。
Silverstripe TX Translator
1.2.0
2024-05-09 01:51 UTC
Requires
- php: ^8.1
- guzzlehttp/guzzle: ^6 || ^7
- silverstripe/supported-modules: dev-main
- symfony/console: ^4 || ^5 || ^6
- symfony/dotenv: ^5 || ^6
- symfony/process: ^4 || ^5 || ^6
- symfony/yaml: ^4 || ^5 || ^6
Requires (Dev)
- phpunit/phpunit: ^9.5
- squizlabs/php_codesniffer: ^3.7
Conflicts
- silverstripe/framework: <4.12.0
README
模块,用于帮助与Transifex集成。与Silverstripe 4.12+和5.0+兼容。
操作
- 从Transifex拉取最新翻译并将其合并到yml/json/js翻译文件中
- 在本地网站上运行i18nTextCollectorTask(可选)
- 将更新的源字符串推送到Transifex(可选)
- 使用文件更改创建github pull-requests
需求
Transifex cli客户端(tx) - https://developers.transifex.com/docs/cli配置Transifex的API密钥。
您必须使用至少版本1.6+的go版本,而不是旧的python版本。
在github token settings中创建一个新的经典github api token,除了public_repo
以外的所有复选框都不勾选。这是创建pull-requests所必需的。
更新翻译后,从github删除此token。
用法
cd /path/to/my-local-site
composer require silverstripe/tx-translator
要拉取来自Transifex的最新翻译,通常会在最低支持的分支上执行此操作
TX_GITHUB_API_TOKEN=mytoken php vendor/silverstripe/tx-translator/scripts/translate.php
要运行文本收集器并将最新源字符串更新到Transifex,通常会在最新的next-minor分支上执行此操作
TX_GITHUB_API_TOKEN=mytoken TX_SITE=my-local-site.test TX_COLLECT=1 TX_PULL=0 TX_PUSH=1 php vendor/silverstripe/tx-translator/scripts/translate.php
环境变量
环境变量可以通过命令行设置,如上面的示例所示,或者在网站根目录中的.env中设置,或者使用其他方法设置环境变量。
请注意,布尔变量的有效值是1、true、on、0、false和off。
TX_GITHUB_API_TOKEN
(必需)- 具有创建pull-requests写入权限的github tokenTX_PULL
(默认1
)- 从Transifex拉取最新翻译,运行i18nTextCollectorTask并更新翻译文件TX_PUSH
(默认0
)- 将新源字符串推送到TransifexTX_COLLECT
(默认0
)- 在本地网站上运行i18nTextCollectorTaskTX_SITE
(如果TX_COLLECT
为1
则必需)- 要运行i18nTextCollectorTask的本地silverstripe网站的URL。http://
将在省略协议时自动添加TX_DEV_MODE
(默认0
)- 不要推送到Transifex或创建github pull-requests。在本地开发和进行dry-runs时很有用TX_VERBOSE_LOGGING
(默认0
)- 显示详细日志