자주 묻는 질문

R Markdown 사용자가 Quarto와 R Markdown의 관계가 궁금하다면 R Markdown 사용자용 FAQ도 참고하세요.

일반

Quarto는 무엇에 사용할 수 있나요?

Quarto®는 Pandoc 위에 구축된 오픈 소스 과학 및 기술 출판 시스템입니다. 서술형 텍스트와 코드를 함께 엮어 문서, 웹 페이지, 블로그 글, 책 등 다양한 형식의 결과물을 깔끔하게 만들 수 있습니다.

Quarto는 어떻게 설치하나요?

Windows, Mac OS, Linux 설치 안내를 제공하는 Quarto.org - 시작하기 페이지를 참고하세요.

Quarto는 어떤 출력 형식을 만들 수 있나요?

Quarto에는 다양한 출력 형식이 있습니다. Pandoc에 내장된 모든 형식(예: HTML, PDF, MS Word, Revealjs, ePub 등)은 물론, 여러 문서를 웹사이트, 블로그, 책으로 발행하는 방법도 포함됩니다. 자세한 내용은 Quarto 형식에서 확인하세요.

Quarto에서 어떤 편집 도구를 사용할 수 있나요?

Quarto는 다양한 도구에서 사용할 수 있습니다. VSCode, JupyterLab, RStudio IDE 또는 어떤 텍스트 편집기에서든 Quarto 문서를 작성하고 편집할 수 있도록 문서를 제공합니다. 먼저 Quarto 시작하기에서 설치한 다음, 사용하려는 도구의 간단한 안내를 확인하세요.

Quarto에서 Jupyter 노트북을 사용할 수 있나요?

네! Quarto는 Jupyter 노트북을 렌더링할 수 있으며, Jupyter, JupyterLab 또는 다른 .ipynb 노트북 편집기를 사용할 수 있습니다. 기존 .ipynb 노트북을 그대로 렌더링할 수도 있지만, Quarto 전용 출력 옵션이나 YAML 헤더를 추가하면 결과물이 더 좋아집니다. 자세한 내용은 JupyterLab 페이지를 참고하세요.

Quarto에서 지원하는 프로그래밍 언어는 무엇인가요?

Quarto가 기본으로 지원하는 언어는 Python, R, Julia, Observable JavaScript입니다. Jupyter와의 통합을 통해 더 많은 언어를 사용할 수도 있습니다.

각 Quarto 문서는 계산 엔진으로 처리할지 선택할 수 있습니다(엔진은 수동 지정 또는 코드 청크를 기반으로 자동 감지). 현재 엔진에는 Knitr( R Markdown에서도 사용되며 R, Python, Julia 등 다양한 언어를 지원)과 Jupyter(Python, Julia, R 등 여러 언어 지원)가 있습니다. 자세한 내용은 엔진 바인딩 문서를 참고하세요.

Quarto는 어떤 자연어를 지원하나요?

Quarto 문서는 원하는 자연어로 작성할 수 있습니다. lang 문서 옵션은 IETF 언어 태그( BCP 47 표준 따름)를 사용해 문서의 기본 언어를 지정합니다(예: en 또는 en-GB).

버그를 보고하거나 기능 요청은 어디에서 하나요?

발견한 문제를 공유해 주셔서 감사합니다! Quarto 저장소에 이슈를 제출해 주세요: https://github.com/quarto-dev/quarto-cli/issues.

Quarto 사용자와 질문을 나누고 토론하려면 어디로 가면 되나요?

