Table of Contents
각 글의 제목으로 목차를 만들고 바로가기 링크를 제공합니다. 글을 쓰는 동안 삽입할 것이 없습니다.
플러그인
Table of Contents
각 글의 제목으로 목차를 만들고 바로가기 링크를 제공합니다. 글을 쓰는 동안 삽입할 것이 없습니다.
설치
두 단계
- EmDash 관리자에서 Registry를 열고 Table of Contents를 검색한 다음 Install을 클릭합니다. 어떤 권한도 요청하지 않습니다.
- 왼쪽 메뉴에서 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 탭에서 사이트가 목차를 로드하고 있는지 확인할 수 있습니다.