# Documentation 플러그인 - 복원 후 Index Topic이 작동하지 않음
**URL:** https://meta.discourse.org/t/documentation-plugin-index-topic-not-working-after-restore/392225
**Category:** Support
**Tags:** doc-categories
**Created:** [12월 27, 2025, 8:50오전 UTC](https://meta.discourse.org/t/documentation-plugin-index-topic-not-working-after-restore/392225 "2025-12-27T08:50:39Z")
**Posts on this page:** 17
**Page:** 1
### Author:  [@alltiagocom](https://meta.discourse.org/u/alltiagocom)
#### Post date: [12월 27, 2025, 8:50오전 UTC](https://meta.discourse.org/t/documentation-plugin-index-topic-not-working-after-restore/392225/1 "2025-12-27T08:50:39Z")
몇 달 전에 Discourse를 설치하고, Documentation Mode 섹션에 일부 주제를 Index Topic으로 추가했습니다. 모든 것이 예상대로 잘 작동했습니다.
모든 것을 백업하고 Digital Ocean 계정을 삭제하는 등 작업을 진행했습니다.
며칠 전 Discourse를 다시 설치하고, 이전에 만든 백업 파일에서 모든 것을 복원했는데, Documentation 섹션을 제외한 모든 것이 잘 작동합니다. 처음에는 해당 인덱스 주제를 비공개(unlisted)로 설정했기 때문인 줄 알았지만, 모든 것을 삭제하기 전에 이미 비공개 상태였고 그때는 잘 작동했으므로 그 문제가 아니었습니다. 그래도 목록에 표시(list)해 보았지만 소용이 없었습니다. 사이드바에는 여전히 카테고리 등 기본 설정된 항목들이 그대로 표시되었습니다.
그런 다음 원래 주제의 내용을 복사하여 새로운 주제로 만들고, 이를 Index Topic으로 설정해 보았는데, 이 주제는 잘 작동했습니다. 작동하지 않는 주제와 마찬가지로 닫고(closed) 비공개(unlisted)로 설정했는데, 닫기나 비공개 설정이 문제가 아니라는 것을 확인했습니다.
복원 과정에서 어떤 이유로든 documentation mode가 깨지는 것 같습니다.
---
### Author:  [@nat](https://meta.discourse.org/u/nat)
#### Post date: [12월 27, 2025, 4:51오후 UTC](https://meta.discourse.org/t/documentation-plugin-index-topic-not-working-after-restore/392225/2 "2025-12-27T16:51:45Z")
확인 차원에서 여쭤봅니다 - 이것 보셨나요?
> [@nat](#):
>
> ## 셀프 호스터를 위한 업데이트
>
> 이 플러그인을 사용하는 셀프 호스터의 경우, 최신 업데이트에서는 인덱스를 수동으로 다시 구축해야 합니다. 이를 위해 다음 rake 작업을 실행해야 합니다:
>
> ```plaintext
> bundle exec rake doc_categories:build_sidebar
>
> # 위의 작업 실행 시 NoDatabaseError로 실패하는 경우,
> # 일반적인 셀프 호스팅 환경에서는 다음을 실행하세요
> sudo -E -u discourse bundle exec rake doc_categories:build_sidebar
>
> ```
>
> 이 rake 작업을 실행할 수 없는 경우, **각 문서 카테고리의 설정으로 이동하여 카테고리 인덱스를 제거하고, 저장한 후 다시 추가하고 저장하면 됩니다.** 이렇게 하면 인덱스가 다시 구축되고 카테고리 캐시도 새로워집니다.
---
### Author:  [@alltiagocom](https://meta.discourse.org/u/alltiagocom)
#### Post date: [12월 27, 2025, 5:11오후 UTC](https://meta.discourse.org/t/documentation-plugin-index-topic-not-working-after-restore/392225/3 "2025-12-27T17:11:42Z")
링크 공유해 주셔서 감사합니다.
아직 전체 구조를 구축 중이라, 결국 새 주제를 만들고 기존 주제의 내용을 복사해서 붙여넣은 뒤, 기존 주제를 삭제했습니다. 어차피 그런 주제가 2개뿐이었거든요.
그래서 질문이 있습니다: 그 `rake task`는 Discourse를 업데이트할 때마다 실행해야 하는 건가요? 아니면 나중에 다시 복구할 때만 하면 되는 건가요?
---
### Author:  [@nat](https://meta.discourse.org/u/nat)
#### Post date: [12월 27, 2025, 5:12오후 UTC](https://meta.discourse.org/t/documentation-plugin-index-topic-not-working-after-restore/392225/4 "2025-12-27T17:12:53Z")
아니요, 그 rake 태스크는 인용된 게시물의 날짜 기준으로 한 번만 실행되는 것이에요.
다만, 주제를 다시 만들 필요는 없어요. 카테고리 설정으로 가서 연결을 해제한 후 저장하고, 기존 주제를 다시 연결하기만 하면 최소한은 작동할 거예요.
---
### Author:  [@RGJ](https://meta.discourse.org/u/RGJ)
#### Post date: [12월 27, 2025, 5:19오후 UTC](https://meta.discourse.org/t/documentation-plugin-index-topic-not-working-after-restore/392225/5 "2025-12-27T17:19:01Z")
> [@nat](#):
>
> 그 인용된 게시글의 날짜 기준으로, 그 rake 태스크는 일회성 작업이었을 뿐입니다.
호기심이 생겨서问一下 - 왜 이걸 마이그레이션으로 구현하지 않았을까요?
---
### Author:  [@nat](https://meta.discourse.org/u/nat)
#### Post date: [12월 27, 2025, 5:24오후 UTC](https://meta.discourse.org/t/documentation-plugin-index-topic-not-working-after-restore/392225/6 "2025-12-27T17:24:41Z")
그때 내가 기억하는 바로는 — 마이그레이션일 수는 없었다. 마이그레이션은 이상적으로는 애플리케이션 코드를 건드리지 않아야 한다(코드가 마이그레이션의 의도와 달라져서 오류가 발생할 수 있기 때문).
[PR](https://github.com/discourse/discourse-doc-categories/pull/51)에서도 그 이유가 명시되어 있다:
> 이 PR에는 활성 문서 인덱스 주제에서 사이드바 섹션과 링크를 다시 빌드하기 위한 레이크 태스크(`doc_categories.rake`)도 포함되어 있습니다. 이는 파서를 사용하거나 nokogiri를 사용해야 하므로, 구현이 달라져서 잘못된 마이그레이션을 초래할 수 있기 때문에 마이그레이션에서 수행하는 것은 권장되지 않습니다.
---
### Author:  [@alltiagocom](https://meta.discourse.org/u/alltiagocom)
#### Post date: [12월 27, 2025, 5:25오후 UTC](https://meta.discourse.org/t/documentation-plugin-index-topic-not-working-after-restore/392225/7 "2025-12-27T17:25:00Z")
네, 제 이해가 맞다면 앞으로는 그 작업을 전혀 할 필요가 없다는 건가요? Discourse를 업데이트할 때마다 rake 태스크나 재링크 과정을 실행할 필요가 없다는 뜻인가요?
제 이해가 맞는지 확인하고 싶었습니다.
---
### Author:  [@nat](https://meta.discourse.org/u/nat)
#### Post date: [12월 27, 2025, 5:25오후 UTC](https://meta.discourse.org/t/documentation-plugin-index-topic-not-working-after-restore/392225/8 "2025-12-27T17:25:23Z")
응. 일회성이었어.
---
### Author:  [@alltiagocom](https://meta.discourse.org/u/alltiagocom)
#### Post date: [12월 27, 2025, 5:27오후 UTC](https://meta.discourse.org/t/documentation-plugin-index-topic-not-working-after-restore/392225/9 "2025-12-27T17:27:30Z")
멋지네요! 설명해 주셔서 감사합니다! 🙌
---
### Author:  [@system](https://meta.discourse.org/u/system)
#### Post date: [1월 26, 2026, 5:28오후 UTC](https://meta.discourse.org/t/documentation-plugin-index-topic-not-working-after-restore/392225/10 "2026-01-26T17:28:21Z")
This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.
---
### Author:  [@nathank](https://meta.discourse.org/u/nathank)
#### Post date: [4월 9, 2026, 12:34오전 UTC](https://meta.discourse.org/t/documentation-plugin-index-topic-not-working-after-restore/392225/11 "2026-04-09T00:34:11Z")
> [@nat](#):
>
> 다만, 주제를 다시 만들 필요는 없어요. 카테고리 설정으로 가서 연결을 해제한 뒤 저장하고, 기존 주제를 다시 연결하기만 해도 작동할 수 있어야 합니다.
인덱스 주제를 수정할 때마다 이 과정을 반복해야 하는 것 같아 정말 귀찮습니다.
무엇을 놓치고 있는 걸까요?
---
### Author:  [@darkpixlz](https://meta.discourse.org/u/darkpixlz)
#### Post date: [4월 9, 2026, 6:15오전 UTC](https://meta.discourse.org/t/documentation-plugin-index-topic-not-working-after-restore/392225/12 "2026-04-09T06:15:48Z")
---
### Author:  [@nat](https://meta.discourse.org/u/nat)
#### Post date: [4월 15, 2026, 5:40오전 UTC](https://meta.discourse.org/t/documentation-plugin-index-topic-not-working-after-restore/392225/13 "2026-04-15T05:40:50Z")
안녕하세요, Nat님. 이 문제를 확인했습니다.
실제로 문제가 있는 것 같지만, 이를 안정적으로 재현해야 합니다. 다음 주쯤 좋은 소식으로 다시 돌아올 수 있기를 바랍니다.
---
### Author:  [@nat](https://meta.discourse.org/u/nat)
#### Post date: [4월 15, 2026, 11:04오전 UTC](https://meta.discourse.org/t/documentation-plugin-index-topic-not-working-after-restore/392225/14 "2026-04-15T11:04:25Z")
@nathank 빠른 질문인데, discourse-calendar이 활성화되어 있나요?
---
### Author:  [@nat](https://meta.discourse.org/u/nat)
#### Post date: [4월 15, 2026, 12:12오후 UTC](https://meta.discourse.org/t/documentation-plugin-index-topic-not-working-after-restore/392225/15 "2026-04-15T12:12:22Z")
>
>
> Invoking \`post.reload\` within the \`post\_created\` or \`post\_edited\` events may cau…se data within \`revisor.post\_changes\` to reset.
@nathank 캘린더 플러그인이 활성화되어 있을 때 문제가 발생할 수 있다고 생각합니다(PR에서 설명되어 있음). 기본적으로 **C** alendar의 부작용(버그)으로 인해 **D** ocs Categories 플러그인이 주제를 재인덱싱하지 않았습니다. 이 수정으로 인해 재인덱싱이 안정적으로 수행됩니다.
이 수정이 문제를 해결하지 못하면 알려 주세요.
---
### Author:  [@nathank](https://meta.discourse.org/u/nathank)
#### Post date: [4월 16, 2026, 9:58오전 UTC](https://meta.discourse.org/t/documentation-plugin-index-topic-not-working-after-restore/392225/16 "2026-04-16T09:58:29Z")
> [@nat](#):
>
> @nathank 간단한 질문인데, discourse-calendar를 활성화하고 계신가요?
답변이 늦어서 죄송합니다 - **네**!
신속하게 선제적으로 문제를 해결해 주셔서 감사합니다. 곧 제 사이트를 업데이트해서 테스트해 보겠습니다.
---
### Author:  [@darkpixlz](https://meta.discourse.org/u/darkpixlz)
#### Post date: [5월 16, 2026, 9:58오전 UTC](https://meta.discourse.org/t/documentation-plugin-index-topic-not-working-after-restore/392225/17 "2026-05-16T09:58:40Z")
이 주제는 마지막 답변 후 30일이 지나면 자동으로 닫힙니다. 새로운 답변은 더 이상 허용되지 않습니다.