Discourse 문서 카테고리

Docs 플러그인을 해당 카테고리로 지정할 필요가 없습니다. 이 플러그인은 Docs 플러그인을 대체하는 것이기 때문입니다. 기존 Docs 플러그인과 새 플러그인 중 하나가 다른 하나를 덮어쓰는 충돌이 발생하여 문제가 생기고 있는 것일 수 있습니다.

doc categories enabled 항목이 체크되어 있는지 확인한 후, 해당 카테고리에서 인덱스 토픽을 생성하고 카테고리 설정의 Index topic 필드에 추가하기만 하면 됩니다. 기존 Docs 플러그인 설정에 카테고리가 여전히 지정되어 있다면, 해당 설정에서 제거해야 합니다.

휴, 빠른 답변 감사합니다! Docs 플러그인이라고 한 건 제 실수였습니다. 여기에는 Doc Categories 플러그인만 설치되어 있어요.

아직 테스트용 주제(Topic)가 2개뿐이지만, 인덱싱되지 않은 주제를 찾는 데 유용한 리포트입니다.

다음은 설정 화면입니다. 거의 다 됐다고 생각하는데, 어딘가에서 1~2단계를 놓치고 있는 것 같아요! 감사합니다!

카테고리 설정을 했나요?

또한, 인덱스는 어떤 모습인가요? 이렇게 구성되어 있나요?

마크, 안녕! 네, 카테고리(Category)는 위에서 언급한 보고서에 따라 설정되어 있죠? 여기 있습니다.

카테고리 페이지는 이런 모습입니다:

무언가를 놓치고 있다는 걸 알아요. 이 페이지가 이런 구조라는 말은 무슨 뜻이었나요?

이 링크는 Meta의 Documentation 인덱스로 연결됩니다. 인덱스가 생성되려면 지정된 토픽이 그 인덱스와 유사한 구조를 가져야 합니다. 올려주신 스크린샷을 보면 무언가를 오해하거나 잘못 읽으신 것 같습니다. 여기부터 읽어보시길 권합니다.

그리고, 약간 주제에서 벗어난 이야기지만 – 아마 밤일 겁니다. 오른쪽에도 인덱스를 표시하려면 사이드바 테마 플러그인이 필요합니까? 아니면 그것도 자동으로 되는 건가요? 감사합니다!

의도가 정확히 무엇인지 모르겠는데, 제 이해로는 사이드바는 기본/코어 기능이지 플러그인이 아닙니다.

알겠습니다. 제목/부제목 섹션을 말씀하신 건가요? 컴포저에서 그 부분을 찾고 있었는데, HTML의

태그 같은 걸 사용해야 하는지 명확하지 않았거든요(저한테는요). 빠른 답변 정말 감사합니다!

제목은 h1, 링크는 불릿 포인트로 처리합니다. 어려움이 있다면 메타 인덱스를 그대로 복사해서 붙여넣으면 시작할 수 있는 예시를 확인할 수 있습니다.

이렇게 말입니다:

## something useful
* this is that: https://forum.example.tld/t/777
* that is another: https://forum.example.tld/t/666

등등

게으러서 수동으로 하지 않았고, 대신 포럼의 AI를 사용했습니다.

1개의 좋아요

감사합니다. 그래서 @MarcP 님이 제공한 문서 인덱스의 일부를 위에 복사해 봤는데, 사이드바 인덱스가 보이지 않아서 이상하네요. 또 제가 무언가를 놓치고 있는 게 아니라면요…

그 스크린샷에는 구조가 표시되지 않습니다. 설정에서 해당 카테고리의 이름, URL 또는 ID를 지정하면서 * description: url 형식을 사용하고 있다는 것에 정말로 확신하나요?

이런 식으로요?

1개의 좋아요

네. Composer에서 이와 유사한 것을 보신다면 (정말 이상한 언어라 신경 쓰지 마세요. 아이디어는 명확할 겁니다):

Tätä käytetään hampurilaisvalikossa esittelemään 20 eniten reaktioita saanutta ketjua kategoriassa #koiramaailma . Eräänlainen mainosikkuna siis.

## Top-20 eniten reagoitua ketjua

