1 files changed, 58 insertions, 41 deletions

diff --git a/zh-cn/yaml-cn.html.markdown b/zh-cn/yaml-cn.html.markdown
index bbda20e9..7b6ff305 100644
--- a/zh-cn/yaml-cn.html.markdown
+++ b/zh-cn/yaml-cn.html.markdown
@@ -1,7 +1,7 @@
 ---
 language: yaml
 contributors:
-  - ["Adam Brenecki", "https://github.com/adambrenecki"]
+  - ["Leigh Brenecki", "https://github.com/adambrenecki"]
 translators:
   - ["Zach Zhang", "https://github.com/checkcheckzz"]
   - ["Jiang Haiyun", "https://github.com/haiiiiiyun"]
@@ -16,6 +16,8 @@ YAML 根本不容许文字制表符。
 
 
 ```yaml
+---  # 文档开头
+
 # YAML 中的注解看起来像这样。
 
 ################
@@ -23,18 +25,23 @@ YAML 根本不容许文字制表符。
 ################
 
 # 我们的根对象 (它们在整个文件里延续) 将会是一个映射，
-# 它等价于在别的语言里的一个字典，哈西表或对象。
+# 它等价于在别的语言里的一个字典，哈希表或对象。
 key: value
 another_key: Another value goes here.
 a_number_value: 100
-# 如果你想将数字 1 作为值，你必须要将它括在引号中。
-# 不然 YAML 解析器会假定它是一个布尔值 true。
+# 数字 1 会被解释为数值，而不是一个布尔值。
+# 如果你想要的是一个布尔值，使用 true。
 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."
+# 注意，字符串不必被括在引号中，但也可以被括起来。
+however: 'A string, enclosed in quotes.'
+'Keys can be quoted too.': "Useful if you want to put a ':' in your key."
+single quotes: 'have ''one'' escape pattern'
+double quotes: "have many: \", \0, \t, \u263A, \x0d\x0a == \r\n, and more."
+# UTF-8/16/32 字符需要被转义(encoded)
+Superscript two: \u00B2
 
 # 多行字符串既可以写成像一个'文字块'(使用 |)，
 # 或像一个'折叠块'(使用 '>')。
@@ -60,21 +67,21 @@ folded_style: >
 # 集合类型         #
 ####################
 
-# 嵌套是通过缩进完成的。
+# 嵌套是通过缩进完成的。推荐使用 2 个空格的缩进（但非必须）
 a_nested_map:
-    key: value
-    another_key: Another Value
-    another_nested_map:
-        hello: hello
+  key: value
+  another_key: Another Value
+  another_nested_map:
+    hello: hello
 
-# 映射的键值不必是字符串。
+# 映射的键不必是字符串。
 0.25: a float key
 
-# 键值也可以是复合型的，比如多行对象
+# 键也可以是复合型的，比如多行对象
 # 我们用 ? 后跟一个空格来表示一个复合键的开始。
 ? |
-    This is a key
-    that has multiple lines
+  This is a key
+  that has multiple lines
 : and this is its value
 
 # YAML 也允许使用复杂键语法表示序列间的映射关系。
@@ -85,20 +92,24 @@ a_nested_map:
 : [ 2001-01-01, 2002-02-02 ]
 
 # 序列 (等价于列表或数组) 看起来像这样：
+# 注意 '-' 算作缩进
 a_sequence:
-    - Item 1
-    - Item 2
-    - 0.5 # 序列可以包含不同类型。
-    - Item 4
-    - key: value
-      another_key: another_value
-    -
-        - This is a sequence
-        - inside another sequence
+  - Item 1
+  - Item 2
+  - 0.5 # 序列可以包含不同类型。
+  - Item 4
+  - key: value
+    another_key: another_value
+  -
+    - This is a sequence
+    - inside another sequence
+  - - - Nested sequence indicators
+      - can be collapsed
 
 # 因为 YAML 是 JSON 的超集，你也可以写 JSON 风格的映射和序列：
 json_map: {"key": "value"}
 json_seq: [3, 2, 1, "takeoff"]
+and quotes are optional: {key: [3, 2, 1, takeoff]}
 
 #######################
 # 其余的 YAML 特性    #
@@ -111,19 +122,22 @@ other_anchor: *anchor_name
 
 # 锚也可被用来复制/继承属性
 base: &base
-    name: Everyone has same name
+  name: Everyone has same name
+
+# The regexp << is called Merge Key Language-Independent Type.
+# 它表明指定映射的所有键值会插入到当前的映射中。
 
 foo: &foo
-    <<: *base
-    age: 10
+  <<: *base
+  age: 10
 
 bar: &bar
-    <<: *base
-    age: 20
+  <<: *base
+  age: 20
 
 # foo 和 bar 将都含有 name: Everyone has same name
 
-# YAML 还有标签，你可以用它显示地声明类型。
+# YAML 还有标签，你可以用它显式地声明类型。
 explicit_string: !!str 0.5
 # 一些解析器实现特定语言的标签，就像这个针对 Python 的复数类型。
 python_complex_number: !!python/complex 1+2j
@@ -146,22 +160,25 @@ date: 2002-12-14
 # 这个 !!binary 标签表明这个字符串实际上
 # 是一个用 base64 编码表示的二进制 blob。
 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=
+  R0lGODlhDAAMAIQAAP//9/X17unp5WZmZgAAAOfn515eXvPz7Y6OjuDg4J+fn5
+  OTk6enp56enmlpaWNjY6Ojo4SEhP/++f/++f/++f/++f/++f/++f/++f/++f/+
+  +f/++f/++f/++f/++f/++SH+Dk1hZGUgd2l0aCBHSU1QACwAAAAADAAMAAAFLC
+  AgjoEwnuNAFOhpEMTRiggcz4BNJHrv/zCFcLiwMWYNG84BwwEeECcgggoBADs=
 
 # YAML 还有一个集合类型，它看起来像这样：
 set:
-    ? item1
-    ? item2
-    ? item3
+  ? item1
+  ? item2
+  ? item3
+or: {item1, item2, item3}
 
-# 像 Python 一样，集合仅是值为 null 的映射；上面的集合等价于：
+# 集合只是值为 null 的映射；上面的集合等价于：
 set2:
-    item1: null
-    item2: null
-    item3: null
+  item1: null
+  item2: null
+  item3: null
+
+...  # 文档结束
 ```
 
 ### 更多资源