DiscoTOC - automatic table of contents

안녕하세요…

DiscoTOC 사용에 문제가 있어서 혹시 아이디어가 있는 분이 있을까요.

예를 들어, 특정 주제에서 DiscoToc이 완벽하게 작동한다고 가정해 보겠습니다:

  • 링크 a → 끝에 "link-a-1"을 추가
  • 링크 b → 끝에 "link-b-2"을 추가

누군가에게 링크 a를 공유했다고 가정해 보겠습니다: (“…link-a-1”)

이제 주제를 순서대로 재배열했다고 상상해 보겠습니다(예: "link b"를 앞으로 옮김).
DiscoToc을 사용하면 다음과 같이 보입니다:

  • 링크 b → 끝에 "link-b-1"을 추가
  • 링크 a → 끝에 "link-a-2"을 추가

그리고 이 시점부터, 제가 공유했던 링크는 더 이상 작동하지 않습니다.
제가 공유한 것은 (“…link-a-1”)였는데, 이제 올바른 것은 (“…link-a-2”)입니다.

혹시 아이디어가 있는 분이 계시다면 정말 감사하겠습니다.

2개의 좋아요

버그 보고!

DiscoTOC가 활성화된 상태에서는 2개 또는 3개의 대시 묶음으로 자동 생성되는 en-dash와 em-dash가 더 이상 작동하지 않습니다. – 또는 — 대신 다시 -- 또는 ---로 표시됩니다.

2개의 좋아요

모든 게시글에서 한 번의 클릭으로 목차 열기 기능을 지원하도록 옵션을 추가해 주셨으면 좋겠습니다!

1개의 좋아요

2024-11-02T22:00:00Z
오류 보고서: 디렉토리를 클릭할 때 표시되는 콘텐츠 위치가 디렉토리의 실제 위치와 일치하지 않습니다.

기본적으로, 현재 페이지 "DiscoTOC - automatic table of contents"도 잘못된 위치에 있습니다.

더 구체적으로 말씀해 주시고 예시를 제공해 주실 수 있을까요. 제 Discourse 포럼 인스턴스에서는 모두 TOC가 정상적으로 로드되고 작동하고 있습니다.

링크하신 페이지도 정상적으로 로드되고 TOC도 작동하고 있습니다.

2개의 좋아요

답변해 주셔서 감사합니다. 지금은 문제를 찾지 못했지만, 그때에는 실제로 문제가 있었던 것이 맞습니다.

게시글이 새 주제로 분리되었습니다: TOC 테마 컴포넌트에 버튼 추가

리더 모드와 디스코 TOC 충돌

DiscoTOC의 목차(큰 문서에는 필수)와 리더 모드(큰 문서에는 이것도 필수)를 동시에 사용할 수 없는 것 같습니다.

목차 목록이 겹치면서 리더 모드 아이콘(그리고 게시물 조작 메뉴 아이콘)을 가립니다.

4개의 좋아요

주제에 대한 질문입니다 - 모든 카테고리 주제를 자동으로 목록으로 생성하는 함수나 플러그인이 있을까요? TOC(목차) 생성이나 심지어 위키 형태의 게시물 콘텐츠 생성을 돕기 위함입니다.

이것은 수동으로 처리해야 하는 번거로움을 줄여주는 방법입니다.

약간의 스크립팅이 필요할 수 있지만, 이를 수행하는 태그가 있다면 흥미로울 것입니다. 그러면 Discourse에 네이티브로 내장되어, 특정 카테고리(예: ‘speech’ 카테고리)의 모든 주제(제목)를 출력하고 실시간으로 링크를 걸어주는 기능이 될 것입니다.

그러나 LINK 버튼 기능 내에서 구현하는 것이 더 좋을 수도 있다고 생각합니다. 버튼을 클릭하면 찾고 있는 주제를 입력하여 검색할 수 있는 기능인데, 여기에 다음과 같은 새로운 최상위 옵션을 추가할 수 있습니다.

"Print-links : X 카테고리의 모든 주제 제목 출력" 버튼 :slight_smile:

주제 날짜 기준 최신/구식 순서 전환 기능이 유용할 것 같습니다.

