YAML 문법

YAML

• .yaml, .yml 확장자
• UTF-8 or UTF-16과 같이 출력 가능한 유니코드 문자집합을 이용
• XML, JSON, YAML 모두 데이터를 표현하는 형식으로 형태와 문법이 다름
  • XML : HTML과 비슷하며 꺽쇠(<>)를 사용하여 계층 구조를 이루고 있음
  • JSON : REST API에 사용되며 최근 XML보다 많이 사용고 있음, 주석을 사용할 수 없다는 특징이 있으며 괄호를 사용
  • YAML : 읽기 쉽게 표현하였으며 공백 위주로 데이터를 구분
• YAML 공식 : https://yaml.org/
• JSON to YAML : https://www.json2yaml.com/
• YAML 문법 체크 : http://www.yamllint.com/

 

주석(commnet)

• # 로 표시
• 한 줄이 끝날때까지 유지

#이건 주석

 

들여쓰기(indent)

• 일반적으로 2칸 사용
• 2칸 or 4칸
• 탭 X
• 같은 부모 노드를 가지는 자식 노드끼리는 들여쓰기가 일치 필수!

user:
  name: eunhye
  like:
    - coffee
    - dessert

 

데이터 정의(mapping)

• hash or dictionary
• key: value 형식
• { } 로도 가능
• 콜론(:) 뒤에 공백은 필수!

user:
  name: eunhye
  like:
    - coffee
    - dessert

user: {
  name: eunhye,
  like: [
    coffee, dessert
  ]
}

 

스칼라(scalar)

• 간단한 값..?! 문자 or 숫자
• 보통 아무 표시도 안하지만 따옴표(")나 작은 따옴표(')를 사용하기도 함
• 문자 안에 콜론(:)이 들어갈 경우 따옴표 필요
• 따옴표 안에서 특수 문자는 C언어 스타일을 따름! 예를 들어서 newline = \n

user:
  name: eunhye
  like:
    - "coffee"
    - 'dessert'

 

시퀀스(sequence)

• list or array
• - 로 표시
• [ ] 로도 가능

user:
  name: eunhye
  like:
    - coffee
    - dessert

user: {
  name: eunhye,
  like: [
    coffee, dessert
  ]
}

 

참/거짓(boolean)

• true/false, yes/no 지원

user:
  name: eunhye
  male: false
  female: true

 

숫자(number)

• 쌍따옴표(")를 사용하면 문자로 인식

user:
  name: eunhye
  age: 27 #number 27

user:
  name: eunhye
  age: "27" #string 27

 

줄바꿈(newline)

• | 을 사용하면 블록 내 줄바꿈 허용되며 마지막 줄바꿈 포함

lines: | 
  first line

  second line

  third line

{
  "lines": "first line\n\nsecond line\n\nthird line\n"
}

• |- 을 사용하면 블록 내 줄바꿈 허용되며 마지막 줄바꿈 미포함

- lines: |-
  first line

  second line

  third line

{
  "lines": "first line\n\nsecond line\n\nthird line\n"
}

• > 을 사용하면 블록 내 줄바꿈 허용되며 중간에 들어간 줄바꿈 미포함, 마지막 줄바꿈 포함

lines: >
  first line

  second line

  third line

{
  "lines": "first line\nsecond line\nthird line\n"
}

 

반복

• 반복되는 노드들은 achor와 alias를 통해 접근

users:
  first-anchor: &first
    name: eunhye
    age: "26"
  second-anchor: &second
    name: yeji
    age: "25"

first-child  : *first #first-child로 접근하면 first-anchor로 접근
second-child : *second #secnod-child로 접근하면 second-anchor로 접근

 

문서의 시작과 끝

• 선택 사항

--- #문서의 시작 

... #문서의 끝