更新文档

2025-11-03 16:00:26 +08:00 · 2025-04-08 02:28:46 +08:00
parent e63dea7e64
commit 984cfa4eed
14 changed files with 287 additions and 249 deletions
--- a/ChangeMirrors.sh
+++ b/ChangeMirrors.sh
@@ -631,7 +631,16 @@ function run_end() {
        echo ''
        return
    fi
-    echo -e "\n✨ 脚本运行完毕，更多使用教程详见官网 👉 \033[3mhttps://linuxmirrors.cn\033[0m\n\n🔥 1Panel · Linux 面板｜极简运维 ➜  https://1panel.cn \033[3;2m【广告】\033[0m\n🔥 林枫云 · 专注独立IP高频VPS｜R9/i9系列定制 ➜  https://www.dkdun.cn \033[3;2m【广告】\033[0m\n\n\033[3;1mPowered by \033[34mLinuxMirrors\033[0m\n"
+    local sponsor_ad=(
+        "🔥 1Panel · Linux 面板｜极简运维 ➜  https://1panel.cn \033[3;2m【广告】\033[0m"
+        "🔥 林枫云 · 专注独立IP高频VPS｜R9/i9系列定制 ➜  https://www.dkdun.cn \033[3;2m【广告】\033[0m"
+        "🔥 乔星欢 · 香港4核4G服务器28元起_香港500Mbps大带宽 ➜  https://www.qiaoxh.com \033[3;2m【广告】\033[0m"
+    )
+    echo -e "\n✨ 脚本运行完毕，更多使用教程详见官网 👉 \033[3mhttps://linuxmirrors.cn\033[0m\n"
+    for ad in "${sponsor_ad[@]}"; do
+        echo -e "  ${ad}"
+    done
+    echo -e "\n\033[3;1mPowered by \033[34mLinuxMirrors\033[0m\n"
 }

 ## 报错退出
--- a/DockerInstallation.sh
+++ b/DockerInstallation.sh
@@ -340,7 +340,16 @@ function run_end() {
        echo ''
        return
    fi
-    echo -e "\n✨ 脚本运行完毕，更多使用教程详见官网 👉 \033[3mhttps://linuxmirrors.cn\033[0m\n\n🔥 1Panel · Linux 面板｜极简运维 ➜  https://1panel.cn \033[3;2m【广告】\033[0m\n🔥 林枫云 · 专注独立IP高频VPS｜R9/i9系列定制 ➜  https://www.dkdun.cn \033[3;2m【广告】\033[0m\n\n\033[3;1mPowered by \033[34mLinuxMirrors\033[0m\n"
+    local sponsor_ad=(
+        "🔥 1Panel · Linux 面板｜极简运维 ➜  https://1panel.cn \033[3;2m【广告】\033[0m"
+        "🔥 林枫云 · 专注独立IP高频VPS｜R9/i9系列定制 ➜  https://www.dkdun.cn \033[3;2m【广告】\033[0m"
+        "🔥 乔星欢 · 香港4核4G服务器28元起_香港500Mbps大带宽 ➜  https://www.qiaoxh.com \033[3;2m【广告】\033[0m"
+    )
+    echo -e "\n✨ 脚本运行完毕，更多使用教程详见官网 👉 \033[3mhttps://linuxmirrors.cn\033[0m\n"
+    for ad in "${sponsor_ad[@]}"; do
+        echo -e "  ${ad}"
+    done
+    echo -e "\n\033[3;1mPowered by \033[34mLinuxMirrors\033[0m\n"
 }

 ## 报错退出
--- a/docs/assets/images/sponsor/qiaoxh-dark.svg
+++ b/docs/assets/images/sponsor/qiaoxh-dark.svg
--- a/docs/assets/images/sponsor/qiaoxh-light.svg
+++ b/docs/assets/images/sponsor/qiaoxh-light.svg
--- a/docs/index.md
+++ b/docs/index.md
@@ -125,21 +125,4 @@ hide:

 [开 始 使 用](use/index.md){ .md-button .md-button--primary } &nbsp; [查看软件源列表](mirrors/index.md){ .md-button }

