게시글 자동 목차

게시글 본문에 포함된 h2, h3, h4 제목을 자동으로 분석하여 계층형 목차를 생성하는 G7 플러그인입니다.

긴 게시글에서도 원하는 내용을 빠르게 찾을 수 있으며, 목차 항목을 클릭하면 해당 제목 위치로 부드럽게 이동합니다.

주요 기능

• 게시글 본문의 h2, h3, h4 자동 분석
• 제목 구조에 따른 계층형 목차 생성
• 목차 항목 클릭 시 해당 위치로 이동
• 한글 제목과 중복 제목에 안전한 앵커 ID 생성
• 기존 제목에 지정된 고유 ID 보존
• 일정 개수 이상의 제목이 있을 때만 목차 표시
• 목차 접기 및 펼치기
• 데스크톱과 모바일 표시 방식 개별 설정
• 목차 번호 표시 여부 설정
• 고정 헤더를 고려한 스크롤 여백 설정
• 일반 방문자 화면과 SEO HTML 모두 지원
• CKEditor5 플러그인과 함께 사용 가능

기본 동작

기본 설정에서는 게시글에 제목이 3개 이상 있을 때 본문 위에 목차가 표시됩니다.

데스크톱에서는 목차가 펼쳐진 상태로 표시되고, 화면이 작은 모바일 환경에서는 접힌 상태로 표시됩니다.

관리자 설정

관리자 화면에서 다음 항목을 변경할 수 있습니다.

• 플러그인 사용 여부
• 목차에 포함할 제목 단계
• 목차가 표시되는 최소 제목 개수
• 목차 제목
• 번호 표시 여부
• 기본 접힘 여부
• 모바일 기본 접힘 여부
• 제목 이동 시 상단 여백

적용 대상

이 플러그인은 G7 게시판의 게시글 상세 화면에 적용됩니다. 별도의 레이아웃 편집 없이 플러그인을 설치하고 활성화하면 사용할 수 있습니다.

식별자

ninecells-table_of_contents

설치 방법

1. G7 관리자 화면에서 플러그인 관리로 이동합니다.
2. 수동 설치를 선택합니다.
3. GitHub 탭을 선택합니다.
4. 아래 저장소 주소를 입력합니다.

https://github.com/ninecells/g7-plugin-table-of-contents

5. 설치가 완료되면 플러그인 목록에서 게시글 자동 목차를 활성화합니다.

요구 사항

• G7 7.0 이상
• sirsoft-board 모듈
• SEO HTML 목차 생성을 위한 PHP DOM 확장