From 6d38bf6af9d82ede7a2e34081eb180acd52a7a21 Mon Sep 17 00:00:00 2001
From: WeJie <WeJie@users.noreply.github.com>
Date: Wed, 4 Sep 2019 12:25:38 +0800
Subject: [yaml/zh-cn]Update yaml-cn.html.markdown

---
 zh-cn/yaml-cn.html.markdown | 62 ++++++++++++++++++++++++---------------------
 1 file changed, 33 insertions(+), 29 deletions(-)

(limited to 'zh-cn/yaml-cn.html.markdown')

diff --git a/zh-cn/yaml-cn.html.markdown b/zh-cn/yaml-cn.html.markdown
index bbda20e9..de933d12 100644
--- a/zh-cn/yaml-cn.html.markdown
+++ b/zh-cn/yaml-cn.html.markdown
@@ -23,12 +23,12 @@ 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
@@ -60,17 +60,17 @@ 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
@@ -86,19 +86,20 @@ a_nested_map:
 
 # 序列 (等价于列表或数组) 看起来像这样：
 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
 
 # 因为 YAML 是 JSON 的超集，你也可以写 JSON 风格的映射和序列：
 json_map: {"key": "value"}
 json_seq: [3, 2, 1, "takeoff"]
+and quotes are optional: {key: [3, 2, 1, takeoff]}
 
 #######################
 # 其余的 YAML 特性    #
@@ -111,15 +112,18 @@ 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
 
@@ -146,10 +150,10 @@ 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:
@@ -157,7 +161,7 @@ set:
     ? item2
     ? item3
 
-# 像 Python 一样，集合仅是值为 null 的映射；上面的集合等价于：
+# 集合只是值为 null 的映射；上面的集合等价于：
 set2:
     item1: null
     item2: null
-- 
cgit v1.2.3


From 4f933f88a60a1ed100289d60c5d5782b3915836e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=B0=AD=E4=B9=9D=E9=BC=8E?= <109224573@qq.com>
Date: Mon, 18 Nov 2019 11:18:39 -0600
Subject: [yaml/zh-cn] Sync with en-us (#3775)

---
 zh-cn/yaml-cn.html.markdown | 31 +++++++++++++++++++++----------
 1 file changed, 21 insertions(+), 10 deletions(-)

(limited to 'zh-cn/yaml-cn.html.markdown')

diff --git a/zh-cn/yaml-cn.html.markdown b/zh-cn/yaml-cn.html.markdown
index de933d12..3ba2afd8 100644
--- a/zh-cn/yaml-cn.html.markdown
+++ b/zh-cn/yaml-cn.html.markdown
@@ -33,8 +33,13 @@ 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
 
 # 多行字符串既可以写成像一个'文字块'(使用 |)，
 # 或像一个'折叠块'(使用 '>')。
@@ -73,8 +78,8 @@ a_nested_map:
 # 键也可以是复合型的，比如多行对象
 # 我们用 ? 后跟一个空格来表示一个复合键的开始。
 ? |
-    This is a key
-    that has multiple lines
+  This is a key
+  that has multiple lines
 : and this is its value
 
 # YAML 也允许使用复杂键语法表示序列间的映射关系。
@@ -85,6 +90,7 @@ a_nested_map:
 : [ 2001-01-01, 2002-02-02 ]
 
 # 序列 (等价于列表或数组) 看起来像这样：
+# 注意 '-' 算作缩进
 a_sequence:
   - Item 1
   - Item 2
@@ -95,6 +101,8 @@ a_sequence:
   -
     - This is a sequence
     - inside another sequence
+  - - - Nested sequence indicators
+      - can be collapsed
 
 # 因为 YAML 是 JSON 的超集，你也可以写 JSON 风格的映射和序列：
 json_map: {"key": "value"}
@@ -157,15 +165,18 @@ gif_file: !!binary |
 
 # YAML 还有一个集合类型，它看起来像这样：
 set:
-    ? item1
-    ? item2
-    ? item3
+  ? item1
+  ? item2
+  ? item3
+or: {item1, item2, item3}
 
 # 集合只是值为 null 的映射；上面的集合等价于：
 set2:
-    item1: null
-    item2: null
-    item3: null
+  item1: null
+  item2: null
+  item3: null
+
+...  # document end
 ```
 
 ### 更多资源
-- 
cgit v1.2.3


From 56ee9f7971be7fe5f4fd582e7a5958b67908a08e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=B0=AD=E4=B9=9D=E9=BC=8E?= <109224573@qq.com>
Date: Sun, 12 Jan 2020 11:05:11 +0800
Subject: Update yaml-cn.html.markdown

---
 zh-cn/yaml-cn.html.markdown | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

(limited to 'zh-cn/yaml-cn.html.markdown')

diff --git a/zh-cn/yaml-cn.html.markdown b/zh-cn/yaml-cn.html.markdown
index 3ba2afd8..ebb3aa62 100644
--- a/zh-cn/yaml-cn.html.markdown
+++ b/zh-cn/yaml-cn.html.markdown
@@ -16,6 +16,8 @@ YAML 根本不容许文字制表符。
 
 
 ```yaml
+---  # document start
+
 # YAML 中的注解看起来像这样。
 
 ################
@@ -135,7 +137,7 @@ bar: &bar
 
 # foo 和 bar 将都含有 name: Everyone has same name
 
-# YAML 还有标签，你可以用它显示地声明类型。
+# YAML 还有标签，你可以用它显式地声明类型。
 explicit_string: !!str 0.5
 # 一些解析器实现特定语言的标签，就像这个针对 Python 的复数类型。
 python_complex_number: !!python/complex 1+2j
-- 
cgit v1.2.3


From 51e66185357ec8e7ab6d35d1c74d6f328029eb72 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=B0=AD=E4=B9=9D=E9=BC=8E?= <109224573@qq.com>
Date: Thu, 23 Jan 2020 10:59:04 +0800
Subject: Update zh-cn/yaml-cn.html.markdown

Co-Authored-By: woclass <inkydragon@users.noreply.github.com>
---
 zh-cn/yaml-cn.html.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'zh-cn/yaml-cn.html.markdown')

