mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2024-12-23 17:41:41 +00:00
189 lines
5.8 KiB
Markdown
189 lines
5.8 KiB
Markdown
---
|
||
language: YAML
|
||
contributors:
|
||
- ["Leigh Brenecki", "https://github.com/adambrenecki"]
|
||
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 是一种数据序列化语言，旨在让人类直接可写可读。
|
||
|
||
它是 JSON 的严格超集，增加了*在语法上有意义的*（syntactically significant）换行符和缩进，就像 Python 一样。但和 Python 的不同之处在于，YAML 不允许使用*文字制表符*（literal tab characters）来表示缩进。
|
||
|
||
|
||
```yaml
|
||
--- # 文档开头
|
||
|
||
# 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](http://yaml.org/)
|
||
+ [Online YAML Converter](http://yamlonline.com)
|
||
+ [Online YAML Validator](http://codebeautify.org/yaml-validator)
|