Beamer 옵션

Beamer는 프레젠테이션과 슬라이드를 만들기 위한 LaTeX 클래스입니다. 자세한 내용은 https://ctan.org/pkg/beamer를 참고하세요.

Quarto로 Beamer 출력을 만드는 자세한 방법은 Beamer 형식 사용자 가이드를 참고하세요.

format: beamer

제목 및 저자

title

문서 제목

subtitle

문서의 부제목을 지정합니다.

date

문서 날짜

date-format

문서의 날짜 형식

author

문서의 저자

institute

프레젠테이션의 저자 소속입니다.

abstract

문서 요약

thanks

문서 제목 뒤에 표시할 감사 문구 각주의 내용입니다.

order

웹사이트 자동 사이드바 메뉴에 포함될 때 사용할 문서 순서입니다.

형식 옵션

brand

이 문서에 사용할 브랜딩 정보입니다. 문자열이면 브랜드 파일의 경로입니다. false이면 이 문서에 브랜딩을 사용하지 않습니다. 객체이면 인라인 브랜드 정의이거나, 밝은/어두운 브랜드 경로 또는 정의를 가진 객체입니다.

theme

테마 이름, 테마 scss 파일, 또는 둘의 조합입니다.

pdf-engine

PDF 출력을 생성할 때 지정한 엔진을 사용합니다. 엔진이 PATH에 없으면 여기에서 전체 경로를 지정할 수 있습니다. 이 옵션을 지정하지 않으면 Quarto는 사용 중인 출력 형식에 따라 다음 기본값을 사용합니다:

  • latex: lualatex (other options: pdflatex, xelatex, tectonic, latexmk)
  • context: context
  • html: wkhtmltopdf (other options: prince, weasyprint, pagedjs-cli; see print-css.rocks for a good introduction to PDF generation from HTML/CSS.)
  • ms: pdfroff
  • typst: typst
pdf-engine-opt

지정한 문자열을 pdf-engine의 명령줄 인수로 사용합니다. 예를 들어, latexmk의 보조 파일에 대해 지속 디렉터리 foo를 사용하려면 pdf-engine-opt: -outdir=foo를 사용합니다. 중복 옵션에 대한 검사는 수행되지 않습니다.

pdf-engine-opts

지정한 문자열 배열을 pdf-engine의 명령줄 인수로 사용합니다. 여러 옵션을 전달하기 위한 pdf-engine-opt의 대안입니다.

beameroption

\setbeameroption{}을 사용해 Beamer 옵션을 추가합니다.

aspectratio

이 프레젠테이션의 종횡비입니다.

logo

로고 이미지입니다.

titlegraphic

제목 슬라이드 이미지입니다.

navigation

프레젠테이션의 내비게이션 기호를 제어합니다(empty, frame, vertical, horizontal).

section-titles

새 섹션에 제목 페이지를 사용할지 여부입니다.

colortheme

이 프레젠테이션의 Beamer 색상 테마로, \usecolortheme에 전달됩니다.

colorthemeoptions

이 프레젠테이션의 Beamer 색상 테마 옵션으로, \usecolortheme에 전달됩니다.

fonttheme

이 프레젠테이션의 Beamer 글꼴 테마로, \usefonttheme에 전달됩니다.

fontthemeoptions

이 프레젠테이션의 Beamer 글꼴 테마 옵션으로, \usefonttheme에 전달됩니다.

innertheme

이 프레젠테이션의 Beamer 내부 테마로, \useinnertheme에 전달됩니다.

innerthemeoptions

이 프레젠테이션의 Beamer 내부 테마 옵션으로, \useinnertheme에 전달됩니다.

outertheme

이 프레젠테이션의 Beamer 외부 테마로, \useoutertheme에 전달됩니다.

outerthemeoptions

이 프레젠테이션의 Beamer 외부 테마 옵션으로, \useoutertheme에 전달됩니다.

themeoptions

\usetheme 안에서 LaTeX Beamer 테마에 전달되는 옵션입니다.

quarto-required

이 문서 또는 프로젝트에서 지원되는 quarto 버전을 설명하는 semver 범위입니다.

예시:

  • >= 1.1.0: quarto 버전 1.1 이상 필요
  • 1.*: 주요 버전 번호가 1인 모든 quarto 버전 필요

목차

toc

출력 문서에 자동 생성된 목차를 포함합니다(또는 latex, context, docx, odt, opendocument, rst, ms의 경우 목차를 생성하라는 지시를 포함합니다).

ms를 통해 PDF를 생성하는 경우 목차는 제목 앞의 문서 시작 부분에 나타납니다. 문서 끝에 두고 싶다면 pdf-engine-opt: --no-toc-relocation 옵션을 사용합니다.

toc-title

목차에 사용할 제목입니다.

