Discourse Doc Categories


I’m really sorry, I can’t find this icon on my interface. Can anyone help me with a more specific location?

When you visit one of the categories you can find the button at the top

2 Likes

thank you very much . and “no matches found” :face_exhaling:

Did you create an index topic in that category?

:laughing:
Thank you. It has appeared now. However, I still can’t understand the following instructions. Would it be convenient for you to explain with a picture?

What don’t you understand? Then explaining would be easier.

But headers and links are showing in the sidebar, nothing else. You can write something else and that will be visible if/when someone looks that post.

Links must be a list. And if you use pure link then title of that post will be used. If you use structure other name: link then that other name is shown.

That was the easy part. Creating that index is the hard task. If you have AI in use on that forum you can tell it to create the index, but OpenAI’s GPT-models have tendency create max 20-30 links.


I’m really sorry, because there’s nothing appearing on the left side.
I have already installed everything mentioned before. I’ve also checked that index, but nothing has changed.

1 Like

You need to open the category where you added the index. Here at Meta, you don’t see the docs when looking at /latest either. But when you visit Contributing, the sidebar shows the content which was specified in the index topic of that category

1 Like

I think I miscommunicated the meaning of “index”. What I meant was that I added the index here and completed the setup.


What is the content of your documentation index topic? Does it look similar to the ones here? As Jagster explained, you need a list with links to the topics you want to appear in the sidebar. Something like:

## Heading

* This text is shown in the sidebar: https://discourse.example.com/t/-/1
* This is a second topic: https://discourse.example.com/t/-/2

1 Like

7 posts were merged into an existing topic: Add Sidebar support “Discourse Icon” & more

May I ask what this is and where it is maintained? I can’t find the specific location.

This is detailed primarily in the first post. Depending o. When you last viewed it. It may have been updated.

Do you have any ETA on this?

Dear @saquetim,
I have installed a self-hosted instance of Discourse with version 3.3.2. I’m now trying to add the discourse-doc-categories plugin, but I encountered the following error.

I’m wondering if upgrading to version 3.4.0.beta1 or 3.4.0.beta2 would resolve the issue. Are these versions compatible with the plugin?


** INCOMPATIBLE PLUGIN **

You are unable to start Discourse due to errors in the plugin at
/opt/bitnami/discourse/plugins/discourse-doc-categories

Please try removing this plugin and rebuilding again!
1 Like

The plugin is supported in 3.4+ - so upgrading will resolve your issue

2 Likes

Dear @Moin, I didnt have any trouble with installation. I just asked plugin is suitable or not. Thank you.

Love the plug in

Is it possible to add support to group headings into sections to help with layout. Something like H1 = Section header, H2 - group/folder header

I’ve tried to mock it up a little:

We are a makerspace with lots of Tool Areas, across different rooms. It would be great to have the Tool groups sectioned off by room

4 Likes