Weblate版本控制系统(VCS)集成深度解析

Weblate版本控制系统(VCS)集成深度解析

weblate Web based localization tool with tight version control integration. 项目地址: https://gitcode.com/gh_mirrors/we/weblate

版本控制系统支持概述

Weblate作为专业的本地化平台，提供了与多种版本控制系统(VCS)的深度集成。目前主要支持Git和Mercurial两大版本控制系统，其中对Git的支持最为全面。

支持的VCS类型

• Git：完整支持标准Git协议，并针对多个主流代码托管平台进行了优化：

  • GitHub
  • GitLab
  • Gitea
  • Gerrit
  • Bitbucket(Cloud和Data Center版本)
  • Azure DevOps
  • 通过Git-SVN支持SVN仓库

• Mercurial：支持基本的Mercurial仓库操作

仓库访问机制详解

Weblate访问代码仓库的方式取决于仓库的可见性和托管平台特性。

公开仓库访问

对于公开仓库，只需提供正确的仓库URL即可，如：

https://example.com/org/repo.git

私有仓库访问

私有仓库需要更复杂的认证配置，常见方式包括：

SSH密钥认证（推荐）

1. 生成Weblate SSH密钥：

   • Weblate会自动生成RSA和Ed25519两种密钥
   • 管理员可在后台管理界面查看公钥
   • 建议备份私钥

2. 配置服务器访问：

   • 将Weblate公钥添加到代码托管平台的账户中
   • 为账户分配适当的仓库访问权限

3. SSH主机密钥验证：

   • Weblate会首次连接时记录主机密钥指纹
   • 管理员可预先添加并验证主机密钥

HTTPS认证

对于不支持SSH或需要临时访问的情况：

https://username:access_token@example.com/repo.git

• 注意特殊字符需要进行URL编码
• 从Weblate 5.10.2开始，使用Git 2.46.0+时支持主动认证

代理配置

如需通过代理访问仓库，可通过以下方式配置：

1. 设置环境变量：http_proxy, https_proxy
2. 或配置Git全局代理：

git config --global http.proxy http://user:pass@proxy.example.com:80

平台专用集成方案

GitHub集成

• SSH限制：每个SSH密钥只能用于一个GitHub账户
• 解决方案：
  • 为Weblate创建专用GitHub用户
  • 或使用HTTPS+个人访问令牌认证
  • 或通过fork仓库方式推送变更

GitLab集成

• 支持通过API创建合并请求(Merge Request)
• 需要配置GITLAB_CREDENTIALS设置

Bitbucket集成

• Cloud版本：使用Bitbucket Cloud API
• Data Center版本：使用Bitbucket Server API
• 两者需要不同的凭证配置

Azure DevOps集成

• 通过Azure DevOps API创建拉取请求
• 需要配置相应的API凭证

高级配置技巧

内部URL引用

使用weblate://project/component格式可以：

• 多个组件共享同一仓库配置
• 节省服务器存储空间
• 加速仓库更新
• 统一管理翻译导出

Git远程助手

通过Git远程助手可以扩展支持其他VCS：

• Bazaar：bzr::lp:project
• Mercurial：hg::https://example.com/repo

自定义Git配置

Weblate执行Git命令时使用$DATA_DIR/home作为HOME目录，因此：

• Git配置应放在DATA_DIR/home/.gitconfig
• 代理等设置需要在此配置

安全最佳实践

1. 密钥管理：

   • 定期轮换SSH密钥
   • 限制密钥的访问权限
   • 备份私钥

2. 访问控制：

   • 为Weblate创建专用账户
   • 遵循最小权限原则

3. 协议选择：

   • 优先使用SSH协议
   • 使用Ed25519密钥替代RSA

4. 旧版SSH兼容： 对于旧版SSH服务器，可在DATA_DIR/ssh/config中添加：

   Host legacy-host
      HostkeyAlgorithms +ssh-rsa
      PubkeyAcceptedAlgorithms +ssh-rsa
   

常见问题排查

1. 连接失败：

   • 检查SSH密钥是否正确配置
   • 验证主机密钥是否匹配
   • 确认防火墙设置

2. 推送问题：

   • 检查账户是否有写权限
   • 验证分支保护规则

3. 认证问题：

   • HTTPS认证注意特殊字符编码
   • API令牌确保有足够权限

通过合理配置版本控制系统集成，Weblate能够无缝融入您的开发工作流，实现翻译与代码的协同管理。根据项目需求选择合适的集成方式，并遵循安全最佳实践，可以构建高效可靠的本地化工作流程。

weblate Web based localization tool with tight version control integration. 项目地址: https://gitcode.com/gh_mirrors/we/weblate