개요
Quartz는 마크다운 파일과 리소스를 정적 웹사이트 번들(HTML, JS, CSS)로 변환합니다. 온라인에 게시하려면 정적 사이트 배포를 지원하는 호스팅 제공업체가 필요합니다.
사전 요구사항: 먼저 Quartz 프로젝트를 위한 GitHub 저장소를 생성하세요.
중요: RSS 피드와 사이트맵이 올바르게 작동하려면 설정에서 baseUrl을 구성해야 합니다.
Cloudflare Pages (추천)
- Cloudflare 대시보드에 접속하여 컴퓨터 및 AI > Workers & Pages > 응용 프로그램 생성 > Pages를 배포하려고 하십니까? 시작 > 기존 Git 리포지토리 가져오기으로 이동합니다
- GitHub 저장소를 선택합니다
- 빌드 설정을 구성합니다:
- 프로덕션 분기:
v4 - 프레임워크 미리 설정:
없음 - 빌드 명령:
npx quartz build - 빌드 출력 디렉토리:
public
- 프로덕션 분기:
- “저장 및 배포”하고 GitHub 동기화마다 자동 업데이트를 모니터링합니다
Netlify
- 로그인하고 “Add new site”를 클릭합니다
- Git 저장소를 선택합니다
- 빌드 명령어 설정:
npx quartz build - 게시 디렉토리 설정:
public - 커스텀 도메인은 도메인 관리에서 접근할 수 있습니다
Vercel
- 프로젝트 루트에
vercel.json파일을 생성합니다:{"cleanUrls": true} - Vercel 대시보드에서 저장소를 연결합니다
- 설정을 구성합니다:
- 프레임워크 프리셋:
Other - 루트 디렉토리:
./ - 빌드 명령어:
npx quartz build
- 프레임워크 프리셋:
- 배포하면
*.vercel.appURL을 받게 됩니다
커스텀 도메인 및 서브도메인
quartz.config.js에서 baseUrl을 업데이트한 다음, Vercel의 도메인 관리 인터페이스를 통해 도메인을 연결합니다.