-<div class="md-nav__sponsor-bottom" style="border-top: none; margin-top: 0">
-  <div class="sponsor-label">
-    <strong>赞助商</strong>
-  </div>
-  <div class="sponsor-wrapper sponsor-flex-wrapper">
-    <a class="sponsor-item sponsor-flex-item" target="_blank" href="https://1panel.cn" title="1Panel · 新一代的 Linux 服务器运维管理面板">
-      <img src="/assets/images/sponsor/1panel.png" alt="1Panel" style="width: 60%" />
-    </a>
-    <a class="sponsor-item sponsor-flex-item" target="_blank" href="https://www.dkdun.cn/aff/VAWGETUL" title="林枫云 · 专注独立IP高频VPS｜R9/i9系列定制">
-      <img src="/assets/images/sponsor/linfengyun-light.png#only-light" alt="林枫云" style="width: 60%" />
-      <img src="/assets/images/sponsor/linfengyun-dark.png#only-dark" alt="林枫云" style="width: 60%" />
-    </a>
-    <a class="sponsor-item sponsor-flex-item" target="_blank" href="https://arcadia.cool" title="Arcadia 一站式代码运维平台">
-      <img src="/assets/images/sponsor/arcadia-light.png#only-light" alt="Arcadia" style="width: 60%" />
-      <img src="/assets/images/sponsor/arcadia-dark.png#only-dark" alt="Arcadia" style="width: 60%" />
-    </a>
-  </div>
-</div>
+--8<-- "docs/sponsor/main.html"
--- a/docs/mirrors/index.md
+++ b/docs/mirrors/index.md
@@ -4,6 +4,8 @@ hide:
  - toc
  - feedback
  - footer
+search:
+  exclude: true
 ---

 ## 中国大陆 :flag-CN:
--- a/docs/sponsor/index.md
+++ b/docs/sponsor/index.md
@@ -6,29 +6,16 @@ hide:
  - footer
 ---

-<div class="md-nav__sponsor-bottom" style="border-top: none; margin-top: 0">
-  <div class="sponsor-label">
-    <strong>赞助商</strong>
-  </div>
-  <div class="sponsor-wrapper sponsor-flex-wrapper">
-    <a class="sponsor-item sponsor-flex-item" target="_blank" href="https://1panel.cn" title="1Panel · 新一代的 Linux 服务器运维管理面板">
-      <img src="/assets/images/sponsor/1panel.png" alt="1Panel" style="width: 60%" />
-    </a>
-    <a class="sponsor-item sponsor-flex-item" target="_blank" href="https://www.dkdun.cn/aff/VAWGETUL" title="林枫云 · 专注独立IP高频VPS｜R9/i9系列定制">
-      <img src="/assets/images/sponsor/linfengyun-light.png#only-light" alt="林枫云" style="width: 60%" />
-      <img src="/assets/images/sponsor/linfengyun-dark.png#only-dark" alt="林枫云" style="width: 60%" />
-    </a>
-    <a class="sponsor-item sponsor-flex-item" target="_blank" href="https://arcadia.cool" title="Arcadia 一站式代码运维平台">
-      <img src="/assets/images/sponsor/arcadia-light.png#only-light" alt="Arcadia" style="width: 60%" />
-      <img src="/assets/images/sponsor/arcadia-dark.png#only-dark" alt="Arcadia" style="width: 60%" />
-    </a>
-  </div>
-</div>
+--8<-- "docs/sponsor/main.html"

-# 成为赞助商
+#

