1.3 릴리스 노트

이번 릴리스에서 수정됨

  • 목록(예: 블로그 게시물)에서 편집된 페이지를 다시 로드할 때 잘못된 미리보기 동작을 수정 (#6026)

이전 릴리스에서 수정됨

  • IDE에서 상호 참조 가능한 그림을 Quarto가 제대로 보고하지 못하던 문제 수정(Quarto 1.3.427에서 시도한 수정이 제대로 동작하지 않았으며, 이번 릴리스에 정상 동작 수정이 포함됨)
  • --to all 미리보기 동작 오류 수정
  • navbar 도구 템플릿의 rel="..." 값 처리 누락 수정 (#5756)
  • PDF 미리보기용 뷰어 리다이렉트에서 Cache-Control 헤더로 브라우저 캐시를 비활성화하여, 같은 포트에서 이후 HTML 미리보기가 정상 동작하도록 수정 (#5882)
  • 하위 폴더의 문서를 배포할 때 발생하는 오류 수정 (quarto-dev/quarto#183)
  • 하위 폴더의 문서를 배포할 때 발생하는 오류 수정 (#5330)
  • 사용자가 citeproc를 직접 활성화했을 때 중복 참고문헌이 생기던 문제 수정 (#5588)
  • 개별 페이지에 search: false를 지정해도 사이트 검색 인덱스에서 제외되지 않던 문제 수정
  • Knitr 1.43 업데이트 후 HTML Widgets가 있는 문서 렌더링 오류 수정 (#5702)
  • 여백 요소 위치를 올바르게 배치 (#5289)
  • macOS에서 크롬 감지 개선 (#2214)
  • 요청 시 책의 반응형 HTML 보기에서 섹션 번호를 올바르게 숨김 (#5306)
  • 목록 안의 그림을 올바르게 처리 (#5317, #5461)
  • 반응형 보기에서 배너 스타일 제목 블록을 숨기지 않도록 수정 (#5296)
  • LUA 필터에서 전역 환경을 사용할 수 있도록 보장 (#5466)
  • ’Theme’이라는 섹션이 있어도 RevealJS 내비게이션이 올바르게 동작하도록 수정 (#5455)

Confluence 배포

  • Atlassian Confluence 스페이스로 문서와 프로젝트를 배포하고 Confluence 페이지의 자식으로 배포하는 기능 추가

Jupyter 노트북

  • {{< embed >}}를 사용해 Quarto 문서에 셀 출력을 임베드하는 기능 추가. Id, Tag, label로 셀을 지정할 수 있으며 {{< embed mynotebook.ipynb#fig-output >}}처럼 label이 fig-output인 셀의 출력을 임베드할 수 있습니다. {{< embed mynotebook.ipynb#fig-output,tbl-out >}}처럼 id 목록도 지정 가능.
  • text/plain 출력이 비어있지 않을 때만 후처리하도록 변경 (#3896)
  • bokeh 플롯 출력에서 셀 개수가 올바르게 생성되도록 수정 (#2107)
  • 트리플 백틱(또는 그 이상)이 포함된 코드 셀 출력 문제 수정 (#3179)
  • Julia 1.8.4 이상에서 IJulia와 충돌하는 SIGCHLD 시그널 핸들러 설치를 하지 않음 (#2539)
  • QUARTO_PYTHON 바이너리의 전체 경로 해석
  • 노트북의 YAML 및 제목 처리 개선(YAML 프런트매터 기반 제목과 heading 기반 제목 자동 병합)
  • matplotlib, seaborn, plotnine 중간 객체를 출력에서 제거
  • IJulia의 miniconda python 환경에서 python3 외에 python도 검색 (#4821)
  • 새로운 nbdev 문법을 위한 셀 YAML 옵션 export: 허용 (#3152)
  • jupyternbclient 간 동작 차이를 완화하기 위해 여러 stream 출력 병합 (#4968)

Knitr 엔진

  • rmarkdown이 찾을 Pandoc 바이너리가 없을 때 Quarto에 포함된 pandoc을 찾도록 지원 (#3688)
  • 인라인 r 표현식만 있는 경우 knitr 엔진을 바인딩하지 않음 (#3908)
  • 플롯이 있는 청크에서 output: asis 문제 수정 (#3683)

코드 주석

HTML Format

  • callout 안에 있는 여백 참조 처리 개선 (#3003)
  • YAML 또는 SCSS로 그리드 열 기준 너비를 커스터마이즈할 수 있는 기능 추가. 자세한 내용은 https://www.quarto.org/docs/prerelease/1.3.html 참고.
  • 테이블 셀 내 긴 code 항목 줄바꿈 수정 (#3221)
  • 소속이 없어도 저자의 url을 사용하여 저자 표시 수정
  • 여러 형식을 생성할 때 다른 형식으로의 링크 지원(TOC에 대체 형식 표시). format-links로 제어
  • 임베디드 콘텐츠를 제공하는 원본 노트북 링크 지원. notebook-links로 제어
  • 단어 구분이 없는 긴 문자열에서 callout 줄바꿈 처리 개선
  • SQL 코드 셀에서 생성된 테이블에 오버플로우 적용 (#3497)
  • OJS 코드 셀에서 parquet 파일 지원 수정 (#3630)
  • 캡션에서 bootstrap 테이블 클래스를 테이블 요소로 전달 (#4036)
  • 이름과 캡션이 있는 코드 목록 렌더링을 올바르게 처리 (#2195)
  • 모바일 크기에서 toc-left 사용 시 요소 상호작용 문제 수정 (#4244)
  • HTML 문서에서 ‘cite as’ 부록을 appendix-cite-as로 제어( false, display, bibtex) (#2625)
  • 사용자 정의 부록 섹션에 올바른 앵커 적용 (#3112)
  • 사용자 정의 부록 섹션을 TOC에 표시하지 않음 (#3113)
  • 체크박스 정렬 지원을 위한 styles.html 템플릿 파셜 사용 (#4556)
  • HTML 출력에서 텍스트 하이라이팅 처리 개선(덮어쓰기 어려운 스타일을 출력하지 않고 테마 -> CSS 변환을 더 잘 지원) (#4334)
  • 중첩된 타이트/루스 목록의 CSS 개선 (#4560)
  • 테이블에서 Bootstrap 반응형 클래스 해석 수정 (#2997)
  • 계산/마크다운 테이블의 외관을 세밀하게 조정하고 스타일을 더 일관되게 적용
  • 헤더와 본문 텍스트의 외관을 세밀하게 조정
  • figcaption DOM 구조 오류 수정 (#5234)

Article Layout

  • 탭셋 안에 있는 여백 콘텐츠의 위치를 개선 (#3280)
  • 여백에 배치되는 각주가 있는 테이블 지원 개선 (#4324)

Revealjs Format

  • df-print: paged 테이블의 글꼴 크기 축소 (#3380)
  • widthheight의 퍼센트 값 지원을 올바르게 처리 (#4063)
  • 많은 항목이 있는 경우 .scrollable 환경에서 번호 목록 여백 개선 (#4283)
  • RevealJS 확장에 대한 scss import 지원 개선 (#3414)
  • 제목 슬라이드에서 저자 표시가 $presentation-title-slide-text-align scss 변수 커스터마이즈를 올바르게 적용 (#3843)
  • show-notes: separate-page 올바르게 지원 (#3996)
  • 가운데 정렬 슬라이드에서 각주/aside 레이아웃 개선 (#4297)
  • crossref가 있는 경우 앵커가 포함된 슬라이드를 가리키도록 보장 (#3533)
  • Revealjs 프레젠테이션에서 output-location을 최상위 옵션으로 지원 (#3261)
  • PDF 내보내기 키보드 단축키 및 메뉴 버튼 수정 (#2988)
  • hash-type: number일 때 제목 슬라이드 CSS 오류 수정 (#4418)

EPUB Format

  • EPUB 출력에서 webtex(epub2) 또는 mathml(epub/epub3)을 기본 활성화 (#4403)

Dates

  • 지원되는 언어-지역 로케일이 없을 때 언어 전용 로케일로 올바르게 폴백 (#3059)

PDF Format

  • 부록의 TOC 페이지 번호 오류 수정 (#3164) (@iusgit 감사)
  • SVG 이미지를 PDF로 자동 변환 지원 (#2575)
  • pdf-enginelatexmk일 때도 Quarto 1.3부터는 모든 Quarto 기능을 활성화하고 latexmk로 PDF 생성 루프를 실행
  • 복잡한 저자 이름에 대한 기본 PDF 저자 처리 수정 (#3483)
  • 정리 유형 블록 사이의 과도한 수직 공백 제거 (#3776)
  • 여러 변형이 있을 때 임시 .tex 파일명 문제 수정 (#3762)
    • 이 수정은 변형이 있는 PDF 파일의 파일명에 영향을 줍니다. Quarto 1.3부터 PDF 출력 자동 이름에는 형식 변형 및 수정자가 포함됩니다.
  • Windows에서 온라인 이미지를 올바르게 다운로드 (#3982)
  • keep-tex: true일 때 .tex 파일 권한이 올바르게 설정됨 (#4380)
  • PDF/LaTeX 출력에서 callout 안 각주 지원 개선 (#1235)
  • fig-pos: falseH 옵션을 지원하지 않는 사용자 정의 그림 환경을 허용 (#4832)
  • fig-pos:에 대괄호/중괄호가 포함된 복잡한 인자를 지정할 수 있도록 지원 (#4854)

Beamer Format

  • theme 형식 메타데이터 옵션 문서화 (#3377)

Markdown Formats

  • 변형(예: +yaml_metadata_block)을 gfm 형식으로 올바르게 전달
  • gfm 형식은 quarto preview에서 로컬 브라우저 기반 미리보기를 지원합니다. 미리보기에서 원시 마크다운을 보려면 문서 프런트매터나 프로젝트에 preview-mode: raw를 추가하세요.
  • gfmcommonmark 출력 형식은 ATX 스타일 헤더를 사용 (#4280)

Mermaid diagrams

  • mermaid 9.2.2로 업그레이드
  • JavaScript 형식에서 mermaid 다이어그램 테마 지원 (#2165). 자세한 내용은 프리릴리스 문서 참고.
  • %%| label mermaid 셀 옵션으로 결과 SVG의 id를 제어해 CSS 오버라이드를 쉽게 함
  • mermaid 플로우차트에 htmlLabels: false 사용
  • mermaid 9.2.2에서 동작하지 않는 툴팁 지원 제거
  • HTML 형식에서 mermaid 다이어그램에 fig-align 지원 추가 (#3294)
  • %%| file mermaid 셀 옵션 지원 추가 (#3665)
  • mermaid(및 dot) 다이어그램에서 code-fold 지원 수정 (#4423)
  • {} 정렬 지정자가 있을 때 캡션 삽입 문제 수정 (#4748)
  • PDF 형식에서 mermaid 다이어그램에 fig-envfig-pos 지원 (#4832)

Dot diagrams

  • PDF 형식에서 dot 다이어그램에 fig-envfig-pos 지원 (#4832)

Dates

  • 지원되는 언어-지역 로케일이 없을 때 언어 전용 로케일로 올바르게 폴백 (#3059)

About Pages

  • About 페이지 이미지에 대체 텍스트를 제공하는 image-alt 지원 추가 (#3010)
  • About 페이지에서 image-title 지원 추가 (#3077)

Article Layout

  • 여백 요소가 많은 매우 큰 문서의 성능을 개선하기 위해 요소 배치 효율성 향상

Listings

  • listing이 template-params를 지원하여 사용자 정의 EJS 템플릿에 templateParams 변수로 전달
  • 사용자 정의 listing 객체가 path: 필드를 표준 listing이 생성하는 메타데이터로 해석하여 reading-time 등 계산된 메타데이터에 접근 가능
  • listing에서 date-modified 지원 개선
  • yml 기반 listing에서 title 및 description 사용 지원 개선
  • 프로젝트에서 입력 파일이 아닌 파일(예: yml)을 직접 listing 내용으로 지정 가능
  • sort: false로 정렬 비활성화(항목이 원래 순서로 표시됨) (#3296)
  • 웹사이트 밖에서 listing을 사용하는 경우 경고 (#4267)
  • listing 항목의 미리보기 이미지로 계산 결과(플롯/그림)를 사용할 수 있도록 허용 (#2324)
  • listing 항목에 대해 자동 발견된 미리보기 이미지의 alt 텍스트 사용 (#3706)
  • listing에 includes:excludes:를 지원해 포함할 항목을 필터링 (#2577)
  • listing에서 구조화된 저자 이름 렌더링 개선 (#4881)

Websites

  • ‘Back to top’ 탐색 버튼 지원. website: 아래 back-to-top-navigation:으로 제어하며, 개별 페이지에서 back-to-top-navigation: false로 비활성화 가능
  • sidebar:를 사용해 특정 페이지에 특정 사이드바를 할당할 때의 문제 수정 (#3389)
  • publish gh-pages가 항상 깨끗한 디렉터리에 렌더링하도록 동작 변경
    • 이전 동작은 gh-pages 브랜치의 기존 콘텐츠에 추가
  • 제목 대신 파일명을 사용해 사이드바 항목을 정렬
  • repo-actions를 배치할 곳이 없을 때 페이지 푸터에 배치 (#3998)
  • Navbar가 없어도 page-footer를 렌더링 (#4053)
  • link-external-icon이 활성화되어도 href 없는 링크를 외부 링크로 취급하지 않음 (#3645)
  • 검색 결과에 인라인 코드 셀 HTML이 포함될 때 이스케이프 처리 (#4404)
  • 사이트맵 갱신에 입력 파일의 마지막 수정 시간을 사용 (#3251)
  • 웹사이트에 repo가 없어도 issue-url로 이슈 보고 URL을 지정할 수 있도록 지원
  • 검색 버튼 제목 및 다양한 토글 aria-label을 올바르게 로컬라이즈 (#4559)
  • 콘텐츠가 없어도 상단 navbar를 켤 수 있도록 navbar: true 지원
  • 메타데이터에 제목이 없는 페이지의 제목 인식 개선 (#4528)
  • 웹사이트와 책 검색에서 각주가 올바르게 인덱싱되도록 보장 (#4601)
  • 사이드바 항목에 아이콘을 포함할 수 있도록 허용 (#3830)
  • 접힌 navbar 토글 버튼의 외관 개선
  • _quarto.yml에서 명시적으로 설정한 경우 푸터 테두리를 올바르게 적용 (#4982)

Books

  • number-sections: false일 때 HTML head title에서 장 번호 제거 (#3304)
  • 비-HTML 책 출력 형식은 프로젝트 출력 디렉터리(_books) 하위의 book-<format> 디렉터리에 배치
  • YAML로 장 제목을 선언하면 첫 번째 장 헤더가 버려지던 문제 수정
  • Asciidoc 렌더링 지원
  • LaTeX 렌더링 지원
  • 책 웹사이트 내비게이션에서 로컬라이즈된 부록 이름 지원 (#4578)
  • LaTeX/PDF 책 렌더링에서 natbib 또는 biblatex를 사용할 때 중복 참고문헌 제목을 출력하지 않음 (#2770)

Preview

  • VS Code Server 리다이렉트 수정 (#3352) (@benz0li 감사)

LUA

  • quarto.version()이 비교를 단순화하는 Version 객체를 반환하도록 변경 (@tarleb 감사)

HTML Output

  • HTML 출력에서 소스 코드 내부 링크(예: code-link: true)에 외부 링크 아이콘을 표시하지 않음. (#3755)
  • toc-expand로 HTML 문서의 TOC 기본 확장 수준을 제어
  • 테마 간 탭 테두리 색상 개선 (#4868)

Miscellaneous

  • pandoc의 number-offset 유형 엄격 검사를 우회 (#3126)
  • 잘못된 URI에서 크래시 대신 경고 출력 (#3220)
  • embed-resourcesself-contained에서 video 쇼트코드가 동작하도록 보장 (#3310)
  • 내비게이션 링크에 선택적 rel 속성 지원 (#3212)
  • CRI가 여러 번 초기화될 때 올바른 포트를 사용 (#3066)
  • giscus에 사용자 정의 테마 지원 (#3105)
  • 키보드 키를 설명하는 새로운 kbd 쇼트코드 추가 (#3384). 자세한 내용은 프리릴리스 문서 참고.
  • OJS의 날짜 선택기 컴포넌트 기본 스타일 교체 (#2863)
  • 사용자 정의 바이너리의 의존성 버전을 확인하는 quarto check versions 지원 (#3602)
  • Lua 쇼트코드 핸들러 API가 네 번째 인자 raw_args(파싱되지 않은 인자 테이블)를 받도록 변경 (#3833)
  • 최종 출력에서 조건부 콘텐츠의 scaffolding div 제거 (#3847)
  • proof 제목이 문단 노드에 추가되도록 보장 (#3772)
  • LaTeX 및 HTML 테이블에서 캡션에 마크다운 파싱 지원 (#2573)
  • include 쇼트코드 파싱 개선 (#3159)
  • video 쇼트코드에서 YouTube 프라이버시 강화 URL 지원 (#4060)
  • 빈 셀을 출력하지 않음 (#4034)
  • HTML 의존성에서 링크 태그를 올바르게 해석 (#4304) (@jdlom 감사)
  • 한국어 언어 코드 올바르게 사용 (#4187)
  • 열고 닫는 문법이 있는 주석에 대한 YAML 옵션 해석 수정 (#3901)
  • 드문 deno 임시 파일 생성 버그를 우회 (#4352)
  • Chromium용 “안전한 포트”만 열도록 변경 (#4514)
  • quarto render에서 잘못된 인자 순서 가능성 감지 (#3581)
  • \_freeze 파일의 git 병합 충돌 가능성 감지 (#4529)
  • poyo 파싱 문제를 우회하기 위해 jupyter 엔진에서 YAML 문자열 끝 공백을 제거 (#4573)
  • 인용을 올바르게 렌더링하기 위해 날짜 형식을 “short” 대신 “iso”로 사용 (#4586)
  • listing 템플릿의 오타 thumnail-image -> thumbnail-image 수정 (#4602) (@mattspence 감사)
  • natbib 또는 biblatex로 참고문헌을 생성할 때 인용에 대해 #refs div를 타겟팅할 수 있도록 지원
  • WSL에서 Chromium 설치 문제에 대한 경고 추가 (#4596)
  • Chrome Browser에서 “No inspectable targets” 문제 수정 (#4653)
  • callout에 title 속성 추가(제목 정의를 위해 heading 대신 사용 가능)
  • Docusaurus 출력에서 더 다양한 raw HTML을 처리
  • 책과 웹사이트에서 DOM을 파일 단위로 읽고 처리해 메모리 사용량을 줄임 (#4350)
  • Windows에서 TeX Live 2023 bin 경로 문제 수정 (#4906)

Pandoc filter changes

  • Quarto 1.3부터 Pandoc 필터에 Custom AST 노드 개념을 도입했습니다. callout, 탭셋, 조건부 블록을 처리하는 Lua 필터를 사용한다면 새 문법을 지원하도록 필터를 변경해야 합니다. 자세한 내용은 프리릴리스 문서 참고.
  • Quarto 1.3은(마크다운 입력의) HTML 테이블을 Pandoc AST 노드로 처리해 사용자 필터가 이를 처리하고 HTML 이외 형식으로 출력할 수 있도록 합니다. 또한 쇼트코드와 crossref 해석이 가능한 “임베디드 마크다운 콘텐츠”를 지원합니다. 자세한 내용은 프리릴리스 문서 참고.

Project

  • 개별 프로젝트 파일을 stdout으로 렌더링하는 문제 수정 (#4052)
  • Windows에서 docusaurus 프로젝트 미리보기 문제 수정 (#4312)
  • 대규모 프로젝트의 성능 문제 수정 (#5002)

Publishing

  • output-dir이 지정된 경우 배포 오류 수정 (#4158)
  • git <2.17.0 사용 시 오류를 출력 (#4575)
  • 웹사이트가 아닌 문서를 배포할 때 --site-url 관련 오류 수정 (#4384)

Other

  • quarto render -h 도움말 실행 오류 수정 (#3202)
  • 디렉터리를 format-resources로 제공하는 확장을 사용할 때 렌더링 오류 수정 (#4377)
  • 렌더링 중 리소스 파일 복사 오류 수정 (#4544)
  • 확장 작성자는 .quartoignore! 접두어로 파일/경로를 지정해 템플릿에 포함하도록 강제할 수 있음. 예: !README.md (#4061)
  • 구형 Windows에서 확장 설치 문제 수정 (#4203)