Weblate 4.5.1 用户文档

• 语言: 中文（简体）
• 格式: .pdf
• 来源: docs.weblate.org

摘要

文档详细介绍了Weblate的用户指南，包括项目和组件的架构、用户注册与配置、命令行客户端wlc的使用方法，以及安全与隐私措施。wlc客户端支持通过API远程管理Weblate，提供多种命令如拉取、推送、提交、重置和锁定等操作。文档还涉及Weblate的 安装步骤、安全依赖跟踪和Docker容器安全扫描，确保在翻译过程中的数据安全和环境稳定。

AI总结

### 《Weblate 4.5.1 用户文档》总结

#### 一、起步
1. **项目和组件架构**
- Weblate 中的翻译内容以 **项目** 和 **组件** 进行组织。
- 每个项目包含多个组件，组件对应翻译文件（如 GNU gettext 或 Android 字符串资源）。
- 项目用于逻辑性地分组管理翻译文件。
- 默认情况下，跨组件的公共字符串会自动传播以减少重复翻译，但可以通过禁用翻译传播进行配置。

2. **用户注册与配置**
- 未注册用户只能浏览项目、查看翻译或提出翻译建议。
- 注册用户可以保存更改并获得翻译贡献信用。
- 注册步骤：填写注册表单、激活邮箱链接、可选配置语言偏好。
- 可通过 `wlc` 客户端工具管理 Weblate，支持命令行操作，如 `commit` 提交更改、`pull` 拉取远程仓库更改等。

---

#### 二、Weblate 客户端
1. **功能与安装**
- `wlc` 是 Weblate 的 Python 命令行工具，支持通过 API 远程管理 Weblate。
- 安装命令：`pip3 install wlc`。
- 支持多种输出格式（如 `csv`、`json`、`text`、`html`），并可通过 `--url` 指定 API 地址，`--key` 指定 API 密钥。

2. **常用命令**
- `version`：显示当前版本。
- `list-languages`、`list-projects`、`list-components`：列出语言、项目或组件。
- `show`、`ls`：显示或列出 Weblate 对象（翻译、组件或项目）。
- `commit`、`pull`、`push`：提交、拉取或推送更改。
- `reset`：重置更改以匹配远程仓库。
- `download`、`upload`：下载或上传翻译文件。

---

#### 三、高级功能
1. **RSS 频道**
- 提供翻译更改的 RSS 导出功能。
- 支持按项目、组件、语言或事件筛选近期更改。
- 例如：`GET /exports/rss////` 获取指定语言的翻译更改。

2. **发布 Weblate**
- 发布步骤包括：推送 Git 仓库标记、创建发布版本、配置下载服务器等。

3. **安全与隐私**
- Weblate 遵循 Linux 基金会的安全最佳实践。
- 使用 Dependabot 监控依赖项漏洞，Docker 容器通过 Anchore 和 Trivy 进行安全扫描。
- 安全扫描结果以 SARIF 格式存储在 GitHub 的 CI 作物中。

---

#### 四、关于 Weblate
1. **项目目标**
- 基于 Web 的连续本地化工具，支持版本控制集成。
- 支持多种文件格式，帮助翻译者高效贡献。

2. **项目信息**
- 官网地址：[https://weblate.org/](https://weblate.org/)
- 托管服务地址：[https://hosted.weblate.org/](https://hosted.weblate.org/)
- 文档地址：[https://docs.weblate.org/](https://docs.weblate.org/)

---

#### 五、翻译功能
1. **支持的文件格式**
- 包括 CSV、YAML、Ruby YAML 等格式。
- 典型配置：
- `locale/*.csv`：单语言译文模版。
- `translations/messages.*.yml`：多语言翻译文件。

2. **自动化翻译与建议**
- 提供机器翻译工具和翻译记忆库的建议。
- 支持基于外部来源的自动化翻译功能，用于快速初始化翻译。

3. **翻译限制与历史**
- 翻译长度默认限制为源字符串长度的 10 倍，可通过配置调整。
- 如果启用了组件设置，所有更改会保存到数据库中，可 revert。
- 提供翻译历史和最近更改列表，便于追踪翻译者贡献。

---

#### 六、总结
Weblate 是一个功能强大的开源翻译管理平台，支持多种文件格式和版本控制集成，旨在帮助开发者和翻译者高效完成本地化任务。通过其 Web 界面和命令行客户端 `wlc`，用户可以轻松管理翻译流程，利用自动化工具提升效率。同时，Weblate 重视安全性，遵循行业最佳实践，确保用户数据和隐私的保护。