Quarto 1.6 – Quarto

Quarto 1.6이 공식 출시되었습니다! 최신 버전은 다운로드 페이지에서 확인하세요.

이번 릴리스에서 특히 주목할 변화는 다음과 같습니다:

brand.yml 지원 – 조직의 브랜드/스타일을 하나의 YAML 파일로 정의하고 여러 포맷에서 일관되게 적용합니다.
RevealJS 업데이트 – 스크롤 모드와 슬라이드 바로 이동 같은 새로운 탐색 기능이 포함됩니다.
콘텐츠를 다른 위치로 옮기는 contents 쇼트코드.
landscape 블록으로 가로 방향 페이지에 콘텐츠 배치.
코드 블록에서 생성한 하위 플로트를 더 쉽게 인식하도록 개선된 상호 참조.

아래 섹션에서 이들 새 기능과 일부 파괴적 변경을 설명하며, 전체 변경사항은 릴리스 노트에서 확인하세요.

brand.yml로 포맷 간 테마 통합

brand.yml은 Quarto 밖의 Posit 프로젝트로, 단순한 YAML 파일로 브랜드 정보를 정의합니다. Quarto는 brand.yml을 주요 채택자로, html, dashboard, typst, revealjs 포맷에서 브랜드 테마 출력물을 지원합니다.

예시로 아래 _brand.yml 파일을 살펴보겠습니다.

_brand.yml

color:
  palette:
    dark-grey: "#222222"
    blue: "#ddeaf1"
  background: blue
  foreground: dark-grey
  primary: black

logo: 
  medium: logo.png

typography:
  fonts:
    - family: Jura
      source: google
  base: Jura
  headings: Jura

이 _brand.yml을 프로젝트에 추가하면 웹페이지, 프레젠테이션, PDF 보고서, 대시보드가 모두 동일한 외관을 공유합니다.

Webpage: html

Dashboard dashboard

Presentation: revealjs

PDF: typst

예제 보기: 소스 | 라이브 사이트

Quarto에서 브랜드를 정의하는 방법은 브랜드 안내서에서 읽어보세요.

RevealJS 업데이트

Quarto v1.6은 RevealJS를 v5.1.0으로 업데이트합니다. 함께 제공되는 두 가지 주목할 기능은 다음과 같습니다:

Jump to Slide: 슬라이드를 빠르게 이동합니다. G를 눌러 활성화하고 번호나 ID를 입력한 뒤 Enter/Return을 누르세요.

Scroll Mode: 클릭 대신 스크롤로 슬라이드를 넘깁니다. R를 누르거나 URL에 ?view=scroll을 추가하거나 네비게이션 메뉴에서 활성화하세요. 작은 화면에서는 자동으로 작동합니다.

contents 쇼트코드

contents 쇼트코드는 문서 한 곳에서 콘텐츠를 생성하고 다른 위치에서 표시할 수 있게 해줍니다. 예를 들어, 코드 셀에서 플롯을 만들고

```{python}
#| echo: false
#| label: a-cell
import matplotlib.pyplot as plt
plt.plot([1,2,3])
```

다음처럼 contents 쇼트코드로 해당 플롯을 콜아웃 안에서 표시할 수 있습니다:

::: callout-note
## 아래 플롯을 참고하세요

{{< contents a-cell >}}

:::

contents 쇼트코드의 자세한 사용법은 contents 쇼트코드 안내서를 참고하세요.

landscape 모드

pdf, docx, typst 포맷에서는 landscape 블록에 콘텐츠를 넣어 가로 방향 페이지를 만들 수 있습니다:

::: {.landscape}

이 영역은 가로 페이지에 표시됩니다.

:::

상호 참조 개선

코드 셀에서 생성한 하위 플로트(하위 표, 하위 그림 등)를 Quarto가 더 쉽게 인식하도록 개선했습니다. 코드 셀의 subcap 속성에 출력 개수만큼 항목을 나열하면 그 내용이 하위 플로트로 처리됩니다. 자세한 사항은 #10328을 확인하세요.