lof

문서에 그림 목록을 출력합니다.

lot

문서에 표 목록을 출력합니다.

번호 매기기

number-sections

출력에 렌더링된 섹션 제목에 번호를 매깁니다. 기본적으로 섹션은 번호가 매겨지지 않습니다. 클래스가 .unnumbered인 섹션은 number-sections가 지정되어도 번호가 매겨지지 않습니다.

number-depth

기본적으로 문서의 모든 제목은 번호가 매겨진 섹션을 만듭니다. number-depth 옵션으로 번호 매기기 깊이를 사용자 지정할 수 있습니다.

예를 들어 장(chapter) 바로 아래 수준의 섹션에만 번호를 매기려면 다음과 같이 지정합니다:

number-depth: 1
shift-heading-level-by

제목 레벨을 양수 또는 음수 정수만큼 이동합니다. 예를 들어 shift-heading-level-by: -1이면 레벨 2 제목이 레벨 1 제목이 되고, 레벨 3 제목이 레벨 2 제목이 됩니다. 제목 레벨은 1보다 낮을 수 없으므로 레벨 1 아래로 이동되는 제목은 일반 문단이 됩니다. 예외적으로 -N만큼 이동할 때, 문서 시작의 레벨 N 제목은 메타데이터 제목을 대체합니다.

top-level-division

최상위 제목을 지정한 구분 타입(default, section, chapter, part)으로 처리합니다. 계층 순서는 part, chapter, section이며 모든 제목이 이동되어 최상위 제목이 지정된 타입이 됩니다.

기본 동작은 휴리스틱으로 최적의 구분 타입을 결정하는 것입니다. 다른 조건이 없으면 section이 선택됩니다. documentclass 변수가 report, book, memoir로 설정되어 있고(article 옵션이 지정되지 않은 경우) chapter가 이 옵션의 설정으로 암시됩니다. 출력 형식이 beamer이면 chapter 또는 part를 지정할 때 최상위 제목은 \part{..}가 되며, 두 번째 수준 제목은 기본 타입을 유지합니다.

슬라이드

incremental

슬라이드 쇼의 목록 항목을 하나씩 단계적으로 표시합니다. 기본값은 목록을 한 번에 표시하는 것입니다.

slide-level

지정된 수준의 제목이 슬라이드를 생성하도록 지정합니다. 이 수준보다 상위의 제목은 슬라이드쇼를 섹션으로 나누는 데 사용되며, 하위 제목은 슬라이드 내의 하위 제목으로 사용됩니다. 값은 0~6입니다. 슬라이드 수준을 0으로 지정하면 제목에 의해 자동으로 분할되지 않으며, 슬라이드 경계는 수평선으로 표시해야 합니다. 슬라이드 수준을 명시적으로 지정하지 않으면 문서 내용에 따라 자동으로 설정됩니다.

글꼴

mainfont

HTML 출력의 경우 HTML 요소에 CSS font-family를 설정합니다.

LaTeX 출력의 경우 xelatex 또는 lualatex에서 사용하는 기본 글꼴 패밀리입니다. fontspec 패키지를 사용해 시스템 글꼴 이름을 지정합니다.

ConTeXt 출력의 경우 기본 글꼴 패밀리입니다. 시스템 글꼴 이름을 사용합니다. 자세한 내용은 ConTeXt Fonts 를 참조하세요.

monofont

HTML 출력의 경우 코드 요소에 CSS font-family 속성을 설정합니다.

PowerPoint 출력의 경우 코드에 사용할 글꼴을 설정합니다.

LaTeX 출력의 경우 xelatex 또는 lualatex에서 사용하는 고정폭 글꼴 패밀리입니다. fontspec 패키지를 사용해 시스템 글꼴 이름을 지정합니다.

ConTeXt 출력의 경우 고정폭 글꼴 패밀리입니다. 시스템 글꼴 이름을 사용합니다. 자세한 내용은 ConTeXt Fonts 를 참조하세요.

fontsize

HTML 출력의 경우 기본 CSS font-size 속성을 설정합니다.

LaTeX 및 ConTeXt 출력의 경우 문서 본문 텍스트의 글꼴 크기를 설정합니다.

fontenc

fontenc 패키지를 통해 글꼴 인코딩을 지정할 수 있습니다.

글꼴 인코딩에 대한 추가 정보는 LaTeX Font Encodings Guide를 참조하세요.

fontfamily

pdflatex pdf-engine으로 PDF를 컴파일할 때 사용할 글꼴 패키지입니다.

사용 가능한 글꼴 옵션 요약은 The LaTeX Font Catalogue를 참조하세요.

Groff(ms) 파일의 경우 예를 들어 T 또는 P 같은 글꼴 패밀리입니다.

fontfamilyoptions

