此主题组件的功能已被 Discourse Docs 插件取代
此主题组件为选定的分类提供知识库风格的视图。
仓库链接 在主题创建器中预览
<kbd>KB</kbd> 按钮。
切换到该视图后，知识库将显示最新主题列表的简化版本。
点击侧边栏中的标签，主题列表将自动按该标签过滤。您可以选择任意数量的标签，标签列表将仅显示已添加到过滤主题中的标签，以便轻松浏览大量文档。
想要搜索？只需在框中输入术语即可。搜索结果也会限制在您已选择的标签范围内。
以下站点设置对此组件的功能必需：启用标签 和 显示按标签过滤
此主题组件目前不支持移动视图。
尽管如此，我们正在开发一个更高级的版本。一旦准备好，我们将在 Meta 上在此处通知您！
This commit now adds a basic mobile view.
Note it’s not perfect, as if there are lots of tags, you do scroll over them. There are a couple of ideas I’m considering to fix that.
We’ve been using Discourse as our KB for 4+ years and have around 350 Knowledge Base specific posts, so this very exciting!
I’m not sure if this is possible via a theme component, but is there anyway this “view” could be the default when someone opens a category? So that rather than going to: /c/knowledge-base that it would automatically load as /c/knowledge-base?kb=active?
We’ve enabled the KB theme component and really like it but we worry that people aren’t seeing the KB view because they’re using the /c/knowledge-base link they’ve previously bookmarked.
Thanks for your work on this.
I’ll look into adding a setting for this! Thanks for the suggestion, and glad you’re finding this useful.
This is now implemented as a theme setting. Subcategories are now supported, too!
Just updated. Looks great, thank you!
How do you apply this to a subcategory? Is there a special syntax?
Thank you so much for this! We have a category in our community that would be perfect for applying this component, but we are facing an issue: categories don’t show up in the “kb categories” drop down so we can’t choose the category to apply the component. Any advice?
You can just type in the category slug and create it. It is not extremely intuitive. I have not been able to figure out how to get sub categories but if your category is on the first level it is pretty easy.
Ok, really not intuitive. I typed and “created” the category, and it worked. But it still does not appear as expected.
I did a fresh Discourse install to test, set up both components:
(D.I.Y. / diy is the category I want to enable KB for, and it has a specific top link created with Custom top navigation links component)
But the D.I.Y. category appears with normal view:
URL shows at the end: /c/diy?kb=active
No special syntax - just enter the slug of the category (subcategory or not) in the kb categories theme setting, refresh your browser, and it should work.
This is a limitation of theme settings right now – you’ll have to type in the slug as @Sean_R suggested.
Did you get this sorted @TowerBR? Did you refresh after adding the category to the setting? Did you click the KB button? Sorry for the silly questions but trying to get to the bottom of it.
It worked thanks 
I like it this way since I can name all of my KB subcategories the same and only need to add them once.
I do notice that if I go to the category by the dropdown that it does not automatically switch to the KB view.
All other ways to navigate appear to work but the sub-category drop-down does not.
Do you have the default to kb view turned on? I just tested this on a site of mine and it did seem to work with subcategories.
I do and it works most o the time just not if I use the sub-category drop-down to change categories from one to another category.
Odd - ok. If you can repro it consistently, let me know and I’ll take a look. I haven’t been able to get that behavior to fire using the subcategory dropdown.
Yep, I had already done that, see the picture of the post above:
I removed the “Custom top navigation links” component. It is now a completely “clean” installation:
Yes, and I cleaned the cache.
Yes. When I select the category by main drop down it already loads the category page with /c/diy?kb=active at the end of the URL. When I hover the KB button, it shows the “normal” URL without this “add-on”, but when I click on it nothing happens.
Are you running on the latest version of the theme component? Are you running on tests-passed or stable for your Discourse version?
It happens every time. I can just click “KB” or refresh fixes it but not when I go to the category from the drop-down.
Yes:
params:
version: tests-passed
This is awesome! Just installed it to take a look, and I can see it is already very useful.
This theme component does seem to conflict with Knowledge Base Plugin by @angus. I can confirm that the plugin has to be uninstalled prior to enabling this theme component, otherwise the below happens when you look at a knowledge base category. Note the weird horizontal line next to the menu and spinning circle.
I’d love to hear some more about the advanced version and what you have planned. Some feedback:
# which is a distraction.