知识库

[justin (Justin DiRose)]

Thanks for the feedback @tobiaseigen! I have some other work on my plate this week, but I’ll be sure to dig into a few of these items next week.

[tobiaseigen]

Another item - this theme component makes no sense alongside the popular tags theme component, and for some reason the exclude category setting for that theme component does not seem to work for me despite multiple browser refreshes. I don’t know if you can accommodate this issue in this theme component… so we can still use the popular tags in other views and not show them here.

I’m not too proud to expose how I am using discourse as my personal knowledge base - in the screenshot below you can see how the tags appear on both sides, even with the howto category set to be excluded in the popular tags theme component.

[justin (Justin DiRose)]

@tobiaseigen

I’m not too proud to expose how I am using discourse as my personal knowledge base

First of all, you should be proud. That’s some expert Discourse use there! Discourse is perfect for that kind of stuff!

@tobiaseigen

I don’t know if you can accommodate this issue in this theme component… so we can still use the popular tags in other views and not show them here.

I’ll take a look with the other items next week sometime.

[tobiaseigen]

Thanks, Justin!

I just installed this on the global legal empowerment network forum. We have a kb category, and sub-categories within kb. Each sub-category has its own individual group access permissions.

It’s pretty cool to see that enabling this theme component in the kb category and subcategories works! In fact it works very well.

Two additional things I noticed:

• the tags menu does not appear to work correctly in the kb category. Items appearing in the list of topics from subcategory clearly have tags but the tags menu is empty, because there are no topics in the kb category.
• it would be very helpful to see a sub-categories list on the menu. I don’t know if this is technically feasible. If so, perhaps it could be listed directly above the tags menu?

[EGreg (Greg Magarshak)]

This is exciting. Can someone please create a post with a link to a theme with KB installed, showing exactly what KB offers versus just regular categories and topics?

[justin (Justin DiRose)]

You can see it in action on our theme creator site: Discourse Theme Creator

[justin (Justin DiRose)]

@Sean_R

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.

This has been fixed in this commit:

FIX: Auto-enter KB view on subcategory change

---

@TowerBR did you end up figuring out what was wrong by chance? If not, send me a PM and maybe we can take a look.

[justin (Justin DiRose)]

@tobiaseigen

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.

This was a component naming conflict which I’ve resolved.

@tobiaseigen

bug? when you select a tag from the left menu to filter by that tag, and then click to another category or latest etc… then when you next click on kb to return to the knowledge base you will find you are still filtering by that tag.

I wasn’t able to reproduce this with the steps. Try updating and let me know if you still have this behavior.

@tobiaseigen

when you click on the tag under a title, it takes you to the tag page for that tag, not to a filtered kb view as it does when you click the tag on the left menu.

This is expected for now as in the theme version we’re just appending the KB UI to the existing topic list.

@tobiaseigen

click on the tag category title on the left menu, and you are taken to the latest view for the category. I’d suggest this not link to anywhere. The category title also should probably not have # which is a distraction.

I think this is a fair suggestion and I’ve removed both the link and the hash.

@tobiaseigen

• it would be handy to see the number of topics with each tag on the left menu
• it would be handy to be able to sort kb topics alphabetically or even in custom order

This is eventually going to be in the advanced version that’s a plugin.

@tobiaseigen

Another item - this theme component makes no sense alongside the popular tags theme component, and for some reason the exclude category setting for that theme component does not seem to work for me despite multiple browser refreshes. I don’t know if you can accommodate this issue in this theme component… so we can still use the popular tags in other views and not show them here.

The popular tags hid properly for me when I added an exception.

@tobiaseigen

• the tags menu does not appear to work correctly in the kb category. Items appearing in the list of topics from subcategory clearly have tags but the tags menu is empty, because there are no topics in the kb category.
• it would be very helpful to see a sub-categories list on the menu. I don’t know if this is technically feasible. If so, perhaps it could be listed directly above the tags menu?

I’m not quite following exactly what the issue is here. Does the kb category have subcategories, but no actual topics in the kb parent category?

If that’s the case, that’s semi-out of the scope of the theme component - we really just wanted to make a particular category filterable. Same with the subcategory filter. Some of these items will be possible in the advanced release.

[TowerBR (Tower)]

