weblate/wlc Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

wlc - Weblate命令行客户端

概述

wlc是Weblate的命令行客户端，基于Weblate REST API实现本地化项目的管理与操作。Weblate作为开源的Web-based持续本地化系统，已被全球165个国家的2500多个开源项目和企业采用。wlc提供便捷的命令行接口，支持本地化资源的查询、提交、推送、下载等操作，简化本地化流程的自动化与集成。

核心功能与特性

• 资源管理：支持项目（list-projects）、组件（list-components）、翻译（list-translations）、语言（list-languages）等本地化资源的列表查询与详情查看（show）。
• 本地化操作：提供提交（commit）、推送（push）、拉取（pull）、下载（download）、上传（upload）等翻译资源的核心操作。
• 项目控制：支持锁定（lock）、解锁（unlock）、锁定状态查询（lock-status）及统计信息获取（stats）。
• 灵活配置：通过配置文件自定义API请求参数（重试次数、超时时间等），适配不同网络环境需求。
• 容器化部署：提供Docker镜像，支持快速集成到CI/CD流程或开发环境。

使用场景与适用范围

• 本地化项目自动化：集成到CI/CD流水线，实现翻译资源的自动拉取、提交与推送。
• 开发环境工具：开发人员通过命令行快速管理本地化资源，无需依赖Web界面。
• 生产环境部署：通过版本标签实现稳定版本控制，或使用滚动更新标签保持最新功能。
• 测试环境验证：使用开发版本（edge）测试新功能在本地化流程中的兼容性。

详细使用方法与配置说明

Docker镜像获取与构建

拉取官方镜像

console
docker pull weblate/wlc:latest

本地构建镜像

console
git clone [***]
cd wlc
docker build -t weblate/wlc .

命令行使用示例

console
# 列出所有项目
wlc list-projects

# 查看指定项目组件详情
wlc show my-project my-component

# 提交翻译更改
wlc commit my-project my-component

# 推送翻译到仓库
wlc push my-project my-component

# 下载翻译文件
wlc download my-project my-component --language zh_CN

# 上传翻译文件
wlc upload my-project my-component --language zh_CN -f translations/zh_CN.po

更多命令及详细说明参见Weblate官方文档。

配置文件说明

配置文件路径为~/.config/weblate，采用INI格式，包含以下核心部分：

[weblate]部分：API连接参数

与urllib3参数关联，用于配置请求行为：

[keys]部分：API密钥配置

格式为API地址 = API密钥，用于认证：

ini
[keys]
[***] = YOUR_API_KEY

Docker Hub标签说明

所有镜像均通过CI测试后发布，edge版本亦具备较高稳定性。

容器运行示例

基本运行（挂载配置文件）

console
docker run --rm -v ~/.config/weblate:/root/.config/weblate weblate/wlc list-projects

执行特定命令

console
docker run --rm -v ~/.config/weblate:/root/.config/weblate weblate/wlc stats my-project my-component

贡献

欢迎参与贡献！详见贡献文档。