diff options
| -rw-r--r-- | docs/_zh_CN/index.html | 2 | ||||
| -rw-r--r-- | docs/css/dark.css | 10 | ||||
| -rw-r--r-- | docs/css/doc-nav.css | 47 | ||||
| -rw-r--r-- | docs/doc.html | 2 | ||||
| -rw-r--r-- | docs/scripts/docsify-plugin-prevnext.js | 95 |
5 files changed, 156 insertions, 0 deletions
diff --git a/docs/_zh_CN/index.html b/docs/_zh_CN/index.html index 66a8a9a..c6c13e6 100644 --- a/docs/_zh_CN/index.html +++ b/docs/_zh_CN/index.html @@ -28,6 +28,7 @@ href="../css/dark.css" disabled /> + <link rel="stylesheet" href="../css/doc-nav.css" /> </head> <body> @@ -88,6 +89,7 @@ <script src="../scripts/prism-rust.js"></script> <script src="../scripts/docsify-corner.js"></script> <script src="../scripts/docsify-plugin-flexible-alerts.js"></script> + <script src="../scripts/docsify-plugin-prevnext.js"></script> <script src="../scripts/day-night-switch.js"></script> </body> diff --git a/docs/css/dark.css b/docs/css/dark.css index b14f3dc..a9791bd 100644 --- a/docs/css/dark.css +++ b/docs/css/dark.css @@ -915,3 +915,13 @@ section.cover blockquote > p > a { section.cover blockquote > p > a:hover { color: #d4a84b; } + +/* ── Prev/Next page navigation (dark) ── */ +.page-nav a { + border-color: #d4a84b; + color: #d4a84b; + background: transparent; +} +.page-nav a:hover { + background: rgba(212, 168, 75, 0.08); +} diff --git a/docs/css/doc-nav.css b/docs/css/doc-nav.css new file mode 100644 index 0000000..a31f1aa --- /dev/null +++ b/docs/css/doc-nav.css @@ -0,0 +1,47 @@ +/* Prev/Next page navigation + Light theme — matches docs/css/light.css cover buttons */ +.page-nav { + display: flex; + margin-top: 0; + gap: 0; +} +.page-nav a { + display: inline-flex; + align-items: center; + gap: 8px; + padding: 16px 24px; + border: 1px solid #b8943e; + border-radius: 2px; + text-decoration: none; + color: #b8943e; + font-size: 15px; + background: transparent; + transition: all 0.15s ease; + flex: 1 1 50%; + max-width: 50%; + box-sizing: border-box; +} +.page-nav a:hover { + background: rgba(184, 148, 62, 0.1); +} +.page-nav .nav-prev { + justify-content: flex-start; + margin-right: 8px; +} +.page-nav .nav-next { + justify-content: flex-end; + margin-left: auto; +} +.page-nav a:only-child { + max-width: 50%; +} +.page-nav .nav-label { + font-size: 12px; + opacity: 0.6; +} +.page-nav .nav-title { + font-weight: 600; + overflow: hidden; + text-overflow: ellipsis; + white-space: nowrap; +} diff --git a/docs/doc.html b/docs/doc.html index 0897109..ea5d7ad 100644 --- a/docs/doc.html +++ b/docs/doc.html @@ -23,6 +23,7 @@ <link rel="stylesheet" href="css/light.css" /> <link id="dark-style" rel="stylesheet" href="css/dark.css" disabled /> + <link rel="stylesheet" href="css/doc-nav.css" /> </head> <body> @@ -91,6 +92,7 @@ <script src="scripts/prism-rust.js"></script> <script src="scripts/docsify-corner.js"></script> <script src="scripts/docsify-plugin-flexible-alerts.js"></script> + <script src="scripts/docsify-plugin-prevnext.js"></script> <script src="scripts/day-night-switch.js"></script> </body> diff --git a/docs/scripts/docsify-plugin-prevnext.js b/docs/scripts/docsify-plugin-prevnext.js new file mode 100644 index 0000000..c80f17c --- /dev/null +++ b/docs/scripts/docsify-plugin-prevnext.js @@ -0,0 +1,95 @@ +/*! + * docsify-plugin-prevnext + * Auto-generates previous/next page navigation based on sidebar order. + */ +(function () { + function install(hook, vm) { + hook.doneEach(function () { + var nav = document.querySelector(".page-nav"); + if (nav) nav.remove(); + + function navigate(path) { + window.location.hash = "#/" + (path || ""); + } + + var sidebarLinks = document.querySelectorAll(".sidebar-nav li a"); + if (!sidebarLinks.length) return; + + var currentPath = vm.route.path; + var links = []; + sidebarLinks.forEach(function (a) { + var href = a.getAttribute("href"); + if (!href) return; + if (href.startsWith("http")) return; + if (href.indexOf("?id=") !== -1) return; // skip sub-headings + var path = href.startsWith("#") ? href.slice(1) : href; + if (path.startsWith("/")) path = path.slice(1); + if (path === "" || path === "/") path = "README"; + links.push({ path: path, text: a.textContent.trim() }); + }); + + function normalize(p) { + return p.replace(/\.md$/g, "").replace(/^\/+|\/+$/g, ""); + } + + // Treat root path as README + var cur = normalize(currentPath) || "README"; + var idx = -1; + for (var i = 0; i < links.length; i++) { + if (normalize(links[i].path) === cur) { + idx = i; + break; + } + } + + if (idx === -1) return; + + var prevLink = idx > 0 ? links[idx - 1] : null; + var nextLink = idx < links.length - 1 ? links[idx + 1] : null; + + // Build nav HTML + var html = ""; + if (prevLink) { + html += + '<a class="nav-prev" href="javascript:;" data-nav="' + + encodeURIComponent(prevLink.path) + + '">' + + '<span><div class="nav-label">‹ Previous</div><div class="nav-title">' + + prevLink.text + + "</div></span></a>"; + } + if (nextLink) { + html += + '<a class="nav-next" href="javascript:;" data-nav="' + + encodeURIComponent(nextLink.path) + + '">' + + '<span><div class="nav-label">Next ›</div><div class="nav-title">' + + nextLink.text + + "</div></span></a>"; + } + + if (!html) return; + + nav = document.createElement("div"); + nav.className = "page-nav"; + nav.innerHTML = html; + + // Attach click handlers via event delegation + nav.addEventListener("click", function (e) { + var target = e.target.closest("a"); + if (!target) return; + var path = target.getAttribute("data-nav"); + if (path) { + e.preventDefault(); + navigate(decodeURIComponent(path)); + } + }); + + var section = document.querySelector(".markdown-section"); + if (section) section.appendChild(nav); + }); + } + + window.$docsify = window.$docsify || {}; + window.$docsify.plugins = (window.$docsify.plugins || []).concat(install); +})(); |