Documentation 플러그인 - 복원 후 Index Topic이 작동하지 않음

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?

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.

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님. 이 문제를 확인했습니다.

실제로 문제가 있는 것 같지만, 이를 안정적으로 재현해야 합니다. 다음 주쯤 좋은 소식으로 다시 돌아올 수 있기를 바랍니다.

@nathank 빠른 질문인데, discourse-calendar이 활성화되어 있나요?

@nathank 캘린더 플러그인이 활성화되어 있을 때 문제가 발생할 수 있다고 생각합니다(PR에서 설명되어 있음). 기본적으로 Calendar의 부작용(버그)으로 인해 Docs Categories 플러그인이 주제를 재인덱싱하지 않았습니다. 이 수정으로 인해 재인덱싱이 안정적으로 수행됩니다.

이 수정이 문제를 해결하지 못하면 알려 주세요.

답변이 늦어서 죄송합니다 - !

신속하게 선제적으로 문제를 해결해 주셔서 감사합니다. 곧 제 사이트를 업데이트해서 테스트해 보겠습니다.