Build

Info

Quartz는 preBuild를 통해 md → html로 변환하여 생성된 정적 파일을 public directory에서 관리하도록 되어있다.

Process

npx quartz build명령어를 통해 빌드 시도

Process Cli commandLine

/quartz/bootstrap-cli.mjs 파일의 build 명령어에 대해 동작하는 handleBuild() 실행.

• yargs, hideBin 라이브러리 사용.
• create, update, restore, sync, build 명령어 정의.

Build Handling

/quartz/cli/handlers/js 파일의 handleBuild() 함수 실행.

1. esbuilder를 사용하여 build context 생성.
2. sass Plugin과 inline-script-loader Plugin을 사용하여 sass, script 처리.
3. Build process 동기화 관리를 위해 Mutex 생성.
4. build() 함수를 통해 빌드 실행.
   1. /quartz/build.ts파일을 빌드한 결과물 mjs 파일을 cache로 저장.
   2. 저장된 ./quartz/.quartz-cache/transpiled-build.mjs 파일을 사용 하여 Quartz를 빌드.

Build Quartz

/quartz/build.ts파일을 build한 결과물인 ./quartz/.quartz-cache/transpiled-build.mjs의 buildQuartz() 함수를 사용하여 빌드.

1. 빌드 컨텍스트 초기화
   1. BuildId 채번
   2. setting 주입
2. 설정된 Plugin 로드 및 초기화
   1. Transformers
   2. Filters
   3. Emitters
3. output dir 설정
   • default: /public
4. target source 탐색
   • glob라이브러리를 사용하여 /content 내부의 모든 .md파일을 탐색
5. markdown 파싱
   • parseMarkdown()함수 사용.
   • Transformers를 사용하여 .md파일을 html로 파싱
   • 참고: Transformers
6. contents 필터링
   • filterContent()함수 사용.
   • Filters를 사용하여 frontmatter 또는 파일의 직접적인 정보를 통해 노출하지 않을 contents 필터링.
   • 참고: Filters
7. contents 출력
   • emitContent() 함수 사용.
   • fast build를 사용하는 경우에는 의존성 그래프에 따라 관련 내용을 업데이트 함.
   • 파싱 및 필터링된 contents를 정적 html 파일로 출력 (output dir)
   • 참고: Emitters