질문을 하거나 다른 사람들의 질문을 확인하기에 가장 좋은 곳은 Quarto Discussions입니다(https://github.com/quarto-dev/quarto-cli/discussions).

개발 및 유지보수

의존성을 어떻게 업그레이드하나요?

일반적으로는 불가능합니다. Quarto는 Pandoc, typst 등 하위 의존성에 맞춘 출력을 생성하며, Deno처럼 특정 상위 의존성에 의존하는 기능을 사용합니다. 설치 프로그램은 모든 필요한 의존성을 함께 묶어 버전 불일치 위험을 없애며, 서드파티 패키저도 같은 정책을 따르길 강하게 권장합니다.

의존성은 얼마나 자주 업데이트되나요?

이상적으로는 안정 릴리스(1.2, 1.3 등)마다 정확히 한 번 업데이트합니다. 필요에 따라 주기를 변경할 권한은 저희에게 있습니다.

Quarto의 의존성은 무엇인가요?

Quarto의 의존성에는 다음이 포함됩니다.

라이선스

Quarto는 무료인가요?

네! Quarto는 오픈 소스입니다. Quarto 1.3(및 이전)은 GNU GPL v2로, Quarto 1.4는 MIT License로 배포됩니다.

Quarto로 상용 콘텐츠를 만들 수 있나요?

네! Quarto의 저작권은 Quarto로 생성한 원본 콘텐츠에는 적용되지 않습니다. Quarto로 원본 콘텐츠를 만드는 것은 법적으로 당신이 만든 원본 콘텐츠의 라이선스를 제한하지 않으며, Quarto로 문서를 작성하는 대상 소프트웨어에 “침투”하여 영향을 미치지 않습니다.

하지만 Quarto의 스타일이나 기능을 포함하는 HTML 출력물에는 GPL이 적용되지 않나요?

적용되는 것은 스타일이나 기능 그 자체입니다. 원본 콘텐츠는 Quarto의 스타일이나 기능의 파생 저작물이 아니기 때문에 포함되지 않습니다.

문서를 공유하고 사람들의 코멘트를 받으려면 어떻게 하나요?

Quarto 콘텐츠는 다양한 위치에 배포할 수 있습니다. Quarto Pub, GitHub Pages, Netlify, Posit Connect 등 서비스에 대한 안내는 배포 가이드에서 확인하세요. 배포 후에는 hypothes.is, Utterances, Giscus를 사용해 댓글을 받을 수 있습니다. 자세한 내용은 댓글 문서를 참고하세요.

Quarto에서 공동 편집을 할 수 있나요?

Quarto에는 공동 편집을 위한 전용 기능은 아직 없습니다. .qmd 파일은 현재 사용하고 있는 텍스트/코드 파일과 동일한 방식으로 협업할 수 있습니다.

Posit Workbench는 동일 문서에 대한 대화형 편집 및 협업을 위한 프로젝트 공유 기능을 제공합니다.

Quarto 웹사이트는 어디에 배포할 수 있나요?

Quarto 웹사이트를 배포하는 방법은 매우 다양합니다. 웹사이트 콘텐츠는 기본적으로 \_site 하위 디렉터리에 출력됩니다(출력 디렉터리는 output-dir 옵션으로 변경 가능). 배포란 결국 출력 디렉터리를 웹 서버나 웹 호스팅 서비스로 복사하는 것입니다.

배포 문서에는 Posit Connect, Netlify, GitHub Pages, Firebase, Site44, Amazon S3 등 Quarto 웹사이트 배포 옵션이 설명되어 있습니다. 각 서비스의 문서를 주로 참고하도록 안내하며, Quarto에 필요한 구성은 별도로 안내합니다.

Quarto + Posit

Posit Connect는 Quarto를 지원하나요?

네! Quarto 콘텐츠는 Posit Connect v2021.08.0 이상에 배포할 수 있습니다. Posit Connect 관리자 가이드에 따라 Quarto를 활성화해야 합니다. Connect 사용자 문서는 RStudio IDE에서 배포하는 방법을 Quarto.org 문서로 안내합니다. Python 기반 Quarto 콘텐츠는 VSCode, JupyterLab, 터미널 등에서 rsconnect-python CLI로 배포할 수 있습니다.

메타

Quarto는 누가 개발하나요?

Quarto 개발은 Posit, PBC의 후원으로 진행됩니다. 같은 핵심 팀이 Quarto와 R Markdown을 함께 개발합니다.

전체 기여자 목록을 확인하세요. Quarto는 오픈 소스이며 GitHub 저장소에서 기여를 환영합니다: https://github.com/quarto-dev/quarto-cli.

Quarto라는 이름의 의미는 무엇인가요?

출판 역사에서 의미가 있는 이름을 찾다가 Quarto를 선택했습니다. Quarto는 한 장에 8쪽(한 면에 4쪽) 인쇄한 다음 두 번 접어 네 장을 만드는 책이나 팸플릿의 판형을 뜻합니다. 알려진 가장 오래된 유럽 인쇄본은 Quarto 형식의 Sibyllenbuch로, 1452–53년에 Johannes Gutenberg가 인쇄한 것으로 알려져 있습니다.