Yaml

X分鐘速成Y

其中 Y=yaml

源代碼下載：?learnyaml-cn.yaml

YAML是一個(gè)數(shù)據(jù)序列化語言，被設(shè)計(jì)成人類直接可寫可讀的。

它是JSON的嚴(yán)格超集，增加了語法顯著換行符和縮進(jìn)，就像Python。但和Python不一樣， YAML根本不容許文字制表符。

# YAML中的注解看起來像這樣。

################
# 標(biāo)量類型 #
################

# 我們的根對(duì)象 (它們在整個(gè)文件里延續(xù)) 將會(huì)是一個(gè)地圖，
# 它等價(jià)于在別的語言里的一個(gè)字典，哈西表或?qū)ο蟆?key: value
another_key: Another value goes here.
a_number_value: 100
scientific_notation: 1e+12
boolean: true
null_value: null
key with spaces: value
# 注意到字符串不需要被引用。但是，它們可以被引用。
"Keys can be quoted too.": "Useful if you want to put a ':' in your key."

# 多行字符串既可以寫成像一個(gè)'文字塊'(使用 |)，
# 或像一個(gè)'折疊塊'(使用 '>')。
literal_block: |
    This entire block of text will be the value of the 'literal_block' key,
    with line breaks being preserved.

    The literal continues until de-dented, and the leading indentation is
    stripped.

        Any lines that are 'more-indented' keep the rest of their indentation -
        these lines will be indented by 4 spaces.
folded_style: >
    This entire block of text will be the value of 'folded_style', but this
    time, all newlines will be replaced with a single space.

    Blank lines, like above, are converted to a newline character.

        'More-indented' lines keep their newlines, too -
        this text will appear over two lines.

####################
# 集合類型 #
####################

# 嵌套是通過縮進(jìn)完成的。
a_nested_map:
    key: value
    another_key: Another Value
    another_nested_map:
        hello: hello

# 地圖不用有字符串鍵值。
0.25: a float key

# 鍵值也可以是多行對(duì)象，用?表明鍵值的開始。
? |
    This is a key
    that has multiple lines
: and this is its value

# YAML也容許鍵值是集合類型，但是很多語言將會(huì)抱怨。

# 序列 (等價(jià)于表或數(shù)組) 看起來像這樣：
a_sequence:
    - Item 1
    - Item 2
    - 0.5 # 序列可以包含不同類型。
    - Item 4
    - key: value
      another_key: another_value
    -
        - This is a sequence
        - inside another sequence

# 因?yàn)閅AML是JSON的超集，你也可以寫JSON風(fēng)格的地圖和序列：
json_map: {"key": "value"}
json_seq: [3, 2, 1, "takeoff"]

#######################
# 其余的YAML特點(diǎn) #
#######################

# YAML還有一個(gè)方便的特點(diǎn)叫'錨'，它讓你簡單地在整個(gè)文件里重復(fù)內(nèi)容。
# 兩個(gè)鍵值將會(huì)有相同的值：
anchored_content: &anchor_name This string will appear as the value of two keys.
other_anchor: *anchor_name

# YAML還有標(biāo)簽，你可以用它顯示地聲明類型。
explicit_string: !!str 0.5
# 一些解析器實(shí)現(xiàn)特定語言的標(biāo)簽，就像這個(gè)為了Python的復(fù)數(shù)類型。
python_complex_number: !!python/complex 1+2j

####################
# 其余的YAML類型 #
####################

# 字符串和數(shù)字不是僅有的YAML可以理解的標(biāo)量。
# ISO 格式的日期和日期時(shí)間文字也是可以被解析的。
datetime: 2001-12-15T02:59:43.1Z
datetime_with_spaces: 2001-12-14 21:59:43.10 -5
date: 2002-12-14

# 這個(gè)!!binary標(biāo)簽表明一個(gè)字符串實(shí)際上是一個(gè)二進(jìn)制blob的base64編碼表示。
gif_file: !!binary |
    R0lGODlhDAAMAIQAAP//9/X17unp5WZmZgAAAOfn515eXvPz7Y6OjuDg4J+fn5
    OTk6enp56enmlpaWNjY6Ojo4SEhP/++f/++f/++f/++f/++f/++f/++f/++f/+
    +f/++f/++f/++f/++f/++SH+Dk1hZGUgd2l0aCBHSU1QACwAAAAADAAMAAAFLC
    AgjoEwnuNAFOhpEMTRiggcz4BNJHrv/zCFcLiwMWYNG84BwwEeECcgggoBADs=

# YAML還有一個(gè)集合類型，它看起來像這樣：
set:
    ? item1
    ? item2
    ? item3

# 像Python一樣，集合僅是有null數(shù)值的地圖；上面的集合等價(jià)于：
set2:
    item1: null
    item2: null
    item3: null