添加gentoo.git源的帮助文档 (#237)

* Create gentoo.git.rst

new file:gentoo.git.rst

* 一些小优化

* 添加gentoo.git

source/gentoo-portage.rst

@@ -5,12 +5,12 @@ Gentoo Portage 源使用帮助
 地址
 ====
 
-https://mirrors.ustc.edu.cn/gentoo-portage/
+https://mirrors.ustc.edu.cn/gentoo-portage
 
 说明
 ====
 
-Gentoo Portage 软件源
+Gentoo Portage Ebuild 源（Rsync 方式同步）
 
 收录架构
 ========
@@ -30,9 +30,15 @@ ALL
   [gentoo]
   location = /usr/portage
   sync-type = rsync
-  sync-uri = rsync://rsync.mirrors.ustc.edu.cn/gentoo-portage/
+  sync-uri = rsync://rsync.mirrors.ustc.edu.cn/gentoo-portage
   auto-sync = yes
 
+相关镜像
+========
+
+- :doc:`gentoo`
+- :doc:`gentoo.git`
+
 相关链接
 ========
 

source/gentoo.git.rst

@@ -0,0 +1,91 @@
+=========================
+Gentoo Git 源使用帮助
+=========================
+
+地址
+====
+
+https://mirrors.ustc.edu.cn/gentoo.git
+
+说明
+====
+
+Gentoo Portage Ebuild 源 （Git 方式同步）
+
+收录架构
+========
+
+ALL
+
+使用说明
+========
+
+请确保系统中已安装 ``dev-vcs/git``。
+
+修改 :file:`/etc/portage/repos.conf/gentoo.conf` 中的 ``sync-type`` 为 ``git``，``sync-uri`` 为 ``https://mirrors.ustc.edu.cn/gentoo.git`` 。
+
+以下是修改后的：
+
+::
+
+  [DEFAULT]
+  main-repo = gentoo
+
+  [gentoo]
+  location = /var/db/repos/gentoo
+  sync-type = git
+  sync-uri = https://mirrors.ustc.edu.cn/gentoo.git
+  auto-sync = yes
+  sync-rsync-verify-jobs = 1
+  sync-rsync-verify-metamanifest = yes
+  sync-rsync-verify-max-age = 24
+  sync-openpgp-key-path = /usr/share/openpgp-keys/gentoo-release.asc
+  sync-openpgp-keyserver = hkps://keys.gentoo.org
+  sync-openpgp-key-refresh-retry-count = 40
+  sync-openpgp-key-refresh-retry-overall-timeout = 1200
+  sync-openpgp-key-refresh-retry-delay-exp-base = 2
+  sync-openpgp-key-refresh-retry-delay-max = 60
+  sync-openpgp-key-refresh-retry-delay-mult = 4
+  sync-webrsync-verify-signature = yes
+
+- 第一次使用 ``Git``  同步方式的用户（从 ``Rsync`` 方式同步换到 ``Git`` 方式同步）：
+
+按照上述教程更改完 :file:`/etc/portage/repos.conf/gentoo.conf`，需要：
+
+::
+
+  # 删除本地 main tree 目录
+  rm -rf /var/db/repos/gentoo
+
+  # 重新同步
+  emerge --sync
+
+- 已经配置过 ``Git`` 同步方式的用户（其他镜像站换中科大源）只需要：
+
+更改完 :file:`/etc/portage/repos.conf/gentoo.conf`：
+
+::
+
+  # 进入 main tree 目录
+  cd /var/db/repos/gentoo
+
+  # 将 remote url 设置为中科大
+  git remote set-url origin https://mirrors.ustc.edu.cn/gentoo.git
+
+  # 重新同步
+  emerge --sync
+
+相关镜像
+========
+
+- :doc:`gentoo`
+- :doc:`gentoo-portage`
+
+相关链接
+========
+
+:官方主页: https://www.gentoo.org/
+:邮件列表: https://www.gentoo.org/main/en/lists.xml
+:论坛: https://forums.gentoo.org/
+:文档: https://www.gentoo.org/doc/en/
+:Wiki: https://wiki.gentoo.org/

source/index.rst

@@ -26,6 +26,7 @@ USTC Mirror Help
    freebsd-ports
    gentoo
    gentoo-portage
+   gentoo.git
    kali
    linuxmint
    mageia