eeacms/i18ndude

i18ndude工具Docker镜像

i18ndude是一款用于处理Python和TAL模板源代码中文本字符串翻译的工具，本镜像为该工具的Docker化版本，便于快速部署和使用。

支持的标签及对应Dockerfile链接

• https://github.com/eea/eea.docker.i18ndude/blob/master/Dockerfile
• https://github.com/eea/eea.docker.i18ndude/blob/4.3.3/Dockerfile

核心功能

• 查找代码中的未翻译消息
• 重建pot翻译模板文件
• 同步翻译文件（po）与pot模板
• 支持本地代码目录或远程Git仓库的翻译处理

使用场景

• 本地开发时检查Python/TAL项目的未翻译内容
• CI/CD流程（如Jenkins）中自动化执行翻译相关任务
• 批量更新项目的翻译模板与同步翻译文件

配置说明与使用示例

默认操作：查找未翻译消息

挂载本地代码目录到容器内/code路径：

bash
$ docker run --rm -v /path/to/python/code:/code eeacms/i18ndude

或指定远程Git仓库：

bash
$ docker run --rm eeacms/i18ndude https://github.com/eea/eea.alchemy.git

在Jenkins中使用（含拉取请求）

需提供以下环境变量：

• GIT_NAME、GIT_SRC：必填
• GIT_BRANCH：默认值为master
• GIT_CHANGE_ID：可为空或拉取请求ID

bash
$ docker run -i --rm -e GIT_SRC="https://github.com/eea/$GIT_NAME.git" -e GIT_NAME="$GIT_NAME" -e GIT_BRANCH="$BRANCH_NAME" -e GIT_CHANGE_ID="$CHANGE_ID" eeacms/i18ndude

高级用法

重建pot模板文件

bash
$ docker run --rm \
             -v $(pwd)/src/eea.facetednavigation:/code \
             -w /code/eea/facetednavigation/locales \
         eeacms/i18ndude \
         i18ndude rebuild-pot --exclude documentation --pot eea.pot --create eea ../../

若仓库内存在update.sh脚本，可直接执行：

bash
$ docker run --rm \
             -v $(pwd)/src/eea.facetednavigation:/code \
             -w /code/eea/facetednavigation/locales \
         eeacms/i18ndude ./update.sh

同步翻译文件

bash
$ docker run --rm \
             -v $(pwd)/src/eea.facetednavigation:/code \
             -w /code/eea/facetednavigation/locales \
         eeacms/i18ndude i18ndude sync --pot eea.pot */LC_MESSAGES/eea.po

查看帮助

bash
$ docker run --rm eeacms/i18ndude --help