fontfamily로 사용할 패키지의 옵션입니다.

예를 들어 libertinus 패키지를 통해 비례 소문자 숫자(old-style)를 사용하는 Libertine 글꼴을 사용하려면 다음과 같이 설정합니다:

fontfamily: libertinus
fontfamilyoptions:
  - osf
  - p
sansfont

xelatex 또는 lualatex에서 사용할 산세리프 글꼴 패밀리입니다. fontspec 패키지를 사용해 시스템 글꼴 이름을 지정합니다.

mathfont

xelatex 또는 lualatex에서 사용할 수학 글꼴 패밀리입니다. fontspec 패키지를 사용해 시스템 글꼴 이름을 지정합니다.

CJKmainfont

xecjk 패키지를 사용해 xelatex 또는 lualatex에서 사용할 CJK 기본 글꼴 패밀리입니다.

mainfontoptions

xelatex 또는 lualatex에서 사용할 기본 글꼴 옵션으로, fontspec을 통해 제공되는 모든 옵션을 사용할 수 있습니다.

예를 들어 소문자 숫자 형태를 사용하는 Palatino의 TeX Gyre 버전을 사용하려면 다음과 같이 설정합니다:

mainfont: TeX Gyre Pagella
mainfontoptions:
  - Numbers=Lowercase
  - Numbers=Proportional    
sansfontoptions

xelatex 또는 lualatex에서 사용할 산세리프 글꼴 옵션으로, fontspec을 통해 제공되는 모든 옵션을 사용할 수 있습니다.

monofontoptions

xelatex 또는 lualatex에서 사용할 고정폭 글꼴 옵션으로, fontspec을 통해 제공되는 모든 옵션을 사용할 수 있습니다.

mathfontoptions

xelatex 또는 lualatex에서 사용할 수학 글꼴 옵션으로, fontspec을 통해 제공되는 모든 옵션을 사용할 수 있습니다.

CJKoptions

xelatex 또는 lualatex에서 사용할 CJK 글꼴 옵션으로, fontspec을 통해 제공되는 모든 옵션을 사용할 수 있습니다.

microtypeoptions

microtype 패키지에 전달할 옵션입니다.

linestretch

HTML 출력의 경우 html 요소에 CSS line-height 속성을 설정하며, 단위 없는 값을 권장합니다.

LaTeX 출력의 경우 setspace 패키지를 사용해 줄 간격을 조정합니다(예: 1.25, 1.5).

색상

linkcolor

HTML 출력의 경우 모든 링크에 CSS color 속성을 설정합니다.

LaTeX 출력의 경우 xcolor에서 허용하는 색상 옵션을 사용해 내부 링크에 사용할 색상을 지정합니다. dvipsnames, svgnames, x11names 목록을 포함합니다.

ConTeXt 출력의 경우 외부 링크와 문서 내 링크 모두의 색상을 설정합니다.

filecolor

xcolor에서 허용하는 색상 옵션을 사용해 외부 링크에 사용할 색상을 지정합니다. dvipsnames, svgnames, x11names 목록을 포함합니다.

citecolor

xcolor에서 허용하는 색상 옵션을 사용해 인용 링크에 사용할 색상을 지정합니다. dvipsnames, svgnames, x11names 목록을 포함합니다.

urlcolor

xcolor에서 허용하는 색상 옵션을 사용해 링크된 URL에 사용할 색상을 지정합니다. dvipsnames, svgnames, x11names 목록을 포함합니다.

toccolor

xcolor에서 허용하는 색상 옵션을 사용해 목차 링크에 사용할 색상을 지정합니다. dvipsnames, svgnames, x11names 목록을 포함합니다.

colorlinks

링크 텍스트에 색상을 추가합니다. linkcolor, filecolor, citecolor, urlcolor, toccolor 중 하나라도 설정되면 자동으로 활성화됩니다.

레이아웃

cap-location

그림 및 표 캡션을 배치할 위치입니다(top, bottom, margin).

fig-cap-location

그림 캡션을 배치할 위치입니다(top, bottom, margin).

tbl-cap-location

표 캡션을 배치할 위치입니다(top, bottom, margin).

documentclass

문서 클래스입니다.

classoption

LaTeX/PDF 출력에서 문서 클래스에 설정할 옵션입니다.

KaTeX를 사용하는 HTML 출력의 경우 classoption: fleqn으로 디스플레이 수식을 왼쪽 정렬할 수 있습니다.

pagestyle

문서의 \pagestyle{}을 제어합니다.

papersize

문서의 용지 크기입니다.

grid

Quarto HTML 페이지를 레이아웃하는 데 사용하는 그리드 시스템의 속성입니다.

margin-left

HTML 출력의 경우 Body 요소에 margin-left 속성을 설정합니다.

