docs: 增加 GitHub Pages 文档页导航#30
Merged
Merged
Conversation
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
Pull request overview
该 PR 通过覆盖 Cayman 主题的默认布局，为 GitHub Pages 上 docs/ 目录下的文档页增加统一的共享导航区，从而让文档之间具备可持续浏览的“继续阅读 / 上一篇 / 下一篇”跳转能力，并在仓库首页补充文档中心入口，提升文档站的可用性与连贯性。
Changes:
- 新增
_layouts/default.html覆盖 Cayman 默认布局：在docs/页面顶部加入“文档中心 / 本主题目录 / 项目首页”导航，并在页面底部加入上一篇/下一篇翻页。 - 基于同目录页面（按路径排序）自动生成“继续阅读”链接，无需逐篇补 front matter 或手工互链。
- README 的“文档入口”新增“文档中心总览”链接。
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| README.md | 在仓库首页补充“文档中心总览”入口，方便从首页进入文档中心。 |
| _layouts/default.html | 覆盖 Cayman 默认布局，为 docs/ 文档页注入共享导航与上一篇/下一篇翻页能力。 |
Comment on lines
+7
to
+9
| <link rel="preconnect" href="https://fonts.gstatic.com"> | ||
| <link rel="preload" href="https://fonts.googleapis.com/css?family=Open+Sans:400,700&display=swap" as="style" type="text/css" crossorigin> | ||
| <meta name="viewport" content="width=device-width, initial-scale=1"> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
GitHub Pages 现在把
docs/下的文章渲染成彼此独立的 Cayman 页面。从首页进入后可以看到单篇内容，但缺少继续阅读的活导航，文档之间基本是断开的。What changed
docs/页面上统一加入共享导航区docs/文档中心、本主题目录、项目首页的入口Notes