clockworkgeek / magei18n
检测 Magento 模块中的可翻译字符串并自动维护区域/CSV 文件
0.0.2
2017-02-10 16:44 UTC
Requires
- php: >=5.3.0
- nikic/php-parser: ^1.3
- symfony/console: ^2.6
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 文件中。这是故意的,这样翻译者可以看到哪些条目还需要修复。