Website Drafts

개요

초안은 배포 준비가 되기 전에 콘텐츠를 미리 보고 계획하는 데 사용합니다. 기본적으로 초안 페이지는 렌더링된 사이트에서 비어 있으며 내비게이션, listing, 검색 결과, 사이트 맵에 나타나지 않습니다. 이 페이지에서는 초안 지정 방법, 렌더링된 사이트에서 초안 표시 방식, 사이트 미리보기에서 초안 표시 방식을 설명합니다.

초안 지정

페이지나 게시물을 초안으로 지정하려면 문서 YAML에 draft: true를 추가합니다:

posts/post-with-code/index.qmd

---
title: "Post with Code"
draft: true
---

디렉터리의 모든 문서를 초안으로 지정하려면 디렉터리 메타데이터에 draft: true를 설정합니다:

posts/_metadata.yml

draft: true

draft 문서 옵션 대신 _quarto.yml에 웹사이트 옵션 drafts를 지정할 수도 있습니다:

_quarto.yml

website:
  title: "Cool Website."
  drafts:
    - posts/post-with-code/index.qmd

경로 목록을 별도 파일로 지정하고 싶다면 메타데이터 포함을 사용하세요. 예를 들어 drafts.yml에 초안을 지정할 수 있습니다:

drafts.yml

website:
  drafts:
    - posts/post-with-code/index.qmd

그 다음 이 파일을 metadata-files에 지정합니다:

_quarto.yml

website:
  title: "Cool Website."

metadata-files:
  - drafts.yml

웹사이트 drafts 옵션은 프로젝트 프로필로도 설정할 수 있습니다.

초안 표시 방식

draft-mode 옵션으로 렌더링된 웹사이트에서 초안 문서의 콘텐츠 및 링크 방식을 제어할 수 있습니다. draft-mode의 값은 다음과 같습니다:

gone(기본값)—비어 있고 링크 없음
unlinked—렌더링되지만 링크 없음
visible—렌더링되며 링크 표시

빈 페이지라도 URL은 존재하지만 페이지 자체는 비어 있습니다. 렌더링되는 초안에는 초안 배너가 추가로 표시됩니다:

'Post With Code' 제목의 게시물 스크린샷. 페이지 상단에 'Draft' 배너가 표시됩니다. — 렌더링된 초안 문서에는 “Draft” 배너가 표시됩니다

초안이 unlinked 상태이면 검색 결과, listing, 사이트 맵, 내비게이션(사이드바, 내비게이션 바, 푸터)에 나타나지 않습니다. 다른 페이지가 unlinked 초안 문서로 링크하고 있다면, 링크는 제거되어 하이퍼링크 없이 링크 텍스트만 남습니다.

완전한 예로 다음 웹사이트 설정을 살펴보세요:

Listing 1: 완전한 _quarto.yml 예시

_quarto.yml

project:
  type: website

website:
  title: "Cool Website."
  navbar:
    left:
      - stuff/item1.qmd
      - stuff/item2.qmd
1  drafts:
    - stuff/item2.qmd
2  draft-mode: unlinked

1: 프로젝트가 초안 문서 목록을 제공합니다. 동일한 내용을 stuff/item2.qmd의 프론트매터에 draft: true로 지정할 수도 있습니다.
2: 초안 모드가 unlinked로 설정되어 있어 초안은 렌더링되지만 링크는 표시되지 않습니다.

렌더링하면 위 사이트의 내비게이션 바는 stuff/item2.qmd 항목을 제외합니다:

하지만 stuff/item2.qmd는 여전히 stuff/item2.html에서 접근할 수 있고 초안 배너가 표시됩니다:

'Item 2' 제목의 웹페이지 스크린샷. 내비게이션 바에는 'Item 1'만 표시됩니다. 내비게이션 바 위에 'Draft' 배너가 있습니다.

초안 미리보기

draft-mode 설정과 관계없이 quarto preview로 사이트를 미리보면 초안은 visible로 처리됩니다. 초안 페이지는 렌더링되어 초안 배너가 표시되고, 초안 페이지를 가리키는 모든 링크나 내비게이션 항목이 표시되고 활성화됩니다. 예를 들어 Listing 1 에서 설명한 사이트를 미리보면 내비게이션에 stuff/item2.html 링크가 표시됩니다:

'Item 2' 제목의 웹페이지 스크린샷. 내비게이션 바에 'Item 1'과 'Item 2' 두 항목이 표시됩니다. 내비게이션 바 위에 'Draft' 배너가 있습니다.

이 미리보기 동작은 RStudio의 Render 버튼과 Positron/VS Code의 Preview 버튼으로 생성된 미리보기에도 적용됩니다.