README

CakePHP 3.x 插件，与 Transifex 协作并拉取/推送翻译。它使用 Transifex API v2。

请注意：新功能仅针对最新的 CakePHP 3.x 版本进行了测试。如果可能，请升级。

安装

安装此插件与安装其他 CakePHP 插件类似。

• composer require dereuromark/cakephp-transifex
• 确保您在 bootstrap 中有 Plugin::load('Transifex') 或 Plugin::loadAll()。

在 transifex.com 上创建账户并创建/加入项目和相关资源。

在您的配置文件或 bootstrap 中放置有关项目、用户和密码的信息。

$config['Transifex'] = [
	'project' => 'cakephp',
	'user' => '...',
	'password' => '...'
];

这就完成了。它应该已经启动并运行。

用法

要获取当前项目的支持资源列表

cake Transifex.Transifex resources

要获取支持的语言列表

cake Transifex.Transifex languages

可以使用以下方式收集资源统计信息

cake Transifex.Transifex statistics

要实际更新您的区域设置文件夹，请使用

cake Transifex.Transifex pull

它将提示语言和资源（使用 * 导入所有）。

要导入特定资源的特定语言，您也可以使用快捷方式

cake Transifex.Transifex pull -l {language} -r {resource}

PO 文件将存储在 src/Locale/{locale}/LC_MESSAGES/{resource}.po。强烈建议使用版本控制来快速查看和确认所做的更改。

高级用法

您可以使用 --reviewed-only 或 -R 仅拉取已审查的翻译

cake Transifex.Transifex pull -R

要拉取插件的区域设置，您需要设置 --plugin 或 -p

cake Transifex.Transifex pull -p Tools

然后它们将被存储在插件的区域设置文件夹中。

如果您有一个主要项目和几个其他（插件或 CakePHP 核心）项目，您可以使用 --project 或 -P 覆盖配置项目设置

cake Transifex.Transifex pull -P cakephp

提示：如果您想先进行 dry-run，请使用 -d -v。这不会修改您的区域设置文件，但会模拟导入。

提示

您可以使用 Transifex.Transifex 的自动别名，它是 Transifex - 或者甚至使用 t 作为更短的别名，使用 自定义别名。

调试

使用 --debug 在通过 cURL 推送时获得更多详细的调试输出。

测试

在测试时，--debug 启用实时测试模式并使用实际 API 而不是模拟和假 JSON 响应文件。请确保在 tests/bootstrap.php 中提供有效的凭据。还请确保这些不是您的实时凭据，以避免数据丢失。您应该在这里使用专用测试账户以确保。

待办事项

• 更多测试

免责声明

自行承担风险。请通过问题或更好的拉取请求提供任何修复或改进。