-<button class="md-button md-button--primary" style="padding: 6px 20px 0 20px" title="https://afdian.com/a/SuperManito" onclick="window.open('https://afdian.com/a/SuperManito')">
-    ![](../assets/images/sponsor/ifdian.png){ width="120" }
-</button>
-
-> 点击按钮前往查看爱发电主页上的说明并与作者取得联系
+<figure style="margin: 0 auto" markdown>
+  <figcaption><h3 style="font-style: normal !important"><strong>成为赞助商</strong></h3></figcaption>
+  <figcaption>
+    <button class="md-button md-button--primary" style="padding: 4px 8px 0 8px; border-radius: 5px" title="https://afdian.com/a/SuperManito" onclick="window.open('https://afdian.com/a/SuperManito')">
+      <img src="/assets/images/sponsor/ifdian.png" alt="1Panel" style="width: 120px" />
+    </button>
+  </figcaption>
+  <figcaption><p style="color: var(--md-default-fg-color--light)">请前往作者爱发电主页查看说明并与作者取得联系</p></figcaption>
+</figure>
--- a/docs/sponsor/main.html
+++ b/docs/sponsor/main.html
@@ -0,0 +1,22 @@
+<div class="sponsor" style="border-top: none; margin-top: 0">
+  <div class="sponsor-label">
+    <strong>赞助商</strong>
+  </div>
+  <div class="sponsor-wrapper sponsor-flex-wrapper">
+    <a class="sponsor-item sponsor-flex-item" target="_blank" href="https://1panel.cn" title="新一代的 Linux 服务器运维管理面板">
+      <img src="/assets/images/sponsor/1panel.png" alt="1Panel" style="width: 60%" />
+    </a>
+    <a class="sponsor-item sponsor-flex-item" target="_blank" href="https://www.dkdun.cn/aff/VAWGETUL" title="林枫云 · 专注独立IP高频VPS｜R9/i9系列定制">
+      <img src="/assets/images/sponsor/linfengyun-light.png#only-light" alt="林枫云" style="width: 60%" />
+      <img src="/assets/images/sponsor/linfengyun-dark.png#only-dark" alt="林枫云" style="width: 60%" />
+    </a>
+    <a class="sponsor-item sponsor-flex-item" target="_blank" href="https://www.qiaoxh.com/?from=linuxmirrors.cn" title="乔星欢 · 香港4核4G服务器28元起_香港500Mbps大带宽">
+      <img src="/assets/images/sponsor/qiaoxh-light.svg#only-light" alt="乔星欢" style="width: 60%; margin-bottom: 6px" />
+      <img src="/assets/images/sponsor/qiaoxh-dark.svg#only-dark" alt="乔星欢" style="width: 60%; margin-bottom: 6px" />
+    </a>
+    <a class="sponsor-item sponsor-flex-item" target="_blank" href="https://arcadia.cool" title="一站式代码运维平台">
+      <img src="/assets/images/sponsor/arcadia-light.png#only-light" alt="Arcadia" style="width: 60%" />
+      <img src="/assets/images/sponsor/arcadia-dark.png#only-dark" alt="Arcadia" style="width: 60%" />
+    </a>
+  </div>
+</div>
--- a/docs/stylesheets/extra.css
+++ b/docs/stylesheets/extra.css
@@ -6,6 +6,21 @@
    --md-default-bg-color--dark: hsla(var(--md-hue), 15%, 14%, 1);
 }

+[data-md-color-primary=white] {
+    --md-typeset-a-color: #2080f0;
+}
+
+[data-md-color-scheme='slate'][data-md-color-primary=black] {
+    --md-typeset-a-color: #2080f0;
+}
+
+.md-typeset .admonition.tip, .md-typeset details.tip {
+    border-color: #009400;
+}
+.md-typeset .tip>.admonition-title, .md-typeset .tip>summary {
+    background-color: #0094001a;
+}
+
 .md-header {
    background-color: hsla(240, 9%, 75%, 0.33);
    -webkit-backdrop-filter: blur(8px);
@@ -85,25 +100,25 @@
    vertical-align: -0.35em !important;
 }