@justin

@TowerBR did you end up figuring out what was wrong by chance? If not, send me a PM and maybe we can take a look.

Unfortunately no, the behavior persists. The KB button seems to do nothing. I’ll send you a PM.

[TowerBR (Tower)]

With a little help from @justin, now everything is working.

I had not enabled tagging_enabled and show_filter_by_tag on the instance I use to test.

Thanks!

[tobiaseigen]

Cool! Lots of great stuff here. Thanks for your hard work on getting this theme component working so well. You mention an advanced version that is a plugin - Is there a roadmap somewhere for all this so I can set my expectations and give feedback? We also have Knowledge Base Plugin by @angus which has some overlapping functionality and it will be good to know which horse I should be betting on. I like aspects of both.

I will do some testing and get back to you.

[justin (Justin DiRose)]

@tobiaseigen

Is there a roadmap somewhere for all this so I can set my expectations and give feedback?

No unfortunately not. But I can tell you the plugin I’m working on is in a much different vein – think the theme component on steroids. I think both the plugin and @angus’ knowledge base plugin will have helpful use cases.

[justin (Justin DiRose)]

I’ve made a neat change – the kb categories setting now autopopulates with categories. This was available in our theme API the whole time, but I didn’t know about it! @tshenry cued me in.

One caveat – if you’ve set this up already, you’ll need to add your categories again once you update.

FEATURE: Use category list setting

[tobiaseigen]

Nice! That works well… you will get fewer support requests now.

A niggle, but I noticed the kb categories setting searches for names of categories, but not the short name (slug).

[justin (Justin DiRose)]

@tobiaseigen

A niggle, but I noticed the kb categories setting searches for names of categories, but not the short name (slug).

Ah yes - you won’t have to worry about the slug. The theme component handles that now. I may have forgotten to change some text though…

Edit: yeah I did. Committed a change to fix that.

[tobiaseigen]

I’m enjoying this theme component alot! Thanks again for creating it. I am really looking forward to the plugin because this is such a valuable bit of functionality that will get my team using discourse more. I can’t be positive, but I think as long as wiki topics look like forum posts people are intimidated and less likely to edit to improve it as a shared resource.

A few things I am grappling with:

1. tags menu shows up on one of my sites, but not on another. Have been unable to pinpoint the conflict. Likely an unofficial plugin. Any suggestions where to look?
2. there is no + NEW TOPIC button at the top of kb category view as there is for Latest. It would be helpful to have one to add a new wiki topic in the category. Right now you have to click across to Latest to start a topic in the category.
3. not a big problem but feels buggy - replicable on both of my sites and at theme creator:
   • go to kb view
   • select tag to filter by it
   • switch to TOP on top menu
   • switch back to KB on top menu
   • tag filter is still in place
4. on the same site where tags menu doesn’t show up, I have another weird problem I can’t replicate on my other site or on theme creator. When I go to a kb category via the categories pulldown, I am taken to Latest even though it should be defaulting to kb. Selecting kb on the menu has no effect… but when I hard refresh in the web browser I am taken to kb.

[tpetrov (Toni Petrov)]

谢谢，Justin。这是一个非常实用的组件，让知识库分类更加井井有条。
我昨天将其安装在一个全新的环境中，但遇到了两个问题：

1. 标签未显示在侧边栏中
2. 选择类别后，知识库视图默认未显示（尽管我已勾选“选中类别时自动显示知识库视图”）

我已禁用所有其他组件，并启用了 tagging_enabled 和 show_filter_by_tag，但问题依然存在。

[justin (Justin DiRose)]

你在浏览器控制台中看到任何错误了吗？另外，启用那两个设置后你刷新过页面吗？

[tpetrov (Toni Petrov)]

您的意思是刷新页面——我确实刷新了？

我没看到任何错误，只有这些提示：

[justin (Justin DiRose)]

这是在公共论坛上吗？我有一些怀疑，但最好能有办法查看一下。

编辑：可以肯定的是，问题 2 是由我们最近的分类路由更改引起的。我正在修复这个问题，但还有一些复杂性需要处理。

问题 1 我无法复现。更有可能的是，你看到的是子分类中的话题。由于这些话题不在你选择的分类中，标签不会显示在侧边栏。