pathmotion/ci-translation-process

翻译流程管理工具集

镜像概述和主要用途

该工具集专注于翻译流程的自动化管理，核心功能包括从PoEditor.com项目导入翻译文件，以及通过扫描源代码更新PO格式翻译文件。适用于开发团队高效维护多语言翻译资源，确保翻译文件与项目代码同步。

核心功能和特性

• PoEditor集成：支持从PoEditor项目导入翻译文件，可配置文件类型、目标路径及语言代码格式
• 源代码扫描：通过分析源代码提取翻译字符串，自动更新PO文件
• 灵活配置：提供丰富的命令行选项，支持自定义输出路径、文件掩码、未使用翻译处理策略等
• 交互控制：支持静默模式、详细日志输出及非交互式运行，适应自动化脚本场景

使用场景和适用范围

• 多语言项目的翻译文件维护
• 使用PoEditor作为翻译管理平台的开发团队
• 需要定期从源代码提取更新翻译字符串的场景
• CI/CD流程中集成翻译文件自动更新环节

使用方法和配置说明

从PoEditor导入翻译

描述

从PoEditor.com项目导入翻译文件到指定位置，支持多种文件格式和组织方式。

用法

bash
poeditor-import [options]

选项

  -d, --destination=DESTINATION  导入文件的目标路径
      --api-key=API-KEY          存储PoEditor API密钥的环境变量名称 [默认值: "PO_EDITOR_API_KEY"]
  -p, --project=PROJECT          PoEditor项目标识符
  -t, --type=TYPE                导入文件的类型/格式 [默认值: "mo"]
  -c, --context                  将翻译上下文导出到单独文件以避免冲突
  -m, --mask=MASK                输出文件掩码，用于覆盖默认路径模式（默认遵循Linux本地化组织方式）[默认值: "/%s/LC_MESSAGES/default"]
      --code=CODE                生成输出掩码使用的语言代码格式（IETF标签），可选值：posix|iso_639_1 [默认值: "POSIX"]
  -h, --help                     显示帮助信息
  -q, --quiet                    不输出任何消息
  -V, --version                  显示应用程序版本
      --ansi                     强制ANSI输出
      --no-ansi                  禁用ANSI输出
  -n, --no-interaction           不进行交互式提问
  -v|vv|vvv, --verbose           增加消息详细程度：1=正常输出，2=详细输出，3=调试输出

通过扫描代码更新翻译文件

描述

扫描源代码文件提取翻译字符串，更新或生成PO格式翻译文件。

用法

bash
update-po-from-code [options]

选项

  -o, --output=OUTPUT       输出PO文件的目录
  -s, --source=SOURCE       源代码路径目录
  -l, --language=LANGUAGE   源代码语言（支持php、php-with-blade，允许多个值）
      --remove-unused       移除源代码中不存在的翻译
      --disable-unused      禁用源代码中不存在的翻译
      --add-comment-unused  为源代码中不存在的翻译添加注释
  -h, --help                显示帮助信息
  -q, --quiet               不输出任何消息
  -V, --version             显示应用程序版本
      --ansi                强制ANSI输出
      --no-ansi             禁用ANSI输出
  -n, --no-interaction      不进行交互式提问
  -v|vv|vvv, --verbose      增加消息详细程度：1=正常输出，2=详细输出，3=调试输出