LaTeX 출력의 경우 geometry가 사용되지 않으면 왼쪽 여백을 설정합니다(그렇지 않으면 geometry가 이 값을 덮어씁니다).

ConTeXt 출력의 경우 layout을 사용하지 않으면 왼쪽 여백을 설정하고, 그렇지 않으면 layout이 이를 덮어씁니다.

wkhtmltopdf의 경우 왼쪽 페이지 여백을 설정합니다.

margin-right

HTML 출력의 경우 Body 요소에 margin-right 속성을 설정합니다.

LaTeX 출력의 경우 geometry가 사용되지 않으면 오른쪽 여백을 설정합니다(그렇지 않으면 geometry가 이 값을 덮어씁니다).

ConTeXt 출력의 경우 layout을 사용하지 않으면 오른쪽 여백을 설정하고, 그렇지 않으면 layout이 이를 덮어씁니다.

wkhtmltopdf의 경우 오른쪽 페이지 여백을 설정합니다.

margin-top

HTML 출력의 경우 Body 요소에 margin-top 속성을 설정합니다.

LaTeX 출력의 경우 geometry가 사용되지 않으면 위쪽 여백을 설정합니다(그렇지 않으면 geometry가 이 값을 덮어씁니다).

ConTeXt 출력의 경우 layout을 사용하지 않으면 위쪽 여백을 설정하고, 그렇지 않으면 layout이 이를 덮어씁니다.

wkhtmltopdf의 경우 위쪽 페이지 여백을 설정합니다.

margin-bottom

HTML 출력의 경우 Body 요소에 margin-bottom 속성을 설정합니다.

LaTeX 출력의 경우 geometry가 사용되지 않으면 아래쪽 여백을 설정합니다(그렇지 않으면 geometry가 이 값을 덮어씁니다).

ConTeXt 출력의 경우 layout을 사용하지 않으면 아래쪽 여백을 설정하고, 그렇지 않으면 layout이 이를 덮어씁니다.

wkhtmltopdf의 경우 아래쪽 페이지 여백을 설정합니다.

geometry

geometry 패키지의 옵션입니다. 예:

geometry:
  - top=30mm
  - left=20mm
  - heightrounded
hyperrefoptions

hyperref 패키지의 옵션입니다. 예:

hyperrefoptions:
  - linktoc=all
  - pdfwindowui
  - pdfpagemode=FullScreen      

링크 색상을 사용자 지정하려면 Quarto PDF reference를 참조하세요.

indent

들여쓰기에 문서 클래스 설정을 사용할지 여부입니다. 문서 클래스 설정을 사용하지 않으면 기본 LaTeX 템플릿이 들여쓰기를 제거하고 문단 사이에 공백을 추가합니다.

Groff(ms) 문서의 경우 문단 들여쓰기(예: 2m)입니다.

block-headings

\paragraph\subparagraph(4~5단계 제목, 또는 book 클래스에서는 5~6단계)을 내리붙임(run-in) 대신 독립 단락으로 만들며, \subsubsection(3~4단계 제목)과 구분하려면 추가 서식이 필요합니다. 이 옵션 대신 KOMA-Script를 사용해 제목을 더 폭넓게 조정할 수 있습니다:

header-includes: |
  \RedeclareSectionCommand[
    beforeskip=-10pt plus -2pt minus -1pt,
    afterskip=1sp plus -1sp minus 1sp,
    font=\normalfont\itshape]{paragraph}
  \RedeclareSectionCommand[
    beforeskip=-10pt plus -2pt minus -1pt,
    afterskip=1sp plus -1sp minus 1sp,
    font=\normalfont\scshape,
    indent=0pt]{subparagraph}

코드

code-line-numbers

코드 블록 출력에 줄 번호를 포함합니다(true 또는 false).

revealjs 출력에서만 특정 줄을 강조 표시하거나(또는 강조 단계 간 애니메이션을) 문자열로 지정할 수 있습니다.

  • 줄 집합은 쉼표로 구분합니다:
    • 3,4,5
    • 1,10,12
  • 범위는 대시로 표기하고 쉼표로 결합할 수 있습니다:
    • 1-3,5
    • 5-10,12,14
  • 마지막으로 애니메이션 단계는 |로 구분합니다:
    • 1-3|1-3,5는 먼저 1-3, 다음에 1-3,5를 표시
    • |5|5-10,12는 먼저 번호 없음, 다음 5, 이후 5-10과 12
code-annotations

코드 주석을 표시할 때 사용할 스타일입니다. 이 값을 false로 설정하면 코드 주석을 숨깁니다.

code-block-border-left

코드 블록에 왼쪽 테두리를 적용합니다. 테두리를 활성화하고 색상을 지정하려면 16진수 색상을 제공합니다.

code-block-bg

