Weblate 4.12.1 用户文档

以下是对《Weblate 4.12.1 用户文档》的中文总结，按照文档内容和结构进行梳理，重点突出核心观点和关键信息： --- ### **1. 用户文档** #### **1.1 REST API** - **请求标头**： - `Accept`：指定响应内容类型。 - `Authorization`：验证令牌，格式为 `Token YOUR-TOKEN`。 - **响应标头**： - `Content-Type`：依赖于请求的 `Accept` 标头。 - `Allow`：列出允许的 HTTP 方法。 - **响应 JSON 对象**： - 包含 `detail`、`count`、`next`、`previous`、`results`、`url` 和 `web_url` 等字段。 - **状态码**： - `200 OK`：请求处理成功。 - `201 Created`：新对象创建成功。 - `204 No Content`：对象删除成功。 - `400 Bad Request`：表单参数丢失。 - `403 Forbidden`：访问被拒绝。 - `429 Too Many Requests`：请求过多。 #### **1.2 身份验证** - **令牌**： - 用户可在个人资料中获取 API 访问令牌。 - 个人令牌以 `wlu_` 为前缀，项目范围令牌以 `wlp_` 为前缀。 - **示例**： - 请求示例：`GET /api/`，包含 `Authorization` 标头。 - 响应示例：返回 `200 OK` 状态码及 JSON 数据。 #### **1.3 客户端配置** - 支持 `.weblate`、`.weblate.ini` 和 `weblate.ini` 配置文件。 - 配置文件位置： - Windows：`C:\Users\NAME\AppData\weblate.ini`。 - Linux：`~/.config/weblate` 和 `/etc/xdg/weblate`。 - 配置内容： - `url`：API 服务器地址，默认为 `http://127.0.0.1:8000/api/`。 - `key`：API 密钥，可存储在 `[keys]` 部分。 - 示例：`[weblate]` 和 `[keys]` 部分配置。 #### **1.4 翻译工作流** - 支持两种翻译模式： - 直接翻译。 - 用户建议翻译，需达到一定投票数后自动验证。 - 翻译项目可设置为公开可见或仅限指定翻译组可见。 #### **1.5 文件格式支持** - **应用商店元数据文件**： - 支持工具：Triple-T gradle-play-publisher、Fastlane、F-Droid。 - 文件包括多种文本文件，Weblate 将其作为单独字符串处理。 - **字幕文件**： - 支持格式：`.srt`、`.sub`、`.ass`、`.ssa`。 - **RC 文件**： - 示例配置：`lang/en-US.rc`，常用于 Windows 资源文件。 #### **1.6 版本更新** - **Weblate 2.17.1**（2017 年 10 月 13 日）： - 修复测试套件运行问题。 - 区域设置更新。 - **Weblate 2.17**（2017 年 10 月 13 日）： - 默认使用 Git 浅克隆。 - 提供更细粒度的 ACL 配置。 - 支持搜索和替换预览。 - **Weblate 4.4**（2020 年 12 月 15 日）： - 提供自定义外观。 - 改进翻译编辑器性能。 - **Weblate 4.4.1**（2021 年 1 月 13 日）： - 修复用户管理和 PO 文件上下文处理。 - 提供附加组件 API。 --- ### **2. 管理员文档** - **组件管理**： - 支持从模板创建组件。 - 提供批量编辑功能，可设置翻译状态、标记和标签。 - **附加组件**： - 提供自动化操作，例如标记只读字符串或自动添加标签。 - 示例：自动标记应用商店元数据文件中的更新日志为只读。 - **访问控制**： - 支持细粒度的 ACL 配置。 - 提供审计日志，记录用户操作及触发的通知。 --- ### **3. 贡献者文档** - **前端开发**： - 使用 Bootstrap、jQuery 和第三方库。 - 支持主流浏览器的最新稳定版。 - **依赖项管理**： - 使用 `yarn` 管理第三方库。 - 包括 Prettier 和 ESLint 工具链。 - **附加组件开发**： - 提供 `EVENT_PRE_COMMIT` 事件回调。 - 示例开发：创建一个空附加组件。 --- ### **总结** 文档涵盖了 Weblate 的 REST API、身份验证、客户端配置、翻译工作流、文件格式支持、版本更新、管理员功能以及开发者指南。重点包括： 1. **REST API**：详细说明了请求标头、响应结构和状态码。 2. **身份验证**：引入了项目范围令牌，增强了安全性。 3. **客户端配置**：支持多种配置文件，方便用户自定义设置。 4. **翻译工作流**：提供灵活的翻译模式和访问控制。 5. **文件格式支持**：扩展了对多种字幕和应用商店元数据文件的支持。 6. **版本更新**：新增了许多功能和性能改进。 如需了解更详细的内容，可参考原文档。