Doc Categories - Sidebar titles revert to URL when editing index

Support
1

I am currently working on an overhaul of our current docs solution, to move us over to using doc categories instead of the docs plugin. I’m currently testing on our dev instance and have run into a little hiccup.

I created the index, and listed the topics by URL, without a title. The sidebar looked correct, pulling in the topic titles.

image
image1971×645 64.2 KB

Then, I wanted to check the behavior of re-ordering the items in the sidebar, so I edited the order of the items in the second section. After I saved the edit, the sidebar titles changed to the URL instead of pulling in the correct titles.

image
image2171×815 80.3 KB

I tried rebuilding the HTML as indicated in Sidebar item title not updated after linked topic title in Index is edited, but that did not fix the issue. I also tried removing the index from the category settings, saving, and adding it again, and that didn’t help either.

The topic I linked above indicated that

My question is - how long should it take to sort out if caching is the issue? Would it be better to include the titles in the index from the jump? Or could this be a different issue altogether?

2 Likes
2

Thanks for writing in and your detailed report.

I don’t think this is a caching issue as the sidebar has changed. The cache should be properly busted once the topic is edited.

Are you self-hosted or hosted by Discourse? I suspect the issue could be how the plugin does URL resolution using the base URLs. :thinking:

1 Like
3

I have the same problem – self hosted (just updated to the latest). Having a simple link in the index is not enough. I have to give it a label to make it working – either label: link or [label](link).

2 Likes
5

Thanks for the quick reply! We are self-hosted.

1 Like
6

The bug is probably not to do with the base URL like I thought, but probably related to topic URL resolution.

I’ve a fix here

2 Likes