자주 묻는 질문
새 문서를 추가하려면 어떻게 하나요?
docs디렉터리에.md파일을 만듭니다;docs/.vitepress/config.mjs의sidebar에 페이지 경로를 등록합니다;- 브라우저를 새로고침하면 새 페이지를 볼 수 있습니다.
자세한 내용은 빠른 시작을 참조하세요.
사이트 제목과 테마 색상을 수정하려면 어떻게 하나요?
- 제목:
docs/.vitepress/config.mjs의title수정; - 테마 색상:
docs/.vitepress/theme/custom.css의--vp-c-brand-*변수 수정.
전체 텍스트 검색을 켜거나 끄려면 어떻게 하나요?
검색 설정은 docs/.vitepress/config.mjs의 themeConfig.search 필드에 있으며, provider: 'local'로 설정하면 로컬 검색이 켜지고, 해당 필드를 제거하면 꺼집니다.
문서는 다크 모드를 지원하나요?
지원합니다. 사이트는 기본적으로 시스템 외관을 따르며, 오른쪽 위의 토글 버튼으로 수동 전환할 수도 있습니다. 별도 설정은 필요 없습니다.
내 서버에 배포하려면 어떻게 하나요?
npm run docs:build의 산출물인 docs/.vitepress/dist 디렉터리를 아무 정적 서버(Nginx, 객체 스토리지 등)에 호스팅하면 됩니다. 자세한 내용은 배포 가이드를 참조하세요.
문서에 다중 버전 전환을 추가하려면 어떻게 하나요?
VitePress 공식 문서의 버전 관리 방식은 여러 개의 정적 빌드 + 커스텀 내비게이션으로 구현하며, 커뮤니티 플러그인(예: vitepress-versioning)으로 빠르게 통합할 수도 있습니다.
빌드 오류가 나면 어떻게 하나요?
흔한 해결 단계:
- Node 버전이 18 이상인지 확인:
node -v; - 캐시를 삭제하고 다시 빌드:
rm -rf docs/.vitepress/cache docs/.vitepress/dist; - 의존성을 다시 설치:
rm -rf node_modules && npm install; - 전체 오류 스택을 확인해 해당 파일을 찾습니다.
푸터를 커스터마이징하려면 어떻게 하나요?
docs/.vitepress/config.mjs에서 themeConfig.footer의 message와 copyright 필드를 수정합니다.