코드 블록에 배경색을 적용합니다. 배경색을 활성화하고 색상을 지정하려면 16진수 색상을 제공합니다.

highlight-style

하이라이트된 소스 코드에 사용할 색상 스타일을 지정합니다.

STYLE 이름 대신 확장자가 .theme인 JSON 파일을 제공할 수 있습니다. 이 파일은 KDE 구문 강조 테마로 파싱되며(유효한 경우) 강조 스타일로 사용됩니다.

syntax-definitions

KDE 언어 구문 정의 파일(XML)

listings

LaTeX 코드 블록에 listings 패키지를 사용합니다. 이 패키지는 소스 코드의 다중 바이트 인코딩을 지원하지 않습니다. UTF-8을 처리하려면 사용자 정의 템플릿을 사용해야 합니다. 자세한 내용은 Encoding issue with the listings package를 참조하세요.

indented-code-classes

모든 들여쓰기 코드 블록에 사용할 클래스를 지정합니다.

실행

실행 옵션은 execute 키 아래에 지정해야 합니다. 예:

execute:
  echo: false
  warning: false
eval

코드 셀을 실행합니다(false이면 코드만 출력에 에코합니다).

  • true (기본값): 코드 셀을 실행
  • false: 코드 셀을 실행하지 않음
  • [...]: 표현식을 선택적으로 포함 또는 제외하기 위한 양수 또는 음수 숫자 목록 (표현식의 명시적 포함/제외는 knitr 엔진을 사용할 때만 가능합니다)
echo

렌더링된 출력에 셀 소스 코드를 포함합니다.

  • true (대부분의 형식에서 기본값): 소스 코드를 출력에 포함
  • false (beamer, revealjs, pptx 같은 프레젠테이션 형식의 기본값): 소스 코드를 출력에 포함하지 않음
  • fenced: 에코 외에도 셀 구분자를 출력의 일부로 포함
  • [...]: 선택적으로 포함하거나 제외할 줄 번호의 양수 또는 음수 목록 (줄의 명시적 포함/제외는 knitr 엔진을 사용할 때만 가능합니다)
output

코드 실행 결과를 출력에 포함합니다. 가능한 값:

  • true: 결과를 포함합니다.
  • false: 결과를 포함하지 않습니다.
  • asis: 출력물을 원시 마크다운으로 처리하고 감싸는 컨테이너를 사용하지 않습니다.
warning

렌더링된 출력에 경고를 포함합니다.

error

출력에 오류를 포함합니다(이는 코드 실행 오류가 문서 처리를 중단하지 않음을 의미합니다).

include

어떤 출력(코드 또는 결과)도 출력에 포함되지 않도록 하는 포괄 옵션입니다.

cache

계산 결과를 캐시합니다(R 문서에는 knitr cache를, Jupyter 문서에는 Jupyter Cache를 사용).

캐시 무효화는 청크 소스 코드 변경 (또는 정의한 다른 캐시 속성 변경)으로 트리거됩니다.

  • true: 결과를 캐시
  • false: 결과를 캐시하지 않음
  • refresh: 다른 이유로 무효화되지 않았더라도 캐시를 강제로 새로 고침
freeze

렌더링 시 이전 계산 출력의 재사용을 제어합니다.

  • true: 전역 프로젝트 렌더 시 이전에 생성된 계산 출력은 재계산하지 않음
  • false (기본값): 이전에 생성된 계산 출력을 재계산
  • auto: 소스 파일이 변경된 경우에만 이전 계산 출력을 재계산

그림

fig-align

그림의 가로 정렬(default, left, right, center)

fig-env

그림 출력에 사용할 LaTeX 환경

fig-pos

\begin{figure}[]에 사용할 LaTeX 그림 위치 지정입니다.

코드와 함께 출력되는 계산 그림은 기본값으로 fig-pos="H"가 적용되어 코드와 그림이 과도하게 떨어지지 않도록 합니다.

fig-posfalse이면 그림 위치 지정자를 사용하지 않습니다. 이는 sidewaysfigure 같은 사용자 정의 그림 환경에서 필요할 수 있습니다.

fig-cap-location

그림 캡션을 배치할 위치입니다(top, bottom, margin).

fig-width

Matplotlib 또는 R 그래픽으로 생성된 그림의 기본 너비입니다.

Jupyter 엔진에서는 이 옵션이 셀 수준에서 제공될 때 효과가 없으며 문서 또는 프로젝트 메타데이터로만 제공할 수 있습니다.

fig-height

Matplotlib 또는 R 그래픽으로 생성된 그림의 기본 높이입니다.

Jupyter 엔진에서는 이 옵션이 셀 수준에서 제공될 때 효과가 없으며 문서 또는 프로젝트 메타데이터로만 제공할 수 있습니다.

fig-format