이것은 아마도 기능 요청사항일 수 있지만, DiscoTOC와 함께 사용할 때 수동으로 이 작업을 수행해야 하는 경우가 많으므로 여기에서 문의해 보았습니다.

아마도 AI가 이런 일을 할 수 있지만, 우리는 AI 기능을 사용하지 않습니다. 어쩌면 이것은 DiscoTOC보다는 LINK 버튼 기능의 확장으로 더 적합하며, 제가 상상하는 것보다 더 넓은 범위에서 활용될 수 있는 것 같습니다.

이 부분은 꽤 자명할 것 같지만, 사이드바를 숨기기 때문에 이 컴포넌트는 블로그 포스트 스타일링(Blog Post Styling) 컴포넌트와 함께 작동하지 않습니다.

관심이 있으시다면, 이전 플러그인처럼 ‘인라인 TOC’ 옵션을 추가하는 것을 제안합니다. 두 컴포넌트가 함께 작동할 수 있도록 말이죠.

인라인 버전은 유용한 옵션이므로, 두 방식 사이를 전환할 수 있으면 좋겠습니다. 인라인 방식은 사용자가 한눈에 알아볼 수 있어 특정 사용 사례에서 매우 유용하지만, 새 방식은 더 지능적이긴 하지만 약간 tucked away(숨겨진) 형태라 놓치기 쉽습니다.

모든 사용자가 관심 있는 섹션으로 바로 이동하는 것이 주된 목적이라면, 인라인 버전이 더 나은 선택이 될 것입니다.

1개의 좋아요

DiscoTOC 플러그인에 대한 피드백을 공유하고자 합니다. 대부분의 Discourse 테마에서는 TOC 사이드바가 적절한 너비로 표시되어 긴 제목도 자연스럽게 처리됩니다. 그러나 Horizon 테마를 사용할 경우 사이드바의 너비가 눈에 띄게 좁아져 긴 제목이 여러 줄로 끊기는 문제가 발생합니다. 이는 가독성을 떨어뜨리고 인터페이스의 전반적인 시각적 일관성에 영향을 미칩니다.

Horizon 테마에 대해 이 문제를 특별히 조사해 주시고, 긴 제목이 더 잘 보이도록 사이드바 너비를 조정할 수 있는 방법을 검토해 주시겠습니까? 이 문제를 해결하면 Horizon 테마를 사용하는 많은 사용자의 경험이 향상될 것이라고 생각합니다.

수고 많으시며, 이 제안에 대해 검토해 주셔서 감사합니다.

2개의 좋아요

제목: 페르시아어 로케일에서 discoTOC 컴포넌트 오류

환경: 기본 로케일이 "페르시아어"로 설정된 포럼.

영향 받는 컴포넌트: discoTOC

설명: 포럼의 기본 로케일이 "페르시아어"로 설정되어 있을 때, discotoc 컴포넌트가 올바르게 작동하지 않습니다.

구체적인 증상:

  1. “타임라인” 및 “목차” 버튼의 UI 요소가 표시되지 않습니다.
  2. 사용자가 주제에 답변을 제출한 후, 목차 보기(TOC)가 자동으로 숨겨지고 타임라인 보기가 표시되며, 목차 보기로 복원할 수 있는 상호작용 요소가 제공되지 않습니다.