diff --git a/zh-cn/yaml-cn.html.markdown b/zh-cn/yaml-cn.html.markdown
index ebb3aa62..5a7e45f4 100644
--- a/zh-cn/yaml-cn.html.markdown
+++ b/zh-cn/yaml-cn.html.markdown
@@ -16,7 +16,7 @@ YAML 根本不容许文字制表符。
 
 
 ```yaml
----  # document start
+---  # 文档开头
 
 # YAML 中的注解看起来像这样。
 
-- 
cgit v1.2.3


From 0f6291c0b2622d66edebd3366ba4362998f6a055 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E8=B0=AD=E4=B9=9D=E9=BC=8E?= <109224573@qq.com>
Date: Thu, 23 Jan 2020 11:00:44 +0800
Subject: Update yaml-cn.html.markdown

---
 zh-cn/yaml-cn.html.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'zh-cn/yaml-cn.html.markdown')

diff --git a/zh-cn/yaml-cn.html.markdown b/zh-cn/yaml-cn.html.markdown
index 5a7e45f4..e75fafba 100644
--- a/zh-cn/yaml-cn.html.markdown
+++ b/zh-cn/yaml-cn.html.markdown
@@ -178,7 +178,7 @@ set2:
   item2: null
   item3: null
 
-...  # document end
+...  # 文档结束
 ```
 
 ### 更多资源
-- 
cgit v1.2.3


From 5864aba42d2cf57dfe96049568b3a9689ea6a813 Mon Sep 17 00:00:00 2001
From: Leigh Brenecki <l@leigh.net.au>
Date: Thu, 13 Feb 2020 10:38:29 +1030
Subject: Purge my deadname

---
 zh-cn/yaml-cn.html.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'zh-cn/yaml-cn.html.markdown')

diff --git a/zh-cn/yaml-cn.html.markdown b/zh-cn/yaml-cn.html.markdown
index e75fafba..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"]
-- 
cgit v1.2.3


From d1cb424d58985b724c442c342e5d148a7c381f5d Mon Sep 17 00:00:00 2001
From: krutik-k <68330578+krutik-k@users.noreply.github.com>
Date: Sat, 18 Jul 2020 15:34:18 +0530
Subject: YAML to JSON

