R을 사용하시는 많은 분들이 R 마크다운을 사용해서 문서를 작성하고 계십니다. 그래서 슬기로운 통계생활의 유료 멤버쉽 분들을 위하여 자체 제작 템플릿을 공유드리고 있는데요, 본 포스팅에서는 템플릿 사용 방법과 어떠한 기능이 있는지 설명드리겠습니다. 본 템플릿은 Qmd에서도 적용됩니다.
슬기로운 통계생활 R 마크다운 템플릿
슬기로운 통계생활 레이텍 템플릿은 슬기로운 통계생활의 유료 멤버쉽 회원 분들을 위한 자체 제작 R 마크다운, Quarto 템플릿 입니다. 멤버쉽 가입을 하신 후 생성되는 Membership 게시판에 보시면 매월 멤버십 전용 구글 드라이브 폴더를 공유받으실 수 있습니다.
슬통 템플릿을 사용하면 LaTeX 지식없이, R 마크다운 지식으로만으로도 다음과 같이 깔끔한 PDF 문서를 작성할 수 있도록 도와드립니다!
사용 준비하기
멤버십 구글 드라이브에 접근하시게 되면 다음과 같은 여러 폴더들이 있는데, 각 폴더에는 유료 멤버십 강의 영상과 관련한 강의안과 파일들이 담겨있습니다. 그 중 슬통 템플릿을 선택해주세요!
한글 폰트 설치 방법
멤버쉽 전용 구글 드라이브에 접근하면 슬통템플릿 폴더 아래에 한글폰트 폴더가 있습니다. 이 파일들 중에서 한글 폰트 폴더에 있는 모든 폰트 파일들을 설치해주세요! 그래야 템플릿이 원활히 작동합니다.
- NotoSansCJKkr
- NotoSerifCJKkr (본문 폰트)
- D2Coding (코드 폰트)
폰트를 설치하는 방법은 윈도우 기준, 파일을 더블 클릭하여 열면 왼쪽 상단에 나오는 Install 버튼을 눌러주시면 됩니다.
R 마크다운 템플릿 사용 (적용) 방법
Rmd 혹은 Qmd 파일에 다음과 같은 문서 설정 파트(YAML)안에 넣어 줍니다.
output:
pdf_document:
latex_engine: xelatex
template: "statplaybook.tex"statplaybook.tex이 다음과 같이 Rmd 파일 혹은 Qmd 파일과 같은 폴더에 있어야 함을 주의해주세요!
슬기로운통계생활 템플릿 사용법
다음은 슬기로운 통계생활 R 마크다운 템플릿의 기능들과 사용하기 위한 설정 방법들 입니다.
표지 없이 심플한 레포트 만드는 방법
템플릿은 기본적으로 표지가 출력 (아래 그림 첫번째) 되어 나옵니다. 표지 없이 심플하게 레포트를 만들고 싶은 경우, 문서 설정 부분의 title, author, date를 지워버리면 기본적인 레포트 형태(아래 그림 두번째)가 됩니다.
title, author, date가 있는 경우 기본 표지
title, author, date가 생략된 심플 버전
문서 테마 관련 설정법
문서 전체의 분위기를 결정하는 각 장과 챕터 색깔과 코드 하이라이팅 방식을 설정 할 수 있습니다.
문서 테마 설정
테마는 챕터, 섹션들의 색깔을 결정합니다. 기본은 검정색이며, darkgreen과 midnightblue를 설정할 수 있고, 기본적인 색깔들 (blue, red, grey) 은 모두 지원합니다. 원하는 색깔을 문서 설정 부분에 다음과 같이 설정해주면 됩니다. 아래 예시는 darkgreen을 설정한 경우 입니다.
themecolor: darkgreen
코드 하이라이팅 옵션들
테마 색상과 맞춰서 highlight 옵션 선택하면 문서의 전반적인 이미지를 결정할 수 있습니다. 아래의 단어들은 선택 할 수 있는 코드 하이라이팅 옵션들이며, 테마 색상과 같이 어울리는 하이라이트 옵션을 선택하면 됩니다.
- tango, pygments, kate, monochrome, espresso, zenburn, haddock, breezedark, arrow, rstudio
실제 문서 작성 R마크다운 코드 및 예시
Rmd와 Qmd 문서 작성 예시는 슬통 템플릿 폴더에 있는 슬기로운통계생활-Rmd작성예시.Rmd와 슬기로운통계생활-Qmd작성예시.qmd 파일을 참고해주시기 바랍니다.
Version 1.0 주요 업데이트 사항 (23년 11월)
- 그래프 현재 위치로 고정 (기본 기능)
- 페이지 번호 추가 (기본 기능)
- 워터마크 사용 가능
- 가로페이지 사용가능
페이지 번호 추가
페이지 하당 가운데에 페이지 번호가 추가 되었습니다. 기본 설정이 업데이트 된 것이며, 추가 설정 작업은 필요 없습니다.
R 마크다운 PDF 그래프 위치 고정
이제 R 마크다운 상의 그래프의 위치와 PDF 결과물의 그래프 위치가 동일하게 설정 되었습니다. 기본 설정으로 업데이트 된 사항이며, 이에 관한 추가 설정 작업은 필요 없습니다.
워터마크 사용 방법
자신이 사용하고 싶은 그림파일을 사용해서 워터마크로 사용할 수 있습니다. 워터마크 기능을 사용하기 위해서는 문서 설정 부분에 다음과 같은 자신이 원하는 그림파일을 설정해주면 됩니다.
watermark: 그림.jpg워터마크를 없애고 싶은 경우 문서 설정 란에서 watermark 부분을 그냥 지워버리면 됩니다. 현재는 기본 설정이 45도로 길울어져 들어가게끔 해놓았습니다. 추후 원하는 각도와 투명도로 설정할 수 있도록 기능 추가 예정입니다. 투명도는 가독성을 떨어뜨리지 않는 선에서 워터마크가 보여지도록 설정해놓은 상태입니다.
가로 회전 페이지 기능 추가
가로 페이지를 만들 수 있는 방법이 추가 되었습니다. 문서 설정 부분에 다음과 같이 pagelscape 옵션을 켠 후, 가로 페이지 시작부분과 끝 부분을 \blandscape과 \elandscape으로 묶어주면 됩니다.
pagelscape: true예를 들어 다음과 같은 코드를 사용해서 가로 페이지를 작성 할 수 있습니다.
\blandscape
- 가로 페이지 예
| | mpg| cyl| disp| hp| drat| wt| qsec| vs| am| gear| carb|
|:-----------------|----:|---:|----:|---:|----:|-----:|-----:|--:|--:|----:|----:|
|Mazda RX4 | 21.0| 6| 160| 110| 3.90| 2.620| 16.46| 0| 1| 4| 4|
|Mazda RX4 Wag | 21.0| 6| 160| 110| 3.90| 2.875| 17.02| 0| 1| 4| 4|
|Datsun 710 | 22.8| 4| 108| 93| 3.85| 2.320| 18.61| 1| 1| 4| 1|
|Hornet 4 Drive | 21.4| 6| 258| 110| 3.08| 3.215| 19.44| 1| 0| 3| 1|
|Hornet Sportabout | 18.7| 8| 360| 175| 3.15| 3.440| 17.02| 0| 0| 3| 2|
|Valiant | 18.1| 6| 225| 105| 2.76| 3.460| 20.22| 1| 0| 3| 1|
\elandscape위 코드의 결과물은 다음과 같습니다.
다른 옵션들과 마찬가지로 가로 회전 페이지를 사용하고 싶지 않은 경우 옵션을 지워버리면 됩니다.
슬기로운 통계생활 R 마크다운 템플릿은 앞으로 계속 업데이트 될 예정이며, 최신 업데이트 소식은 본 페이지를 참고해주시기 바랍니다. 템플릿을 사용하시다가 불편한 점, 원하는 기능이 있는 경우 슬기로운 통계생활 네이버 카페를 통해서 제안주시기 바랍니다.
