silverstripe/tx-translator

本包的最新版本(1.2.0)没有可用的许可信息。

Silverstripe TX Translator

1.2.0 2024-05-09 01:51 UTC

This package is auto-updated.

Last update: 2024-09-07 05:01:19 UTC


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 token
  • TX_PULL(默认1)- 从Transifex拉取最新翻译,运行i18nTextCollectorTask并更新翻译文件
  • TX_PUSH(默认0)- 将新源字符串推送到Transifex
  • TX_COLLECT(默认0)- 在本地网站上运行i18nTextCollectorTask
  • TX_SITE(如果TX_COLLECT1则必需)- 要运行i18nTextCollectorTask的本地silverstripe网站的URL。http://将在省略协议时自动添加
  • TX_DEV_MODE(默认0)- 不要推送到Transifex或创建github pull-requests。在本地开发和进行dry-runs时很有用
  • TX_VERBOSE_LOGGING(默认0)- 显示详细日志