Quarto book 한글 세팅

Quarto book 한글 pdf 세팅 방법

Author

Don Don

Published

August 5, 2022

Quarto 문서에서도 bookdown 패키지와 같이 html or pdf book을 만들 수 있다. 다만 html의 경우 한글이 오류 없이 작동하지만, pdf의 경우 한글을 활용한 문서를 만들기 위해서는 몇 가지 세팅을 해줘야 한다. 세팅을 따로 하지 않을 경우 한글을 인식하지 못하는 문제가 있다. 2시간 정도 quarto github을 찾아봤지만 적당한 해결방법이 보이지 않았는데, pdf rendering 과정을 볼 수 있는 background jobs에서 힌트를 얻었다. pdf로 변환할 때, texlive(tlmgr)을 이용하는데, texlive에서 한글이 인식되면 Quarto에서도 잘 작동할 것 같았다.

MAC texlive 세팅

  1. mactex 설치 http://wiki.ktug.org/wiki/wiki.php/%EC%84%A4%EC%B9%98%ED%95%98%EA%B8%B0MacOSX/MacTeX
-    해당 링크에서 mactex 설치 링크 들어가서 설치($10$분 소요)
  1. 터미널 켜기 :

    • KTUG 사설 저장소 등록 :
sudo tlmgr repository add http://ftp.ktug.org/KTUG/texlive/tlnet ktug
-   사설 저장소로부터 폰트 다운로드와 등록 : 
sudo tlmgr pinning add ktug 
-   texlive 업데이트 : 
sudo tlmgr update --all --self
  1. 터미널 다시 키고, texlive의 폰트를 mac os 폰트로 등록 :
ln -s /Library/TeX/Root/texmf-dist/fonts/truetype ~/Library/Fonts/
    
ln -s /Library/TeX/Root/texmf-dist/fonts/opentype ~/Library/Fonts/

_Quarto.yml 파일에 kotex 업데이트

위의 절차를 완료한 후 _Quarto.yml 파일에 kotex 패키지를 수동으로 업데이트하면 된다.

project:
  type: book

book:
  title: "Qbook"
  author: "Jane Doe"
  date: "8/5/2022"
  chapters:
    - index.qmd
    - intro.qmd
    - summary.qmd
    - references.qmd

bibliography: references.bib

format:
  html:
    theme: cosmo
  pdf:
    documentclass: scrreprt
    include-in-header: 
      text: |
        \usepackage{kotex}
        \usepackage{float}
        
editor: visual
Note

안될 경우 latex-tinytex: false 설정 후 knit를 진행하면 됨

Citation

BibTeX citation:
@online{don2022,
  author = {Don, Don and Don, Don},
  title = {Quarto Book {한글} {세팅}},
  date = {2022-08-05},
  url = {https://dondonkim.netlify.app/posts/2022-08-05-quarto-book/quartobook.html},
  langid = {en}
}
For attribution, please cite this work as:
Don, Don, and Don Don. 2022. “Quarto Book 한글 세팅.” August 5, 2022. https://dondonkim.netlify.app/posts/2022-08-05-quarto-book/quartobook.html.