jonasfranz/crowdin

jonasfranz/crowdin镜像说明

镜像概述

jonasfranz/crowdin是一款Drone CI/CD生态的插件镜像，专注于与Crowdin翻译平台集成，实现项目翻译文件的自动化上传、同步与更新，帮助开发者在持续集成流程中高效管理多语言翻译工作。

核心功能

• 自动上传项目源语言文件到Crowdin平台
• 同步Crowdin上的目标语言翻译文件到本地项目
• 支持Drone流水线触发的翻译更新任务
• 提供灵活的参数配置适配不同项目需求

使用场景

• 代码提交后自动更新Crowdin平台的翻译源文件
• 定期拉取Crowdin上的最新翻译到项目代码库
• 在CI/CD流程中集成翻译同步步骤，确保多语言版本实时更新

配置说明

使用该镜像需配置以下关键参数（详细选项参考项目DOCS.md）：

• CROWDIN_API_KEY: Crowdin平台的API密钥（建议通过Secret管理）
• CROWDIN_PROJECT_ID: 目标Crowdin项目ID
• SOURCE_FILES: 需要上传的源文件路径（支持通配符）
• TRANSLATION_FILES: 需要同步的翻译文件路径模板（如./locales/%lang%.json）

Docker部署示例

基础运行命令

bash
docker run --rm \
  -e CROWDIN_API_KEY=your_secret_key \
  -e CROWDIN_PROJECT_ID=12345 \
  -e SOURCE_FILES="./src/locales/en.json" \
  -e TRANSLATION_FILES="./src/locales/%lang%.json" \
  -v $(pwd):/drone/src \
  jonasfranz/crowdin

Drone流水线配置示例

在项目.drone.yml中添加翻译更新步骤：

yaml
steps:
- name: sync-crowdin-translations
  image: jonasfranz/crowdin
  settings:
    api_key:
      from_secret: crowdin_api_key
    project_id: ***
    source_files: ./src/locales/en.json
    translation_files: ./src/locales/%lang%.json
    sync_translations: true