12.5 YAML

  • R Markdown 문서의 가장 처음에 정의하는 metadata
  • .Rmd 파일을 .md 파일로 변환 후 최종 출력문서 생성 시 필요한 pandoc의 옵션을 설정하는 것과 같은 의미임
  • 일반적으로 문서 형태 및 생성을 위해 사용하는 R package (예: bookdown, officedown, rticles 등)에 따라 YAML 구성요소가 달라짐

기본 문법

  • /#: 주석 처리
  • YAML 문서의 시작과 끝은 --- 로 정의함
  • 기본적으로 콜론(:)으로 구분된 태그(키): 값 쌍으로 구성됨 \(\rightarrow\) key: value
    • 여기서 콜론 바로 다음에는 반드시 공백문자가 있어야 함
  • key의 하위 키는 리스트 형태로 표현하고, 하위 키는 두 개 이상의 스페이스로 공백을 주어 표현
---
key : value
   subkey1: value1
   subkey2: value2
      subsubkey1: value3
---

R Markdown 기본 YAML 구조

---
title: "문서 제목" # 일반적으로 따옴표 사용
subtitle: "문서 부제목"
author: "문서 작성자"
date: "문서 작성일자" 
output: 
   - "html_document"
   - "word_document"
   - "pdf_document"
   - "md_document"
   - "isoslides_presentation"
   - "slidy_presentation"
   - "beamer_presentation"
bibliography: 참고문헌.bib # bibtex 서식 활용
.
.
.
---