The Weblate Manual 4.15.1

• 语言: 英语
• 格式: .pdf
• 来源: docs.weblate.org

摘要

《The Weblate Manual 4.15.1》是一份关于Weblate的用户手册和管理员指南，涵盖了Weblate的基本使用、注册与用户配置、翻译流程、文件下载与上传、术语库管理、检查与修复、搜索功能、工作流程配置、常见问题解答、文件格式支持、版本控制集成、REST API使用、Weblate客户端、Python API开发等内容。文档还详细介绍了Weblate的配置、部署、升级、备份与迁移、认证与访问控制、翻译项目管理、语言定义、持续本地化、许可与翻译流程优化等高级功能。此外，文档还包括了Weblate的发布流程、支持信息、测试套件与持续集成等内容。

AI总结

《The Weblate Manual 4.15.1》是一份关于Weblate的官方文档，主要介绍了Weblate的使用、管理和开发相关内容。以下是对文档内容的总结：

### 1. 用户文档（User docs）
Weblate是一款基于Web的持续本地化工具，支持与版本控制系统深度集成，并支持多种文件格式，方便翻译人员协作。用户文档涵盖了以下核心内容：
- **基本功能**：介绍Weblate的核心功能和使用场景。
- **翻译流程**：包括翻译操作、术语管理、质量检查、搜索功能等。
- **文件处理**：支持下载和上传翻译文件，兼容多种格式（如PO、XLIFF、JSON等）。
- **API与客户端**：提供REST API和Python API，方便开发者集成。
- **常见问题**：解答用户在使用过程中可能遇到的问题。

### 2. 管理员文档（Administrator docs）
管理员文档主要针对Weblate的部署、配置和维护，内容包括：
- **部署与升级**：提供Weblate的安装、配置和升级指南。
- **权限管理**：支持身份验证、访问控制和翻译项目管理。
- **性能优化**：包括翻译记忆、术语库和自动化建议的优化配置。
- **安全与合规**：提供安全报告和第三方组件（如Django、Python Social Auth）的使用说明。
- **支持与维护**：包括数据备份、日志管理、许可证管理和社区支持等内容。

### 3. 贡献者文档（Contributor docs）
贡献者文档为开发者提供了参与Weblate开发的指南，内容包括：
- **代码贡献**：介绍如何开始贡献代码、使用调试工具和开发插件。
- **测试与CI**：强调测试套件的重要性，鼓励开发者为新功能添加测试。
- **发布流程**：详细说明Weblate的版本发布流程，包括准备工作、发布执行和后续操作。
- **安全与隐私**：提供安全问题的报告流程和处理指南。
- **项目信息**：包括项目目标、维护者信息、许可证（GPLv3）和项目资源（如文档、代码仓库）。

### 4. 变更历史（Change History）
文档末尾列出了Weblate的版本更新历史，以下是部分重要更新：
- **4.15.1版本（2023年1月19日）**：
- 修复了自动翻译建议的显示问题。
- 修复了插件页面的崩溃问题。
- 支持gotext JSON文件和i18next v4文件格式。
- 提升了项目创建和保存的性能。
- **4.15版本（2022年12月16日）**：
- 新增支持浏览单个字符串的变更记录。
- 支持地方化变量在Fluent格式中的处理。
- 增加了键盘快捷键（Alt+Enter）提交翻译建议。
- 提升了翻译记忆的性能。

### 5. 项目信息
- **项目目标**：提供一个功能强大的Web-based持续本地化工具，支持多种文件格式和版本控制集成。
- **项目名称**：Weblate是“web”和“translate”的合成词。
- **项目网站**：[https://weblate.org](https://weblate.org) 和[https://hosted.weblate.org](https://hosted.weblate.org)。
- **维护者**：由Michal Čihař维护，邮箱为[e-mail]。
- **许可证**：遵循GPLv3协议，使用REUSE 3.0规范。

### 6. 安全与隐私
- **安全问题**：通过HackerOne或邮件（[e-mail]）报告安全漏洞。
- **第三方组件**：Weblate依赖于Django、Django REST框架等第三方库，发现漏洞需直接向相关项目报告。

### 7. 发布流程
Weblate采用两个月的发布周期（x.y），并根据需要发布修复版本（x.y.z）。发布前需完成以下步骤：
1. 检查新翻译语言。
2. 设置最终版本号。
3. 更新截图并合并翻译。
4. 创建发布版本。
5. 更新Docker镜像和Helm图表。

### 8. 数据隐私
Weblate会收集以下信息：
- 用户URL、站点标题、版本信息。
- 数据统计（项目、组件、语言、用户等）。
- 公共SSH密钥。
- 公共项目列表（名称、URL、网站）。

### 9. 法律文件
文档末尾附有GNU GPL许可证，强调Weblate的开源属性和使用条款。

### 总结
《The Weblate Manual 4.15.1》是一份全面的指南，涵盖了Weblate的使用、管理和开发各个方面，适合不同角色的用户阅读。文档结构清晰，内容详实，适合快速了解Weblate的功能和使用方法。