-.md-nav__sponsor-bottom {
+.sponsor {
    margin-top: 2rem;
    padding-top: 1rem;
    border-top: 1px solid var(--md-default-fg-color--lightest);
 }

-.md-nav__sponsor-bottom .sponsor-label {
+.sponsor .sponsor-label {
    font-size: 0.8rem;
    text-align: center;
    margin-bottom: 0.2rem;
    color: var(--md-default-fg-color);
 }

-.md-nav__sponsor-bottom .sponsor-wrapper {
+.sponsor .sponsor-wrapper {
    width: 100%;
    padding: 0.5rem 0;
 }

-.md-nav__sponsor-bottom .sponsor-item {
+.sponsor .sponsor-item {
    display: flex;
    align-items: center;
    justify-content: center;
@@ -116,11 +131,11 @@
    max-height: 80px;
 }

-.md-nav__sponsor-bottom .sponsor-item:hover {
+.sponsor .sponsor-item:hover {
    background-color: var(--md-code-bg-color);
 }

-.md-nav__sponsor-bottom .sponsor-item img {
+.sponsor .sponsor-item img {
    max-width: 100%;
    height: auto;
    vertical-align: middle;
@@ -139,14 +154,23 @@
    max-width: 300px;
 }

-@media screen and (max-width: 960px) {
+@media screen and (max-width: 768px) {
    .sponsor-flex-item {
        flex: 0 1 calc(50% - 1rem);
+        min-width: 150px;
+        max-width: calc(50% - 1rem);
+    }
+}
+
+@media screen and (max-width: 480px) {
+    .sponsor .sponsor-item {
+        padding: 0;
+        height: 40px;
    }
 }

@media screen and (max-width: 768px) {
-    .md-nav__sponsor-bottom {
+    .sponsor-toc {
        display: none;
    }
 }
--- a/docs/theme/partials/palette.html
+++ b/docs/theme/partials/palette.html
@@ -23,8 +23,9 @@
      if (typeof document.startViewTransition !== 'function') {
          return // 不支持 View Transitions API 的浏览器直接返回
      }
-      // 获取所有主题切换按钮
-      const themeToggles = document.querySelectorAll('.md-header__button.md-icon')
+      // 获取所有主题切换按钮 - 更精确的选择器
+      // 只选择form[data-md-component="palette"]内部的按钮，而不是所有md-header__button
+      const themeToggles = document.querySelectorAll('form[data-md-component="palette"] .md-header__button.md-icon')
      themeToggles.forEach((toggle) => {
          toggle.addEventListener(
              'click',
@@ -36,28 +37,12 @@
                  const targetId = this.getAttribute('for')
                  const targetInput = document.getElementById(targetId)
                  if (!targetInput) return
-                  // 获取当前存储的主题信息和即将切换到的主题信息
-                  const currentPalette = __md_get('__palette')
-                  const currentScheme = currentPalette?.color?.scheme || ''
-                  const currentMedia = currentPalette?.color?.media || ''
-                  // 获取新主题信息
-                  const newScheme = targetInput.getAttribute('data-md-color-scheme')
-                  const newMedia = targetInput.getAttribute('data-md-color-media')
-                  // 判断当前浏览器/系统主题
-                  const isSystemDark = window.matchMedia('(prefers-color-scheme: dark)').matches
-                  // 判断是否切换到暗色主题
-                  const isDark = newScheme != 'default'
-                  // 确定当前主题的实际暗色状态
-                  let isCurrentDark = currentScheme.includes('slate')
-                  if (currentMedia === '(prefers-color-scheme)') {
-                      isCurrentDark = isSystemDark
-                  }
-                  // 确定新主题的实际暗色状态
-                  let isNewDark = newScheme.includes('slate')
-                  if (newMedia === '(prefers-color-scheme)') {
-                      isNewDark = isSystemDark
-                  }
-                  // 如果当前主题和目标主题相同，则不需要动画
+                  // 获取当前主题状态
+                  const currentScheme = document.body.getAttribute('data-md-color-scheme')
+                  const isCurrentDark = currentScheme.includes('slate')
+                  // 点击后会切换到相反的主题
+                  const isNewDark = !isCurrentDark
+                  // 当前主题和目标主题相同则不触发动画
                  if (isCurrentDark === isNewDark) {
                      targetInput.click()
                      return
@@ -74,8 +59,8 @@
                          // 切换主题
                          targetInput.click()
                          // 添加暗/亮模式类，用于动画控制
-                          document.documentElement.classList.remove(isDark ? 'light' : 'dark')
-                          document.documentElement.classList.add(isDark ? 'dark' : 'light')
+                          document.documentElement.classList.remove(isNewDark ? 'light' : 'dark')
+                          document.documentElement.classList.add(isNewDark ? 'dark' : 'light')
                          // 等待主题变化完成
                          await new Promise((resolve) => setTimeout(resolve, 100))
                      })
@@ -83,12 +68,12 @@
                          // 视图过渡准备就绪，开始动画
                          document.documentElement.animate(
                              {
-                                  clipPath: isDark ? [...clipPath].reverse() : clipPath,
+                                  clipPath: isNewDark ? [...clipPath].reverse() : clipPath,
                              },
                              {
                                  duration: 500,
                                  easing: 'ease-in',
-                                  pseudoElement: isDark ? '::view-transition-old(root)' : '::view-transition-new(root)',
+                                  pseudoElement: isNewDark ? '::view-transition-old(root)' : '::view-transition-new(root)',
                              }
                          )
                      })
@@ -97,8 +82,7 @@
          )
      })
      // 初始化主题状态类
-      const currentPalette = __md_get('__palette')
-      const currentScheme = currentPalette?.color?.scheme || ''
+      const currentScheme = document.body.getAttribute('data-md-color-scheme')
      const isDark = currentScheme.includes('slate')
      document.documentElement.classList.add(isDark ? 'dark' : 'light')
  })
--- a/docs/theme/partials/toc.html
+++ b/docs/theme/partials/toc.html
@@ -9,19 +9,23 @@
  </ul>

  <div class="md-content" data-md-component="content">
-    <div class="md-nav__sponsor-bottom">
+    <div class="sponsor sponsor-toc">
      <div class="sponsor-label">
        <strong>赞助商</strong>
      </div>
      <div class="sponsor-wrapper">
-        <a class="sponsor-item" target="_blank" href="https://1panel.cn" title="1Panel · 新一代的 Linux 服务器运维管理面板">
+        <a class="sponsor-item" target="_blank" href="https://1panel.cn" title="新一代的 Linux 服务器运维管理面板">
          <img src="/assets/images/sponsor/1panel.png" alt="1Panel" style="width: 60%" />
        </a>
        <a class="sponsor-item" target="_blank" href="https://www.dkdun.cn/aff/VAWGETUL" title="林枫云 · 专注独立IP高频VPS｜R9/i9系列定制">
          <img src="/assets/images/sponsor/linfengyun-light.png#only-light" alt="林枫云" style="width: 60%" />
          <img src="/assets/images/sponsor/linfengyun-dark.png#only-dark" alt="林枫云" style="width: 60%" />
        </a>
-        <a class="sponsor-item" target="_blank" href="https://arcadia.cool" title="Arcadia 一站式代码运维平台">
+        <a class="sponsor-item" target="_blank" href="https://www.qiaoxh.com/?from=linuxmirrors.cn" title="乔星欢 · 香港4核4G服务器28元起_香港500Mbps大带宽">
+          <img src="/assets/images/sponsor/qiaoxh-light.svg#only-light" alt="乔星欢" style="width: 66%; margin-bottom: 6px" />
+          <img src="/assets/images/sponsor/qiaoxh-dark.svg#only-dark" alt="乔星欢" style="width: 66%; margin-bottom: 6px" />
+        </a>
+        <a class="sponsor-item" target="_blank" href="https://arcadia.cool" title="一站式代码运维平台">
          <img src="/assets/images/sponsor/arcadia-light.png#only-light" alt="Arcadia" style="width: 60%" />
          <img src="/assets/images/sponsor/arcadia-dark.png#only-dark" alt="Arcadia" style="width: 60%" />
        </a>
--- a/docs/use/index.md
+++ b/docs/use/index.md
@@ -110,7 +110,9 @@ hide:

 选项卡分别代表脚本内置软件源类型和获取脚本途径，请在使用前检查目标镜像站是否支持您所使用的操作系统，可以在[软件源列表](../mirrors/index.md)中查看具体有哪些软件源。

-!!! tip "默认自动备份原有软件源内容，如需了解更多请翻阅下方文档"
+!!! tip "默认自动备份原有软件源内容，如需了解更多请翻阅下方文档。若使用过程中的某些选项令你疑惑不解，那么在选择软件源后一路回车即是最佳实践。"
+
+</br>

 <div class="grid cards" markdown>

@@ -140,9 +142,9 @@ hide:

 </div>

- ### 常见问题
+### 常见问题

-    - #### 关于报错 Command not found
+- #### 关于报错 Command not found

    !!! quote ""

@@ -240,13 +242,13 @@ hide:

            如果以上方法试了都不行，那就复制[源码](https://gitee.com/SuperManito/LinuxMirrors/raw/main/ChangeMirrors.sh)至本地新建任意名称的 `.sh` 脚本，粘贴源码内容后通过 `bash` 指令手动执行。

-    - #### 备份原有软件源
+- #### 备份原有软件源

    !!! quote ""

        脚本会自动备份原有软件源内容，备份路径为原有文件或目录的绝对路径加上 `.bak` 后缀，例如 `/etc/apt/sources.list => /etc/apt/sources.list.bak`，当检查到已存在备份内容时会询问是否覆盖备份。

-    - #### 还原已备份的软件源
+- #### 还原已备份的软件源

    !!! quote ""

@@ -303,7 +305,7 @@ hide:
            cp -rf /etc/nix/nix.conf.bak /etc/nix/nix.conf
            ```

-    - #### 关于开启 SSH 远程登录的方法
+- #### 关于开启 SSH 远程登录的方法

    !!! quote ""

@@ -334,7 +336,13 @@ hide:

        > 命令以及配置步骤仅供参考，只适配了部分常见发行版

-    - #### 关于调用脚本的互联网位置
+- #### 关于未显示方向键交互控制界面
+
+    !!! quote ""
+
+        如果发现交互界面是输入而不是新式的方向键控制，那么请自行安装 `ncurses` 或 `nano` 软件包，新式的按键交互依赖 `tput` 指令实现。
+
+- #### 关于调用脚本的互联网位置

    !!! quote ""

@@ -342,7 +350,7 @@ hide:

        当然你也可以使用代码托管仓库的原始地址来调用，这里只是想告诉你为什么会有几个不同的地址，默认的官网地址更易于记忆和访问。

-    - #### 关于软件源下载速度相关问题
+- #### 关于软件源下载速度相关问题

    !!! quote ""

@@ -352,7 +360,7 @@ hide:

        网上也有很多基于 C、Python 编写的镜像站测速开源脚本，而本项目脚本基于 Bash Shell 编写且不依赖任何第三方库，Bash 是 Linux 运维中最常用的脚本语言并且绝大部分发行版都会预装，这意味着用户不需要安装任何环境就能直接运行，这种便利性是其它高级语言无法替代的，不过目前来看 Bash 脚本可能无法实现精准测速的功能，使用其它高级语言编写测速功能无疑是造轮子的行为。

-    - #### 关于未启用的软件源仓库
+- #### 关于未启用的软件源仓库

    !!! quote ""

@@ -374,13 +382,6 @@ hide:

            部分仓库默认没有启用，若需启用请将 `/etc/zypp/repos.d` 目录下相关 repo 文件中的 `enabled` 值修改为 `1`

-    - #### 其它
-
-        !!! quote ""
-
-            - 如果提示 `bash: /proc/self/fd/11: No such file or directory`，请切换至 `Root` 用户执行，切换命令为 `sudo -i` 或 `su root`
-            - 如果交互打印界面发现是输入而不是新式的方向键交互，那么请自行安装 `ncurses` 或 `nano` 软件包，新式的方向键交互依赖 `tput` 指令实现。
-

 ---

--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -48,12 +48,14 @@ theme:
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: white
+      accent: blue
      toggle:
        icon: octicons/sun-16
        name: 亮色模式
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: black
+      accent: blue
      toggle:
        icon: octicons/moon-16
        name: 暗黑模式
@@ -146,11 +148,19 @@ plugins:
  - search:
      lang: en
      separator: '[\s\-,:!=\[\]()"/]+|(?!\b)(?=[A-Z][a-z])|\.(?!\d)|&[lg]t;'
-  - exclude-search:
-      exclude:
-        - mirrors.md
  - tags
  - termynal
+  - minify:
+      minify_js: true
+      minify_css: true
+      htmlmin_opts:
+          remove_comments: true
+      cache_safe: true
+      js_files:
+        - assets/js/common.js
+        - assets/js/component.js
+        - assets/js/components/mirrors-table/data.js
+        - assets/js/components/mirrors-table/index.js
 nav:
  - "介绍": index.md
  - "使用方法": use/index.md
--- a/requirements.txt
+++ b/requirements.txt
@@ -1,4 +1,5 @@
 mkdocs-material==9.6.11
 mkdocs-glightbox==0.4.0
 mkdocs-exclude-search==0.6.6
+mkdocs-minify-plugin==0.8.0
 termynal==0.13.0