위에서 언급된 discoTOC 컴포넌트 사용법에 대해 몇 가지 기술적인 질문이 있어 확인을 부탁드립니다:

  1. 1단계에서는 제목을 가진 토픽 작성을, 2단계에서는 특정 버튼 사용을 언급하고 있습니다. 1단계를 따르되 마크다운 제목(예: ##, ###)으로 토픽을 구조화했지만, 기어 메뉴의 "toc 버튼"을 클릭하지 않은 경우(2단계 생략), discoTOC 컴포넌트가 제목만을 기준으로 표를 자동으로 생성하거나 표시할까요? 즉, 버튼을 클릭하는 것이 컴포넌트가 정상적으로 작동하는 데 필수적인가요, 아니면 단순히 특정 요소를 삽입하기 위한 트리거일 뿐인가요?
  2. 기어 메뉴에 있는 "toc 버튼"의 정확한 목적이나 기능은 무엇인가요? 토픽 에디터 워크플로우 내에서 이 버튼은 어떻게 사용해야 하나요?
  3. 별도로, **<div data-theme-toc="true"> </div>**라는 스니펫을 발견했습니다. 이 스니펫이 discoTOC와 함께 하는 정확한 역할을 설명해 주실 수 있을까요? 이 div 요소는 무엇을 제어하며, 표 생성이나 표시에 영향을 주기 위해 토픽 콘텐츠 내에서 어떻게 구현하거나 설정해야 하나요?

상세한 설명을 부탁드립니다.

이것이 충분히 기술적인 설명인지 모르겠지만, 컴포넌트가 적절한 목차(TOC)를 생성하려면 게시물 내에 <div data-theme-toc="true"> </div>와 함께 일부 제목이 모두 필요합니다.

<div data-theme-toc="true"> </div>를 삽입하지 않으면 게시물에는 단순히 제목만 있는 상태가 되며, 제목을 포함하지 않고 해당 태그만 추가하면 목차가 생성되지 않습니다(컴포넌트에는 기본값이 3인 TOC min heading 설정도 있습니다. 따라서 가시적인 목차를 생성하려면 게시물에 최소 3개의 헤더가 필요합니다).

‘목차 삽입’ 버튼은 게시물에 <div data-theme-toc="true"> </div>를 삽입하지만, 동일한 효과를 위해 이를 직접 복사하여 붙여넣거나 수동으로 입력할 수도 있습니다.

도움이 되기를 바랍니다. :crossed_fingers:


예상 시간: Auto TOC categories 및 Auto TOC tags 컴포넌트 설정을 사용하는 경우, 해당 상황에서는 <div data-theme-toc="true"> </div>를 삽입할 필요가 없다는 점을 상기해 주셨습니다. :+1:

7개의 좋아요

또한… 이제 이 기능을 위한 설정(답글에 TOC 활성화)이 있으므로 답글에도 toc를 사용할 수 있습니다. :partying_face:

4개의 좋아요

답글에 구조가 여러 레벨로 나뉘어 있는 경우, 답글에 대한 기본 목차(TOC)로 설정하는 것이 가능한지 궁금합니다.
혹시 이 부분에 대한 우려 사항이 있을까요?

리플 ToC를 사용해보니, 이 방식이 매우 합리적으로 느껴집니다.

실제로 목차를 수동으로 추가하는 사람은 파워 유저뿐인데(우리 사이트의 경우 사실상 저뿐입니다), 이 기능을 자동으로 처리할 수 있다면 정말 큰 도움이 될 것입니다.

3개의 좋아요

몇 가지 문제가 있습니다:

  1. 처음에 TOC 없이 생성된 주제에 TOC를 추가하려고 하면 작동하지 않습니다. 이것이 정상적인가요? TOC를 포함하여 주제를 생성한 경우에만 작동하는 것 같습니다. 주제를 편집해도 작동하지 않습니다.
  2. TOC를 포함하여 성공적으로 생성한 주제에서 TOC의 제목을 클릭해도 해당 제목으로 스크롤되지 않습니다.
  3. ## 제목에 대해서만 TOC를 생성하는 것 같습니다. ### 제목이 있지만, 이들은 표시되지 않습니다.

최근 Meta에서 제 테마 컴포넌트 토픽에서 그렇게 해보았는데 잘 작동했습니다.

1개의 좋아요

이상하네… 저장했을 때 바로 안 보였으니까, 페이지를 새로고침해야 하는 건가? 바로 표시될 거라고 기대했는데.

이제 표시된다는 건 알아서 다행이다.

(정리하자면, 이미지에 추가한 텍스트는 추가할 수 있었지만, 오른쪽의 목차가 표시되지 않았다.)

다른 문제들도 이제 잘 작동한다. 이해가 안 되네… 뭐, 알 수 없지…

부모 제목이 “포커스” 상태가 아닐 때 하위 제목이 숨겨지는 동작을 비활성화할 수 있는지 아는가?
모든 제목이 항상 표시되기를 원하는데, 그렇지 않으면 실제보다 콘텐츠가 적어 보인다.

기대했던 대로 작동한다는 걸 알아서 이미 만족스러우니, 가능할 수 있다면 이건 그냥 아이스크림 위 체리 같은 작은 부분이다.