# 使用新侧边栏优化文档导航
**URL:** https://meta.discourse.org/t/better-documentation-navigation-with-a-new-sidebar/316058
**Category:** Site feedback
**Tags:** documentation, feedback, docs-sidebar, doc-categories
**Created:** [2024年七月12日 11:26 UTC](https://meta.discourse.org/t/better-documentation-navigation-with-a-new-sidebar/316058 "2024-07-12T11:26:16Z")
**Posts on this page:** 9
**Page:** 2
### Author:  [@Lhc\_fl](https://meta.discourse.org/u/Lhc_fl)
#### Post date: [2024年八月2日 07:19 UTC](https://meta.discourse.org/t/better-documentation-navigation-with-a-new-sidebar/316058/23 "2024-08-02T07:19:05Z")
嗯，有人觉得侧边栏链接是不是太浅了？特别是与元品牌相关的。
---
### Author:  [@hugh](https://meta.discourse.org/u/hugh)
#### Post date: [2024年八月2日 10:50 UTC](https://meta.discourse.org/t/better-documentation-navigation-with-a-new-sidebar/316058/24 "2024-08-02T10:50:36Z")
对我来说看起来还可以，而且颜色对比度符合 WCAG AA 级标准：[https://webaim.org/resources/contrastchecker/?fcolor=646464&bcolor=FFFFFF](https://webaim.org/resources/contrastchecker/?fcolor=646464&bcolor=FFFFFF)。
不过，每个人都不一样——你觉得阅读困难吗？
---
### Author:  [@Lhc\_fl](https://meta.discourse.org/u/Lhc_fl)
#### Post date: [2024年八月2日 10:54 UTC](https://meta.discourse.org/t/better-documentation-navigation-with-a-new-sidebar/316058/25 "2024-08-02T10:54:41Z")
那应该就是我的问题了。这在某种程度上分散了我的注意力……也许只是我一个人。
---
### Author:  [@hugh](https://meta.discourse.org/u/hugh)
#### Post date: [2024年八月2日 11:01 UTC](https://meta.discourse.org/t/better-documentation-navigation-with-a-new-sidebar/316058/26 "2024-08-02T11:01:00Z")
如果其他人也有类似的感受，我们可以进一步探讨并尝试其他对比。
---
### Author:  [@Overgrow](https://meta.discourse.org/u/Overgrow)
#### Post date: [2024年八月11日 10:38 UTC](https://meta.discourse.org/t/better-documentation-navigation-with-a-new-sidebar/316058/27 "2024-08-11T10:38:56Z")
它极佳地利用了侧边栏。过去我们曾使用过一个功能类似的插件，但它只是将文档树添加到了页眉。侧边栏更适合此目的。
从用户体验的角度来看，它运行良好。我唯一缺少的是侧边栏中的完整“树”结构。
目前，侧边栏中没有选项可以在“主”文档类别之间导航，也无法返回到根级别。
例如，如果您切换到“通用用法”，则应能够导航到根级别（#Documentation）。也许可以在“返回论坛”链接下方添加一个类似“返回文档主页”的链接。
总的来说，我认为两级树类别就足够了，如果侧边栏能够支持这两个级别，那就太好了。
---
### Author:  [@hugh](https://meta.discourse.org/u/hugh)
#### Post date: [2024年八月15日 05:23 UTC](https://meta.discourse.org/t/better-documentation-navigation-with-a-new-sidebar/316058/28 "2024-08-15T05:23:00Z")
> [@Overgrow](#):
>
> 我唯一缺少的是侧边栏中完整的“树”状结构。
我们已经在研究这个问题了！我同意这会很好，我们正在研究它的具体实现方式。
目前，您可以通过点击标题中的类别名称来导航回退，但我们正在努力寻找更好的方法来实现这一点。
---
### Author:  [@twofoursixeight](https://meta.discourse.org/u/twofoursixeight)
#### Post date: [2024年八月24日 03:53 UTC](https://meta.discourse.org/t/better-documentation-navigation-with-a-new-sidebar/316058/29 "2024-08-24T03:53:44Z")
我对这个新侧边栏有一个建议。
在底部添加一个标签系统。这样你就可以在文档侧边栏和普通侧边栏之间切换。这样就不用等页面加载了。我想象的是：
```plaintext
[文档][论坛/通用][管理菜单？]
[筛选]
[指南]
[主题/自定义]
```
这很像我为管理侧边栏提出的建议。
如果你是版主，还可以添加第三个标签，以实现更快的导航。
---
### Author:  [@ddventures](https://meta.discourse.org/u/ddventures)
#### Post date: [2024年十一月4日 08:26 UTC](https://meta.discourse.org/t/better-documentation-navigation-with-a-new-sidebar/316058/30 "2024-11-04T08:26:29Z")
如何添加图标？我的没有图标。
---
### Author:  [@Jagster](https://meta.discourse.org/u/Jagster)
#### Post date: [2025年一月4日 11:43 UTC](https://meta.discourse.org/t/better-documentation-navigation-with-a-new-sidebar/316058/32 "2025-01-04T11:43:10Z")
侧边栏链接的最佳或最简单的（不完全相同）构建方法是什么？手动劳动……不是一个选择😂
我为此使用了人工智能，它做得相当不错。但问题在于 OpenAI，因为它的模型很懒惰，而且经常拒绝生成超过 20 个点的长列表。我不能，也不想，离开 OpenAI——主要是因为那样我将不得不改变很多东西。
[上一頁](https://meta.discourse.org/t/better-documentation-navigation-with-a-new-sidebar/316058.md?page=1)