justin
(Justin DiRose)
1
此主题组件的功能已被 Discourse Docs 插件取代
此主题组件为选定的分类提供知识库风格的视图。
导航胶囊中会为在设置中启用的任何分类添加一个
<kbd>KB</kbd> 按钮。
切换到该视图后,知识库将显示最新主题列表的简化版本。
点击侧边栏中的标签,主题列表将自动按该标签过滤。您可以选择任意数量的标签,标签列表将仅显示已添加到过滤主题中的标签,以便轻松浏览大量文档。
想要搜索?只需在框中输入术语即可。搜索结果也会限制在您已选择的标签范围内。
注意事项
以下站点设置对此组件的功能必需:启用标签 和 显示按标签过滤
此主题组件目前不支持移动视图。
尽管如此,我们正在开发一个更高级的版本。一旦准备好,我们将在 Meta 上在此处通知您!
27 个赞
justin
(Justin DiRose)
8
此提交现已添加基本的移动端视图。
请注意,这并非完美,因为如果标签数量较多,您需要滚动查看它们。我正在考虑几个解决方案来修复这个问题。
9 个赞
wesochuck
(Wes Osborn)
9
我们使用 Discourse 作为知识库已超过 4 年,拥有约 350 篇专门的知识库帖子,这令人非常兴奋!
我不确定这是否可以通过主题组件实现,但有没有办法让此“视图”在用户打开某个分类时成为默认视图?也就是说,与其访问 /c/knowledge-base,而是自动加载为 /c/knowledge-base?kb=active?
我们已启用知识库主题组件,并且非常喜欢它,但我们担心用户因为使用之前收藏的 /c/knowledge-base 链接而看不到知识库视图。
感谢你们为此付出的努力。
6 个赞
justin
(Justin DiRose)
10
我会考虑为此添加一个设置!感谢您的建议,很高兴您觉得这很有用。
6 个赞
TowerBR
(Tower)
14
非常感谢您提供的帮助!我们的社区中有一个类别非常适合应用此组件,但我们遇到了一个问题:类别不会显示在“知识库类别”下拉菜单中,因此我们无法选择要应用组件的类别。有什么建议吗?
Sean_R
(Republic Wireless)
15
您可以直接输入分类别名来创建它。这并不非常直观。我还没弄清楚如何获取子分类,但如果您的分类位于第一级,那就相当简单。
1 个赞
TowerBR
(Tower)
16
好的,确实不太直观。我输入并“创建”了该分类,它确实生效了。但它仍然没有按预期显示。
我重新安装了一个 Discourse 进行测试,并配置了这两个组件:

(D.I.Y. / diy 是我希望启用知识库功能的分类,并且已通过 自定义顶部导航链接 组件为其创建了一个特定的顶部链接)

但是 D.I.Y. 分类仍以普通视图显示:
URL 末尾显示为:/c/diy?kb=active
1 个赞
justin
(Justin DiRose)
17
无需特殊语法——只需在 kb categories 主题设置中输入分类的 slug(无论是子分类还是普通分类),刷新浏览器,即可生效。
这是当前主题设置的一个限制——你必须像 @Sean_R 建议的那样手动输入 slug。
@TowerBR,这个问题解决了吗?添加分类到设置后是否刷新了页面?是否点击了 KB 按钮?抱歉问这些看似简单的问题,只是想彻底搞清楚原因。
1 个赞
Sean_R
(Republic Wireless)
18
成功了,谢谢 
我喜欢这种方式,因为我可以将所有知识库子类别命名为相同名称,只需添加一次即可。
不过我注意到,如果通过下拉菜单进入该类别,它不会自动切换到知识库视图。
其他所有导航方式似乎都能正常工作,唯独子类别下拉菜单不行。
2 个赞
justin
(Justin DiRose)
19
你开启了“默认使用知识库视图”选项吗?我刚刚在自己的网站上测试过,它似乎对子分类也能正常工作。
2 个赞
Sean_R
(Republic Wireless)
20
是的,大部分时间都能正常工作,只是如果使用子类别下拉菜单在不同类别之间切换时就不行了。
justin
(Justin DiRose)
21
奇怪,好的。如果你能稳定复现这个问题,请告诉我,我会查看一下。我尝试使用子类别下拉菜单,但无法触发该行为。
2 个赞
TowerBR
(Tower)
22
是的,我已经这样做了,请查看上方帖子的截图:post above:

我已移除了“自定义顶部导航链接”组件。现在这是一个完全“干净”的安装:

是的,并且我也清除了缓存。
是的。当我通过主下拉菜单选择分类时,页面已经加载了带有 /c/diy?kb=active 结尾的 URL。当我将鼠标悬停在 KB 按钮上时,它显示的是不带这个“附加参数”的“正常”URL,但点击它时没有任何反应。
justin
(Justin DiRose)
23
您是否运行的是最新版本的主题组件?您的 Discourse 版本是 tests-passed 还是 stable?
2 个赞
Sean_R
(Republic Wireless)
24
每次都会发生这种情况。我可以点击“知识库”或刷新来修复,但当我从下拉菜单进入类别时却无法修复。
TowerBR
(Tower)
25
是的:
params:
version: tests-passed
3 个赞
太棒了!我刚安装好查看了一下,发现它已经非常实用了。
这个主题组件似乎与 @angus 的 https://meta.discourse.org/t/knowledge-base-plugin/115288 插件存在冲突。我可以确认,在启用此主题组件之前必须先卸载该插件,否则在查看知识库分类时会出现以下问题。请注意菜单旁边奇怪的横线和旋转的圆圈。
我很想进一步了解高级版本以及你们的规划。以下是一些反馈:
- 疑似 bug:当你从左侧菜单选择一个标签进行筛选,然后点击其他分类或“最新”等选项后,再次点击“知识库”返回时,你会发现仍然处于该标签的筛选状态。
- 点击标题下方的标签时,会跳转到该标签的页面,而不是像点击左侧菜单中的标签那样跳转到已筛选的知识库视图。
- 点击左侧菜单中的标签分类标题时,会跳转到该分类的“最新”视图。建议此处不要设置任何链接。此外,分类标题上可能也不应包含
# 符号,以免分散注意力。
- 在左侧菜单中显示每个标签对应的主题数量会很有帮助。
- 能够按字母顺序甚至自定义顺序对知识库主题进行排序也会很有用。
4 个赞