프로젝트 옵션

프로젝트의 유형, 렌더링 대상, 출력 등을 정의하는 옵션입니다. 프로젝트 옵션은 project 키 아래에 지정합니다. 예:

_quarto.yml

project:
  type: default
  output-dir: _output

`title`	프로젝트 제목
`type`	프로젝트 유형(`default`, `website`, `book`, `manuscript`)
`render`	렌더링할 파일 목록(기본 전체)
`execute-dir`	계산 작업 디렉터리 제어(`file`: 현재 파일 디렉터리, `project`: 프로젝트 루트)
`output-dir`	출력 디렉터리
`lib-dir`	HTML 라이브러리(JS/CSS 등) 디렉터리
`resources`	출력에 복사할 추가 파일
`brand`	brand.yml 경로 또는 밝기/어두움별 brand.yml 객체
`preview`	`quarto preview` 옵션(Preview 참조)
`pre-render`	사전 렌더 단계에서 실행할 스크립트
`post-render`	사후 렌더 단계에서 실행할 스크립트

미리보기

preview 키에서 quarto preview의 동작을 제어하는 옵션을 지정합니다. 예:

_quarto.yml

project:
  type: default
  output-dir: _output
  preview:
    port: 4200
    browser: false

사용 가능한 preview 옵션은 다음과 같습니다.

`port`	리스닝 포트(기본 3000~8000 사이 랜덤)
`host`	바인딩 호스트 이름(기본 127.0.0.1)
`serve`	외부 프리뷰 서버 옵션(Serve 참조)
`browser`	프리뷰 보기 브라우저 자동 열기(기본 true)
`watch-inputs`	입력 파일 변경 시 재렌더(기본 true)
`navigate`	출력이 업데이트되면 브라우저 자동 이동(기본 true)
`timeout`	활성 클라이언트 없을 때 종료까지 대기 시간(초)

Serve

자체 미리보기 서버가 포함된 다른 배포 시스템(예: Hugo, Docusaurus)용 프로젝트 확장을 만들고 있다면, preview: serve 옵션으로 미리보기 서버 동작을 사용자 지정하세요.

_quarto.yml

project:
  type: default
    preview:
      serve:
        cmd: "hugo serve --port {port} --bind {host} --navigateToChanged"
        env:
          HUGO_RELATIVEURLS: "true"
        ready: "Web Server is available at"

`cmd`	지정 명령으로 프로젝트 프리뷰 실행(`{port}`로 포트 삽입)
`args`	프리뷰 명령에 추가할 커맨드라인 인수
`env`	프리뷰 명령 환경 변수
`ready`	서버 준비 감지용 정규 표현식

preview: serve 사용 예시는 Hugo와 Docusaurus 확장 소스 코드를 참고하세요.