Discourse Doc Categories

Customization Plugin
,
152

5 posts were split to a new topic: Highlight current doc topic in the sidebar identified by their slugs in the index

153

Is it normal that once I use Doc Categories, when I’m viewing a topic in that category my sidebar navigation doesn’t have the link to the admin anymore? I find that quite annoying but I don’t know if it’s a general issue or my setup. Seems to me that access to “admin stuff” should be in a stable place for site admins?

1 Like
154

Yes, that’s normal. The usual sidebar is replaced by the Doc Categories sidebar. The admin stuff is in a stable place
 once you go back:

image
image310×422 20.4 KB

1 Like
155

Right – is there a way to customize this Doc Categories sidebar? I do like the doc listing a lot, but the fact that “usual” sidebar stuff like “my posts” etc. suddenly disappears is confusing, particularly as the rest of the design doesn’t really change. I guess if when viewing Doc Categories it looked overall very different, it wouldn’t be so confusing. I know that when I first arrived on Meta the whole Documentation thing confused me and I stayed away from it for a bit because of that :face_with_peeking_eye: (I was like “OMG where am I now?”)

2 Likes
156

A little CSS can give the docs sidebar a distinct background color – maybe that would help?

.discourse-docs-sidebar-panel {
background-color: darkmagenta;
}

image
image1383×823 123 KB

5 Likes
157

That’s a good idea, thanks! I’m going to look more closely into the different selectors for part of the Discourse page layout. I imagine there’s a reference somewhere.
I can’t remember if I asked the question or not before, but is there a way to apply a CSS rule according to group or TL the user belongs to?

3 Likes
Finding CSS selectors for page layout, user groups
158

I’ve spun off a topic with some hints: Finding CSS selectors for page layout, user groups

4 Likes
159

For posterity: I just did a new install following all the directions and still had to add and delete the index file using the steps of “adding index → save index→ delete index → add index back” to get the Docs category to show properly.

Perhaps that, or the Rake task could be added as a call out somewhere in the install instructions for the plugin.

4 Likes
Experiment: Collaborative content gardening hub for meta
160

Hi :smiley:
Everything works great with this plugin, thanks for it! :heart:
Just one little thing
 it kinds “breaks” the in-topic hyperkink anchor behaviour.
The view jumps correctly from A to B, but instead of the usual smooth page-scroll up and down, the page reloads (at the correct anchored position).

Is there a way to fix this?

161

Is there a way to display topics in a documentation category as “cards” like the category cards? (cf e.g. in Google Drive when you choose card view instead of list view for your documents)

162

Is there a branch that I should use for this plugin to be compatible with a self hosted instance running the v2026.1 Extended Support Release? I see d-compat branches for 2026.5, 2026.4, 2026.3, and 2026.2.

Thanks for any help!

163

The plugin doesn’t support a card view yet. :smiley:

A custom theme component probably could make it work, but AFAIK there isn’t anything ready out of the box.

We changed to use compatibility branches after your release, but the plugin has a pinned commit hash in the .discourse-compatibility file: