知识库

:warning: 此主题组件的功能已被 Discourse Docs 插件取代

此主题组件为选定的分类提供知识库风格的视图。

:link: 仓库链接

:link: 在主题创建器中预览


导航胶囊中会为在设置中启用的任何分类添加一个 <kbd>KB</kbd> 按钮。

切换到该视图后,知识库将显示最新主题列表的简化版本。

点击侧边栏中的标签,主题列表将自动按该标签过滤。您可以选择任意数量的标签,标签列表将仅显示已添加到过滤主题中的标签,以便轻松浏览大量文档。

想要搜索?只需在框中输入术语即可。搜索结果也会限制在您已选择的标签范围内。

注意事项

以下站点设置对此组件的功能必需启用标签显示按标签过滤

此主题组件目前不支持移动视图。

尽管如此,我们正在开发一个更高级的版本。一旦准备好,我们将在 Meta 上在此处通知您!

27 个赞

此提交现已添加基本的移动端视图。

请注意,这并非完美,因为如果标签数量较多,您需要滚动查看它们。我正在考虑几个解决方案来修复这个问题。

9 个赞

我们使用 Discourse 作为知识库已超过 4 年,拥有约 350 篇专门的知识库帖子,这令人非常兴奋!

我不确定这是否可以通过主题组件实现,但有没有办法让此“视图”在用户打开某个分类时成为默认视图?也就是说,与其访问 /c/knowledge-base,而是自动加载为 /c/knowledge-base?kb=active

我们已启用知识库主题组件,并且非常喜欢它,但我们担心用户因为使用之前收藏的 /c/knowledge-base 链接而看不到知识库视图。

感谢你们为此付出的努力。

6 个赞

我会考虑为此添加一个设置!感谢您的建议,很高兴您觉得这很有用。

6 个赞

现在这已作为主题设置实现。子分类也已支持!

9 个赞

刚刚更新。看起来很棒,谢谢!

3 个赞

如何将其应用于子类别?是否有特殊的语法?

非常感谢您提供的帮助!我们的社区中有一个类别非常适合应用此组件,但我们遇到了一个问题:类别不会显示在“知识库类别”下拉菜单中,因此我们无法选择要应用组件的类别。有什么建议吗?

您可以直接输入分类别名来创建它。这并不非常直观。我还没弄清楚如何获取子分类,但如果您的分类位于第一级,那就相当简单。

1 个赞

好的,确实不太直观。我输入并“创建”了该分类,它确实生效了。但它仍然没有按预期显示。

我重新安装了一个 Discourse 进行测试,并配置了这两个组件:

br%20a170a9ec422c

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

br%2086f9546a1534

但是 D.I.Y. 分类仍以普通视图显示:

URL 末尾显示为:/c/diy?kb=active

1 个赞

无需特殊语法——只需在 kb categories 主题设置中输入分类的 slug(无论是子分类还是普通分类),刷新浏览器,即可生效。

这是当前主题设置的一个限制——你必须像 @Sean_R 建议的那样手动输入 slug。

@TowerBR,这个问题解决了吗?添加分类到设置后是否刷新了页面?是否点击了 KB 按钮?抱歉问这些看似简单的问题,只是想彻底搞清楚原因。

1 个赞

成功了,谢谢 :slight_smile:

我喜欢这种方式,因为我可以将所有知识库子类别命名为相同名称,只需添加一次即可。

不过我注意到,如果通过下拉菜单进入该类别,它不会自动切换到知识库视图。

其他所有导航方式似乎都能正常工作,唯独子类别下拉菜单不行。

2 个赞

你开启了“默认使用知识库视图”选项吗?我刚刚在自己的网站上测试过,它似乎对子分类也能正常工作。

2 个赞

是的,大部分时间都能正常工作,只是如果使用子类别下拉菜单在不同类别之间切换时就不行了。

奇怪,好的。如果你能稳定复现这个问题,请告诉我,我会查看一下。我尝试使用子类别下拉菜单,但无法触发该行为。

2 个赞

是的,我已经这样做了,请查看上方帖子的截图:post above

br%2086f9546a1534

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

br%20346e44618d61

是的,并且我也清除了缓存。

是的。当我通过主下拉菜单选择分类时,页面已经加载了带有 /c/diy?kb=active 结尾的 URL。当我将鼠标悬停在 KB 按钮上时,它显示的是不带这个“附加参数”的“正常”URL,但点击它时没有任何反应。

您是否运行的是最新版本的主题组件?您的 Discourse 版本是 tests-passed 还是 stable

2 个赞

每次都会发生这种情况。我可以点击“知识库”或刷新来修复,但当我从下拉菜单进入类别时却无法修复。

是的:

params:
   version: tests-passed
3 个赞

太棒了!我刚安装好查看了一下,发现它已经非常实用了。

这个主题组件似乎与 @angushttps://meta.discourse.org/t/knowledge-base-plugin/115288 插件存在冲突。我可以确认,在启用此主题组件之前必须先卸载该插件,否则在查看知识库分类时会出现以下问题。请注意菜单旁边奇怪的横线和旋转的圆圈。

我很想进一步了解高级版本以及你们的规划。以下是一些反馈:

  • 疑似 bug:当你从左侧菜单选择一个标签进行筛选,然后点击其他分类或“最新”等选项后,再次点击“知识库”返回时,你会发现仍然处于该标签的筛选状态。
  • 点击标题下方的标签时,会跳转到该标签的页面,而不是像点击左侧菜单中的标签那样跳转到已筛选的知识库视图。
  • 点击左侧菜单中的标签分类标题时,会跳转到该分类的“最新”视图。建议此处不要设置任何链接。此外,分类标题上可能也不应包含 # 符号,以免分散注意力。
  • 在左侧菜单中显示每个标签对应的主题数量会很有帮助。
  • 能够按字母顺序甚至自定义顺序对知识库主题进行排序也会很有用。
4 个赞