Quarto 블로그

Quarto 블로그 제작방법
Quarto
블로그
Author
Affiliation
Published

2022년 08월 15일

1 블로그를 하는 이유

블로그를 작성하고 운영하는 이유를 다음과 같이 들 수 있다.

  • 학습: 강의를 듣거나 무언가 읽어 독서를 통해 학습되는 지식보다 글쓰기를 통해 축적되는 지식이 어떻게 보면 학습 효과가 더 크다. 특히, 학습한 내용을 코드로 작성하여 돌려볼 경우 학습효과를 배가시킨다.
  • 지식나눔: 구글 검색엔진을 통해 검색된 블로그 게시글을 통해 짧은 시간 학습에 도움을 받지만, 마찬가지로 본인이 작성한 블로그 게시글이 다른 사람에게 도움을 주는 것도 사실이다. 한가지 명심할 사항은 본인 실력보다 한두단계 앞선 사람으로 배우는 것이 실질적으로 큰 도움이 된다. 그래서 눈높이 교육이라는 얘기도 있지 않나 싶다.
  • 구인구직, 포트폴리오: 차곡차곡 누적된 블로그 게시물은 그 자체로 포트폴리오가 되고 헤드헌터를 통해 채용 인터뷰 요청을 받게 된다.

2 블로그 시작

Quarto 블로그 제작은 RStudio hugo, distill 블로그와 방식에서 몇가지 차이점이 있다.

Quarto CLI 를 사용하는 경우 다음 명령어를 투사하게 되면 myblog 디렉토리 아래 블로그 기본 사항이 준비되어 블로그 제작을 시작할 수 있다.

quarto create-project myblog --type website:blog

다른 방식은 RStudio 에서 New Project를 선택한 후에 Quarto Blog 프로젝트를 시작하는 방식이다.

3 블로그 미리보기

Quarto CLI 를 통해 quarto.cmd preview 명령어를 통해 블로그를 출판하기 전에 로컬 컴퓨텅에서 확인이 가능하다. 2022년 4월 RMarkdown/Bookdown 에서 Quarto로 옮겨간 초창기 경험이 Nicholas Tierney (2022-04-11), “Notes on Changing from Rmarkdown/Bookdown to Quarto” 블로그에 잘 정리되어 있다.

quarto.cmd preview는 윈도우의 경우고 맥이나 리눅스 계열은 quarto preview로 충분하다.

quarto.cmd preview

4 _quarto.yml 블로그 반영

_quarto.yml 파일에 블로그 메뉴를 지정한다. 블로그 전용 웹사이트를 운영하는 경우 _quarto.yml 파일에 블로그에 맞춰 YAML 파일 구성을 하면 된다.

website:
  title: "Quarto 데이터 사이언스"
  site-url: https://quartopub.com/sites/statkclee/quarto-ds
  twitter-card:
    card-style: summary_large_image
    description: "한글 Quarto 첫걸음"
    image: "fig/koRea_logo.png"
  page-footer:
    left: "[Quarto](https://quarto.org/) 로 제작"
  navbar:
    background: "#447099"
    left:
      - href: index.qmd
        text: "Home"
      - href: quarto_blog.qmd     
        text: "Blog"
      - text: Quarto
        menu:
        - href: quarto_install.qmd
          text: "Quarto 설치/출판"
        - href: quarto_about.qmd
          text: "Quarto 소개"
        - href: quarto_slideshow.qmd
          text: "Quarto 슬라이드"

4.1 quarto_blog.qmd

_quarto.yml 파일에 지정된 웹사이트에서 블로그로 들어가는 메뉴에 들어간 파일명이 quarto_blog.qmd 이라 해당 파일에 블로그 설정을 담아낸다.

---
title: "Quarto 데이터 과학"
listing:
  contents: posts
  sort: "date desc"
  type: default
  categories: true
  sort-ui: false
  filter-ui: false
page-layout: full
title-block-banner: false
---

5 _metadata.yml YAML

Quarto 웹사이트 내부에 블로그를 내장하여 운영하는 것이기 때문에 관례상 posts\ 디렉토리를 생성하여 관련 블로글 게시글을 각 폴더로 만들어 운영하는 것이 여러모로 유용하다.

quarto\
|-- posts\
    |-- _metadata.yml
    |-- quarto_blog_20220815
        |-- index.qmd 
    |-- quarto_transfer_20220715
        |-- index.qmd 

_metadata.yml YAML 파일에 블로그 설정을 담아낸다.

# Options specified here will apply to all posts in this folder

# freeze computational output
freeze: true

# Enable banner style title blocks
title-block-banner: false

# Author name of all blog posts
author: 'Victor Lee'

# Table of content settings
toc: true
toc-depth: 3

page-layout: article

6 블로그 작성

이제 블로그에 대한 게시글 작성에 대한 모든 것이 준비되어 index.qmd 파일에 Quarto 블로그 게시글을 작성하면 된다.

posts\quarto_blog_20220815\index.qmd

7 참고 블로그

No matching items