lokalise/lokalise-cli-2

镜像概述

Lokalise CLI v2的Docker容器化版本，提供与Lokalise平台（[***] Hub地址：https://hub.docker.com/r/lokalise/lokalise-cli-2/%E3%80%82

核心功能与特性

• 容器化运行Lokalise CLI v2，无需本地安装命令行工具
• 支持从Lokalise平台导出数据到本地目录
• 支持将本地文件导入（上传）到Lokalise平台
• 兼容Lokalise CLI v2的所有命令和参数

使用场景

适用于需要通过命令行或自动化流程（如CI/CD）与Lokalise平台交互的场景，例如：

• 从Lokalise下载最新本地化文件到本地项目
• 将本地更新的翻译文件上传到Lokalise平台
• 批量处理多语言文件的导入导出

使用方法与配置说明

从Lokalise导出数据到本地目录

通过以下命令将Lokalise平台的文件导出到本地目录：

bash
docker run \
    -v /tmp/locale:/opt/dest \  # 挂载本地目录到容器内/opt/dest，用于接收导出文件
    lokalise/lokalise-cli-2 lokalise2 \
    --token <token> \  # Lokalise平台的API令牌（需替换为实际令牌）
    --project-id <project_id:branch> \  # Lokalise项目ID和分支（格式：项目ID:分支名，需替换为实际值）
    file download \  # 执行文件下载命令
    --format json \  # 指定导出文件格式（可选，支持多种格式）
    --unzip-to /opt/dest  # 指定导出文件解压到容器内的路径（对应本地挂载目录）

将本地文件导入到Lokalise

通过以下命令将本地文件上传到Lokalise平台：

bash
docker run \
    -v /tmp/en.json:/opt/src/en.json \  # 挂载本地文件到容器内/opt/src/en.json（需替换本地文件路径）
    lokalise/lokalise-cli-2 lokalise2 \
    --token <token> \  # Lokalise平台的API令牌（需替换为实际令牌）
    --project-id <project_id:branch> \  # Lokalise项目ID和分支（格式：项目ID:分支名，需替换为实际值）
    file upload \  # 执行文件上传命令
    --file /opt/src/en.json \  # 容器内待上传文件路径（对应本地挂载路径）
    --lang-iso en  # 指定文件对应的语言ISO代码（需替换为实际语言代码）

参数说明

• <token>: Lokalise平台的API访问令牌，可在Lokalise账户设置中获取
• <project_id:branch>: Lokalise项目ID和分支，格式为项目ID:分支名，分支可选，默认使用主分支
• --format: 导出文件格式，支持json、xml、csv等多种格式
• --lang-iso: 上传文件对应的语言ISO代码（如en、zh-CN等）