Table of Contents

각 글의 제목으로 목차를 만들고 바로가기 링크를 제공합니다. 글을 쓰는 동안 삽입할 것이 없습니다.

플러그인

Table of Contents

각 글의 제목으로 목차를 만들고 바로가기 링크를 제공합니다. 글을 쓰는 동안 삽입할 것이 없습니다.

  • 카테고리: table of contents
  • 상태: 사용 가능
  • 버전: 0.1.0
  • 가격: 미확인
  • 출처: 공식 플러그인 레지스트리
  • 설치 방식: 레지스트리 샌드박스 플러그인
  • 확인일: 2026-10-21

설치

두 단계

  1. EmDash 관리자에서 Registry를 열고 Table of Contents를 검색한 다음 Install을 클릭합니다. 어떤 권한도 요청하지 않습니다.
  2. 왼쪽 메뉴에서 Table of Contents를 열고 Setup 탭으로 이동한 다음, 표시되는 짧은 블록을 기본 레이아웃의 head(보통 src/layouts/Base.astro)에 붙여넣습니다. 다른 사람이 사이트를 만들었다면 그 사람에게 이 블록을 보내 주세요.

이것으로 끝입니다. 제목이 충분한 모든 글이나 페이지에 목차가 생기며, 작성자는 아무것도 할 필요가 없습니다. Settings 탭에서는 제목, 어떤 제목 수준을 포함할지, 목록의 위치, 처음부터 접어 둘지를 설정합니다.

정확한 위치를 직접 정하려면 글 템플릿에 “를 넣으세요. 제목 하나를 제외하려면 data-toc-skip을 지정하세요.

자주 묻는 질문

이 플러그인은 무엇을 하나요?

독자의 브라우저에서 글이나 페이지의 제목을 읽어 맨 위에 바로가기 링크 목록을 보여줍니다. 한 줄을 클릭하면 해당 섹션으로 스크롤되고, 읽는 동안 현재 섹션이 표시되며, 주소 표시줄에 섹션 링크가 들어가 공유할 수 있습니다. 작성자는 아무것도 삽입하지 않습니다.

어떤 제목이 사용되나요?

선택할 수 있습니다. H2만, H2와 H3, 또는 H2부터 H4까지입니다. H3 항목은 해당 H2 아래에 놓입니다. H1은 글 제목이므로 절대 사용되지 않습니다.

제목에 id가 없습니다. 그래도 작동하나요?

네. 제목에 id가 없으면 플러그인이 제목 텍스트로 id를 만들어 주므로 어떤 테마에서도 링크가 작동합니다.

짧은 글에서는 끌 수 있나요?

목록은 설정한 수(기본값은 3개) 이상의 제목이 있는 페이지에만 표시됩니다. 사이트의 특정 영역 전체에는 /posts 같은 주소 시작 부분과 함께 Show on을 사용하세요.

어디에 표시되나요?

첫 번째 제목 앞, 첫 번째 단락 뒤, 또는 콘텐츠 영역의 맨 위입니다. 다른 곳에 두고 싶다면 템플릿에 data-toc가 있는 빈 요소를 넣으면 그 자리에 표시됩니다.

이동한 후 제목이 고정 메뉴 아래에 가려집니다

Settings의 Sticky header height를 메뉴 바의 높이(픽셀)로 설정하세요.

무언가를 수집하나요?

아니요. 플러그인은 콘텐츠에 접근할 수 없으며 사이트 밖으로 요청을 보내지 않습니다. 유일한 호출은 사이트가 자체 설정을 가져오는 것입니다.

사이트가 느려지나요?

스크립트는 약 5 KB이며 페이지가 준비된 후 로드되고 1분간 캐시됩니다. 다른 서버에서 로드되는 것은 없습니다.

변경 내역

0.1.0

  • 첫 릴리스. 각 글이나 페이지의 제목으로 만든 목차. 바로가기 링크, 부드러운 스크롤, 현재 섹션 표시를 지원합니다.
  • 설정: 제목, 포함할 제목 수준, 최소 제목 수, 위치, 번호 매기기, 처음부터 접기, 모든 곳 또는 특정 경로로 시작하는 주소에 표시, 고정 헤더 높이, 콘텐츠 영역.
  • data-toc로 직접 배치하세요. data-toc-skip으로 제목을 제외하세요.
  • Setup 탭에서 사이트가 목차를 로드하고 있는지 확인할 수 있습니다.