RStudio IDE

개요

RStudio v2022.07 이상 버전에는 Quarto 문서를 편집하고 미리보기할 수 있는 지원이 포함되어 있습니다(아래 문서는 이 빌드 또는 이후 버전을 사용한다고 가정합니다).

RStudio에서 Quarto를 사용한다면 RStudio의 최신 릴리스를 사용하는 것을 강력히 권장합니다.

RStudio는 https://posit.co/download/rstudio-desktop/에서 다운로드할 수 있습니다.

Creating Documents

새 Quarto 문서를 만들려면 File : New File : Quarto Document… 명령을 사용하세요:

The 'New Quarto Document' dialog menu in RStudio.

Render and Preview

문서를 편집하면서 미리보려면 Render 버튼을 사용하세요:

The top section of a qmd file as displayed in RStudio. There is a toolbar right above the document containing various options, including 'Render.' There is a stylized, segmented blue arrow pointing at the word.

저장할 때마다 자동으로 렌더링하고 싶다면 편집기 도구 모음의 Render on Save 옵션을 선택하면 됩니다.

미리보기는 편집기 옆에 표시됩니다:

An RStudio window. On the left half of the page is a Quarto document and the 'Jobs' pane open underneath that. There is messages in green text in the 'Jobs' pane that say: 'Watching files for changes. Browse at http://localhost:4064'. On the right half of the window is the Quarto output of the document on the left, as rendered by Knitr.

문서를 다시 렌더링할 때마다 미리보기가 갱신됩니다. 나란히 미리보기는 HTML과 PDF 출력 모두에서 작동합니다.

Projects

Quarto 문서(또는 문서 모음)를 위한 새 프로젝트를 만들려면 File : New Project… 명령을 사용하고, New Directory를 지정한 다음 Quarto Project를 선택하세요:

이 UI로 기본 프로젝트뿐 아니라 웹사이트와 책도 만들 수 있습니다. git 저장소를 생성하고 프로젝트에 renv 환경을 초기화하는 옵션도 제공합니다.

비주얼 에디터

RStudio IDE에는 Quarto 마크다운용 비주얼 에디터가 포함되어 있으며, 표, 인용, 상호 참조, 각주, div/span, 정의 목록, 속성, raw HTML/TeX 등을 지원합니다.

자세한 내용은 RStudio에서 비주얼 에디터 사용 문서를 참고하세요.

Knitr 엔진

Quarto는 기존 R Markdown 문서와 높은 호환성을 갖도록 설계되었습니다. 일반적으로 기존 Rmd 문서를 변경 없이 Quarto로 렌더링할 수 있습니다.

R Markdown 문서와 Quarto 문서의 중요한 차이점 중 하나는 Quarto에서 청크 옵션을 보통 청크 시작 줄이 아니라 코드 청크 상단의 특수 주석에 포함한다는 점입니다. 예:

```{r}
#| echo: false
#| fig-cap: "Air Quality"

library(ggplot2)
ggplot(airquality, aes(Temp, Ozone)) + 
  geom_point() + 
  geom_smooth(method = "loess", se = FALSE)
```

Quarto는 fig-cap, fig-subcap, fig-alt 같은 긴 옵션을 더 잘 수용하고, 청크 메타데이터를 쉽게 편집할 수 없는 구조화된 에디터(예: 대부분의 전통적인 노트북 UI)에서 청크 옵션을 쉽게 편집할 수 있도록 이 방식을 사용합니다.

Note

원한다면 청크 옵션을 첫 줄에 포함할 수도 있습니다(예: ```{r, echo = FALSE}). 다만 실행 엔진 간 문서의 이식성과 일관성을 위해 주석 기반 문법을 권장합니다.

이 방식으로 포함된 청크 옵션은 YAML 프론트매터 옵션과의 일관성을 위해 R 문법이 아니라 YAML 문법을 사용합니다. 다만 옵션 값 앞에 !expr를 붙이면 R 코드를 사용할 수 있습니다. 예:

#| fig-cap: !expr 'paste("Air", "Quality")'

Caution

!expr 문법은 YAML “tag” 리터럴의 예이며 직관적이지 않을 수 있습니다. !expr 뒤에는 _단일 YAML “flow scalar”_가 와야 합니다. 큰따옴표/작은따옴표/무따옴표 문자열이 어떻게 동작하는지에 대한 자세한 내용은 YAML spec을 참고하세요.

Jupyter 엔진

RStudio에서 Jupyter 엔진을 대상으로 하는 Quarto 마크다운 문서로 작업할 수도 있습니다. 이런 파일은 보통 YAML 프론트매터에 사용할 커널을 지정하는 jupyter 옵션을 포함합니다. 예:

---
title: "Matplotlib Demo"
author: "Norah Smith"
jupyter: python3
---

가상 환경(venv)에서 작업하려면 File : New Project… 명령을 사용해 Jupyter 엔진과 venv를 지정하고, venv에 초기 설치할 패키지를 지정하세요.

RStudio는 프로젝트를 열 때 이 가상 환경을 자동으로 활성화합니다. 추가 Python 패키지는 RStudio Terminal 탭에서 설치할 수 있습니다. 예:

An RStudio terminal window. The prompt is prefixed by the word '(env)', indicating that this prompt is taking place in a Python virtual environment named 'env.' The first line is empty and the second line contains the command 'python3 -m pip install scikit-learn.'

YAML 인텔리전스

프로젝트 파일, YAML 프론트매터, 실행 셀 옵션에서 YAML 코드 자동 완성이 제공됩니다.

Quarto document with YAML being edited. Next to the cursor code completion helper is open showing YAML options beginning with the letters preceding the cursor ('to').

잘못된 YAML이 있으면 문서를 저장할 때도 강조 표시됩니다.

Quarto document YAML metadata with an incorrect option underlined in red.

R 패키지

RStudio를 사용하지 않거나 R 콘솔에서 렌더링하고 싶다면 quarto R 패키지를 사용할 수 있습니다. R 패키지 설치 방법:

install.packages("quarto")

문서를 렌더링하려면 다음을 사용하세요.

library(quarto)
quarto_render("document.qmd")

웹사이트(즉, 디렉터리 안의 모든 qmd를 웹사이트로 구성한 경우)를 렌더링하려면:

library(quarto)
quarto_render()

작업 중인 문서의 라이브 미리보기(저장 시 자동 렌더링 및 브라우저 새로 고침)를 하려면 quarto_preview() 함수를 사용하세요.

library(quarto)
quarto_preview("document.qmd")

웹사이트 또는 책 프로젝트를 작업 중이라면, 프로젝트 디렉터리에 대해 quarto_preview()를 사용할 수도 있습니다.

library(quarto)
quarto_preview()