hugh
(Hugh Lashbrooke)
1
本周,我们对 Discourse 文档 进行了一项重大改进——全新的侧边栏!此功能旨在使导航和访问我们的文档比以往任何时候都更加轻松直观。
有什么新内容?
新的侧边栏会显示在所有文档类别和主题中,方便您浏览其内容。以下是您可以期待的内容:
-
改进的导航: 借助清晰的层级结构,在不同主题之间切换现在更快、更直接。
-
上下文感知: 侧边栏会突出显示您当前正在查看的主题,方便您了解在文档中的位置。
-
可折叠部分: 侧边栏中的每个部分都可以根据需要折叠和展开,方便您查找所需的主题。
-
实时筛选: 通过输入相关关键字,快速在侧边栏中查找特定主题——如果找不到,系统会邀请您使用相同的提示执行更深入的搜索。
-
移动友好: 新的侧边栏在移动设备上运行流畅,具有与桌面视图相同的所有功能。
让我们来看看
您今天就可以亲眼看看新的文档侧边栏!
以下是一些屏幕截图,让您对预期内容有更直观的了解:
如您所见,侧边栏清晰地概述了所有文档部分,使导航变得轻而易举。
每个类别都显示了其中的主题,并分为不同的部分。
您当前正在查看的主题在侧边栏中突出显示,方便参考。
每个部分都可以折叠,让您可以更轻松地找到所需内容。
可以展开各个部分以更清晰地显示其内容。
基于近期的改进
这个新的侧边栏是我们持续改进 Discourse 文档体验的一部分。它建立在近期为提高清晰度而重组文档的工作之上。新的侧边栏通过提供直观的界面来导航重新分类的文档,是对这些结构性改进的补充。
这与我们正在进行的对所有文档主题内容的全面审查相结合,以符合最近发布的风格指南。这是一项正在进行中的工作,您可能会在过程中逐渐注意到改进。
我们希望得到您的反馈!
您有机会使用新的文档侧边栏了吗?我们很想听听您的想法!请在此主题中发布您的体验、建议或任何疑问。
如果您对我们整体的文档工作有任何疑问或反馈,请在此主题上告知我们。
感谢您成为 Discourse 社区的一员。我们很高兴看到这项新功能如何增强您的 Discourse 体验。
22 个赞
恭喜新变化;它们真的很酷。 
- 跨所有类别的实时筛选
我知道目前的工作方式可能很困难;我希望能够进行筛选,而不管我处于什么(子)类别。这是我自然尝试的第一件事:
当然,有帮助链接,这很好。相反,我本以为会是这样:
-
使用 Ctrl + / 时内容向上滚动
当使用快捷方式聚焦搜索输入时,它会向上滚动侧边栏和内容。我不希望内容在这里向上滚动。
-
丢失上下文感知
如果使用筛选器,单击一个主题,然后清除筛选器,您可能看不到突出显示的主题。编辑:另外,如果您从帖子导航到某个主题。
-
查看主题时折叠的部分未突出显示
如果您正在查看某个主题并折叠各个部分,我认为从上下文的角度来看,以某种方式突出显示该部分或简单地强调它会很有用。
9 个赞
真奇怪。我不知道为什么你的有点不一样。
这是我看到的样子:
而且你看起来也没有在框里添加开发者指南分类描述。你是不是把这个分类静音了?
3 个赞
Moin
8
5 个赞
mcwumbly
(Dave McClure)
10
欢迎您进行尝试,但要使其真正成为我们准备全面支持的内容,还有很多工作要做。
维护索引主题涉及相当大的开销,而这正是驱动侧边栏用户界面的原因,并且没有内置系统可以确保它们与类别中的主题保持一致。
目前,我们接受维护此处文档的开销,重点是收集人们关于在此处阅读和浏览文档体验的反馈。我们现在更看重这方面的反馈,而不是关于使用此组件维护文档的体验反馈。
8 个赞
Jagster
(Jakke Lehtonen)
12
它比旧的更容易使用。更……清晰。但我敢打赌,技术更强的用户可能会觉得它有限制。
我不会使用文档,即使我有需要,因为我的用户害怕过滤。这个系统会更用户友好。
但如果它需要管理员方面持续的关爱和照顾……
3 个赞
hugh
(Hugh Lashbrooke)
13
感谢您指出这些问题,@Arkshine!这些问题应该都可以修复,我们会看看能做什么。
2 个赞
Moin
14
不知何故,文档侧边栏改变了搜索的工作方式。在我的平板电脑上,当文档侧边栏可见时,我无法使用回车键获取搜索结果。我注意到它显示的是“next”而不是“go”,但我不知道为什么。
Moin
18
它仍然发生。我可以在 Chrome 和 Edge 中重现它,但在 Firefox 应用中不行。
saquetim
(Sérgio Saquetim)
19
我仍然无法重现。我不明白文档侧边栏是如何引起此问题的。
它不会更改任何搜索代码。
可能是其他原因。
您能否提供更多关于您使用的设置的详细信息?浏览器版本、操作系统等。
Moin
20
Galaxy Tab S9 FE
Android 14;SM-X510 Build/UP1A.231005.007
Chrome 126.0.6478.123
我尝试了外接键盘。这帮助我确定 Enter 键似乎需要按第二次。
2 个赞
saquetim
(Sérgio Saquetim)
21
好的,我可以在 Android 上重现此问题。
问题不仅出现在文档侧边栏,管理员侧边栏也存在同样的问题。
我们将需要调查此问题。
我已经知道是什么原因了。
我们将在内部讨论最佳的解决方案。
4 个赞