Add gentoo installation guide, update mirror switching method, and display the latest download link (#83)

Author: a1gorhythm7

Package-Manager/installation.md renamed to Package-Manager/installation.mdx

@@ -2,15 +2,20 @@
 sidebar_position: 2
 ---
 
+import ReleaseProvider, { DownloadRuyi } from '@site/src/pages/LatestReleases';
+
 # 安装
 
 让我们从 RuyiSDK 包管理器的安装开始。
 
 本文档使用 ``~`` 表示当前普通用户的家目录，必要时使用 ``/home/foo`` 作为家目录绝对路径示例。
 
+<ReleaseProvider>
+  <>
+
 ## 使用预编译的二进制安装
 
-目前 RuyiSDK 包管理器工具为 **Linux** 系统预编译了  **amd64**、**arm64**、**riscv64** 三种架构的二进制，它不依赖系统 Python，适用范围较为广泛。
+目前 RuyiSDK 包管理器工具为 **Linux** 系统预编译了 **amd64**、**arm64**、**riscv64** 三种架构的二进制，它不依赖系统 Python，适用范围较为广泛。
 
 它们同时发布在 GitHub Release 和 ISCAS 镜像站上：
 
@@ -21,21 +26,18 @@ sidebar_position: 2
 
 如果输出为 ``x86_64``：
 
-```bash
-$ wget https://mirror.iscas.ac.cn/ruyisdk/ruyi/releases/0.31.0/ruyi.amd64
-```
+<DownloadRuyi arch="x86_64" />
 
 如果输出为 ``aarch64``：
 
-```bash
-$ wget https://mirror.iscas.ac.cn/ruyisdk/ruyi/releases/0.31.0/ruyi.arm64
-```
+<DownloadRuyi arch="aarch64" />
 
 如果输出为 ``riscv64``：
 
-```bash
-$ wget https://mirror.iscas.ac.cn/ruyisdk/ruyi/releases/0.31.0/ruyi.riscv64
-```
+<DownloadRuyi arch="riscv64" />
+
+您也可以浏览 [RuyiSDK 镜像](https://mirror.iscas.ac.cn/ruyisdk/ruyi/releases/) 以获取更新的版本。您也可以选择从 [GitHub releases](https://github.com/ruyisdk/ruyi/releases) 下载。
+
 
 下面以 ``x86_64`` 架构为例，给下载的二进制添加执行权限：
 
@@ -55,6 +57,8 @@ $ sudo cp -v ruyi.amd64 /usr/local/bin/ruyi
 
 ## 使用系统包管理器安装
 
+### Arch Linux
+
 目前 Arch Linux 用户可以使用系统包管理器安装和卸载 Ruyi 包管理器，相对于使用预编译的二进制安装，维护更加便利；使用系统 Python 也可以获得更好的性能。
 
 从 AUR 安装，以 ``yay`` 为例，注意应当使用普通用户：
@@ -77,6 +81,56 @@ $ sudo pacman -Sy
 $ sudo pacman -S ruyi
 ```
 
+
+### Gentoo Linux
+
+Gentoo Linux 用户可参考以下步骤，通过官方提供的 `ruyisdk-overlay` 安装并配置 Ruyi 包管理器（`ruyi`）。
+
+
+
+1. 安装 `eselect-repository` 与 Git 客户端：
+
+```bash
+sudo emerge --ask app-eselect/eselect-repository dev-vcs/git
+```
+
+2. 确保系统已添加主 Gentoo 仓库（通常已默认配置）。
+
+
+3. 使用 `eselect-repository` 添加 `ruyisdk-overlay`
+
+```bash
+sudo eselect repository add ruyisdk git https://github.com/ruyisdk/ruyisdk-overlay.git
+```
+
+4. 同步仓库
+
+```bash
+sudo emaint sync -r ruyisdk
+```
+
+5. 接受测试关键字（Unmask）
+
+Ruyi 的 ebuild 被标记为测试版本 (`~amd64`)，需要解屏蔽才能安装。
+
+```bash
+sudo emerge dev-util/ruyi --autounmask-write --autounmask
+sudo dispatch-conf
+```
+
+1. 第一条命令会生成必要的 `package.accept_keywords` 改动。
+2. 运行 `dispatch-conf` ，并在界面中输入 `u`（use-new）接受改动。
+
+
+6. 安装 Ruyi 包管理器
+
+```bash
+sudo emerge --ask dev-util/ruyi
+```
+
+---
+
+
 ## 验证你的安装
 
 ```bash
@@ -85,6 +139,7 @@ $ ruyi version
 
 命令应当可以正常运行并打印版本和 Copyright 信息，如果失败请检查系统环境或重新尝试安装。
 
+
 ## 开始使用
 
 至此 Ruyi 包管理器已经成功安装在您的系统中。可以从 Ruyi 本身帮助信息中了解使用方法，或继续阅读本文档。
@@ -95,3 +150,5 @@ $ ruyi version
 $ ruyi --help
 ```
 
+  </>
+</ReleaseProvider>

Package-Manager/packages.md

@@ -14,24 +14,24 @@ $ ruyi update
 
 软件包缓存将存放在用户目录中，通常为 ``~/.cache/ruyi/packages-index/`` ；在 ``XDG_CACHE_HOME`` 环境变量被设置时，目录为 ``$XDG_CACHE_HOME/ruyi/packages-index/`` 。
 
-### ``ruyi update`` 拉取失败
+### `ruyi update` 拉取失败
 
-由于目前软件包索引信息托管于 GitHub 仓库，若出现仓库访问不稳定的情况，可在配置文件中配置使用 [备用仓库](https://mirror.iscas.ac.cn/git/ruyisdk/packages-index.git)。
+由于目前软件包索引信息托管于 GitHub 仓库，若出现仓库访问不稳定的情况，可以使用 `ruyi config` 子命令来配置使用[备用仓库](https://mirror.iscas.ac.cn/git/ruyisdk/packages-index.git)。
 
-Ruyi 包管理器的配置文件默认存放在 ``~/.config/ruyi/config.toml``，在 ``XDG_CONFIG_HOME`` 被配置的时候为 ``$XDG_CONFIG_HOME/ruyi/config.toml``。文件不存在可以自行建立。
+```bash
+# 查看当前仓库配置
+$ ruyi config get repo
 
-```
-[repo]
-local = ""
-remote = "https://mirror.iscas.ac.cn/git/ruyisdk/packages-index.git"
-branch = "main"
-```
+# 将远程仓库切换到中国科学院镜像
+$ ruyi config set repo.remote https://mirror.iscas.ac.cn/git/ruyisdk/packages-index.git
 
-其中 ``local`` 为本地缓存目录， ``remote`` 为远程镜像源地址， ``branch`` 为镜像所在 git 分支。
+# （可选）修改默认分支，通常为 main
+$ ruyi config set repo.branch main
 
-保存配置后重新尝试刷新本地缓存：
+# （可选）修改本地缓存目录
+$ ruyi config set repo.local /your/custom/cache/path
 
-```bash
+# 配置修改完成后，重新刷新本地软件包缓存
 $ ruyi update
 ```