간단한 예시:

```{{r}}
#| label: tbl-example
#| tbl-cap: I want these images to be interpreted as Tables.
#| tbl-subcap:
#|   - This is the subcaption for the first subtable
#|   - This is the subcaption for the second subtable
plot(1:10)
plot(11:20)
```

'표 1'이라는 캡션이 있고 각 플롯은 '(a)', '(b)'로 시작하는 캡션을 갖춘 문서 스크린샷. — 위 코드 셀을 HTML로 실행한 결과 이미지

파괴적 변경

Quarto는 되도록 이전 버전과 호환되도록 노력하지만, 이번 릴리스에서는 일부 사용자가 영향을 받을 수 있는 파괴적 변경이 두 가지 있습니다.

TypeScript(*.ts) 파일이 pre- 또는 post-render 스크립트나 quarto run에서 Deno 표준 라이브러리를 가져오는 경우

import 구문이 변경되었습니다. 필요한 변경 사항은 Deno 스크립트를 참고하세요.
LaTeX graphics.tex partial을 재정의하거나 해당 partial을 사용하지 않는 완전한 커스텀 템플릿을 사용하는 경우

Pandoc 변경으로 인해 일부 이미지가 \pandocbounded로 감싸지게 되었습니다. 따라서 graphics.tex partial이나 템플릿에 \pandocbounded 정의가 필요합니다. graphics.tex 소스에서 변경 내용을 참고하고, Pandoc 커밋 26b25a4에서 upstream 정보를 확인하세요.

감사 인사

이 릴리스에 이슈와 PR로 기여해주신 모든 분께 감사드립니다:

ArthurData, Blake-Madden, Coding4Sec, EricMarcon, Fgazzelloni, GeorgRamer, Gewerd-Strauss, GuillaumeDehaene, HarunCelikOtto, IULibScholComm, IndrajeetPatil, LeoLuongVuong, MarcellGranat, Mavoort, Nenuial, PeteArm, ShixiangWang, Steinthal, Walser52, Xinenomine, abbyruthe, aborruso, adamblake, albert-ying, alecloudenback, allefeld, aronatkins, arthur-shaw, astrowonk, avras, baker-jr-john, bcm0, blackerby, boshek, brandonmontez, brianmsm, bryanhanson, carschandler, castedo, chaz-clark, christopherkenny, coatless, d-morrison, danieltomasz, daxkellie, ddlawton, debruine, dsbitor, e-miz, eculler, edavidaja, edvinsyk, eitsupi, ethanwhite, fermarsan, floesche, fradav, fredguth, gadenbuie, georgestagg, github-actions[bot], halleysfifthinc, hamelsmu, hansfn, harrylojames, hodgesmr, holtzy, hugetim, hurak, iagopinal, isabelizimm, itsmevictor, jameslairdsmith, javajon, jchiquet, jdfoote, jido, jimjam-slam, jkrumbiegel, jmgirard, jmhammond, joelostblom, johannes-menzel, juliantao, jvcarli, kazuyanagimoto, kbvernon, kdheepak, kjohnsen, lballabio, leovan, loneguardian, longapalooza, lucacasonato, lukmanaj, lwjohnst86, machow, maelle, masud90, melaniewalsh, mfisher87, mipmip, mitzimorris, mpr1255, nessan, neuwirthe, nichtich, njericha, nsarang, olivroy, ozanozbeker, paciorek, pagiraud, parmsam, pedrohbraga, peteole, produnis, raffaem, ryarazi, ryjohnson09, s2t2, salim-b, samlalwani, sgelzenleuchter, skriptum, snhansen, stragu, sun123zxy, sverrirarnors, topepo, truecluster, tylere, winniehell, xtimbeau, yogabonito, yurivict, yves-amevoin.

이 게시물의 목록/소셜 카드 이미지에 등장하는 팔레트 이모지는 오픈소스 이모지 프로젝트 OpenMoji에서 가져온 것입니다. 라이선스: CC BY-SA 4.0