* Mitä helvettiä eläinlääkinnässä tapahtuu 🤬: https://foorumi.katiska.eu/t/mita-helvettia-elainlaakinnassa-tapahtuu/6772
* Kuivamuonamainokset: Hassut aidot tapaukset: https://foorumi.katiska.eu/t/kuivamuonamainokset-hassut-aidot-tapaukset/479

이 설명은 사이드바에 표시되지 않습니다.

1개의 좋아요

음, 보시는 것처럼 오른쪽에 아무것도 없습니다 :frowning:

혹시 도움이 된다면, 제가 설치한 플러그인 목록도 여기에 올립니다…

    cmd:
      - git clone https://github.com/discourse/docker_manager.git
      - git clone https://github.com/discourse/discourse-solved.git
      - git clone https://github.com/discourse/discourse-user-notes.git
      - git clone https://github.com/discourse/discourse-openid-connect.git
      - git clone https://github.com/discourse/discourse-ai.git
      - git clone https://github.com/discourse/discourse-yearly-review.git
      - git clone https://github.com/paviliondev/discourse-custom-wizard.git
      - git clone https://github.com/discourse/discourse-doc-categories.git
      - git clone https://github.com/discourse/discourse-reactions.git
      - git clone https://github.com/discourse/discourse-akismet.git
      - git clone https://github.com/discourse/discourse-data-explorer.git
      - git clone https://github.com/discourse/discourse-oauth2-basic.git
      - git clone https://github.com/discourse/discourse-assign.git
      - git clone https://github.com/discourse/discourse-templates.git
      - git clone https://github.com/discourse/discourse-policy.git
      - git clone https://github.com/discourse/discourse-gamification.git
      - git clone https://github.com/discourse/discourse-category-experts.git
      - git clone https://github.com/merefield/discourse-ai-topic-summary.git
      - git clone https://github.com/MonDiscourse/discourse-formatting-toolbar.git
      - git clone https://github.com/discourse/discourse-custom-topic-lists.git
      - git clone https://github.com/thoka/discourse-send-pdf-inline.git
      - git clone https://github.com/discourse/discourse-prometheus.git
      - git clone https://github.com/communiteq/discourse-user-response-times.git
      - git clone https://github.com/discourse/discourse-fingerprint.git
      - git clone https://github.com/discourse/discourse-bcc.git
      - git clone https://github.com/featheredtoast/discourse-pushover-notifications.git
      - git clone https://github.com/discourse/discourse-saved-searches.git

보통 사이드바는 왼쪽(빨간색)에 위치합니다. 문서 사이드바는 기본적으로 콘텐츠를 대체할 뿐입니다. 오른쪽(보라색)에는 DiscoTOC - automatic table of contents 플러그인 구성 요소에 의해 추가된 목차를 볼 수 있습니다.

음, DiscoTOC도 설치된 테마 구성 요소입니다. 이것도 실행이 안 돼요. 뭔가 문제가 있는 것 같네요…

확실하지는 않지만, 스크린샷이 명확하지 않습니다. 스크린샷을 찍으셨는데 사이드바가 전혀 보이지 않나요? 문서 사이드바가 안 나오는 건가요? 아니면 사이드바 자체가 전혀 안 보이는 건가요(숨겨진 게 아니라면 = 키를 눌러보세요).

수정; 이 부분을 생각해보면, discoTOC(게시물의 목차) 문제인지, 아니면 doc-categories(문서 인덱스 사이드바) 문제인지 명확히 말씀해 주셔야 합니다.

1개의 좋아요

마크 씨, 안녕하세요.

DiscoTOC가 정상적으로 작동합니다. 다시 확인해 보니, 지침대로 설정(기어)으로 들어가서 TOC를 삽입하면 사이드바 TOC가 실제로 생성됩니다.

제 스크린샷에는 모두 사이드바가 포함되어 있으므로, 사이드바가 표시되지 않은 열린 지형(랜스케이프) 화면을 보여 드리고 있습니다.

아주 간단한 수정으로 해결될 것 같은 느낌이 들지만, 아직까지는 그렇지 않네요 :frowning:

스크린샷에서 사이드바를 찾을 수 없습니다 - 모두 게시글 내용만 표시되어 있습니다. 인덱스가 표시되어야 하는 카테고리에 있을 때 전체 Discourse 화면의 스크린샷을 올려주실 수 있나요?

3개의 좋아요