Dashboard 옵션
형식
다음 문서 및 형식 옵션은 대시보드 전용이거나 대시보드에서 특별한 동작을 합니다.
| 옵션 | 설명 |
|---|---|
title |
제목(내비게이션 바 왼쪽 상단에 표시) |
author |
작성자(제목 옆에 작은 글꼴로 표시) |
logo |
로고(내비게이션 바에서 제목 왼쪽에 표시) |
orientation |
rows 또는 columns(기본값: rows) |
scrolling |
채우기 레이아웃 대신 스크롤 사용 여부(기본값: false) |
expandable |
카드 콘텐츠 확장 가능 여부(기본값: true) |
theme |
대시보드 테마(내장 또는 사용자 정의 scss) |
nav-buttons |
내비게이션 바 오른쪽에 표시할 버튼. linkedin, facebook, reddit, twitter, github 또는 사용자 정의 Nav Item를 사용합니다. |
예:
---
title: "Dashboard"
author: "Acme, Inc."
logo: images/acme.png
format:
dashboard:
theme: default
orientation: rows
expandable: true
scrolling: false
nav-buttons:
- reddit
- icon: gitlab
href: https://gitlab.com/
---페이지
페이지는 전역 orientation과 다른 사용자 지정 orientation을 지정할 수 있습니다.
| 옵션 | 설명 |
|---|---|
orientation |
rows 또는 columns(기본값: 전역 orientation) |
scrolling |
true 또는 false(기본값: 전역 scrolling) |
예:
---
title: "Dashboard"
format: dashboard
---
# Plots {orientation="columns" scrolling="true"}사이드바
사이드바는 .sidebar 속성을 1단계 헤딩(전역 사이드바) 또는 2단계 헤딩(페이지 수준 사이드바)에 적용해 생성합니다.
| 클래스 | 설명 |
|---|---|
.sidebar |
콘텐츠를 사이드바로 배치합니다 |
예:
---
title: "Dashboard"
format: dashboard
---
# Plots {.sidebar}행과 열
행과 열은 레이아웃과 크기 동작을 사용자 지정하는 옵션을 지원합니다. 다음 클래스는 레이아웃 동작을 변경하는 데 사용할 수 있습니다.
| 클래스 | 설명 |
|---|---|
.tabset |
콘텐츠를 탭셋으로 배치합니다 |
.fill |
콘텐츠가 사용 가능한 레이아웃 공간을 채웁니다 |
.flow |
콘텐츠가 자연스러운 크기로 흐르도록 합니다 |
대부분의 대시보드에서는 .fill과 .flow가 카드 콘텐츠에 따라 자동으로 결정되며 수동 지정이 필요하지 않습니다.
다음 속성은 명시적인 크기 지정에 사용할 수 있습니다.
| 옵션 | 설명 |
|---|---|
width |
백분율 또는 절대 픽셀 너비(기본값은 행의 요소에 공간을 균등 분배) |
height |
백분율 또는 절대 픽셀 높이(기본값은 열의 요소에 공간을 균등 분배) |
예:
---
title: "Dashboard"
format: dashboard
---
## Row {height="65%"}
## Row {height="35%"}일부 구성 요소에만 width 또는 height가 명시되어 있으면 나머지 공간은 지정되지 않은 요소에 균등하게 분배됩니다.
카드
카드 옵션으로 제목과 다양한 레이아웃 동작을 지정할 수 있습니다.
| 옵션 | 설명 |
|---|---|
title |
카드 헤더에 표시되는 제목 |
padding |
카드 콘텐츠 주변 여백(기본값: 8px) |
expandable |
카드 콘텐츠 확장 가능 여부(기본값: true) |
width |
백분율 또는 절대 픽셀 너비(기본값은 행의 요소에 공간을 균등 분배) |
height |
백분율 또는 절대 픽셀 높이(기본값은 열의 요소에 공간을 균등 분배) |
fill |
카드가 컨테이너를 채울지 또는 콘텐츠 높이에 맞춰 ’flow’할지 여부(기본값은 카드 콘텐츠에 따라 Quarto가 결정) |
예:
```{python}
#| title: "Life Expectancy"
#| padding: 3px
#| expandable: false
#| width: 70%
```이 옵션들은 .card div에도 동일하게 적용할 수 있습니다. 예:
::: {.card title="Life Expectancy" padding="3px"}
This is the content.
:::값 상자
값 상자는 다음 옵션을 지원합니다.
| 옵션 | 설명 |
|---|---|
title |
값 위에 표시되는 제목 |
icon |
bootstrap icons의 아이콘 식별자 |
color |
배경색(모든 CSS 색상 또는 테마별 색상 별칭 사용 가능, 아래 참고) |
value |
주요 표시 값 |
color에 사용할 수 있는 테마별 별칭은 다음과 같습니다.
| 색상 별칭 | 기본 테마 색상 |
|---|---|
primary |
파랑 |
secondary |
회색 |
success |
초록 |
info |
밝은 파랑 |
warning |
노랑/주황 |
danger |
빨강 |
light |
연한 회색 |
dark |
검정 |
값 상자 옵션은 셀 옵션으로 지정하거나 dict()(Python) 또는 list()(R) 출력으로 지정할 수 있습니다(옵션이 동적이어야 할 때 유용). 자세한 내용은 값 상자 구성 요소 문서를 참고하세요.
제목 및 저자
title |
문서 제목 |
subtitle |
문서의 부제목을 지정합니다. |
date |
문서 날짜 |
date-format |
문서의 날짜 형식 |
author |
문서의 저자 |
order |
웹사이트 자동 사이드바 메뉴에 포함될 때 사용할 문서 순서입니다. |
대시보드
logo |
로고 이미지(내비게이션 바 왼쪽에 배치) |
orientation |
대시보드 콘텐츠의 기본 방향입니다(기본값 |
scrolling |
채우기 레이아웃 대신 스크롤을 사용합니다(기본값: |
expandable |
카드 콘텐츠를 확장 가능하게 합니다(기본값: |
nav-buttons |
대시보드 내비게이션 바에 표시할 링크 |
형식 옵션
brand |
이 문서에 사용할 브랜딩 정보입니다. 문자열이면 브랜드 파일의 경로입니다. false이면 이 문서에 브랜딩을 사용하지 않습니다. 객체이면 인라인 브랜드 정의이거나, 밝은/어두운 브랜드 경로 또는 정의를 가진 객체입니다. |
theme |
테마 이름, 테마 scss 파일, 또는 둘의 조합입니다. |
css |
CSS 스타일시트 하나 이상입니다. |
identifier-prefix |
HTML 및 DocBook 출력의 모든 식별자와 내부 링크, Markdown 및 Haddock 출력의 각주 번호에 접두사를 추가합니다. 다른 페이지에 포함될 조각을 생성할 때 중복 식별자를 방지하는 데 유용합니다. |
email-obfuscation |
HTML 문서에서
|
html-q-tags |
HTML에서 인용에 |
quarto-required |
이 문서 또는 프로젝트에서 지원되는 quarto 버전을 설명하는 semver 범위입니다. 예시:
|
목차
toc |
출력 문서에 자동 생성된 목차를 포함합니다(또는
|
toc-depth |
목차에 포함할 섹션 레벨 수를 지정합니다. 기본값은 3입니다. |
번호 매기기
number-sections |
출력에 렌더링된 섹션 제목에 번호를 매깁니다. 기본적으로 섹션은 번호가 매겨지지 않습니다. 클래스가 |
number-depth |
기본적으로 문서의 모든 제목은 번호가 매겨진 섹션을 만듭니다. 예를 들어 장(chapter) 바로 아래 수준의 섹션에만 번호를 매기려면 다음과 같이 지정합니다: |
number-offset |
출력에서 섹션 제목 번호의 오프셋입니다(기본값은 0). 첫 번째 숫자는 최상위 제목의 번호에, 두 번째는 2단계 제목에 더해지는 식으로 적용됩니다. 예를 들어 문서의 첫 최상위 제목 번호를 “6”으로 하려면 |
shift-heading-level-by |
제목 레벨을 양수 또는 음수 정수만큼 이동합니다. 예를 들어 |
레이아웃
cap-location |
그림 및 표 캡션을 배치할 위치입니다( |
fig-cap-location |
그림 캡션을 배치할 위치입니다( |
tbl-cap-location |
표 캡션을 배치할 위치입니다( |
classoption |
LaTeX/PDF 출력에서 문서 클래스에 설정할 옵션입니다. KaTeX를 사용하는 HTML 출력의 경우 |
grid |
Quarto HTML 페이지를 레이아웃하는 데 사용하는 그리드 시스템의 속성입니다. |
max-width |
body 요소에 CSS |
margin-left |
HTML 출력의 경우 Body 요소에 LaTeX 출력의 경우 ConTeXt 출력의 경우
|
margin-right |
HTML 출력의 경우 Body 요소에 LaTeX 출력의 경우 ConTeXt 출력의 경우
|
margin-top |
HTML 출력의 경우 Body 요소에 LaTeX 출력의 경우 ConTeXt 출력의 경우
|
margin-bottom |
HTML 출력의 경우 Body 요소에 LaTeX 출력의 경우 ConTeXt 출력의 경우
|
코드
code-fold |
코드를 HTML
|
code-summary |
|
code-overflow |
코드 줄이 컨테이너보다 넓을 때 오버플로 처리 방식을 선택합니다.
|
code-line-numbers |
코드 블록 출력에 줄 번호를 포함합니다( revealjs 출력에서만 특정 줄을 강조 표시하거나(또는 강조 단계 간 애니메이션을) 문자열로 지정할 수 있습니다.
|
code-copy |
코드 블록에 코드 복사 아이콘을 활성화합니다.
|
code-link |
코드 블록 내 함수에 온라인 문서로의 하이퍼링크를 활성화합니다. 코드 링크는 현재 knitr 엔진에서만(downlit 패키지 통해) 구현됩니다. downlit의 제한으로 |
code-annotations |
코드 주석을 표시할 때 사용할 스타일입니다. 이 값을 false로 설정하면 코드 주석을 숨깁니다. |
highlight-style |
하이라이트된 소스 코드에 사용할 색상 스타일을 지정합니다. STYLE 이름 대신 확장자가 |
syntax-definitions |
KDE 언어 구문 정의 파일(XML) |
indented-code-classes |
모든 들여쓰기 코드 블록에 사용할 클래스를 지정합니다. |
실행
실행 옵션은 execute 키 아래에 지정해야 합니다. 예:
execute:
echo: false
warning: falseeval |
코드 셀을 실행합니다(
|
echo |
렌더링된 출력에 셀 소스 코드를 포함합니다.
|
output |
코드 실행 결과를 출력에 포함합니다. 가능한 값:
|
warning |
렌더링된 출력에 경고를 포함합니다. |
error |
출력에 오류를 포함합니다(이는 코드 실행 오류가 문서 처리를 중단하지 않음을 의미합니다). |
include |
어떤 출력(코드 또는 결과)도 출력에 포함되지 않도록 하는 포괄 옵션입니다. |
cache |
계산 결과를 캐시합니다(R 문서에는 knitr cache를, Jupyter 문서에는 Jupyter Cache를 사용). 캐시 무효화는 청크 소스 코드 변경 (또는 정의한 다른 캐시 속성 변경)으로 트리거됩니다.
|
freeze |
렌더링 시 이전 계산 출력의 재사용을 제어합니다.
|
그림
fig-align |
그림의 가로 정렬( |
fig-cap-location |
그림 캡션을 배치할 위치입니다( |
fig-width |
Matplotlib 또는 R 그래픽으로 생성된 그림의 기본 너비입니다. Jupyter 엔진에서는 이 옵션이 셀 수준에서 제공될 때 효과가 없으며 문서 또는 프로젝트 메타데이터로만 제공할 수 있습니다. |
fig-height |
Matplotlib 또는 R 그래픽으로 생성된 그림의 기본 높이입니다. Jupyter 엔진에서는 이 옵션이 셀 수준에서 제공될 때 효과가 없으며 문서 또는 프로젝트 메타데이터로만 제공할 수 있습니다. |
fig-format |
Matplotlib 또는 R 그래픽으로 생성된 그림의 기본 형식( |
fig-dpi |
Matplotlib 또는 R 그래픽으로 생성된 그림의 기본 DPI입니다. Jupyter 엔진에서는 이 옵션이 셀 수준에서 제공될 때 효과가 없으며 문서 또는 프로젝트 메타데이터로만 제공할 수 있습니다. |
fig-asp |
그림의 종횡비, 즉 높이/너비 비율입니다.
|
fig-responsive |
이 문서의 이미지를 반응형으로 만들지 여부입니다. |
표
tbl-colwidths |
일부 형식(예: HTML)은 표 열 너비를 자동으로 잘 조정하므로 명시적 열 너비 지정의 효과가 크지 않습니다. 다른 형식(예: LaTeX)은 긴 셀 콘텐츠를 올바르게 흐르게 하려면 열 크기가 필요합니다(이 때문에 72열을 넘는 표에는 Pandoc이 명시적 너비를 지정합니다). 다음과 같이 지정할 수 있습니다:
|
tbl-cap-location |
표 캡션을 배치할 위치입니다( |
df-print |
Knitr 엔진 문서에서 표를 출력하는 데 사용하는 방법입니다:
기본 출력 방식은 |
참고문헌
bibliography |
문서 참고문헌(BibTeX 또는 CSL). 단일 파일 또는 파일 목록일 수 있습니다. |
csl |
참고문헌 서식에 사용할 Citation Style Language 파일입니다. |
citations-hover |
인용 위에 마우스를 올리면 참고문헌 정보를 보여주는 팝업을 활성화합니다. |
citeproc |
내장 인용 처리를 활성화합니다. 이 기능을 사용하려면 인용이 포함된 문서와 서지 데이터 소스가 필요합니다. 외부 참고문헌 파일 또는 문서의 YAML 메타데이터에 있는 |
citation-abbreviations |
|
각주
footnotes-hover |
각주에 마우스를 올리면 각주 내용을 보여주는 팝업을 활성화합니다. |
reference-location |
각주의 위치를 지정합니다.
|
상호 참조
crossref |
상호 참조 레이블과 접두사 설정입니다. 자세한 내용은 Cross-Reference Options을 참조하세요. |
crossrefs-hover |
상호 참조에 마우스를 올리면 참조 항목을 보여주는 팝업을 활성화합니다. |
인용
citation |
문서 자체에 대한 인용 정보를 문서 front matter의 CSL YAML로 지정합니다. 지원되는 옵션에 대한 자세한 내용은 Citation Metadata를 참조하세요. |
언어
lang |
IETF 언어 태그( BCP 47 표준 준수)를 사용해 문서의 기본 언어를 식별합니다. 예: 이 설정은 대부분의 형식에 영향을 주며, LaTeX(PDF 출력의 경우 |
language |
사용자 정의 언어 번역이 포함된 YAML 파일입니다. |
dir |
문서의 기본 문자 방향입니다( 양방향 문서의 경우 LaTeX에서 양방향 문서를 사용할 때는 |
포함
include-before-body |
문서 본문의 시작 부분(예: HTML의 키가 “file”인 객체 또는 문자열 값은 포함할 내용이 들어 있는 파일 이름을 의미합니다. 키가 “text”인 객체는 포함할 텍스트 콘텐츠를 의미합니다. |
include-after-body |
마크다운 콘텐츠 바로 뒤, 문서 본문의 끝부분에 내용을 포함합니다. HTML의 닫는 키가 “file”인 객체 또는 문자열 값은 포함할 내용이 들어 있는 파일 이름을 의미합니다. 키가 “text”인 객체는 포함할 텍스트 콘텐츠를 의미합니다. |
include-in-header |
헤더의 끝에 내용을 포함합니다. 예를 들어 HTML 문서에 특수한 CSS 또는 JavaScript를 포함하는 데 사용할 수 있습니다. 키가 “file”인 객체 또는 문자열 값은 포함할 내용이 들어 있는 파일 이름을 의미합니다. 키가 “text”인 객체는 포함할 텍스트 콘텐츠를 의미합니다. |
resources |
이 문서와 함께 배포할 파일의 경로(또는 glob)입니다. |
metadata-files |
제공된 YAML(또는 JSON) 파일에서 메타데이터를 읽습니다. 이 옵션은 모든 입력 형식에서 사용할 수 있지만, YAML 파일의 문자열 스칼라는 항상 마크다운으로 파싱됩니다. 일반적으로 입력은 YAML 메타데이터 블록에서와 동일하게 처리됩니다. 목록에서 나중에 지정된 파일의 값이 앞서 지정된 파일의 값보다 우선합니다. 문서 내부에서 지정하거나 |
메타데이터
keywords |
문서 메타데이터에 포함할 키워드 목록입니다. |
pagetitle |
문서의 제목 메타데이터를 설정합니다. |
title-prefix |
HTML 헤더에 표시되는 제목 앞에 문자열을 접두사로 지정합니다(본문 시작에 표시되는 제목에는 적용되지 않음). |
description-meta |
문서의 설명 메타데이터를 설정합니다. |
author-meta |
문서의 저자 메타데이터를 설정합니다. |
date-meta |
문서의 날짜 메타데이터를 설정합니다. |
렌더링
from |
읽을 형식입니다. 형식 이름 뒤에 +EXTENSION 또는 -EXTENSION을 붙여 확장을 개별적으로 활성화하거나 비활성화할 수 있습니다(예: markdown+emoji). |
output-file |
작성할 출력 파일 |
output-ext |
생성된 출력 파일에 사용할 확장자 |
template |
생성된 문서에 사용할 사용자 정의 템플릿 파일을 지정합니다. |
template-partials |
생성된 콘텐츠에 대해 템플릿에서 접근 가능한 partial로 지정된 파일을 포함합니다. |
embed-resources |
외부 의존성 없이 독립형 HTML 파일을 생성합니다. |
self-contained-math |
|
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에서 종속성을 다운로드하므로 보려면 인터넷 연결이 필요합니다. |
extract-media |
원본 문서에 포함되거나 연결된 이미지 및 기타 미디어를 DIR 경로로 추출합니다. 필요한 경우 디렉터리를 생성하고, 문서의 이미지 참조가 추출된 파일을 가리키도록 조정합니다. 미디어는 다운로드되거나 파일 시스템에서 읽히거나, 필요에 따라 바이너리 컨테이너(예: docx)에서 추출됩니다. 원래의 파일 경로가 상대 경로이면서 …을 포함하지 않는 경우 해당 경로를 사용합니다. 그 외에는 콘텐츠의 SHA1 해시를 기반으로 파일 이름이 생성됩니다. |
resource-path |
이미지 및 기타 리소스를 검색할 경로 목록입니다. |
default-image-extension |
이미지 경로/URL에 확장자가 없을 때 사용할 기본 확장자를 지정합니다. 이렇게 하면 서로 다른 종류의 이미지가 필요한 형식에서 동일한 소스를 사용할 수 있습니다. 현재 이 옵션은 Markdown 및 LaTeX 리더에만 영향을 줍니다. |
abbreviations |
한 줄에 하나씩 약어를 적은 사용자 정의 약어 파일을 지정합니다. 이 목록은 Markdown 입력을 읽을 때 사용됩니다. 목록에서 발견된 문자열 뒤에는 줄바꿈 방지 공백이 추가되며, 마침표는 LaTeX와 같은 형식에서 문장 끝 공백을 생성하지 않습니다. 문자열에는 공백을 포함할 수 없습니다. |
dpi |
픽셀을 인치/센티미터로 변환하거나 그 반대로 변환할 때 사용할 기본 dpi(인치당 도트) 값을 지정합니다(엄밀히는 ppi: inch당 픽셀). 기본값은 |
html-table-processing |
|
텍스트 출력
strip-comments |
마크다운 소스의 HTML 주석을 제거하고, 이를 마크다운/텍스타일/HTML 출력으로 원시 HTML로 전달하지 않습니다. |
ascii |
출력에 ASCII 문자만 사용합니다. 현재 XML 및 HTML 형식(이 옵션 선택 시 UTF-8 대신 엔티티 사용), CommonMark, gfm, Markdown(엔티티 사용), roff ms(16진수 이스케이프 사용), 그리고 제한적으로 LaTeX(가능한 경우 표준 명령으로 악센트 문자 처리)에서 지원됩니다. roff man 출력은 기본적으로 ASCII를 사용합니다. |