編輯“YAML”（章節(jié)）

== YAML語言的構成元素 ==
*'''YAML的基本元件'''

YAML提供縮排／區(qū)塊以及內(nèi)置（inline）兩種格式，來表示清單和雜湊表。以下展示幾種YAML的基本原件。

*'''清單（陣列）'''

習慣上清單比較常用區(qū)塊格式（block format）表示，也就是用短杠+空白字符作為起始。

<pre>
--- # 最喜愛的電影
- Casablanca
- North by Northwest
- Notorious
</pre>

另外還有一種內(nèi)置格式（inline format）可以選擇──用方括號圍住，并用逗號+空白區(qū)隔（類似[[JSON]]的語法）
</pre>
--- # 購物清單 
[milk, pumpkin pie, eggs, juice]
</pre>

*'''雜湊表'''

鍵值和資料由冒號及空白字符分開。
<pre>
--- # 區(qū)塊形式
name: John Smith
age: 33
--- # 內(nèi)置形式
{name: John Smith, age: 33}
</pre>

*'''區(qū)塊的字符'''

再次強調(diào)，字串不需要包在引號之內(nèi)。保存新行(Newlines preserved)
<pre>
--- |                                      
#譯者注：這是一首著名的五行民謠(limerick)
There once was a man from Darjeeling     
#這里曾有一個人來自大吉嶺
Who got on a bus bound for Ealing        
#他搭上一班往伊靈的公車
It said on the door                 
#門上這麼說的
"Please don't spit on the floor"     
#"請勿在地上吐痰"
So he carefully spat on the ceiling     
#所以他小心翼翼的吐在天花板上
</pre>
根據(jù)設定，前方的引領空白符號（leading white space）必須排成條狀，以便和其他資料或是行為（如范例中的縮排）明顯區(qū)分。

*'''折疊新行(Newlines folded)'''
<pre>
--- >
  Wrapped text         #摺疊的文字
  will be folded       #將會被收
  into a single        #進單一一個
  paragraph            #段落
  
  Blank lines denote   #空白的行代表
  paragraph breaks     #段落之間的區(qū)隔
</pre>

和保存新行不同的是，換行字元會被轉(zhuǎn)換成空白字符。而引領空白字符則會被自動消去。

*'''階層化的元素'''

雜湊表中使用清單
<pre>
- {name: John Smith, age: 33}
- name: Mary Smith
  age: 27
</pre>

清單中使用雜湊表
<pre>
men: [John Smith, Bill Jones]
women:
  - Mary Smith
  - Susan Williams
</pre>

*'''YAML的進階元件'''

這部分算是一個后續(xù)的討論，在比較各種數(shù)資料列語言時，YAML最常被提到的特色有兩個：關系樹和資料形態(tài)。

樹狀結溝之間的交互參照

資料合并和參考

為了維持文件的簡潔，并避免資料輸入的錯誤，YAML提供了結點參考（*）和雜湊合并（<<）參考到其他結點標簽的錨點標記（&）。參考會將樹狀結構加入錨點標記的內(nèi)容，并可以在所有數(shù)據(jù)結構中運作（可以參考上面"ship-to"的范例）合并只有雜湊表可以使用，可以將鍵值自錨點標記復制到指定的雜湊表中。

當資料被instantiate合并和參考會被剖析器自動展開。

<pre>
#眼部雷射手術之標準程序
---
- step:  &id001                  #定義錨點標籤 &id001
    instrument:      Lasik 2000
    pulseEnergy:     5.4
    pulseDuration:   12
    repetition:      1000
    spotSize:        1mm

- step:
     <<: *id001                  # 合併鍵值：使用在錨點標籤定義的內(nèi)容
     spotSize:       2mm         # 覆寫"spotSize"鍵值

- step:
     <<: *id001                  # 合併鍵值：使用在錨點標籤定義的內(nèi)容
     pulseEnergy:    500.0       # 覆寫鍵值
     alert: >                    # 加入其他鍵值
           warn patient of 
           audible pop
</pre>

*'''資料形態(tài)'''

由于自動判定資料形態(tài)的功能，嚴格型態(tài)（也就是使用者有宣告的資料形態(tài)）很難在大部分的YAML文件中看到。資料型態(tài)可以被區(qū)分成三大類：原碼（[[core]]），定義（defined），使用者定義（user-defined）。原碼可以自動被解析器分析（例如：浮點數(shù)，整數(shù)，字串，清單，映射，...）。有一些進階的資料形態(tài)──例如位元資料──在YAML中有被“定義”，但不是每一種解析器都有支援。最后，YAML支援使用者自定的區(qū)域變量，包括：自訂的類別，結構或基本型態(tài)（例如：四倍精度的浮點數(shù)）。

*'''強迫轉(zhuǎn)型'''

YAML的自動判定資料形態(tài)是哪一種實體。但有時使用者會想要將資料強迫轉(zhuǎn)型成自定的某種型態(tài)。最常見的狀況是字串，有時候可能看起來像數(shù)字或布林值，這種時候可以使用雙引號，或是使用嚴格型態(tài)標簽。

<pre>
---
a: 123                     # 整數(shù)
b: "123"                   # 字串（使用雙括號）
c: 123.0                   # 浮點數(shù)
d: !!float 123             # 浮點數(shù)，使用!!表達的嚴格型態(tài)
e: !!str 123               # 字串，使用嚴格型態(tài)
f: !!str Yes               # 字串，使用嚴格型態(tài)
g: Yes                     # 布林值"真"
h: Yes we have No bananas  # 字串（包含"Yes"和"No"）

</pre>

*'''其他特殊資料形態(tài)'''

除了一般的資料形態(tài)之外，使用者也可以使用一些較為進階的型態(tài)，但不保證可被每種解析器分析。使用時和強迫轉(zhuǎn)型類似，要在形態(tài)名稱之前加上兩個驚嘆號（!!）。有幾種重要的形態(tài)在本篇沒有討論，包括集合（sets），有序映照（ordered maps），時間郵戳（timestamps）以及[[十六進制]]資料（hexadecimal）。下面這個范例則是位元資料（binary）
<pre>
---
picture: !!binary |
 R0lGODlhDAAMAIQAAP//9/X
 17unp5WZmZgAAAOfn515eXv
 Pz7Y6OjuDg4J+fn5OTk6enp
 56enmleECcgggoBADs=mZmE
</pre>

*'''使用者自行擴充的資料形態(tài)'''

許多YAML的實現(xiàn)允許使用者自訂資料形態(tài)。在將一個物件序列化時，這個方法還頗方便的。某些區(qū)域資料形態(tài)可能不存在默認的資料形態(tài)中，不過這種型態(tài)在特定的YAML應用程式中是有定義的。這種區(qū)域資料形態(tài)用驚嘆號（!）表示。
<pre>
---
myObject:  !myClass { name: Joe, age: 15}
</pre>