ongr / translations-bundle
ONGR 翻译包
Requires
Requires (Dev)
- mikey179/vfsstream: 1.4
- ongr/ongr-strict-standard: ~2.1
- phpunit/phpunit: ~4.4
- squizlabs/php_codesniffer: ~2.0
README
此包提供了一个图形用户界面,用于翻译管理。它使得在整个项目中控制和管理存储在多个域中的翻译文件变得简单。翻译可以自动从您的项目中收集并导出。
文档
该包的完整文档可以在这里找到。
安装
遵循5个快速步骤开始翻译。
步骤1:下载包
FilterManager包使用Composer安装。
# You can require any version you need, check the latest stable to make sure you are using the newest version. $ composer require ongr/translations-bundle "~1.0"
请注意,filter manager需要Elasticsearch包,安装和配置指南可以在这里找到。
步骤2:启用包
在app/AppKernel.php
中注册包
class AppKernel extends Kernel { /** * {@inheritdoc} */ public function registerBundles() { return [ // ... new ONGR\ElasticsearchBundle\ONGRElasticsearchBundle(), new ONGR\FilterManagerBundle\ONGRFilterManagerBundle(), new FOS\JsRoutingBundle\FOSJsRoutingBundle(), new ONGR\TranslationsBundle\ONGRTranslationsBundle(), ]; } // ... }
注意: 此包使用ONGRElasticsearchBundle来存储翻译。此外,还使用了ONGRFilterManagerBundle和FOSJsRoutingBundle包来构建用户界面。
步骤3:导入路由
导入API和UI路由
# app/config/routing.yml ongr_translation_ui: resource: "@ONGRTranslationsBundle/Resources/config/routing.yml" prefix: /translations # or any other prefix of your choice fos_js_routing: resource: "@FOSJsRoutingBundle/Resources/config/routing/routing.xml"
步骤4:配置Elasticsearch包
此包依赖于ONGRElasticsearchBundle来存储翻译。您可以将此包包含在现有的管理者映射中,但我们建议为翻译创建单独的索引和管理者。有关如何操作的信息可以在官方ElasticsearchBundle 文档中找到。
步骤5:配置包
此包需要最小的配置即可开始使用
# app/config/config.yml ongr_translations: managed_locales: ["en", "de", "lt"] repository: 'es.manager.translations.translation'
在上面的示例中,managed_locales
定义了我们正在使用的区域设置,而repository
定义了Translation
文档的存储库服务。
您的存储库ID可能因您在
ongr_elasticsearch
部分中配置的管理者名称而异。在这种情况下,使用名为translations
的管理者。
最后,如果您尚未启用,请启用Symfony翻译组件
framework: # ... translator: { fallbacks: ["%locale%"] }
设置就这些了。遵循下一章了解如何处理翻译。
有关详细的配置参考,请查看专门的文档页面。
翻译您的第一条消息!
在开始翻译消息之前,您需要有一些消息。让我们从这个包中导入消息。以下是执行此操作的命令ongr:translations:import
。
$ bin/console ongr:translations:import ONGRTranslationsBundle
安装资产
$ bin/console assets:install
现在在浏览器中打开http://127.0.0.1:8000/translations
。您应该看到翻译列表。
许可证
此软件包受MIT许可证的许可。有关完整的版权和许可信息,请查看随源代码一起分发的LICENSE文件。