02
콘텐츠 편집하기
Form 모드에서 섹션·서브섹션·콘텐츠 편집과, 문서 정보 영역·서브섹션 목차 자동 생성까지 안내합니다.
새 섹션 추가하기
새로운 섹션 파일을 생성하는 방법을 안내합니다.
- + 버튼 클릭사이드바 상단의 "+" 버튼을 클릭합니다.
- 섹션 정보 입력모달 창에서 다음 정보를 입력합니다:
- 순서: 숫자만 입력 (예: "3" → 번호는 03으로 자동 생성)
- 문서 정보 (넘버링 없음): 릴리즈 노트·법적 고지 등이면 체크
- Slug: 영문 소문자, 숫자, 하이픈(-)만 사용 (예: "new-feature")
- 제목: 다국어 제목 입력
- 생성 완료✅ 버튼을 클릭하면 새 섹션 파일이 생성되고 자동으로 선택됩니다.
서브섹션 추가하기
섹션 내에 서브섹션을 추가하는 방법을 안내합니다.
- + 서브섹션 추가 버튼 클릭Form 모드에서 "+ 서브섹션 추가" 버튼을 클릭합니다.
- 서브섹션 정보 입력서브섹션의 다음 정보를 입력합니다:
- ID: 고유 식별자 (예: "feature-overview")
- 제목: 다국어 제목
- 설명: 다국어 설명 (선택)
콘텐츠 추가하기
서브섹션에 Step Guide, InfoBox, Screenshot, Table을 추가하는 방법을 안내합니다.
콘텐츠 타입
Manual Editor는 다음 4가지 콘텐츠 타입을 지원합니다:
1. Step Guide: 단계별 가이드 (이미지 포함 가능)
2. InfoBox: 정보 박스 (info, warning, tip, danger)
3. Screenshot: 스크린샷 이미지
4. Table: 표 (manualTable)
- 서브섹션 확장콘텐츠를 추가할 서브섹션을 클릭하여 확장합니다.
- 콘텐츠 타입 선택+콘텐츠 추가" 버튼을 클릭하고 원하는 콘텐츠 타입을 선택합니다.
- 콘텐츠 편집선택한 콘텐츠 타입에 맞는 필드를 입력합니다.
드래그 앤 드롭으로 순서 변경
서브섹션과 콘텐츠의 순서를 드래그 앤 드롭으로 변경할 수 있습니다.
- 항목 드래그이동하려는 서브섹션 또는 콘텐츠 항목을 클릭하고 드래그합니다.
- 목표 위치에 드롭원하는 위치로 드래그한 후 마우스를 놓으면 순서가 변경됩니다.
문서 정보 영역
릴리즈 노트, 법적 고지, 오픈소스 라이선스 등은 문서 정보 영역을 사용합니다. 제품 표지의 목차 하단에 섹션 번호 없이 표시됩니다.
- 섹션 파일 열기 (_product.yaml 아님)문서 정보는
_product.yaml에서 설정하지 않습니다. 섹션 YAML 파일을 생성하거나 엽니다 (예:90-release-notes.yaml,08-reference.yaml). - 문서 정보 (넘버링 없음) 설정Form 모드에서 섹션 정보를 열고 문서 정보 (넘버링 없음) 을 체크합니다. 또는 YAML 모드에서 다음과 같이 설정합니다: ``
yaml section: number: "" slug: release-notes order: 90 unnumbered: true title: ko: 릴리즈 노트 en: Release Notes`` - 제품 표지 미리보기 확인저장 후 Sanity 동기화하면, 제품 표지의 문서 정보(목차 하단)에 번호 없이 표시됩니다. 번호가 있는 본문 섹션은 목차에,
unnumbered섹션은 문서 정보에 나뉩니다.
팁
- 사이드바에서
_product.yaml을 선택하면 표지(목차 + 문서 정보) 미리보기를 볼 수 있습니다. - 「참고 및 법적 고지」 같은 기존 섹션도 해당 파일에서 문서 정보 (넘버링 없음) 을 켜면 이동합니다.
- 정렬은 order로 유지되며, 번호만 숨겨집니다.
서브섹션 목차 자동 생성
섹션에 서브섹션이 3개 이상이면, 섹션 페이지 상단에 제목 링크 목차가 자동으로 생성됩니다.
동작 방식
동작
- 서브섹션이 3개 이상일 때만 표시
- 서브섹션 제목을 페이지 내 링크로 나열
- 클릭 시 해당 서브섹션(
#id)으로 이동 - 목차를 따로 작성할 필요 없음 — 각 서브섹션 제목을 사용
feature-overview)를 채워 두세요. 링크 앵커로 사용됩니다.참고
서브섹션이 3개 미만이면 목차를 숨겨 짧은 섹션이 복잡해지지 않게 합니다.