[파트 4] VitePress Nav·Sidebar 자동 생성

이 파트는 RSS 수집 시스템과 독립적으로 동작합니다. docs/src/ 디렉토리 구조를 읽어 VitePress의 Nav와 Sidebar 설정 객체를 빌드 시점에 자동으로 생성합니다.

이 파트가 하는 일

config.mts에서 autoGenerateConfig()를 한 번 호출하면 docs/src/ 전체를 탐색하여 VitePress가 요구하는 nav·sidebar 객체를 반환합니다. 폴더·파일을 수동으로 등록할 필요가 없으며, 새 폴더나 Markdown 파일이 추가되면 다음 빌드 시 자동으로 반영됩니다.

파일 맵

docs/.vitepress/composables/
├── index.ts                        ← 공개 진입점 (autoGenerateConfig)
├── options.ts                      ← 사용자 설정 (config.mts에서 import)
│
├── core/
│   ├── types.ts                    ← 시스템 전체 타입 정의
│   ├── constants.ts                ← 기본값 상수
│   └── iconResolver.ts             ← 폴더 아이콘 resolve
│
├── builders/
│   ├── navBuilder.ts               ← Nav 객체 조립
│   └── sidebarBuilder.ts           ← Sidebar 객체 조립
│
├── traversal/
│   └── directoryTraverser.ts       ← 디렉토리 재귀 탐색
│
├── metadata/
│   ├── frontmatterParser.ts        ← frontmatter 파싱 · 캐시
│   └── titleResolver.ts            ← 표시 제목 결정 (textMap → H1 → 파일명)
│
├── sort/
│   ├── fileSorter.ts               ← 파일·폴더 정렬 실행
│   └── sortRuleResolver.ts         ← 경로별 정렬 규칙 결정
│
└── utils/
    ├── pathUtils.ts                ← 파일 시스템 경로 ↔ 웹 경로 변환
    ├── textUtils.ts                ← kebab/snake → Title Case 변환
    └── timeUtils.ts                ← 날짜 파싱 · 포맷

별도 위치:

docs/.vitepress/composables/
└── usePostData.ts                  ← Vue 컴포저블 (frontmatter → 화면 출력용)

의존 관계 요약

index.ts  (autoGenerateConfig)
 │
 ├── options.ts              [사용자 설정]
 ├── core/constants.ts       [기본값]
 ├── utils/pathUtils.ts
 ├── metadata/frontmatterParser.ts
 │    └── utils/timeUtils.ts
 │
 ├── traversal/directoryTraverser.ts
 │    ├── metadata/frontmatterParser.ts
 │    ├── metadata/titleResolver.ts
 │    │    └── utils/textUtils.ts
 │    ├── sort/sortRuleResolver.ts
 │    ├── sort/fileSorter.ts
 │    └── utils/pathUtils.ts
 │
 ├── builders/navBuilder.ts
 │    └── core/iconResolver.ts
 │
 └── builders/sidebarBuilder.ts
      ├── traversal/directoryTraverser.ts
      ├── metadata/titleResolver.ts
      ├── sort/sortRuleResolver.ts
      ├── sort/fileSorter.ts
      └── core/iconResolver.ts

이 파트에서 자주 하는 작업

작업	참고 문서
Nav·Sidebar 동작 원리 이해	01-how-it-works.md
options.ts 설정값 변경	02-configuration.md
정렬 방식 변경	02-configuration.md#sidebarsort
폴더 아이콘 변경	02-configuration.md#foldericons
코드 수정 전 모듈 파악	03-modules.md