Discourse 문서 카테고리

[nathank (Nathan Kershaw)]

@nat

bundle exec rake doc_categories:build_sidebar

방금 이 작업을 수행했는데, 약간 이상한 오류가 발생했지만 정상적으로 실행된 것 같습니다:

root@spokes-web-only:/var/www/discourse# bundle exec rake doc_categories:build_sidebar
fatal: detected dubious ownership in repository at ‘/var/www/discourse’
To add an exception for this directory, call:

    git config --global --add safe.directory /var/www/discourse

Processing category #21 - Ask the Candidates
⮑ Created 3 sections and 55 links

Processing category #21 - Ask the Candidates
⮑ Created 3 sections and 55 links

이것이 정상적인 상태인가요?

그리고 인덱스 토픽과 상호작용하는 방식을 변경해야 하는지, 아니면 그대로 유지해도 되는지 궁금합니다.

[nat (Natalie T)]

@nathank

그렇게 되어야 하나요?

네, 맞습니다. 더 이상 할 일이 없습니다.

@nathank

모든 것이 변경되지 않았다는 건가요?

네, 그렇습니다.

가까운 미래에 () 쉬운 정렬, 재배치, 업데이트와 같은 기능을 개선하기 위해 노력할 예정입니다. 아마도 전용 UI를 사용할지도 모르겠네요. 셀프 호스터들이 수동으로 해야 할 작업이 더 이상 없을 것으로 기대합니다.

[Sailor (Peter Petrik)]

@nat

최근 업데이트

이것이 어떤 플러그인 버전 및/또는 커밋에 해당하는지 명확히 설명해 주시겠어요?

현재 저는 Discourse 3.6.0.beta1-dev를 사용 중인데, Documentation Categories 플러그인에는 업데이트 가능한 항목이 표시되지 않습니다. 해당 플러그인 버전은 0.0.1이며 커밋은 ba90a37입니다.

[nat (Natalie T)]

@Sailor

commit ba90a37

해당 변경사항은 약 7개의 커밋이 더 최신 상태입니다.

변경사항은 동일한 버전인 Discourse 3.6.0.beta1-dev에 포함되어 있습니다. 이상적으로는 다음에 Discourse 본체를 업데이트할 때 이 변경사항도 함께 적용될 것입니다.

일반적으로 플러그인만 업데이트하는 것은 권장하지 않으며, UI를 통한 일반적인 업그레이드 방법 또는 ./launcher rebuild app 명령을 사용하는 것을 권장합니다.

[cmdntd]

문서 메뉴(왼쪽)가 discourse의 최신 버전(3.6.0.beta2)에서 표시되지 않습니다

다시 확인해 주실 수 있을까요?

[Moin]

저한테는 Meta에서 아직 잘 동작합니다.

여기에 설명된 대로 인덱스를 재구축해 보셨나요?

Discourse 문서 카테고리

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 categor…

[cmdntd]

@nat

sudo -E -u discourse bundle exec rake doc_categories:build_sidebar

감사합니다. 이렇게 하면 정상적으로 작동합니다:

sudo -E -u discourse bundle exec rake doc_categories:build_sidebar

[caue-pareto (cpareto)]

여러분 안녕하세요,

방금 설치해 보았는데, 우리가 사용 중인 Discourse 버전 3.5.2와 이 플러그인이 호환되지 않는 것 같습니다.

호환성을 확인해 주실 수 있을까요? 다음과 같은 오류가 발생하고 있습니다:

November 5, 2025, 06:55
/var/www/discourse/plugins/discourse-doc-categories/lib/doc_categories/initializers/add_category_extensions.rb:19:in `apply': undefined method `register_category_update_param_with_callback' for an instance of Plugin::Instance (NoMethodError)
discourse
November 5, 2025, 06:55
** INCOMPATIBLE PLUGIN **
discourse
November 5, 2025, 06:55
You are unable to start Discourse due to errors in the plugin at
discourse
November 5, 2025, 06:55
/var/www/discourse/plugins/discourse-doc-categories
discourse
November 5, 2025, 06:55
Please try removing this plugin and rebuilding again!

[nat (Natalie T)]

안녕하세요, 해당 메서드는 더 최신 버전에만 존재하므로 먼저 Discourse 인스턴스를 업데이트해야 합니다.

[caue-pareto (cpareto)]

discourse/discourse:3.5.2 이미지에는 이 업데이트된 코드가 포함되어 있나요? 이 이미지를 사용 중인데, 10시간 전에 업데이트된 것으로 보입니다.

[nat (Natalie T)]

3.5.2는 호환되지 않습니다. 보안 업데이트는 제공되지만, 새로운 기능은 없습니다. 최소한 3.6.0.beta1이 필요합니다.

[sren-1]

3.6.0.beta3-latest와 관련된 문제를 아시나요? 최근 3.6.0.beta1에서 업데이트한 이후로 플러그인이 작동하지 않습니다.

[pacharanero (Marcus Baw)]

@sren-1

최근 3.6.0.beta1로 업데이트한 후부터 플러그인이 작동하지 않습니다.

여기에 설명된 대로 rake 작업을 실행해 보셨나요?

Discourse 문서 카테고리

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 categor…

Rake 작업을 수행할 수 없는 경우, 대안으로(카테고리 설정에서 'Index Topic’을 제거한 후 저장을 클릭하고 다시 추가) 진행할 수 있습니다.

[jordanjay29]

@pacharanero

Rake 작업을 수행할 수 없다면 대안이 있습니다(카테고리 설정에서 Index Topic을 제거한 후 저장하고, 다시 추가하는 것입니다).

지정된 형식으로 정적 이름을 가진 링크를 인덱스에 추가한 이후, 매번 이 작업을 수행해야 했습니다:

* A Link Text: https://meta.discourse.org/t/an-example-link/

이렇게 하지 않으면 카테고리 사이드바 링크가 제목으로 파싱되지 않고 전체 URL 그대로 남습니다. 이는 최신 Discourse(커밋 5817b6c 기준 2025.12.0-latest)에서 발생하는 문제입니다.

[pacharanero (Marcus Baw)]

@jordanjay29

사이드바 링크가 제목으로 파싱되지 않고 전체 URL로 남아 있습니다.

저도 가끔 이런 일이 일어나는 것을 확인했습니다. 페이지를 새로고침하면 해결되는 것 같습니다.

(이것은 플러그인이 전혀 작동하지 않는 경우와 다릅니다. rake 작업을 수행하지 않거나 Index Topic을 재시작하지 않으면 그런 일이 발생하며, 제가 한 번은 설정을 깜빡한 포럼에서 같은 문제가 발생했습니다.)

[jordanjay29]

@pacharanero

페이지를 새로고침하면 해결되는 것 같습니다.

저에게는 그렇게 하지 않았습니다. 위에서 인용한 rake 또는 카테고리 설정 조정만이 해결책이었습니다.

[sren-1]

감사합니다. 저도 피드백을 제공하겠습니다

[sren-1]

@pacharanero

Rake 작업을 수행할 수 없다면 대안이 있습니다(카테고리 설정에서 Index Topic을 제거한 후 저장을 클릭하고 다시 추가합니다).

잘 작동했습니다. 정말 감사합니다!

[nat (Natalie T)]

최근 업데이트로 이 문제가 해결되었을 수 있습니다. 그래도 문제가 남아 있다면 다시 알려주시기 바랍니다.