Weblate 4.9.1 用户文档

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

摘要

文档详细介绍了Weblate 4.9.1的功能和使用指南，包括项目和组件的架构、翻译流程的操作、版本控制的集成、REST API的使用以及管理员的配置手册。文档还记录了Weblate 4.9.1和4.9版本的更新日志，展示了错误修复、功能改进和新特性的添加。

AI总结

《Weblate 4.9.1 用户文档》主要介绍了Weblate的功能、使用方法及管理员指南，以下是核心内容的总结：

### 1. 用户文档
#### 1.1 基础知识
- **项目与组件架构**：Weblate将翻译内容组织为项目和组件，项目下可包含多个组件，每个组件对应一种翻译文件（如gettext或Android资源）。默认情况下，项目内的公共字符串可以跨组件传播，减少重复翻译。

#### 1.2 注册与用户个人资料
- **注册流程**：用户需填写注册表单并通过邮件激活账号，注册后可保存翻译并获得贡献credit。
- **个人资料设置**：可选语言能力以优化翻译体验。

#### 1.3 使用Weblate进行翻译工作
- **翻译流程**：支持上传、下载翻译文件，提供术语表、翻译检查、搜索功能及完整的翻译工作流。

#### 1.4 翻译文件管理
- **下载与上传**：支持多种文件格式的翻译文件管理，包括PO、XLIFF、JSON等。
- **术语表**：为翻译提供标准化术语，确保一致性。

#### 1.5 检查与修正
- **质量控制**：提供自动化检查工具，包括格式检查、翻译一致性验证等。

#### 1.6 搜索
- **高级搜索**：支持多条件搜索，包括翻译内容、上下文信息等。

#### 1.7 翻译工作流
- **流程管理**：支持从资源上传到翻译完成的完整流程，包括源文件更新、翻译记忆库应用等。

#### 1.8 常见问题
- **FAQ**：解答常见的使用问题，包括文件格式、翻译流程、权限设置等。

#### 1.9 支持的文件格式
- **多格式支持**：包括gettext（.po、.pot）、XLIFF（.xlf）、Android资源文件（.xml）、JSON、Java属性文件（.properties）等。

#### 1.10 版本控制集成
- **VCS集成**：支持Git、GitHub、GitLab、Gitea、Mercurial等版本控制系统，提供仓库浏览和操作功能。

#### 1.11 REST API
- **API功能**：提供REST API接口，支持项目、组件、翻译文件的创建、读取、更新、删除操作，扩展了API的覆盖范围。

#### 1.12 Weblate客户端
- **客户端工具**：提供命令行工具，方便用户进行翻译文件的上传、下载和管理。

#### 1.13 Python API
- **脚本化操作**：支持通过Python API进行自动化操作，包括翻译记忆库访问、组件管理等。

### 2. 管理员文档
#### 2.1 配置手册
- **部署指南**：详细说明了Weblate的安装、配置及上线步骤，包括依赖项管理、性能优化等。

#### 2.2 部署
- **环境要求**：支持Python 3.6及以上版本，推荐使用Docker容器化部署。

#### 2.3 升级
- **版本升级**：提供详细的升级步骤和注意事项，确保数据迁移和功能兼容。

#### 2.4 备份与迁移
- **数据安全**：支持自动备份及手动备份，确保数据安全；提供数据迁移指南，方便服务器迁移。

#### 2.5 身份验证
- **权限管理**：支持多种身份验证方式，包括本地账号、LDAP、GitHub、GitLab、Google等OAuth2认证。

#### 2.6 访问控制
- **权限控制**：提供详细的权限管理，包括项目访问控制、翻译权限、管理权限等。

#### 2.7 翻译项目管理
- **项目与组件**：支持创建、配置和管理翻译项目及组件，提供项目概览、组件列表和组件配置等功能。

#### 2.8 语言定义
- **语言支持**：提供多种语言的定义及配置，包括语言代码、翻译工具支持等。

#### 2.9 持续本地化集成
- **CI/CD集成**：支持将Weblate集成到持续集成/持续交付流程中，提供自动化翻译和验证。

#### 2.10 翻译许可
- **许可管理**：支持设置翻译许可协议，确保翻译内容的合规性。

#### 2.11 翻译进程
- **进程监控**：提供翻译进度统计、用户贡献度等数据，帮助跟踪翻译项目进展。

#### 2.12 检查与修正
- **质量保证**：提供多种检查工具，包括翻译一致性检查、格式验证、机器翻译后校对等。

#### 2.13 机器翻译
- **自动翻译**：集成了多种机器翻译服务，包括Google Translate、DeepL、Microsoft Translator等。

#### 2.14 附加组件
- **功能扩展**：提供多种附加组件，包括自动翻译、翻译记忆库、格式转换、安全检查等。

#### 2.15 翻译记忆库
- **记忆库管理**：支持翻译记忆库的创建、管理和使用，提升翻译效率。

#### 2.16 配置
- **系统配置**：详细说明了Weblate的配置选项，包括性能优化、安全设置、邮件配置等。

#### 2.17 配置示例
- **配置实例**：提供多种配置示例，帮助管理员快速上手。

#### 2.18 管理命令
- **命令行工具**：提供多种管理命令，包括用户管理、数据导入/导出、系统维护等。

#### 2.19 公告
- **通知功能**：支持在系统中发布公告，及时通知用户重要信息。

#### 2.20 组件列表
- **组件管理**：提供组件的概览、配置和操作功能。

#### 2.21 可选模块
- **模块化扩展**：支持通过模块扩展Weblate的功能，提供自定义化配置。

#### 2.22 定制Weblate
- **个性化定制**：支持界面定制、功能扩展及工作流程定制，满足个性化需求。

#### 2.23 管理界面
- **界面功能**：提供直观的管理界面，方便管理员进行系统配置和监控。

#### 2.24 支持
- **获取支持**：提供多种获取支持的渠道，包括文档、社区支持、商业支持等。

### 3. 更新日志
#### 4.9.1版本更新
- **Bug修复**：修复了单语言文件上传问题、统计数据显示问题、GitHub SSH密钥变更适配性问题。
- **功能改进**：优化了API过滤功能、翻译记忆库应用、机器翻译错误处理。

#### 4.9版本更新
- **新功能**：新增了翻译文件下载限制、Markdown支持、ICU MessageFormat检查、SSH调用自定义。
- **性能优化**：提升了翻译页面加载速度、Git仓库获取性能。
- **安全增强**：修复了潜在的安全漏洞，优化了配置错误报告。

### 4. 技术细节
- **前端技术**：基于Bootstrap、jQuery等主流框架构建，支持主流浏览器。
- **依赖管理**：使用yarn管理前端依赖，提供自动化更新和构建脚本。
- **代码风格**：采用Prettier和ESLint保证代码质量。
- **本地化支持**：提供多语言支持，方便用户根据需要切换界面语言。

### 总结
Weblate 4.9.1是一款功能强大的开源翻译管理平台，支持多种文件格式、版本控制系统和机器翻译服务。其完善的权限管理、质量控制和扩展性使其适用于个人和团队的翻译项目。通过REST API和Python API，可以方便地与其他系统集成，满足自动化和个性化的需求。管理员可通过详细的配置手册和管理命令，轻松部署、维护和扩展Weblate系统。