Discourse Doc Categories

You don’t need to point the Docs plugin to the category - this plugin replaces the Docs plugin. That might be what is affecting things for you, as it would cause a conflict with one overriding the other.

All you need to do is make sure doc categories enabled is checked, and then create the index topic in the category, adding it to the category’s settings in the Index topic field. If you still have the category set in the old Docs plugin settings, then you should remove it from there.

Hey Hugh, thanks for the swift reply! If I said the Docs plugins, my apologies. I only have the Doc Categories plugin installed here.

So here is the useful report to find Topics not indexed. I only have 2 test topics so far.
image

Then here is the settings screen. I know I am close, but I’m missing a step or 2 somewhere! Thx!

image

Did you set the category setting?

Also, what does your index look like? Is it structured like-so?

Hi Marc! Yeah Category is set (obviously) set via the report above right? but here it is.
image

Category page looks like this:
image

I know i’m missing something. What did you mean by this page: Is it structured like-so ?

This links to a index for the Documentation on Meta. Your designated topic needs to look similar to that for the index to generate. From ur screenshots, I think you misunderstood/misread something. Read from here.

Also, kind of off-topic – but maybe night. Do I need the sidebar theme plugin to show index on the right as well? or is that automatic as well? Thanks!

Not sure what you mean, from my understanding the sidebar is default/core and not a plugin.

Gotcha, did you mean by the heading/subheading sections? I was looking for that in the composeer, but it wasnt apparent (to me anyway) if i needed like HTML < h1 > headings and what not. Appreciate again the rapid responses!

Headings are h1, links are by bulletpoints. You can literally copy paste the meta index it should give you an example to start with if you’re struggling.

Like this way:

## something useful
* this is that: https://forum.example.tld/t/777
* that is another: https://forum.example.tld/t/666

Etc

I’m lazy so I didn’t do that manually, but I used AI of forum.

Thanks. So i copied a part of the Documentation index above as provided by @MarcP, just don’t see the sidebar index which is strange, unless again im missing something…

That screenshot doesn’t show the structure. Are you totally sure you are using form

* description: url

and you tell name, url or ID of that topic in settings of that category?

Like this?

1 Like

Yeah. If you see something similar to this in composer (don’t mind the really strange language, the idea should be clear though):

Tätä käytetään hampurilaisvalikossa esittelemään 20 eniten reaktioita saanutta ketjua kategoriassa #koiramaailma . Eräänlainen mainosikkuna siis.

## Top-20 eniten reagoitua ketjua

* Mitä helvettiä eläinlääkinnässä tapahtuu 🤬: https://foorumi.katiska.eu/t/mita-helvettia-elainlaakinnassa-tapahtuu/6772
* Kuivamuonamainokset: Hassut aidot tapaukset: https://foorumi.katiska.eu/t/kuivamuonamainokset-hassut-aidot-tapaukset/479

Those descriptions don’t show on the sidebar.

1 Like

Well, as you can see, nothing on the right side :frowning:

If it helps anyone, here is the list of plugins i have installed as well…

    cmd:
      - git clone https://github.com/discourse/docker_manager.git
      - git clone https://github.com/discourse/discourse-solved.git
      - git clone https://github.com/discourse/discourse-user-notes.git
      - git clone https://github.com/discourse/discourse-openid-connect.git
      - git clone https://github.com/discourse/discourse-ai.git
      - git clone https://github.com/discourse/discourse-yearly-review.git
      - git clone https://github.com/paviliondev/discourse-custom-wizard.git
      - git clone https://github.com/discourse/discourse-doc-categories.git
      - git clone https://github.com/discourse/discourse-reactions.git
      - git clone https://github.com/discourse/discourse-akismet.git
      - git clone https://github.com/discourse/discourse-data-explorer.git
      - git clone https://github.com/discourse/discourse-oauth2-basic.git
      - git clone https://github.com/discourse/discourse-assign.git
      - git clone https://github.com/discourse/discourse-templates.git
      - git clone https://github.com/discourse/discourse-policy.git
      - git clone https://github.com/discourse/discourse-gamification.git
      - git clone https://github.com/discourse/discourse-category-experts.git
      - git clone https://github.com/merefield/discourse-ai-topic-summary.git
      - git clone https://github.com/MonDiscourse/discourse-formatting-toolbar.git
      - git clone https://github.com/discourse/discourse-custom-topic-lists.git
      - git clone https://github.com/thoka/discourse-send-pdf-inline.git
      - git clone https://github.com/discourse/discourse-prometheus.git
      - git clone https://github.com/communiteq/discourse-user-response-times.git
      - git clone https://github.com/discourse/discourse-fingerprint.git
      - git clone https://github.com/discourse/discourse-bcc.git
      - git clone https://github.com/featheredtoast/discourse-pushover-notifications.git
      - git clone https://github.com/discourse/discourse-saved-searches.git

Usually the sidebar is on the left (red) The docs sidebar just replaces the default content. On the right (purple) you see a table of content which is added by the DiscoTOC - automatic table of contents thrme component.

Yeah DiscoTOC is an installed theme component as well. Can’t get that going either. Something is amiss…

Not sure but your screenshots are not clear. You are taking the screenshot and not showing a sidebar at all? It’s the doc sidebar not showing? Or is the sidebar not showing at all (is it not just hidden, try pressing =)

Edit; thinking of this you should be clear if you are having issues with discoTOC (table of content for the OP) or the doc-categories (doc index sidebar)

1 Like

Hey Marc–
So the DiscoTOC works. I went back double-check and it does indeed create a sidebar TOC after I go to gears and insert TOC as instructions say.

All of my screenshots include the sidebar, so i am showing the open landscape w/o any sidebars showing.

I just have this weird feeling it will be a very simple fix, but I’m not there yet :frowning:

I don’t see any sidebars in your screenshots - they all show just the post content. Could you post a screenshot of the full Discourse screen when you’re on a category that should have an index showing?

3 Likes