Crowdin CLI 使用教程
1. 项目介绍
Crowdin CLI 是一个强大的命令行工具,旨在简化在 Crowdin 平台上管理本地化项目的过程。通过 Crowdin CLI,用户可以轻松上传源文件、下载翻译内容,并保持本地化资源与 Crowdin 项目的同步。该工具支持自动化更新源文件、自动保存翻译内容到指定位置,以及快速上传现有翻译到 Crowdin 平台。Crowdin CLI 是跨平台的,可以在 Linux、macOS 和 Windows 系统上运行。
2. 项目快速启动
安装 Crowdin CLI
首先,确保你已经安装了 Java 运行环境(JRE),因为 Crowdin CLI 是基于 Java 开发的。然后,你可以通过以下命令下载并安装 Crowdin CLI:
curl -o crowdin-cli.zip https://downloads.crowdin.com/cli/v4/crowdin-cli.zip
unzip crowdin-cli.zip
配置 Crowdin CLI
在项目根目录下创建一个名为 crowdin.yml
的配置文件,并添加以下内容:
project_id: 'your_project_id'
api_token: 'your_api_token'
base_path: '/path/to/your/project'
files:
- source: '/source/file.txt'
translation: '/translations/%two_letters_code%/%original_file_name%'
上传源文件
使用以下命令将源文件上传到 Crowdin 项目:
crowdin upload sources
下载翻译
使用以下命令从 Crowdin 下载最新的翻译内容:
crowdin download
3. 应用案例和最佳实践
自动化翻译流程
通过将 Crowdin CLI 集成到 CI/CD 管道中,可以实现翻译流程的自动化。例如,在每次代码提交时自动上传源文件,并在翻译完成后自动下载并合并翻译内容。
多语言支持
Crowdin CLI 支持多语言翻译,用户可以通过配置文件指定不同的语言代码,并自动下载对应语言的翻译文件。
与版本控制系统集成
通过与 GitHub、GitLab 等版本控制系统集成,可以实现翻译内容的版本管理,确保每次翻译更新都能与代码版本同步。
4. 典型生态项目
GitHub Actions
Crowdin CLI 可以与 GitHub Actions 集成,实现自动化的翻译管理。通过在 GitHub Actions 中配置 Crowdin CLI 任务,可以在每次代码推送时自动上传源文件,并在翻译完成后自动下载翻译内容。
Jenkins
对于使用 Jenkins 进行持续集成的项目,可以通过 Jenkins Pipeline 集成 Crowdin CLI,实现自动化的翻译管理流程。
CircleCI
CircleCI 用户可以通过配置 CircleCI 的 .circleci/config.yml
文件,集成 Crowdin CLI,实现自动化的翻译管理。
通过以上步骤,你可以快速上手使用 Crowdin CLI,并将其集成到你的开发流程中,实现高效的本地化管理。