GitLab CE 中文版(简体与繁體)
(20170524:因 GitLab 从 v9.2 开始将陆续支持多语言,故此项目已被新的 fork 所取代)
一、项目说明
1.1 起源
此项目以 GitLab CE v9.0.1 为汉化起点,始于平民于自己所在公司搭建 v8.17.3 的那一天(20170314)。其中,简体中文版分支( zh-cn-old
),基于 v9.0.1
和 v9.0.1-zh
修改,后者来源于 @larryli 发起的 [ GitLab 中文社区版 ] ( https://gitlab.com/larryli/gitlab ) 项目(7.3-zh
~ 7.11-zh
, v8.0.5.zh1
~ v8.8.5.zh1
),以及 @xhang 对其的 [ 延续 ] ( https://gitlab.com/xhang/gitlab ) 项目(v8.11.11.zh
~ v9.0.1-zh
+)。于此,特别感谢他们两位及其他众多翻译贡献者(如 @twang2218 等),让大家目前在官方支持中文前可以更方便地使用 GitLab !
1.2 GPG 签名
为保证数据的安全性,目前平民已默认对 Git 提交和标签都进行了 GPG 签名,建议大家在汉化时先验证标签的 GPG 签名!具体可参见 《GPG 钥匙使用说明》 。
1.3 繁体中文版
繁體中文版的兩個分支( zh-tw-old
和 zh-hk-old
)正在翻譯中,歡迎 fork 或 直接點擊項目首頁 “Request Acess” 加入,一起協作翻譯。期待我們的第一個繁體中文版可以早日上線!(20170402)
二、汉化指南
(以 zh-cn-old
分支为例)
注:如果汉化中出现问题,请重新安装 GitLab,安装前注意备份数据。
2.1 Omnibus 安装汉化
2.1.1 手动导出汉化补丁包汉化
请先使用官方包安装或升级完成,确认当前版本。
sudo cat /opt/gitlab/embedded/service/gitlab-rails/VERSION
假设当前版本为 v9.0.1
,并确认汉化版本库是否包含该版本的汉化标签(-zh-cn
结尾),即是否包含 v9.0.1-zh-cn
。
如果版本相同,首先在本地 clone
仓库。
# 克隆汉化版本库
git clone https://gitlab.com/Fenlly/gitlab-ce-zh.git
# 如果已经克隆过,则进行更新
git fetch
然后比较汉化标签和原标签,导出打补丁用的 diff 文件。为保证数据传输过程中的安全性等,建议对标签进行 GPG 签名验证。
# 导出 9.0.1 版本的汉化补丁
git diff v9.0.1 v9.0.1-zh-cn > ../9.0.1-zh-cn.diff
然后上传 9.0.1-zh-cn.diff
文件到服务器。
# 停止 gitlab
sudo gitlab-ctl stop
# 打汉化补丁
## 使用 patch 工具
sudo patch -d /opt/gitlab/embedded/service/gitlab-rails -p1 < /path/to/9.0.1-zh-cn.diff
## 或使用 git 工具
cd /opt/gitlab/embedded/service/gitlab-rails
sudo git apply /path/to/9.0.1-zh-cn.diff
确定没有 .rej
文件,重启 GitLab 即可。
sudo gitlab-ctl start
执行重新配置命令
sudo gitlab-ctl reconfigure
2.2 源码安装汉化
源码安装推荐按照 gitlab-ce 源代码中 doc/install/installation.md 的内容手工安装 GitLab 中文版本。
相关修改只需要在 Clone the Source 步骤中使用 https://gitlab.com/Fenlly/gitlab-ce-zh.git
仓库和当前版本的后缀增加 -zh-cn
即可。
另外也可以在 Install Gems 步骤中使用 https://gems.ruby-china.org
镜像加快 gems
安装。具体步骤如下:
cd /home/git/gitlab
sudo -u git -H bundle config mirror.https://rubygems.org https://gems.ruby-china.org
# 如果使用的是 PostgreSQL (注意,选项中包含 "without ... mysql")
sudo -u git -H bundle install --deployment --without development test mysql aws kerberos
# 或者如果你用的是 MySQL (注意,选项中包含 "without ... postgres")
sudo -u git -H bundle install --deployment --without development test postgres aws kerberos
对于升级操作也可以按照相应的 update.md 类似处理即可。
参考文献
平民,20170402 ~ 0524