HTML 배포

개요

이 문서는 Quarto HTML 문서를 배포하는 다양한 방법을 다루며, 호스팅 서비스에 배포하거나 이메일, Dropbox 등을 사용해 독립형 HTML 파일을 공유하는 방법을 포함합니다.

Quarto 문서 모음을 웹사이트로 배포하는 것도 가능합니다. 자세한 내용은 배포 기본 문서를 참고하세요.

배포 명령

quarto publish 명령은 Quarto Pub, GitHub Pages, Netlify, Posit Connect에 문서를 배포하는 간단한 방법을 제공합니다.

예를 들어 다음은 document.qmd를 각 서비스에 배포하는 명령입니다:

Terminal

quarto publish quarto-pub document.qmd
quarto publish gh-pages document.qmd
quarto publish netlify document.qmd
quarto publish connect document.qmd

개별 문서를 간단히 배포하려면 quarto publish만 알면 충분합니다.

지원되는 다양한 서비스와 선택 기준을 간략히 살펴보면 다음과 같습니다:

대상	설명
Quarto Pub	Quarto 문서, 웹사이트, 책을 위한 배포 서비스입니다. 공개 콘텐츠를 위한 무료이면서 사용하기 쉬운 서비스를 원할 때 Quarto Pub을 사용하세요.
GitHub Pages	GitHub 저장소에 관리되는 소스 코드를 기반으로 콘텐츠를 배포합니다. 문서나 사이트의 소스 코드가 GitHub에 호스팅될 때 GitHub Pages를 사용하세요.
Posit Connect	조직 내에서 데이터 제품을 안전하게 공유하기 위한 배포 플랫폼입니다. 공개 인터넷이 아닌 조직 내부에 콘텐츠를 배포하려면 Posit Connect를 사용하세요.
Netlify	전문 웹 배포 플랫폼입니다. 사용자 정의 도메인, 인증, 브랜치 미리보기 등 고급 기능 지원이 필요할 때 Netlify를 사용하세요.
Other Services	Quarto로 렌더링한 콘텐츠는 표준 형식(HTML, PDF, MS Word 등)을 사용하므로 어디든 배포할 수 있습니다. 위 방법이 요구 사항을 충족하지 못할 때 사용하세요.

위 링크된 문서는 일반적으로 전체 프로젝트(웹사이트 또는 책) 배포를 다루지만, 위에서 보여준 것처럼 개별 문서나 프레젠테이션을 배포할 때도 모든 명령은 동일하게 동작합니다.

독립형 HTML

필요에 따라 Quarto 문서를 자체 포함 HTML로 렌더링할 수 있습니다. 이때 기사 렌더링에 필요한 모든 콘텐츠(플롯에서 생성된 이미지, 필요한 CSS와 JavaScript 등)가 하나의 HTML 파일로 묶입니다. 이를 위해 embed-resources 옵션을 사용하세요:

format:
  html:
    embed-resources: true

그런 다음 스프레드시트, 프레젠테이션, PDF 같은 다른 문서 형식을 공유하는 것과 같은 방식으로 이 HTML 파일을 공유할 수 있습니다(예: Dropbox나 다른 파일 공유 서비스에 업로드).

embed-resources: true를 사용할 때 MathJax와 KaTeX 같은 수식 라이브러리는 크기가 크고 다운로드에 시간이 걸리기 때문에 기본적으로 포함되지 않습니다. 수식 라이브러리를 포함하려면 self-contained-math: true 옵션을 추가하세요:

format:
  html:
    embed-resources: true
    self-contained-math: true