You can also use https://yamlonline.com/ for the yaml validator as well as yaml converter to json,csv,xml,base64 also for beautify and minify YAML.
---
 zh-cn/yaml-cn.html.markdown | 1 +
 1 file changed, 1 insertion(+)

(limited to 'zh-cn/yaml-cn.html.markdown')

diff --git a/zh-cn/yaml-cn.html.markdown b/zh-cn/yaml-cn.html.markdown
index 7b6ff305..cad3fed5 100644
--- a/zh-cn/yaml-cn.html.markdown
+++ b/zh-cn/yaml-cn.html.markdown
@@ -184,4 +184,5 @@ set2:
 ### 更多资源
 
 + [YAML official website](http://yaml.org/)
++ [Online YAML Converter](http://yamlonline.com)
 + [Online YAML Validator](http://codebeautify.org/yaml-validator)
-- 
cgit v1.2.3


From 0c9d8a5fc5ff404e139e84dd5cd03101749d3590 Mon Sep 17 00:00:00 2001
From: Wen Sun <syl1887415157@126.com>
Date: Sun, 26 Jul 2020 17:01:53 +0800
Subject: [yaml/zh-cn]: retranslate some content

---
 zh-cn/yaml-cn.html.markdown | 82 ++++++++++++++++++++++++++++-----------------
 1 file changed, 52 insertions(+), 30 deletions(-)

(limited to 'zh-cn/yaml-cn.html.markdown')

diff --git a/zh-cn/yaml-cn.html.markdown b/zh-cn/yaml-cn.html.markdown
index 7b6ff305..8a93c026 100644
--- a/zh-cn/yaml-cn.html.markdown
+++ b/zh-cn/yaml-cn.html.markdown
@@ -5,27 +5,27 @@ contributors:
 translators:
   - ["Zach Zhang", "https://github.com/checkcheckzz"]
   - ["Jiang Haiyun", "https://github.com/haiiiiiyun"]
+  - ["Wen Sun", "https://github.com/HermitSun"]
 filename: learnyaml-cn.yaml
 lang: zh-cn
 ---
 
-YAML 是一个数据序列化语言，被设计成人类直接可写可读的。
+YAML 是一种数据序列化语言，旨在让人类直接可写可读。
 
-它是 JSON 的严格超集，增加了语法显著换行符和缩进，就像 Python。但和 Python 不一样，
-YAML 根本不容许文字制表符。
+它是 JSON 的严格超集，增加了*在语法上有意义的*（syntactically significant，参见译注1）换行符和缩进，就像Python一样。但和Python的不同之处在于，YAML不允许使用*文字制表符*（literal tab characters）来表示缩进。
 
 
 ```yaml
 ---  # 文档开头
 
-# YAML 中的注解看起来像这样。
+# YAML 中的注释看起来像这样。
 
 ################
 # 标量类型     #
 ################
 
-# 我们的根对象 (它们在整个文件里延续) 将会是一个映射，
-# 它等价于在别的语言里的一个字典，哈希表或对象。
+# 我们的根对象 (贯穿整个文档的始终) 是一个映射（map），
+# 它等价于其它语言中的一个字典（dictionary），哈希表（hash）或对象（object）。
 key: value
 another_key: Another value goes here.
 a_number_value: 100
@@ -35,16 +35,18 @@ scientific_notation: 1e+12
 boolean: true
 null_value: null
 key with spaces: value
-# 注意，字符串不必被括在引号中，但也可以被括起来。
+# 注意，字符串可以不括在引号里。当然，也可以括在引号里。
 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)
+# UTF-8/16/32字符需要指明编码（通过\u）。
+# 参见译注2。
 Superscript two: \u00B2
 
-# 多行字符串既可以写成像一个'文字块'(使用 |)，
-# 或像一个'折叠块'(使用 '>')。
+# 多行字符串既可以写成一个'字面量块'(使用 '|')，
+# 也可以写成一个'折叠块'(使用 '>')。
+# 参见译注3。
 literal_block: |
     This entire block of text will be the value of the 'literal_block' key,
     with line breaks being preserved.
@@ -67,7 +69,7 @@ folded_style: >
 # 集合类型         #
 ####################
 
-# 嵌套是通过缩进完成的。推荐使用 2 个空格的缩进（但非必须）
+# 嵌套是通过缩进完成的。推荐使用2个空格的缩进（但非必须）。
 a_nested_map:
   key: value
   another_key: Another Value
@@ -77,22 +79,22 @@ a_nested_map:
 # 映射的键不必是字符串。
 0.25: a float key
 
-# 键也可以是复合型的，比如多行对象
-# 我们用 ? 后跟一个空格来表示一个复合键的开始。
+# 键也可以是复合（complex）的，比如多行对象
+# 我们用'?'后跟一个空格来表示一个复合键的开始。
 ? |
   This is a key
   that has multiple lines
 : and this is its value
 
-# YAML 也允许使用复杂键语法表示序列间的映射关系。
-# 但有些语言的解析器可能会不支持。
+# YAML也允许使用复合键语法表示序列间的映射关系。
+# 但有些解析器可能会不支持。
 # 一个例子：
 ? - Manchester United
   - Real Madrid
 : [ 2001-01-01, 2002-02-02 ]
 
-# 序列 (等价于列表或数组) 看起来像这样：
-# 注意 '-' 算作缩进
+# 序列 (sequences，等价于列表list或数组array) 看起来像这样
+# 注意 '-' 代表缩进：
 a_sequence:
   - Item 1
   - Item 2
@@ -106,7 +108,7 @@ a_sequence:
   - - - Nested sequence indicators
       - can be collapsed
 
-# 因为 YAML 是 JSON 的超集，你也可以写 JSON 风格的映射和序列：
+# 因为YAML是JSON的超集，你也可以写JSON风格的映射和序列：
 json_map: {"key": "value"}
 json_seq: [3, 2, 1, "takeoff"]
 and quotes are optional: {key: [3, 2, 1, takeoff]}
@@ -115,7 +117,7 @@ and quotes are optional: {key: [3, 2, 1, takeoff]}
 # 其余的 YAML 特性    #
 #######################
 
-# YAML 还有一个方便的特性叫 '锚'，它能让你很容易在文档中进行文本复用。
+# YAML 还有一个方便的特性叫“锚”（anchors）。你可以使用它在文档中轻松地完成文本复用。
 # 如下两个键会有相同的值：
 anchored_content: &anchor_name This string will appear as the value of two keys.
 other_anchor: *anchor_name
@@ -124,8 +126,9 @@ other_anchor: *anchor_name
 base: &base
   name: Everyone has same name
 
-# The regexp << is called Merge Key Language-Independent Type.
-# 它表明指定映射的所有键值会插入到当前的映射中。
+# '<<'称为语言无关的合并键类型（Merge Key Language-Independent Type）.
+# 它表明一个或多个指定映射中的所有键值会插入到当前的映射中。
+# 参见译注4。
 
 foo: &foo
   <<: *base
@@ -137,42 +140,42 @@ bar: &bar
 
 # foo 和 bar 将都含有 name: Everyone has same name
 
-# YAML 还有标签，你可以用它显式地声明类型。
+# YAML 还有标签（tags），你可以用它显式地声明类型。
 explicit_string: !!str 0.5
-# 一些解析器实现特定语言的标签，就像这个针对 Python 的复数类型。
+# 一些解析器实现了特定语言的标签，就像这个针对Python的复数类型的标签。
 python_complex_number: !!python/complex 1+2j
 
-# 我们也可以在 YAML 的复合键中使用特定语言的标签
+# 我们也可以在YAML的复合键中使用特定语言的标签：
 ? !!python/tuple [5, 7]
 : Fifty Seven
-# 将会是 Python 中的  {(5, 7): 'Fifty Seven'}
+# 将会是Python中的 {(5, 7): 'Fifty Seven'}
 
 ####################
 # 其余的 YAML 类型 #
 ####################
 
-# 除了字符串和数字，YAML 还能理解其它标量。
-# ISO 格式的日期和日期时间文本也可以被解析。
+# 除了字符串和数字，YAML还支持其它标量。
+# ISO格式的日期和时间字面量也可以被解析。
 datetime: 2001-12-15T02:59:43.1Z
 datetime_with_spaces: 2001-12-14 21:59:43.10 -5
 date: 2002-12-14
 
 # 这个 !!binary 标签表明这个字符串实际上
-# 是一个用 base64 编码表示的二进制 blob。
+# 是一个用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=
 
-# YAML 还有一个集合类型，它看起来像这样：
+# YAML还有一个集合（set）类型，它看起来像这样：
 set:
   ? item1
   ? item2
   ? item3
 or: {item1, item2, item3}
 
-# 集合只是值为 null 的映射；上面的集合等价于：
+# 集合只是值均为null的映射；上面的集合等价于：
 set2:
   item1: null
   item2: null
@@ -185,3 +188,22 @@ set2:
 
 + [YAML official website](http://yaml.org/)
 + [Online YAML Validator](http://codebeautify.org/yaml-validator)
+
+### 译注
+
+1. 原文为'syntactically significant newlines and indentation'，原译为“语法显著换行符和缩进”。
+
+   个人认为，significant在此处应为“有意义的”，而非“显著的”。联系上下文，此处应指YAML的换行和缩进具有语法含义，而非在语法上显著（虽然确实很醒目）。
+
+   故译为“在语法上有意义的换行符和缩进”。
+
+2. 原文为'UTF-8/16/32 characters need to be encoded'，原译为“UTF-8/16/32 字符需要被转义”。个人认为，“转义”应为escape，并且虽然`\u`本身是一个转义字符，但目的是为了表明编码。
+
+   故译为“UTF-8/16/32字符需要指明编码”。
+
+3. “字面量块”即'literal block'，此处取literal的“字面”之意。
+
+   从下文也可以看到，字面量块会保留原字符串，包括换行等特殊字符；而折叠块会把原字符串的每一行用空格分隔，然后合并到同一行。
+
+4. 原文为'The regexp << is called Merge Key Language-Independent Type.'。若regexp直译为正则表达式，似有不妥，故在尽量保留含义的基础上有所省略。
+
-- 
cgit v1.2.3


From 8534586df73f694b8374afcd48ef5a766265347d Mon Sep 17 00:00:00 2001
From: Wen Sun <syl1887415157@126.com>
Date: Sun, 26 Jul 2020 17:06:35 +0800
Subject: [yaml/zh-cn] remove translation notes

---
 zh-cn/yaml-cn.html.markdown | 23 +----------------------
 1 file changed, 1 insertion(+), 22 deletions(-)

(limited to 'zh-cn/yaml-cn.html.markdown')

diff --git a/zh-cn/yaml-cn.html.markdown b/zh-cn/yaml-cn.html.markdown
index 8a93c026..36d30165 100644
--- a/zh-cn/yaml-cn.html.markdown
+++ b/zh-cn/yaml-cn.html.markdown
@@ -12,7 +12,7 @@ lang: zh-cn
 
 YAML 是一种数据序列化语言，旨在让人类直接可写可读。
 
-它是 JSON 的严格超集，增加了*在语法上有意义的*（syntactically significant，参见译注1）换行符和缩进，就像Python一样。但和Python的不同之处在于，YAML不允许使用*文字制表符*（literal tab characters）来表示缩进。
+它是 JSON 的严格超集，增加了*在语法上有意义的*（syntactically significant）换行符和缩进，就像Python一样。但和Python的不同之处在于，YAML不允许使用*文字制表符*（literal tab characters）来表示缩进。
 
 
 ```yaml
@@ -41,12 +41,10 @@ however: 'A string, enclosed in quotes.'
 single quotes: 'have ''one'' escape pattern'
 double quotes: "have many: \", \0, \t, \u263A, \x0d\x0a == \r\n, and more."
 # UTF-8/16/32字符需要指明编码（通过\u）。
-# 参见译注2。
 Superscript two: \u00B2
 
 # 多行字符串既可以写成一个'字面量块'(使用 '|')，
 # 也可以写成一个'折叠块'(使用 '>')。
-# 参见译注3。
 literal_block: |
     This entire block of text will be the value of the 'literal_block' key,
     with line breaks being preserved.
@@ -128,7 +126,6 @@ base: &base
 
 # '<<'称为语言无关的合并键类型（Merge Key Language-Independent Type）.
 # 它表明一个或多个指定映射中的所有键值会插入到当前的映射中。
-# 参见译注4。
 
 foo: &foo
   <<: *base
@@ -189,21 +186,3 @@ set2:
 + [YAML official website](http://yaml.org/)
 + [Online YAML Validator](http://codebeautify.org/yaml-validator)
 
-### 译注
-
-1. 原文为'syntactically significant newlines and indentation'，原译为“语法显著换行符和缩进”。
-
-   个人认为，significant在此处应为“有意义的”，而非“显著的”。联系上下文，此处应指YAML的换行和缩进具有语法含义，而非在语法上显著（虽然确实很醒目）。
-
-   故译为“在语法上有意义的换行符和缩进”。
-
-2. 原文为'UTF-8/16/32 characters need to be encoded'，原译为“UTF-8/16/32 字符需要被转义”。个人认为，“转义”应为escape，并且虽然`\u`本身是一个转义字符，但目的是为了表明编码。
-
-   故译为“UTF-8/16/32字符需要指明编码”。
-
-3. “字面量块”即'literal block'，此处取literal的“字面”之意。
-
-   从下文也可以看到，字面量块会保留原字符串，包括换行等特殊字符；而折叠块会把原字符串的每一行用空格分隔，然后合并到同一行。
-
-4. 原文为'The regexp << is called Merge Key Language-Independent Type.'。若regexp直译为正则表达式，似有不妥，故在尽量保留含义的基础上有所省略。
-
-- 
cgit v1.2.3


From 2cad7e537acd3590103f49430de0f45297202dea Mon Sep 17 00:00:00 2001
From: Wen Sun <syl1887415157@126.com>
Date: Sat, 8 Aug 2020 09:44:23 +0800
Subject: [yaml/zh-cn]: revert spaces

---
 zh-cn/yaml-cn.html.markdown | 25 ++++++++++++-------------
 1 file changed, 12 insertions(+), 13 deletions(-)

(limited to 'zh-cn/yaml-cn.html.markdown')

diff --git a/zh-cn/yaml-cn.html.markdown b/zh-cn/yaml-cn.html.markdown
index 36d30165..c82f402d 100644
--- a/zh-cn/yaml-cn.html.markdown
+++ b/zh-cn/yaml-cn.html.markdown
@@ -67,7 +67,7 @@ folded_style: >
 # 集合类型         #
 ####################
 
-# 嵌套是通过缩进完成的。推荐使用2个空格的缩进（但非必须）。
+# 嵌套是通过缩进完成的。推荐使用 2 个空格的缩进（但非必须）。
 a_nested_map:
   key: value
   another_key: Another Value
@@ -78,20 +78,20 @@ a_nested_map:
 0.25: a float key
 
 # 键也可以是复合（complex）的，比如多行对象
-# 我们用'?'后跟一个空格来表示一个复合键的开始。
+# 我们用 '?' 后跟一个空格来表示一个复合键的开始。
 ? |
   This is a key
   that has multiple lines
 : and this is its value
 
-# YAML也允许使用复合键语法表示序列间的映射关系。
+# YAML 也允许使用复杂键语法表示序列间的映射关系。
 # 但有些解析器可能会不支持。
 # 一个例子：
 ? - Manchester United
   - Real Madrid
 : [ 2001-01-01, 2002-02-02 ]
 
-# 序列 (sequences，等价于列表list或数组array) 看起来像这样
+# 序列 (sequences，等价于列表 list 或数组 array ) 看起来像这样：
 # 注意 '-' 代表缩进：
 a_sequence:
   - Item 1
@@ -106,7 +106,7 @@ a_sequence:
   - - - Nested sequence indicators
       - can be collapsed
 
-# 因为YAML是JSON的超集，你也可以写JSON风格的映射和序列：
+# 因为 YAML 是 JSON 的超集，你也可以写 JSON 风格的映射和序列：
 json_map: {"key": "value"}
 json_seq: [3, 2, 1, "takeoff"]
 and quotes are optional: {key: [3, 2, 1, takeoff]}
@@ -142,37 +142,37 @@ explicit_string: !!str 0.5
 # 一些解析器实现了特定语言的标签，就像这个针对Python的复数类型的标签。
 python_complex_number: !!python/complex 1+2j
 
-# 我们也可以在YAML的复合键中使用特定语言的标签：
+# 我们也可以在 YAML 的复合键中使用特定语言的标签：
 ? !!python/tuple [5, 7]
 : Fifty Seven
-# 将会是Python中的 {(5, 7): 'Fifty Seven'}
+# 将会是 Python 中的 {(5, 7): 'Fifty Seven'}
 
 ####################
 # 其余的 YAML 类型 #
 ####################
 
-# 除了字符串和数字，YAML还支持其它标量。
-# ISO格式的日期和时间字面量也可以被解析。
+# 除了字符串和数字，YAML 还支持其它标量。
+# ISO 格式的日期和时间字面量也可以被解析。
 datetime: 2001-12-15T02:59:43.1Z
 datetime_with_spaces: 2001-12-14 21:59:43.10 -5
 date: 2002-12-14
 
 # 这个 !!binary 标签表明这个字符串实际上
-# 是一个用base64编码表示的二进制blob。
+# 是一个用 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=
 
-# YAML还有一个集合（set）类型，它看起来像这样：
+# YAML 还有一个集合（set）类型，它看起来像这样：
 set:
   ? item1
   ? item2
   ? item3
 or: {item1, item2, item3}
 
-# 集合只是值均为null的映射；上面的集合等价于：
+# 集合只是值均为 null 的映射；上面的集合等价于：
 set2:
   item1: null
   item2: null
@@ -185,4 +185,3 @@ set2:
 
 + [YAML official website](http://yaml.org/)
 + [Online YAML Validator](http://codebeautify.org/yaml-validator)
-
-- 
cgit v1.2.3


From 90d53cbd37e0a76d9d0fb5ad84e1d63bb5a9b3dc Mon Sep 17 00:00:00 2001
From: Wen Sun <syl1887415157@126.com>
Date: Sat, 8 Aug 2020 09:49:10 +0800
Subject: [yaml/zh-cn]: revert spaces

---
 zh-cn/yaml-cn.html.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'zh-cn/yaml-cn.html.markdown')

diff --git a/zh-cn/yaml-cn.html.markdown b/zh-cn/yaml-cn.html.markdown
index c82f402d..30ed4695 100644
--- a/zh-cn/yaml-cn.html.markdown
+++ b/zh-cn/yaml-cn.html.markdown
@@ -12,7 +12,7 @@ lang: zh-cn
 
 YAML 是一种数据序列化语言，旨在让人类直接可写可读。
 
-它是 JSON 的严格超集，增加了*在语法上有意义的*（syntactically significant）换行符和缩进，就像Python一样。但和Python的不同之处在于，YAML不允许使用*文字制表符*（literal tab characters）来表示缩进。
+它是 JSON 的严格超集，增加了*在语法上有意义的*（syntactically significant）换行符和缩进，就像 Python 一样。但和 Python 的不同之处在于，YAML 不允许使用*文字制表符*（literal tab characters）来表示缩进。
 
 
 ```yaml
-- 
cgit v1.2.3


From 32ecae608ee5ea5eb037ebe67def486a61a35a21 Mon Sep 17 00:00:00 2001
From: Wen Sun <syl1887415157@126.com>
Date: Sat, 8 Aug 2020 10:04:29 +0800
Subject: [yaml/zh-cn]: modify some translation

---
 zh-cn/yaml-cn.html.markdown | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'zh-cn/yaml-cn.html.markdown')

diff --git a/zh-cn/yaml-cn.html.markdown b/zh-cn/yaml-cn.html.markdown
index 30ed4695..7ac9bc06 100644
--- a/zh-cn/yaml-cn.html.markdown
+++ b/zh-cn/yaml-cn.html.markdown
@@ -92,7 +92,7 @@ a_nested_map:
 : [ 2001-01-01, 2002-02-02 ]
 
 # 序列 (sequences，等价于列表 list 或数组 array ) 看起来像这样：
-# 注意 '-' 代表缩进：
+# 注意 '-' 也算缩进：
 a_sequence:
   - Item 1
   - Item 2
-- 
cgit v1.2.3