README

此模块允许您生成翻译字典。为您的网站上的每种语言获取包含默认文本和现有翻译的CSV文件。您的翻译者可以使用生成的CSV文件完成缺失的翻译并修改现有的翻译。一旦所有翻译完成，您只需将它们导入到您的Magento 2的i18n文件夹即可。

设置

获取包

Composer包

composer require blackbird/translation-dictionaries-generator

Zip包

将包解压到app/code/Blackbird/TranslationDictionariesGenerator中，从您的Magento实例的根目录开始。

安装模块

转到您的Magento根目录并运行以下magento命令

php bin/magento setup:upgrade

如果您处于生产模式，请务必重新编译和重新部署静态资源，或者使用--keep-generated选项。

管理员

首先，您可以排除所有您不想翻译的模块（例如：后台模块），以减少翻译数量。为了排除模块，请转到商店 > 配置 > Blackbird扩展 > 翻译字典生成器。在这里，您有一个多选字段，可以选择排除所有模块。

命令

要开始生成翻译字典，您必须运行此命令

php bin/magento blackbird:translation:export

警告：没有参数时，将导出您网站上可用的所有语言

您将在以下文件夹中找到字典文件：$ROOT_MAGENTO/var/translation_export。

参数

• -l 或 --locale_code 允许您定义要导出的语言，如下所示

php bin/magento blackbird:translation:export --locale_code=fr_FR,en_US

• -i 或 --input 允许您使用包含所有Magento字符串的输入CSV文件。它将为给定字符串为每种语言生成一个包含现有翻译的新文件。

php bin/magento blackbird:translation:export -i /home/blackbird/phrases.csv

• 您可以将这两个选项结合起来

php bin/magento blackbird:translation:export -i /home/blackbird/phrases.csv -l fr_FR,en_US

可能的错误

我们的模块使用了一个名为i18n:collect-phrases的Magento功能来收集您网站上所有可翻译的字符串

如果找到空的翻译字符串（例如：__('')），则此功能可能会生成错误

In Phrase.php line 90:
                 
  Missed phrase

要处理此错误，有两种可能性

• 您的IDE可以轻松搜索
• 在您的Magento根目录中使用grep命令

grep -rnw . -e "__('')"

一旦您确定了空的翻译字符串，您可以给它赋值或对其进行注释。但请注意在导出后进行回滚（在本地使用以获得更高的安全性）

支持

• 如果您对这个代码有任何问题，请随时提出问题。
• 如果您想为此项目做出贡献，请随时创建一个拉取请求。

联系

如需更多信息，请联系我们

• 通过电子邮件：hello@bird.eu
• 或通过表单：https://black.bird.eu/en/contacts/

作者

• Kevin Weyhaupt - 维护者 - 这就是我！
• 黑鸟团队 - 贡献者 - 他们很棒！

许可证

本项目采用MIT许可证 - 详细信息请参阅LICENSE文件。

这就全部了！