Matplotlib 또는 R 그래픽으로 생성된 그림의 기본 형식(retina, png, jpeg, svg, pdf)

fig-dpi

Matplotlib 또는 R 그래픽으로 생성된 그림의 기본 DPI입니다.

Jupyter 엔진에서는 이 옵션이 셀 수준에서 제공될 때 효과가 없으며 문서 또는 프로젝트 메타데이터로만 제공할 수 있습니다.

fig-asp

그림의 종횡비, 즉 높이/너비 비율입니다. fig-asp를 지정하면 그림의 높이(fig-height 옵션)는 fig-width * fig-asp에서 계산됩니다.

fig-asp 옵션은 knitr 엔진에서만 사용할 수 있습니다.

tbl-colwidths

columns 문자(기본 72)보다 넓은 마크다운 그리드/파이프 표에 대해 명시적 열 너비를 적용합니다.

일부 형식(예: HTML)은 표 열 너비를 자동으로 잘 조정하므로 명시적 열 너비 지정의 효과가 크지 않습니다. 다른 형식(예: LaTeX)은 긴 셀 콘텐츠를 올바르게 흐르게 하려면 열 크기가 필요합니다(이 때문에 72열을 넘는 표에는 Pandoc이 명시적 너비를 지정합니다).

다음과 같이 지정할 수 있습니다:

  • auto: 표에 하이퍼링크가 있을 때를 제외하고 마크다운 표 열 너비를 적용(하이퍼링크는 셀의 마크다운 텍스트 폭 기준 자동 계산을 흔들 수 있음). (auto는 HTML 출력 형식의 기본값)

  • true: 항상 마크다운 표 너비 적용(true는 비HTML 형식의 기본값)

  • false: 마크다운 표 너비를 적용하지 않음.

  • 숫자 배열(예: [40, 30, 30]): 명시적 너비 백분율 배열.

tbl-cap-location

표 캡션을 배치할 위치입니다(top, bottom, margin).

df-print

Knitr 엔진 문서에서 표를 출력하는 데 사용하는 방법입니다:

  • default: 데이터 프레임의 기본 S3 메서드를 사용
  • kable: knitr::kable() 함수를 사용하는 마크다운 표
  • tibble: tibble 패키지를 사용하는 일반 텍스트 표
  • paged: 행과 열 오버플로에 페이징을 적용한 HTML 표

기본 출력 방식은 kable입니다.

참고문헌

bibliography

문서 참고문헌(BibTeX 또는 CSL). 단일 파일 또는 파일 목록일 수 있습니다.

csl

참고문헌 서식에 사용할 Citation Style Language 파일입니다.

cite-method

인용을 형식화하는 방법입니다(citeproc, natbib, biblatex).

citeproc

내장 인용 처리를 활성화합니다. 이 기능을 사용하려면 인용이 포함된 문서와 서지 데이터 소스가 필요합니다. 외부 참고문헌 파일 또는 문서의 YAML 메타데이터에 있는 references 목록을 사용할 수 있습니다. 선택적으로 csl 인용 스타일 파일도 포함할 수 있습니다.

biblatexoptions

BibLaTeX에 대한 옵션 목록입니다.

natbiboptions

참고문헌 생성 시 natbib에 전달할 옵션입니다.

biblio-style

natbib 또는 biblatex를 사용할 때 사용할 참고문헌 스타일입니다(예: \bibliographystyle{dinat}).

biblio-title

natbib 또는 biblatex를 사용할 때 사용할 참고문헌 제목입니다.

biblio-config

cite 방법이 citeproc이 아닐 때 natbib 또는 biblatex의 참고문헌 설정 출력 여부를 제어합니다.

citation-abbreviations

form="short"가 지정된 경우 형식화된 참고문헌에서 사용할 저널 약어를 포함하는 JSON 파일입니다. 파일 형식은 다음 예시로 설명할 수 있습니다:

{ "default": {
    "container-title": {
      "Lloyd's Law Reports": "Lloyd's Rep",
      "Estates Gazette": "EG",
      "Scots Law Times": "SLT"
    }
  }
}
link-citations

true이면 인용이 해당 참고문헌 항목으로 하이퍼링크됩니다(저자-연도 및 숫자 스타일에만 해당). 기본값은 false입니다.

link-bibliography

true이면 참고문헌의 DOI, PMCID, PMID, URL이 하이퍼링크로 렌더링됩니다. (항목에 DOI/PMCID/PMID/URL이 있지만 스타일이 이를 렌더링하지 않는 경우 제목이, 제목이 없으면 항목 전체가 하이퍼링크됩니다.) 기본값은 true입니다.

notes-after-punctuation

