From a47ddbfc2a7674a88881511547608b0232e43bd3 Mon Sep 17 00:00:00 2001 From: KenanZhu <3471685733@qq.com> Date: Thu, 28 May 2026 17:08:02 +0800 Subject: [PATCH] restructure: reorganize navigation and file system for multi-version support MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Refactor docs.json navigation to Languages → Tabs → Versions → Groups hierarchy per Mintlify design spec. Mirror the structure in the file system as zh/manual/v1.3.0/ to allow future versions to coexist. Update all internal cross-references accordingly. Co-Authored-By: Claude Opus 4.7 --- docs.json | 104 +++++++++--------- zh/{ => manual/v1.3.0}/configuration/file.mdx | 0 .../v1.3.0}/configuration/start.mdx | 0 zh/{ => manual/v1.3.0}/configuration/ui.mdx | 0 zh/{ => manual/v1.3.0}/faq/contact.mdx | 0 zh/{ => manual/v1.3.0}/faq/faq.mdx | 0 .../v1.3.0}/faq/troubleshooting.mdx | 2 +- zh/{ => manual/v1.3.0}/features/core.mdx | 0 zh/{ => manual/v1.3.0}/features/timer.mdx | 0 zh/{ => manual/v1.3.0}/index/beforestart.mdx | 0 zh/{ => manual/v1.3.0}/index/intro.mdx | 8 +- .../v1.3.0}/installation/driver.mdx | 2 +- .../v1.3.0}/installation/install.mdx | 0 13 files changed, 61 insertions(+), 55 deletions(-) rename zh/{ => manual/v1.3.0}/configuration/file.mdx (100%) rename zh/{ => manual/v1.3.0}/configuration/start.mdx (100%) rename zh/{ => manual/v1.3.0}/configuration/ui.mdx (100%) rename zh/{ => manual/v1.3.0}/faq/contact.mdx (100%) rename zh/{ => manual/v1.3.0}/faq/faq.mdx (100%) rename zh/{ => manual/v1.3.0}/faq/troubleshooting.mdx (93%) rename zh/{ => manual/v1.3.0}/features/core.mdx (100%) rename zh/{ => manual/v1.3.0}/features/timer.mdx (100%) rename zh/{ => manual/v1.3.0}/index/beforestart.mdx (100%) rename zh/{ => manual/v1.3.0}/index/intro.mdx (80%) rename zh/{ => manual/v1.3.0}/installation/driver.mdx (94%) rename zh/{ => manual/v1.3.0}/installation/install.mdx (100%) diff --git a/docs.json b/docs.json index f5c9a67..ef14314 100644 --- a/docs.json +++ b/docs.json @@ -12,54 +12,59 @@ "family": "Inter" }, "navigation": { - "tabs": [ + "languages": [ { - "tab": "用户手册", - "languages": [ + "language": "zh", + "default": true, + "tabs": [ { - "language": "zh", - "default": true, - "groups": [ + "tab": "用户手册", + "versions": [ { - "group": "开始", - "icon": "book-open", - "pages": [ - "zh/index/intro", - "zh/index/beforestart" - ] - }, - { - "group": "安装", - "icon": "download", - "pages": [ - "zh/installation/install", - "zh/installation/driver" - ] - }, - { - "group": "配置", - "icon": "sliders", - "pages": [ - "zh/configuration/start", - "zh/configuration/ui", - "zh/configuration/file" - ] - }, - { - "group": "功能", - "icon": "bolt", - "pages": [ - "zh/features/core", - "zh/features/timer" - ] - }, - { - "group": "FAQ", - "icon": "circle-question", - "pages": [ - "zh/faq/troubleshooting", - "zh/faq/faq", - "zh/faq/contact" + "version": "v1.3.0", + "groups": [ + { + "group": "开始", + "icon": "book-open", + "pages": [ + "zh/manual/v1.3.0/index/intro", + "zh/manual/v1.3.0/index/beforestart" + ] + }, + { + "group": "安装", + "icon": "download", + "pages": [ + "zh/manual/v1.3.0/installation/install", + "zh/manual/v1.3.0/installation/driver" + ] + }, + { + "group": "配置", + "icon": "sliders", + "pages": [ + "zh/manual/v1.3.0/configuration/start", + "zh/manual/v1.3.0/configuration/ui", + "zh/manual/v1.3.0/configuration/file" + ] + }, + { + "group": "功能", + "icon": "bolt", + "pages": [ + "zh/manual/v1.3.0/features/core", + "zh/manual/v1.3.0/features/timer" + ] + }, + { + "group": "FAQ", + "icon": "circle-question", + "pages": [ + "zh/manual/v1.3.0/faq/troubleshooting", + "zh/manual/v1.3.0/faq/faq", + "zh/manual/v1.3.0/faq/contact" + ] + } ] } ] @@ -73,11 +78,12 @@ "dark": "/logo/dark.svg" }, "navbar": { + "primary": { + "type": "button", + "label": "下载 AutoLibrary", + "href": "https://autolibrary.kenanzhu.com/downloads" + }, "links": [ - { - "label": "AutoLibrary 下载页面", - "href": "https://autolibrary.kenanzhu.com/downloads" - }, { "label": "GitHub", "href": "https://github.com/KenanZhu/AutoLibrary", diff --git a/zh/configuration/file.mdx b/zh/manual/v1.3.0/configuration/file.mdx similarity index 100% rename from zh/configuration/file.mdx rename to zh/manual/v1.3.0/configuration/file.mdx diff --git a/zh/configuration/start.mdx b/zh/manual/v1.3.0/configuration/start.mdx similarity index 100% rename from zh/configuration/start.mdx rename to zh/manual/v1.3.0/configuration/start.mdx diff --git a/zh/configuration/ui.mdx b/zh/manual/v1.3.0/configuration/ui.mdx similarity index 100% rename from zh/configuration/ui.mdx rename to zh/manual/v1.3.0/configuration/ui.mdx diff --git a/zh/faq/contact.mdx b/zh/manual/v1.3.0/faq/contact.mdx similarity index 100% rename from zh/faq/contact.mdx rename to zh/manual/v1.3.0/faq/contact.mdx diff --git a/zh/faq/faq.mdx b/zh/manual/v1.3.0/faq/faq.mdx similarity index 100% rename from zh/faq/faq.mdx rename to zh/manual/v1.3.0/faq/faq.mdx diff --git a/zh/faq/troubleshooting.mdx b/zh/manual/v1.3.0/faq/troubleshooting.mdx similarity index 93% rename from zh/faq/troubleshooting.mdx rename to zh/manual/v1.3.0/faq/troubleshooting.mdx index 3955de3..5c9e8a4 100644 --- a/zh/faq/troubleshooting.mdx +++ b/zh/manual/v1.3.0/faq/troubleshooting.mdx @@ -8,7 +8,7 @@ description: "AutoLibrary 故障排除与常见问题解决方法" 这大概率是因为浏览器驱动未正确安装或版本不匹配。 - 因此我们强烈建议使用 AutoLibrary 的[浏览器驱动自动下载功能](/zh/installation/driver#%E6%96%B9%E5%BC%8F%E4%B8%80%EF%BC%9A%E4%BD%BF%E7%94%A8%E6%B5%8F%E8%A7%88%E5%99%A8%E9%A9%B1%E5%8A%A8%E8%87%AA%E5%8A%A8%E4%B8%8B%E8%BD%BD%E5%8A%9F%E8%83%BD%EF%BC%88%E6%8E%A8%E8%8D%90%EF%BC%89)。 + 因此我们强烈建议使用 AutoLibrary 的[浏览器驱动自动下载功能](/zh/manual/v1.3.0/installation/driver#%E6%96%B9%E5%BC%8F%E4%B8%80%EF%BC%9A%E4%BD%BF%E7%94%A8%E6%B5%8F%E8%A7%88%E5%99%A8%E9%A9%B1%E5%8A%A8%E8%87%AA%E5%8A%A8%E4%B8%8B%E8%BD%BD%E5%8A%9F%E8%83%BD%EF%BC%88%E6%8E%A8%E8%8D%90%EF%BC%89)。 这可以很大程度上减少此类问题的发生。 diff --git a/zh/features/core.mdx b/zh/manual/v1.3.0/features/core.mdx similarity index 100% rename from zh/features/core.mdx rename to zh/manual/v1.3.0/features/core.mdx diff --git a/zh/features/timer.mdx b/zh/manual/v1.3.0/features/timer.mdx similarity index 100% rename from zh/features/timer.mdx rename to zh/manual/v1.3.0/features/timer.mdx diff --git a/zh/index/beforestart.mdx b/zh/manual/v1.3.0/index/beforestart.mdx similarity index 100% rename from zh/index/beforestart.mdx rename to zh/manual/v1.3.0/index/beforestart.mdx diff --git a/zh/index/intro.mdx b/zh/manual/v1.3.0/index/intro.mdx similarity index 80% rename from zh/index/intro.mdx rename to zh/manual/v1.3.0/index/intro.mdx index 0c4f158..ddce80e 100644 --- a/zh/index/intro.mdx +++ b/zh/manual/v1.3.0/index/intro.mdx @@ -12,28 +12,28 @@ AutoLibrary 是一款专为北京建筑大学图书馆设计的自动化工具 快速开始，安装 AutoLibrary 与其它必要的准备。 完整参数参考：用户信息、预约参数、系统设置与配置文件详解。 核心功能概览：自动预约、签到、续约，以及定时任务管理。 常见问题解决方法与使用问答，快速排查使用问题。 diff --git a/zh/installation/driver.mdx b/zh/manual/v1.3.0/installation/driver.mdx similarity index 94% rename from zh/installation/driver.mdx rename to zh/manual/v1.3.0/installation/driver.mdx index 5cabf71..7be86f5 100644 --- a/zh/installation/driver.mdx +++ b/zh/manual/v1.3.0/installation/driver.mdx @@ -32,7 +32,7 @@ description: "AutoLibrary 浏览器驱动配置指南 - 自动下载与手动安 - 在 [AutoLibrary 配置界面](/zh/configuration/ui#%E8%BF%90%E8%A1%8C%E9%85%8D%E7%BD%AE)中，点击 [**浏览器驱动自动下载**] 按钮。 + 在 [AutoLibrary 配置界面](/zh/manual/v1.3.0/configuration/ui#%E8%BF%90%E8%A1%8C%E9%85%8D%E7%BD%AE)中，点击 [**浏览器驱动自动下载**] 按钮。 ![浏览器驱动自动下载窗口](/images/v1.2.1/driver-auto-download-window.png) diff --git a/zh/installation/install.mdx b/zh/manual/v1.3.0/installation/install.mdx similarity index 100% rename from zh/installation/install.mdx rename to zh/manual/v1.3.0/installation/install.mdx