다른 형식 포함

개요

HTML 페이지(독립형 또는 웹사이트 내)는 문서 프론트 매터에 지정된 다른 형식으로의 링크를 자동으로 포함할 수 있습니다. 예를 들어 다음 문서 프론트 매터는:

title: Sample Page
author: Norah Jones
date: last-modified
toc: true
format: 
  html: default
  ipynb: default

목차 아래 오른쪽 여백에 추가 노트북 형식 링크가 포함된 HTML 페이지를 생성합니다:

목차 아래 오른쪽 여백의 'Other Formats' 제목 아래에 Jupyter 형식 링크가 포함된 HTML 페이지 스크린샷.

페이지에 목차가 활성화되어 있으면 추가 형식이 목차 안에 새 섹션으로 자동 배치됩니다. 목차가 표시되지 않으면 추가 형식은 문서 상단 오른쪽 여백에 표시됩니다.

추가 형식 링크는 기본적으로 표시되지만 format-links YAML 옵션으로 표시 여부나 포함할 구체적 형식을 제어할 수 있습니다.

Note독립형 HTML 문서에서 모든 형식 렌더링

RStudio의 Render 버튼과 Positron/VS Code의 Preview 버튼은 문서가 Quarto 웹사이트의 일부가 아니면 모든 형식을 자동으로 렌더링하지 않습니다. 모든 형식을 렌더링하려면 명령줄에서 quarto render를 사용하세요:

Terminal
quarto render multi-format.qmd

같은 확장자를 사용하는 형식 렌더링

형식들이 같은 파일 확장자를 공유하는 경우(예: HTML 페이지와 Revealjs 프레젠테이션은 모두 .html 사용) 출력이 서로 덮어씁니다. 같은 확장자를 사용하는 형식을 포함하려면 output-file로 구분하세요. 예를 들어 RevealJS 프레젠테이션 링크를 포함하려면 별도의 output-file을 지정합니다:

document.qmd
title: Sample Page
format: 
  html: default
  revealjs: 
    output-file: document-revealjs.html

링크할 형식 지정

format-links 값에 목록을 제공하면 Other Formats 섹션에 포함할 형식 목록을 명시할 수 있습니다. 예를 들어 다음 문서 프론트 매터는 PDF 형식을 제외하고 Jupyter 노트북 형식 링크만 포함합니다:

title: Sample Page
author: Norah Jones
date: last-modified
toc: true
format: 
  html: default
  ipynb: default
  pdf: default
format-links: [ipynb]

format-links에 다음 키를 가진 객체를 전달하여 링크를 사용자 지정할 수도 있습니다:

  • format: 링크할 형식
  • text: 링크에 표시할 텍스트
  • icon: Bootstrap icons 이름

예를 들어 다음에서는 typst 형식 링크를 PDF 파일 아이콘과 함께 “PDF”라는 텍스트로 표시합니다:

title: Sample Page
author: Norah Jones
date: last-modified
toc: true
format: 
  html: default
  typst: default
format-links:
  - html
  - format: typst
    text: PDF
    icon: file-pdf

format-links 항목은 Code Links and Other Links와 같은 옵션으로 제공할 수도 있습니다. 예를 들어 다른 형식 대신 외부 URL로의 링크를 추가할 수 있습니다:

format-links:
  - text: Other Link
    href: https://quarto.org/
    icon: hand-thumbs-up

모든 링크 숨기기

형식 링크를 전혀 표시하지 않으려면 문서 프론트 매터에 format-links: false를 지정하세요. 예를 들어 다음 프론트 매터는 Other Formats 링크를 표시하지 않습니다:

title: Sample Page
author: Norah Jones
date: last-modified
toc: true
format: 
  html: default
  ipynb: default
format-links: false

프로젝트 수준에서 형식 제어

Quarto 프로젝트에서 특정 폴더의 형식과 동작을 제어하려면 _metadata.yml 파일에 format과 format-links 옵션을 제공합니다. 마찬가지로 _quarto.yml 프로젝트 파일에 포함하면 전체 프로젝트에 대해 이 옵션들을 지정할 수 있습니다. 자세한 내용은 Directory Metadata 또는 Project Metadata를 참고하세요.

format 옵션은 _quarto.yml, _metadata.yml, 문서 YAML 간의 다른 metadata처럼 병합되지 않습니다. 프로젝트 또는 디렉터리 수준에서 일부 형식을 지정했다면 문서 YAML에도 명시적으로 나열해야 합니다. 예를 들어 프로젝트 수준에서 HTML 옵션을 설정했다고 가정해 봅시다:

_quarto.yml
format:
  html:
    toc: true

PDF 형식 링크가 포함된 HTML 문서를 얻으려면 YAML 헤더에 두 형식을 모두 나열해야 합니다:

document.qmd
format: 
  html: default
  pdf: default