clockworkgeek/magei18n

检测 Magento 模块中的可翻译字符串并自动维护区域/CSV 文件

0.0.2 2017-02-10 16:44 UTC

This package is not auto-updated.

Last update: 2024-09-28 17:49:03 UTC


README

为想要跟踪区域字符串的模块开发者。MageI18n 通过静态扫描 PHP 中的 ->__("...") 方法或 XML 文件中的 translate="..." 并根据需要添加到/从 CSV 文件中。

推荐安装

确保 $COMPOSER_HOME/vendor/bin 在包含路径中。通常这意味着将 PATH=$PATH:~/.composer/vendor/bin 添加到您的 .bashrc 文件中,然后注销再登录。接下来只需输入

composer global require clockworkgeek/magei18n

在现有项目中首次使用

首先在模块的项目目录中测试。以下命令应列出所有可翻译文件的 CSV 格式。

magei18n scan

如果您的模块尚未有区域文件,则可以像这样生成

mkdir -p app/locale/en_US
magei18n scan > app/locale/en_US/Example_Module.csv

如果存在区域文件并且需要保留,则最好使用

magei18n update

update 命令将删除它无法识别的任何字符串并添加缺失的任何字符串。已识别的字符串将保持不变,这将保留现有的翻译。

Git 工作流程

MageI18n 设计为作为预提交钩子在工作。将命令 magei18n git-diff 添加到任何现有的钩子脚本中。或者,如果不存在,输入

cat > .git/hooks/pre-commit
#!/bin/sh
magei18n git-diff

<Ctrl+D>
chmod +x .git/hooks/pre-commit

此命令将仅添加/删除最新提交中更改的字符串。如果您故意省略了模块区域文件中的某些条目,这将很有帮助。

关于多区域

MageI18n 将将新发现的字符串添加到它找到的 所有 CSV 文件中。这是故意的,这样翻译者可以看到哪些条目还需要修复。