源代码下载：learnyaml-cn.yaml
YAML 是一种数据序列化语言，旨在让人类间接可写可读。
它是 JSON 的严格超集，减少了 在语法上有意义的 （syntactically significant）换行符和缩进，就像 Python 一样。但和 Python 的不同之处在于，YAML 不容许应用 文字制表符（literal tab characters）来示意缩进。
--- # 文档结尾
# YAML 中的正文看起来像这样。################
# 标量类型 #
################
# 咱们的根对象 (贯通整个文档的始终) 是一个映射（map），# 它等价于其它语言中的一个字典（dictionary），哈希表（hash）或对象（object）。key: value
another_key: Another value goes here.
a_number_value: 100
# 数字 1 会被解释为数值，而不是一个布尔值。# 如果你想要的是一个布尔值，应用 true。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 字符须要指明编码（通过 \u）。Superscript two: \u00B2
# 多行字符串既能够写成一个 '字面量块'(应用 '|')，# 也能够写成一个 '折叠块'(应用 '>')。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.
####################
# 汇合类型 #
####################
# 嵌套是通过缩进实现的。举荐应用 2 个空格的缩进（但非必须）。a_nested_map:
key: value
another_key: Another Value
another_nested_map:
hello: hello
# 映射的键不用是字符串。0.25: a float key
# 键也能够是复合（complex）的，比方多行对象
# 咱们用 '?' 后跟一个空格来示意一个复合键的开始。? |
This is a key
that has multiple lines
: and this is its value
# YAML 也容许应用简单键语法示意序列间的映射关系。# 但有些解析器可能会不反对。# 一个例子：? - Manchester United
- Real Madrid
: [2001-01-01, 2002-02-02]
# 序列 (sequences，等价于列表 list 或数组 array) 看起来像这样：# 留神 '-' 也算缩进：a_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 个性 #
#######################
# YAML 还有一个不便的个性叫“锚”（anchors）。你能够应用它在文档中轻松地实现文本复用。# 如下两个键会有雷同的值：anchored_content: &anchor_name This string will appear as the value of two keys.
other_anchor: *anchor_name
# 锚也可被用来复制 / 继承属性
base: &base
name: Everyone has same name
# '<<' 称为语言无关的合并键类型（Merge Key Language-Independent Type）.
# 它表明一个或多个指定映射中的所有键值会插入到以后的映射中。foo: &foo
<<: *base
age: 10
bar: &bar
<<: *base
age: 20
# foo 和 bar 将都含有 name: Everyone has same name
# YAML 还有标签（tags），你能够用它显式地申明类型。explicit_string: !!str 0.5
# 一些解析器实现了特定语言的标签，就像这个针对 Python 的复数类型的标签。python_complex_number: !!python/complex 1+2j
# 咱们也能够在 YAML 的复合键中应用特定语言的标签：? !!python/tuple [5, 7]
: Fifty Seven
# 将会是 Python 中的 {(5, 7): 'Fifty Seven'}
####################
# 其余的 YAML 类型 #
####################
# 除了字符串和数字，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。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）类型，它看起来像这样：set:
? item1
? item2
? item3
or: {item1, item2, item3}
# 汇合只是值均为 null 的映射；下面的汇合等价于：set2:
item1: null
item2: null
item3: null
... # 文档完结更多资源
- YAML official website
- Online YAML Converter
- Online YAML Validator
有倡议？或者发现什么谬误？在 Github 上开一个 issue，或者发动 pull request！
原著 Leigh Brenecki，并由 0 个好心人批改。
© 2022 Leigh Brenecki
Translated by: Zach Zhang Jiang Haiyun Wen Sun
本作品采纳 CC BY-SA 3.0 协定进行许可。