메타데이터 확장

메타데이터 확장은 기존 Quarto 설정에 재사용 가능한 방식으로 병합할 수 있는 메타데이터(YAML 객체)를 제공하는 Quarto 확장입니다.

Important

현재 메타데이터 확장은 프로젝트 수준 메타데이터만 병합합니다. 이 제한은 향후 해제될 예정입니다.

빠른 시작

여기서는 간단한 메타데이터 확장을 만드는 방법을 설명합니다. 이를 위해 quarto create 명령을 사용합니다. VS Code, Positron, RStudio를 사용 중이라면 각 통합 터미널에서 quarto create를 실행하세요.

시작하려면 메타데이터 확장을 만들 상위 디렉터리에서 quarto create extension metadata를 실행하세요:

Terminal

$ quarto create extension metadata
 ? Extension Name › my-prerender-scripts

위와 같이 확장 이름을 묻게 됩니다. my-prerender-scripts를 입력하고 Enter를 누르면 메타데이터 확장이 생성됩니다:

? Extension Name › my-prerender-scripts
Creating extension at /Users/cscheid/Desktop/my-prerender-scripts:
  - Created README.md
  - Created _extensions/my-prerender-scripts/_extension.yml
  - Created .gitignore
? Open With
❯ vscode
  rstudio
  (don't open)

VS Code, Positron, RStudio에서 실행 중이라면 새 창이 열리며 확장 프로젝트가 표시됩니다.

메타데이터 확장의 구성

_extensions/my-prerender-scripts/의 파일 구성은 다음과 같습니다:

_extensions/my-prerender-scripts/_extension.yml

title: My-prerender-scripts
author: Carlos Scheidegger
version: 1.0.0
quarto-required: ">=99.9.0"
contributes:
  metadata:
    project:
      # 프로젝트별 메타데이터를 여기에 추가합니다

메타데이터 확장의 동작 방식

project 키 아래에 추가한 YAML은 이 확장을 사용하는 모든 프로젝트에 자동으로 병합됩니다. 이 동작은 커스텀 프로젝트 확장과는 다릅니다. 메타데이터 확장을 사용하는 Quarto 프로젝트는 메타데이터 병합을 위해 프로젝트 유형을 변경할 필요가 없습니다.

Note

앞에서 언급한 대로 메타데이터 확장은 project 키의 프로젝트 수준 메타데이터만 병합합니다. 이 제한은 향후 해제될 예정입니다.