The Weblate Manual 3.4

### 《The Weblate Manual 3.4》总结 #### 升级指南（3.3 到 3.4） - **升级步骤**：按照通用升级指南进行更新。 - **配置或依赖变更**： - Celery 现在支持多队列，建议更新到新的工人设置。 - 新增依赖：`diff-match-patch` 和 `translation-finder`。 - **从 Python 2 迁移到 Python 3**： 1. 备份翻译记忆：`./manage.py dump_memory > memory.json`。 2. 升级到 Python 3。 3. 删除翻译记忆数据库：`./manage.py delete_memory --all`。 4. 恢复翻译记忆：`./manage.py import_memory memory.json`。 5. 重建全文索引：`./manage.py rebuild_index --clean --all`。 6. 清理头像缓存（如使用文件缓存）：`./manage.py cleanup_avatar_cache`。 7. 建议清除缓存。 #### 从 Pootle 迁移 - 支持从 Pootle 迁移用户账户，但可能导致意外问题。如不需要，建议移除相关权限。 #### 翻译项目组织 - Weblate 将可翻译内容组织成树状结构： - **项目配置**：包含所有相关翻译（如应用程序的多个版本及文档）。 - **组件配置**：定义 VCS 仓库和翻译文件掩码。 - **翻译**：自动处理翻译文件，匹配组件配置中的掩码。 - 支持多种翻译格式（双语和单语），参考 [Supported formats](https://docs.weblate.org/)。 - **克隆 VCS 仓库**：建议使用 Weblate 内部 URL 共享克隆仓库，提升性能并减少磁盘空间。 #### 新增功能与改进 - **3.4 版本**： - 支持 XLIFF 占位符。 - Celery 支持多任务队列。 - 支持重命名和移动项目及组件。 - 报表中包含字符计数。 - 自动检测翻译文件并指导添加组件。 - 自定义 Git 合并提交消息。 - 显示组件警报的视觉指示。 - 优化了翻译文件加载性能。 - 新增 squash 提交前的addon。 - 改善翻译更改的显示。 - 默认合并样式改为 rebase 并支持配置。 - 更好地处理语言代码中的私用子标签。 - 优化全文索引更新性能。 - 文件上传 API 支持更多参数。 - **3.3 版本**： - 支持删除项目和组件。 - 优化单语翻译的性能。 - 翻译组件警报突出问题。 - expose XLIFF 字符串 resname 作为上下文。 - 支持 XLIFF 状态。 - 检查 DATA_DIR 中不可写文件。 - 改善 CSV 导出为更改。 - **3.2.2 版本**： - 移除不再需要的 Babel 依赖。 - 更新语言定义。 - 优化质量检查性能。 - 修复 sitewide 搜索失败检查。 - 支持指定源语言。 - 改善 XLIFF 文件支持。 - 扩展 `import_project` 选项。 - 优化全文搜索索引。 - 新增自动翻译管理命令。 - 新增占位符突出显示和快捷键。 - 改善翻译锁定处理。 - 支持 AngularJS 插值质量检查。 - 添加基于组的 ACL。 #### 配置选项 - **DEFAULT_MERGE_STYLE**：新组件的默认合并样式（默认为 rebase）。 - **DEFAULT_TRANSLATION_PROPAGATION**：默认设置翻译传播（默认为 True）。 - **DEFAULT_PULL_MESSAGE**：默认拉取请求标题。 - **ENABLE_AVATARS**：启用基于 Gravatar 的用户头像（默认启用）。 - **ENABLE_HOOKS**：启用匿名远程钩子（默认启用）。 - **REGISTRATION_EMAIL_MATCH**：限制注册邮箱域名。 - **REGISTRATION_OPEN**：允许新账户注册（默认 True）。 - **SUGGESTION_CLEANUP_DAYS**：自动删除建议的天数（默认无限期保留）。 #### 主要变化与改进 - 支持多种翻译格式和 VCS 仓库。 - 优化性能和用户体验。 - 增强安全性和配置灵活性。 - 改善机器翻译和自动化功能。 - 增加了更多管理命令和 API 支持。 以上总结涵盖了 Weblate 3.4 的核心升级信息、功能改进和配置选项，重点突出了关键变化和操作步骤。