编辑“YAML”（章节）

== YAML语言的构成元素 ==
*'''YAML的基本元件'''

YAML提供缩排／区块以及内置（inline）两种格式，来表示清单和杂凑表。以下展示几种YAML的基本原件。

*'''清单（阵列）'''

习惯上清单比较常用区块格式（block format）表示，也就是用短杠+空白字符作为起始。

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

另外还有一种内置格式（inline format）可以选择──用方括号围住，并用逗号+空白区隔（类似[[JSON]]的语法）
</pre>
--- # 购物清单 
[milk, pumpkin pie, eggs, juice]
</pre>

*'''杂凑表'''

键值和资料由冒号及空白字符分开。
<pre>
--- # 区块形式
name: John Smith
age: 33
--- # 內置形式
{name: John Smith, age: 33}
</pre>

*'''区块的字符'''

再次强调，字串不需要包在引号之内。保存新行(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>
根据设定，前方的引领空白符号（leading white space）必须排成条状，以便和其他资料或是行为（如范例中的缩排）明显区分。

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

和保存新行不同的是，换行字元会被转换成空白字符。而引领空白字符则会被自动消去。

*'''阶层化的元素'''

杂凑表中使用清单
<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的进阶元件'''

这部分算是一个后续的讨论，在比较各种数资料列语言时，YAML最常被提到的特色有两个：关系树和资料形态。

树状结沟之间的交互参照

资料合并和参考

为了维持文件的简洁，并避免资料输入的错误，YAML提供了结点参考（*）和杂凑合并（<<）参考到其他结点标签的锚点标记（&）。参考会将树状结构加入锚点标记的内容，并可以在所有数据结构中运作（可以参考上面"ship-to"的范例）合并只有杂凑表可以使用，可以将键值自锚点标记复制到指定的杂凑表中。

当资料被instantiate合并和参考会被剖析器自动展开。

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

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

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

*'''资料形态'''

由于自动判定资料形态的功能，严格型态（也就是使用者有宣告的资料形态）很难在大部分的YAML文件中看到。资料型态可以被区分成三大类：原码（[[core]]），定义（defined），使用者定义（user-defined）。原码可以自动被解析器分析（例如：浮点数，整数，字串，清单，映射，...）。有一些进阶的资料形态──例如位元资料──在YAML中有被“定义”，但不是每一种解析器都有支援。最后，YAML支援使用者自定的区域变量，包括：自订的类别，结构或基本型态（例如：四倍精度的浮点数）。

*'''强迫转型'''

YAML的自动判定资料形态是哪一种实体。但有时使用者会想要将资料强迫转型成自定的某种型态。最常见的状况是字串，有时候可能看起来像数字或布林值，这种时候可以使用双引号，或是使用严格型态标签。

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

</pre>

*'''其他特殊资料形态'''

除了一般的资料形态之外，使用者也可以使用一些较为进阶的型态，但不保证可被每种解析器分析。使用时和强迫转型类似，要在形态名称之前加上两个惊叹号（!!）。有几种重要的形态在本篇没有讨论，包括集合（sets），有序映照（ordered maps），时间邮戳（timestamps）以及[[十六进制]]资料（hexadecimal）。下面这个范例则是位元资料（binary）
<pre>
---
picture: !!binary |
 R0lGODlhDAAMAIQAAP//9/X
 17unp5WZmZgAAAOfn515eXv
 Pz7Y6OjuDg4J+fn5OTk6enp
 56enmleECcgggoBADs=mZmE
</pre>

*'''使用者自行扩充的资料形态'''

许多YAML的实现允许使用者自订资料形态。在将一个物件序列化时，这个方法还颇方便的。某些区域资料形态可能不存在默认的资料形态中，不过这种型态在特定的YAML应用程式中是有定义的。这种区域资料形态用惊叹号（!）表示。
<pre>
---
myObject:  !myClass { name: Joe, age: 15}
</pre>
说明	输入内容	输出结果
斜体	''斜体文字''	斜体文字
粗体	'''粗体文字'''	粗体文字
粗斜体	'''''粗斜体文字'''''	*粗斜体文字*