true이면(각주 스타일의 기본값) Quarto가(Pandoc을 통해) 각주 참조나 위첨자 숫자 인용을 뒤따르는 구두점 뒤로 이동합니다. 예를 들어 소스에 blah blah [@jones99].가 있으면 결과는 blah blah.[^1]처럼 보이며 마침표 뒤로 각주가 이동하고 공백이 사라집니다.

false이면 공백은 여전히 사라지지만 각주는 구두점 뒤로 이동하지 않습니다. 이 옵션은 위첨자 인용 번호를 사용하는 숫자 스타일에서도 사용할 수 있으나(이들 스타일의 기본값은 인용을 이동하지 않음) 적용됩니다.

각주

links-as-notes

링크를 각주로 인쇄합니다.

상호 참조

crossref

상호 참조 레이블과 접두사 설정입니다. 자세한 내용은 Cross-Reference Options을 참조하세요.

인용

citation

문서 자체에 대한 인용 정보를 문서 front matter의 CSL YAML로 지정합니다.

지원되는 옵션에 대한 자세한 내용은 Citation Metadata를 참조하세요.

언어

lang

IETF 언어 태그( BCP 47 표준 준수)를 사용해 문서의 기본 언어를 식별합니다. 예: en, en-GB. Language subtag lookup 도구로 태그를 조회하거나 검증할 수 있습니다.

이 설정은 대부분의 형식에 영향을 주며, LaTeX(PDF 출력의 경우 babelpolyglossia) 또는 ConTeXt를 사용할 때 줄바꿈(하이픈화)을 제어합니다.

language

사용자 정의 언어 번역이 포함된 YAML 파일입니다.

dir

문서의 기본 문자 방향입니다(rtl 또는 ltr).

양방향 문서의 경우 dir 속성이 있는 pandoc 기본 spandiv를 사용해 일부 출력 형식에서 기본 방향을 재정의할 수 있습니다. 최종 렌더러(예: HTML 생성 시 브라우저)가 [Unicode Bidirectional Algorithm]을 지원한다면 항상 필요하지는 않을 수 있습니다.

LaTeX에서 양방향 문서를 사용할 때는 xelatex 엔진만 완전히 지원됩니다 (--pdf-engine=xelatex 사용).

포함

include-before-body

문서 본문의 시작 부분(예: HTML의 <body> 태그 뒤, 또는 LaTeX의 \begin{document} 명령 뒤)에 내용을 포함합니다.

키가 “file”인 객체 또는 문자열 값은 포함할 내용이 들어 있는 파일 이름을 의미합니다.

키가 “text”인 객체는 포함할 텍스트 콘텐츠를 의미합니다.

include-after-body

마크다운 콘텐츠 바로 뒤, 문서 본문의 끝부분에 내용을 포함합니다. HTML의 닫는 </body> 태그와 LaTeX의 \end{document} 명령 앞에 포함되지만, 이 옵션은 마크다운 콘텐츠의 끝을 의미합니다.

키가 “file”인 객체 또는 문자열 값은 포함할 내용이 들어 있는 파일 이름을 의미합니다.

키가 “text”인 객체는 포함할 텍스트 콘텐츠를 의미합니다.

include-in-header

헤더의 끝에 내용을 포함합니다. 예를 들어 HTML 문서에 특수한 CSS 또는 JavaScript를 포함하는 데 사용할 수 있습니다.

키가 “file”인 객체 또는 문자열 값은 포함할 내용이 들어 있는 파일 이름을 의미합니다.

키가 “text”인 객체는 포함할 텍스트 콘텐츠를 의미합니다.

metadata-files

제공된 YAML(또는 JSON) 파일에서 메타데이터를 읽습니다. 이 옵션은 모든 입력 형식에서 사용할 수 있지만, YAML 파일의 문자열 스칼라는 항상 마크다운으로 파싱됩니다. 일반적으로 입력은 YAML 메타데이터 블록에서와 동일하게 처리됩니다. 목록에서 나중에 지정된 파일의 값이 앞서 지정된 파일의 값보다 우선합니다. 문서 내부에서 지정하거나 -M을 사용해 지정한 메타데이터 값은 이 옵션으로 지정된 값을 덮어씁니다.

메타데이터

keywords

문서 메타데이터에 포함할 키워드 목록입니다.

subject

문서 주제

title-meta

문서의 제목 메타데이터를 설정합니다.

author-meta

문서의 저자 메타데이터를 설정합니다.

date-meta

문서의 날짜 메타데이터를 설정합니다.

렌더링

from

읽을 형식입니다. 형식 이름 뒤에 +EXTENSION 또는 -EXTENSION을 붙여 확장을 개별적으로 활성화하거나 비활성화할 수 있습니다(예: markdown+emoji).

output-file

작성할 출력 파일

output-ext

생성된 출력 파일에 사용할 확장자

template

생성된 문서에 사용할 사용자 정의 템플릿 파일을 지정합니다.

