환경 변수

Quarto가 확인하는 변수

다음 변수는 Quarto 문서 렌더링 방식을 제어하기 위해 사용자가 직접 설정할 수 있습니다. 예를 들어 quarto render 실행 전에 다음처럼 지정할 수 있습니다.

Terminal

export QUARTO_R=/opt/R/4.2.3/bin
quarto render

Quarto 프로젝트에서 환경 변수를 지정하는 다른 방법은 환경 변수 문서를 참고하세요.

Variable	Description
`QUARTO_R`	`knitr` 엔진과 `quarto run *.R` 명령이 사용할 `Rscript` 버전의 경로를 명시합니다. \|
`QUARTO_PYTHON`	`jupyter` 엔진과 `quarto run *.py` 명령이 사용할 `python` 실행 파일의 경로를 명시합니다. \|
`QUARTO_JULIA`	`julia` 엔진이 사용할 `julia` 실행 파일의 경로를 명시합니다. \|
`QUARTO_VERSION_REQUIREMENT`	환경에서 요구하는 Quarto 버전을 나타내는 `semver` 문자열입니다. 버전 요구 사항을 만족하지 못하면 Quarto는 실행되지 않습니다. \|
`QUARTO_KNITR_RSCRIPT_ARGS`	`knitr` 엔진으로 렌더링할 때 Quarto가 실행하는 `Rscript`에 전달할 명령줄 인자를 콤마로 구분해 지정합니다. 예: \| `QUARTO_KNITR_RSCRIPT_ARGS="--no-init-file,--max-connections=258"`
`QUARTO_TEXLIVE_BINPATH`	`tlmgr option sys_bin`으로 전달할 TeX Live 바이너리 경로를 명시합니다. `tlmgr add path`로 `PATH`를 구성할 때 사용하며, 지정하지 않으면 Quarto가 알려진 경로를 자동으로 탐색합니다. \|
`QUARTO_CHROMIUM`	헤드리스 크롬으로 사용할 실행 파일 경로를 명시합니다. Quarto는 Chrome Devtools Protocol을 사용해 HTML 다이어그램을 캡처한 뒤 PDF에 삽입하므로, 이 프로토콜과 호환되는 바이너리(Chrome, Chromium, Chrome Headless Shell, Edge 등)를 지정해야 합니다. \|
`QUARTO_CHROMIUM_HEADLESS_MODE`	`QUARTO_CHROMIUM` 바이너리를 실행할 때 사용할 `--headless` 모드를 제어합니다. `"none"`으로 설정하면 기존 방식처럼 `--headless`만 전달하고, `"old"` 또는 `"new"`로 지정하면 `--headless=<모드>` 형식으로 인자를 전달합니다. Quarto 1.6에서는 Chrome 112~131에 맞춰 `"old"`가 기본값이었으나, Chrome 132에서 구형 헤드리스 모드를 제거하면서 Quarto 1.7.13부터 기본값이 `"none"`으로 변
`QUARTO_LOG` `QUARTO_LOG_LEVEL` `QUARTO_LOG_FORMAT`	다음 변수는 로깅 동작을 제어합니다. \| `QUARTO_LOG`는 명령줄의 `--log` 플래그와 동일하며, 로그 파일 경로를 지정합니다. \| `QUARTO_LOG_LEVEL`은 명령줄의 `--log-level`과 같으며, 기록할 로그의 최대 레벨을 지정합니다. 값으로는 `DEBUG`, `INFO`(기본값), `WARNING`, `ERROR`를 사용할 수 있습니다. \| `QUARTO_LOG_FORMAT`은 명령줄의 `--log-format`과 같으며, 로그 출력 형식을 설정합니다. `plain`(기본값)과 `json-stream` 중에서 선택할 수 있습니다. \|

Quarto가 설정하는 변수

아래 변수는 Quarto가 실행 중에 설정합니다. 실행 가능한 코드 셀에서 다음과 같이 조회할 수 있습니다.

Sys.getenv("QUARTO_DOCUMENT_PATH")

import os
print(os.environ["QUARTO_DOCUMENT_PATH"])

ENV["QUARTO_DOCUMENT_PATH"]

Variable	Description
`QUARTO_PROJECT_ROOT`	프로젝트 루트 경로입니다. 프로젝트가 아닌 단일 문서 렌더링 시에는 해당 파일이 있는 디렉터리가 설정됩니다.
`QUARTO_DOCUMENT_PATH`	현재 렌더링 중인 문서가 위치한 디렉터리 경로입니다.
`QUARTO_DOCUMENT_FILE`	렌더링 중인 문서 파일 이름입니다.
`QUARTO_PROFILE`	사용 중인 프로필입니다. 예를 들어 `quarto render --profile advanced,production` 실행 시 `QUARTO_PROFILE=advanced,production` 으로 설정됩니다.
`QUARTO_FIG_WIDTH` and `QUARTO_FIG_HEIGHT`	문서 메타데이터에서 지정한 `fig-width`, `fig-height` 값이 각각 저장됩니다.
`QUARTO_RUN_NO_NETWORK`	`true`이면 TypeScript로 작성된 Quarto 프로젝트 스크립트가 네트워크를 통해 소스를 다운로드할 수 없습니다. 이 경우 표준 라이브러리에 접근할 수 없다는 의미이기도 합니다.
`QUARTO_EXECUTE_INFO`	Quarto 엔진 실행 정보가 담긴 JSON 파일 경로입니다. 실행 가능한 코드 셀에서 이 파일을 읽어 실행 컨텍스트 메타데이터를 확인할 수 있습니다.

QUARTO_EXECUTE_INFO가 가리키는 JSON 객체에 대한 자세한 내용은 Quarto 엔진 실행 정보를 참고하세요.