A few months ago I installed Discourse, added some topics as Index Topic in the Documentation Mode section. Everything worked as expected. backed up everything, deleted the Digital Ocean account, etc. A few days ago I installed Discourse again and restored everything from the backup file I created and everything is working, except for the Documentation sections. At first I thought maybe the issue was that I unlisted those index topics, but they were unlisted before I uninstalled everything and they were working, so that couldn’t be the issue. Still, I tried to list them, but no luck. The sidebar was still showing the categories and all that other stuff that is the default. Then I decided to copy the original topic’s content and create a new topic with it, set it to Index Topic, and that one works. Also closed and unlisted like the one that’s not working, so closing and unlisting is not the issue. It seems that in the restore process, something is breaking the documentation mode for some reason.

Just checking - have you seen this? [图片]Discourse Doc Categories Updates for self-hosters For self-hosters using this plugin, our most recent update would require a manual rebuild of the index. This would involve running this rake task: bundle exec rake doc_categories:build_sidebar # if running the task above fails due to NoDatabaseError, # run with the following for typical self-hosted setups sudo -E -u discourse bundle exec rake doc_categories:build_sidebar If you are not able to run this rake task, you may go to each documentation category’s settings, remove the category index, save, add it back, and save. This would rebuild them and refresh the category cache as well

Thank you for the link. Since I’m still building the whole structure, I ended up just creating a new topic, copying and pasting the content from the old one, and delete the old topic. I only had 2 of those anyway. So, my question is: is that rake task something I need to do every time I update Discourse? Or just when I restore (if I do it again in the future)?

No, that rake task is just a one-time thing from the date of that quoted post. You shouldn’t need to re-create the topic though, just going to category settings, unlinking, saving, and relinking the existing topic at least should work.

[图片] nat: that rake task is just a one-time thing from the date of that quoted post Just wondering - why wasn’t this implemented as a migration?

From what I recalled at that time — It couldn’t be a migration. Migrations ideally don’t touch application code (because code can drift from when the migration is intended and error out). The PR also indicates the reason: This PR also includes a rake task (doc_categories.rake ) for rebuilding sidebar sections and links from active doc index topics – this is not exactly recommended to do in a migration as it would involve either using the parser or nokogiri (which implementations can drift and cause an invalid migration).

So, if I understand it correctly, from now on, I don’t need to do any of that? The rake task or the relinking process, whenever I update Discourse? Just want to make sure I understand it.

Yup. It was only a one-time thing.

Awesome! Thank you for clarifying! :raising_hands:

[图片] nat: You shouldn’t need to re-create the topic though, just going to category settings, unlinking, saving, and relinking the existing topic at least should work. I’m finding that I need to do this every time I edit the index topic, which is a right pain. Am I missing something?

Hey fellow Nat, I’m acknowledging this issue here. I think there is a real problem but will need to reliably repro this. Will get back here sometime next week with good news hopefully.

@nathank quick question, do you have discourse-calendar enabled?

Documentation 插件 - 恢复后索引主题不工作

产品支持

nat (Natalie T) 2025 年12 月 27 日 17:12 4

不，那个 rake 任务只是从引用的帖子日期开始的一次性操作。

您不应该需要重新创建主题，只需进入类别设置，取消链接，保存，然后重新链接现有主题至少应该可以工作。

话题		回复	浏览量
Discourse Doc Categories Plugin official , doc-categories	135	13018	2026 年10 月 23 日
Discourse Docs Plugin – Topics Not Updating in Docs Page Product Support docs	6	477	2025 年4 月 16 日
Sidebar activation issues after recent Doc Categories update Bug doc-categories , horizon-theme , bug	4	334	2025 年9 月 25 日
Introducing the visual index editor for Discourse Doc Categories Announcements doc-categories	2	149	2026 年11 月 4 日
Doc Categories - Sidebar titles revert to URL when editing index Product Support doc-categories	4	330	2025 年12 月 23 日

Documentation 插件 - 恢复后索引主题不工作

相关话题