template-partials

생성된 콘텐츠에 대해 템플릿에서 접근 가능한 partial로 지정된 파일을 포함합니다.

filters

입력이 파싱된 뒤 출력이 작성되기 전에 pandoc AST를 변환하는 필터로 사용할 실행 파일 또는 Lua 스크립트를 지정합니다.

shortcodes

숏코드 처리기를 구현하는 Lua 스크립트를 지정합니다.

keep-md

코드 실행으로 생성된 markdown 파일을 유지합니다.

keep-ipynb

코드 실행으로 생성된 노트북 파일을 유지합니다.

ipynb-filters

ipynb 파일을 markdown으로 렌더링하기 전에 전처리하는 필터입니다.

ipynb-shell-interactivity

어떤 노드를 대화형으로 실행할지(표현식 출력 표시) 지정합니다.

plotly-connected

true이면 “notebook_connected” plotly 렌더러를 사용하며, 이 렌더러는 CDN에서 종속성을 다운로드하므로 보려면 인터넷 연결이 필요합니다.

keep-tex

렌더링 중 사용된 중간 tex 파일을 유지합니다.

extract-media

원본 문서에 포함되거나 연결된 이미지 및 기타 미디어를 DIR 경로로 추출합니다. 필요한 경우 디렉터리를 생성하고, 문서의 이미지 참조가 추출된 파일을 가리키도록 조정합니다. 미디어는 다운로드되거나 파일 시스템에서 읽히거나, 필요에 따라 바이너리 컨테이너(예: docx)에서 추출됩니다. 원래의 파일 경로가 상대 경로이면서 …을 포함하지 않는 경우 해당 경로를 사용합니다. 그 외에는 콘텐츠의 SHA1 해시를 기반으로 파일 이름이 생성됩니다.

resource-path

이미지 및 기타 리소스를 검색할 경로 목록입니다.

default-image-extension

이미지 경로/URL에 확장자가 없을 때 사용할 기본 확장자를 지정합니다. 이렇게 하면 서로 다른 종류의 이미지가 필요한 형식에서 동일한 소스를 사용할 수 있습니다. 현재 이 옵션은 Markdown 및 LaTeX 리더에만 영향을 줍니다.

abbreviations

한 줄에 하나씩 약어를 적은 사용자 정의 약어 파일을 지정합니다. 이 목록은 Markdown 입력을 읽을 때 사용됩니다. 목록에서 발견된 문자열 뒤에는 줄바꿈 방지 공백이 추가되며, 마침표는 LaTeX와 같은 형식에서 문장 끝 공백을 생성하지 않습니다. 문자열에는 공백을 포함할 수 없습니다.

dpi

픽셀을 인치/센티미터로 변환하거나 그 반대로 변환할 때 사용할 기본 dpi(인치당 도트) 값을 지정합니다(엄밀히는 ppi: inch당 픽셀). 기본값은 96입니다. 이미지에 dpi 정보가 내부적으로 포함되어 있으면 이 옵션에 지정된 기본값 대신 인코딩된 값을 사용합니다.

html-table-processing

none이면 HTML 입력의 표를 처리하지 않습니다.

use-rsvg-convert

true이면 rsvg-convert를 사용해 SVG 이미지를 PDF로 변환하려고 시도합니다.

Latexmk

latex-auto-mk

Quarto의 내장 PDF 렌더링 래퍼를 사용합니다(누락된 LaTeX 패키지 자동 설치 지원 포함).

latex-auto-install

LaTeX 패키지 자동 설치를 활성화/비활성화합니다.

latex-min-runs

컴파일 최소 패스 수입니다.

latex-max-runs

컴파일 최대 패스 수입니다.

latex-clean

컴파일 후 중간 파일을 정리합니다.

latex-makeindex

makeindex에 사용할 프로그램입니다.

latex-makeindex-opts

makeindex의 명령줄 옵션 배열입니다.

latex-tlmgr-opts

tlmgr의 명령줄 옵션 배열입니다.

latex-output-dir

중간 파일 및 PDF의 출력 디렉터리입니다.

latex-tinytex

false로 설정하면 TinyTex 설치본을 사용한 PDF 컴파일을 방지합니다.

latex-input-paths

LaTeX가 입력을 찾을 경로 배열입니다.

텍스트 출력

ascii

출력에 ASCII 문자만 사용합니다. 현재 XML 및 HTML 형식(이 옵션 선택 시 UTF-8 대신 엔티티 사용), CommonMark, gfm, Markdown(엔티티 사용), roff ms(16진수 이스케이프 사용), 그리고 제한적으로 LaTeX(가능한 경우 표준 명령으로 악센트 문자 처리)에서 지원됩니다. roff man 출력은 기본적으로 ASCII를 사용합니다.