Discourse 문서 카테고리

혼란과 어려움의 원인은 Index Topic이 특정 형식을 따라야 한다는 점인데, 이는 문서에서 (완전히 명확하게) 명시되어 있지 않기 때문일 수 있습니다. (최상위 게시물)

저는 이 플러그인을 직접 설치하여 설명을 꼼꼼히 따랐지만, @dennisjbr 님이 겪은 것과 정확히 동일한 방식으로 작동하지 않았습니다.

Meta 예시를 링크하는 것보다 필요한 Markdown의 예를 보여주는 것이 도움이 될 수 있습니다. 왜냐하면 핵심 규칙은 Markdown의 번호/불릿 리스트가 반드시 있어야 한다는 것이기 때문입니다. 문서에는 '리스트’라고만 되어 있지만, '리스트’라는 단어는 일반 영어 용법상 Markdown이 아닌 리스트를 포함할 수 있습니다!

다음은 Index Topic으로 작동합니다:

* https://meta.discourse.org/t/discourse-doc-categories/322376
* Some Arbitrary Text: https://meta.discourse.org/t/discourse-doc-categories/322376

다음은 작동하지 않습니다:

https://meta.discourse.org/t/discourse-doc-categories/322376
Some Arbitrary Text: https://meta.discourse.org/t/discourse-doc-categories/322376

이 외에도 Markdown 헤딩을 사용하여 섹션을 만들고 여러 개의 리스트를 사용할 수 있지만, Markdown 리스트가 없다면 사이드바에 아무것도 표시되지 않습니다. 이것이 다소 자명하고 다른 사람들을 혼란스럽게 하지 않았을 수 있다는 점은 인정합니다. 하지만 저에게는 (멍청하게든, 그렇지 않든) 함정이었고, 저는 Discourse, TC, 플러그인에 대해 초보자가 아닙니다.

5개의 좋아요