README

Laravel Larex: Crowdin 插件

一个 Laravel Larex 插件，用于从/到 Crowdin 导入/导出本地化字符串

📋 要求

• PHP ≥ 8.0
• Laravel ≥ 8
• Laravel Larex ≥ v4.4
• Crowdin API 令牌
  • 标准账户: https://crowdin.com/settings#api-key (API v2)
  • 企业账户: https://<your-organization-name>.crowdin.com/u/user_settings/access-tokens
• Crowdin 项目 ID
  • 标准账户: https://crowdin.com/project/<your-project>/tools/api (API v2)
  • 企业账户: https://<your-organization-name>.crowdin.com/u/projects/<your-project-id>#home

🚀 安装

您可以使用 composer 安装此包

composer require lukasss93/laravel-larex-crowdin --dev

然后，将服务提供者添加到 config/app.php。
如果启用了包自动发现，则可以跳过此步骤。

'providers' => [
    Lukasss93\LarexCrowdin\LarexCrowdinServiceProvider::class
];

⚙ 发布配置文件

发布配置文件是可选的

php artisan vendor:publish --provider="Lukasss93\LarexCrowdin\LarexCrowdinServiceProvider" --tag="larex-crowdin-config"

🔧 配置

1. 安装 Laravel Larex ≥ v4.4
2. 发布（如果您尚未发布）并编辑您的 larex.php 配置
3. 在 importers.list 数组中添加 Crowdin 导入器

   //...
   'importers' => [
       //...
       'list' => [
           //...
           'crowdin' => Lukasss93\LarexCrowdin\Importers\CrowdinImporter::class,
       ],
   ],
   //...

4. 在 exporters.list 数组中添加 Crowdin 导出器

   //...
   'exporters' => [
       //...
       'list' => [
           //...
           'crowdin' => Lukasss93\LarexCrowdin\Exporters\CrowdinExporter::class,
       ],
   ],
   //...

5. 编辑您的 .env 文件并添加以下字符串

   # For more info about this fields, see the "config/larex-crowdin.php" file
   LAREX_CROWDIN_TOKEN=<crowdin-token>
   LAREX_CROWDIN_PROJECT_ID=<crowdin-projectID>
   LAREX_CROWDIN_ORGANIZATION=<crowdin-organization-name>

👓 使用方法

• 运行 php artisan larex:import crowdin 从您的 Crowdin 项目导入字符串到您的 Larex CSV
• 运行 php artisan larex:export crowdin 将字符串从您的 Larex CSV 导出到您的 Crowdin 项目
• 您仍然可以使用 --include 和 --exclude 选项来选择导入/导出的特定语言

⚗️ 测试

composer test

🔰 版本支持

📃 变更日志

请参阅 CHANGELOG.md 以获取有关最近更改的更多信息。

🏅 致谢

• Luca Patera
• 所有贡献者

📖 许可证

请参阅 LICENSE.md 文件以获取更多信息。