YAML 语言格式
1. 认识 YAML
YAML(Yet Another Markup Language)语言(发音 /ˈjæməl/ )是一个类似 XML、JSON 的标记性语言。YAML 强调以数据为中心,并不是以标识语言为重点。因而 YAML 本身的定义比较简单,号称“一种人性化的数据格式语言”。目的就是方便人类读写。它实质上是一种通用的数据串行化格式。
1.1 YAML 的设计目标:
人类容易阅读
可用于不同程序间的数据交换
适合描述程序所使用的数据结构,特别是脚本语言
丰富的表达能力与可扩展性
易于使用
1.2 YAML 与 XML、JSON
YAML 与 XML
- 具有 XML 同样的优点,但比 XML 更加轻量、简单、敏捷等
YAML 与 JSON
JSON 可以看作是 YAML 的子集,也就是说 JSON 能够做的事情,YAML 也能够做
YAML 能表示得比 JSON 更加简单和阅读,例如“字符串不需要引号”。所以 YAML 容易可以写成 JSON 的格式,但并不建议这种做
YAML 能够描述比 JSON 更加复杂的结构,例如“关系锚点”可以表示数据引用(如重复数据的引用)。
1.3 YAML 组织结构
YAML 文件可以由一或多个文档组成(也即相对独立的组织结构组成),文档间使用“---”(三个横线)在每文档开始作为分隔符。同时,文档也可以使用“...”(三个点号)作为结束符(可选)。
<br/>
如果只是单个文档,分隔符“---”可省略。
每个文档并不需要使用结束符“...”来表示结束,但是对于网络传输或者流来说,作为明确结束的符号,有利于软件处理。(例如不需要知道流关闭就能知道文档结束) <br/>
YAML 认为数据由以下三种结构组成:(每个文档由三种结构混合组成)
标量 (相当于数据类型)
序列 (相当于数组和列表)
键值表(相当于 Map 表)
2. YAML 编写规范
规范一:文档使用 Unicode 编码作为字符标准编码,例如 UTF-8
规范二:使用“#”来表示注释内容
- # 客户订单
- date: 2018-06-024
- customer:
- - name: Jai
- items:
- - no: 1234 # 订单号
- - descript: cpu
规范三:使用空格作为嵌套缩进工具。通常建议使用两个空格缩进,不建议使用 tab (甚至不支持)
规范四:序列表示
- 使用“-”(横线) + 单个空格表示单个列表项
- --- # 文档开始
- - 第一章 简介
- - 第二章 设计目录
- 使用"[]"表示一组数据
- --- # 文档开始
- [blue, red, green]
- 组合表示。每个结构都可以嵌套组成复杂的表示结构。
- --- # 文档开始
- - [blue, red, green] # 列表项本身也是一个列表
- - [Age, Bag]
- - site: {osc:www.oschina.net, baidu: www.baidu.com} # 这里是同 键值表 组合表示
- 使用“-”(横线) + 单个空格表示单个列表项
规范五:键值表
- 使用 “:”(冒号) + 空格表示单个键值对
- # 客户订单
- date: 2015-02-01
- customer:
- - name: Jai
- items:
- - no: 1234 # 订单号
- - descript: cpu
- - price: ¥800.00
- 使用"{}"表示一个键值表
- # 客户订单
- date: 2015-02-01
- customer:
- - name: Jai
- items: {no: 1234, descript: cpu, price: ¥800.00}
- "? " 问号+空格表示复杂的键。当键是一个列表或键值表时,就需要使用本符号来标记。
- # 使用一个列表作为键
- ? [blue, reg, green]: Color
- # 等价于
- ? - blue
- - reg
- - gree
- : Color
组合表示。每个结构都可以嵌套组成复杂的表示结构。
Color:
- blue
- red
- green
# 相当于 (也是 JSON 的表示)
{Color: [blue, red, green]}
div:
- border: {color: red, width: 2px}
- background: {color: green}
- padding: [0, 10px, 0, 10px]
# 使用缩进表示的键值表与列表项
items:
- item: cpu
model: i3
price: ¥800.00
- item: HD
model: WD
price: ¥450.00
# 上面使用 “-” 前导与缩进来表示多个列表项,相当于下面的JSON表示
items: [{item:cpu, model:i3, price:¥800.00}, {item:HD, model:WD, price: ¥450.00}]
- 使用 “:”(冒号) + 空格表示单个键值对
规范六:文本块
使用 “|” 和文本内容缩进表示的块:保留块中已有的回车换行。相当于段落块
- yaml: | # 注意 ":" 与 "|" 之间的空格
- JSON的语法其实是YAML的子集,大部分的JSON文件都可以被YAML的解释器解释。
- 如果你想更深入的学习YAML,我建议你去 http://www.yaml.org 看看
使用 “>” 和文本内容缩进表示的块:将块中回车替换为空格,最终连接成一行。
- yaml: > # 注意 ":" 与 ">" 之间的空格,另外可以使用空行来分段落
- JSON的语法其实是YAML的子集,
- 大部分的JSON文件都可以被YAML的解释器解释。
- 如果你想更深入的学习YAML,我建议你去 http://www.yaml.org 看看
使用定界符“”(双引号)、‘’(单引号)或回车表示的块:最终表示成一行。
- yaml: # 使用回车的多行,最终连接成一行。
- JSON的语法其实是YAML的子集,
- 大部分的JSON文件都可以被YAML的解释器解释。
- yaml: # 使用了双引号,双引号的好处是可以转义,即在里面可以使用特殊符号
- "JSON的语法其实是YAML的子集,
- 大部分的JSON文件都可以被YAML的解释器解释。"
规范七:数据类型的约定
对一些常用数据类型的表示格式进行了约定,包括:
- integer: 12345 # 整数标准形式
- octal: 0o34 # 八进制表示,第二个是字母 o
- hex: 0xFF # 十六进制表示
- float: 1.23e+3 # 浮点数
- fixed: 13.67 # 固定小数
- minmin: -.inf # 表示负无穷
- notNumber: .NaN # 无效数字
- null: # 空值
- boolean: [true, false] # 布尔值
- string: '12345' # 字符串
- date: 2015-08-23 # 日期
- datetime: 2015-08-23T02:02:00.1z # 日期时间
- iso8601: 2015-08-23t21:59:43.10-05:00 # iso8601 日期格式
- spaced: 2015-08-23 21:59:43.10 -5 # ?
“!”(叹号)显式指示类型,或自定义类型标识。单叹号通常是自定义类型,双叹号是内置类型
- isString: !!str 2015-08-23 # 强调是字符串不是日期数据
- picture: !!binary | # Base64 图片
- R0lGODlhDAAMAIQAAP//9/X
- 17unp5WZmZgAAAOfn515eXv
- Pz7Y6OjuDg4J+fn5OTk6enp
- 56enmleECcgggoBADs=
- #下面是内置类型
- !!int # 整数类型
- !!float # 浮点类型
- !!bool # 布尔类型
- !!str # 字符串类型
- !!binary # 也是字符串类型
- !!timestamp # 日期时间类型
- !!null # 空值
- !!set # 集合
- !!omap, !!pairs # 键值列表或对象列表
- !!seq # 序列,也是列表
- !!map # 键值表
- #下面是一些例子:
- --- !!omap
- - Mark: 65
- - Sammy: 63
- - Key: 58
- --- !!set # 注意,“?”表示键为列表,在这里列表为 null
- ? Mark
- ? Sammy
- ? Key
- # 下面是自定义的类型或标识
- %TAG ! tag:clarkevans.com,2002: # % 是指令符号
- --- !shape
- # Use the ! handle for presenting
- # tag:clarkevans.com,2002:circle
- - !circle
- center: &ORIGIN {x: 73, y: 129}
- radius: 7
- - !line
- start: *ORIGIN
- finish: { x: 89, y: 102 }
- - !label
- start: *ORIGIN
- color: 0xFFEEBB
- text: Pretty vector drawing.
规范八:锚点与引用,定义数据的复用。
- 第一步:使用 “&” 定义数据锚点(即要复制的数据)
- 第二步:使用 “*” 引用上述锚点数据(即数据的复制目的地)
- ---
- hr:
- - Mark McGwire
- # Following node labeled SS
- - &SS Sammy Sosa # 定义要复制的数据
- rbi:
- - *SS # Subsequent occurrence 这里是数据复制目标
- - Ken Griffey
1. 认识 YAML
YAML 语言(发音 /ˈjæməl/ )的设计目标,强调以数据为中心,并不是以标识语言为重点。因而 YAML 本身的定义比较简单,号称“一种人性化的数据格式语言”。就是方便人类读写。它实质上是一种通用的数据串行化格式。
1.1 YAML 的设计目标:
人类容易阅读
可用于不同程序间的数据交换
适合描述程序所使用的数据结构,特别是脚本语言
丰富的表达能力与可扩展性
易于使用
1.2 YAML 与 XML、JSON
YAML 与 XML
- 具有 XML 同样的优点,但比 XML 更加简单、敏捷等
YAML 与 JSON
JSON 可以看作是 YAML 的子集,也就是说 JSON 能够做的事情,YAML 也能够做
YAML 能表示得比 JSON 更加简单和阅读,例如“字符串不需要引号”。所以 YAML 容易可以写成 JSON 的格式,但并不建议这种做
YAML 能够描述比 JSON 更加复杂的结构,例如“关系锚点”可以表示数据引用(如重复数据的引用)。
1.3 YAML 组织结构
YAML 文件可以由一或多个文档组成(也即相对独立的组织结构组成),文档间使用“---”(三个横线)在每文档开始作为分隔符。同时,文档也可以使用“...”(三个点号)作为结束符(可选)。如下图所示:
<br/>
如果只是单个文档,分隔符“---”可省略。
每个文档并不需要使用结束符“...”来表示结束,但是对于网络传输或者流来说,作为明确结束的符号,有利于软件处理。(例如不需要知道流关闭就能知道文档结束) <br/>
YAML 认为数据由以下三种结构组成:(每个文档由三种结构混合组成)
标量 (相当于数据类型)
序列 (相当于数组和列表)
键值表(相当于 Map 表)
2. YAML 编写规范
规范一:文档使用 Unicode 编码作为字符标准编码,例如 UTF-8
规范二:使用“#”来表示注释内容
- # 客户订单
- date: 2015-02-01
- customer:
- - name: Jai
- items:
- - no: 1234 # 订单号
- - descript: cpu
规范三:使用空格作为嵌套缩进工具。通常建议使用两个空格缩进,不建议使用 tab (甚至不支持)
规范四:序列表示
- 使用“-”(横线) + 单个空格表示单个列表项
- --- # 文档开始
- - 第一章 简介
- - 第二章 设计目录
- 使用"[]"表示一组数据
- --- # 文档开始
- [blue, red, green]
- 组合表示。每个结构都可以嵌套组成复杂的表示结构。
- --- # 文档开始
- - [blue, red, green] # 列表项本身也是一个列表
- - [Age, Bag]
- - site: {osc:www.oschina.net, baidu: www.baidu.com} # 这里是同 键值表 组合表示
- 使用“-”(横线) + 单个空格表示单个列表项
规范五:键值表
- 使用 “:”(冒号) + 空格表示单个键值对
- # 客户订单
- date: 2015-02-01
- customer:
- - name: Jai
- items:
- - no: 1234 # 订单号
- - descript: cpu
- - price: ¥800.00
- 使用"{}"表示一个键值表
- # 客户订单
- date: 2015-02-01
- customer:
- - name: Jai
- items: {no: 1234, descript: cpu, price: ¥800.00}
- "? " 问号+空格表示复杂的键。当键是一个列表或键值表时,就需要使用本符号来标记。
- # 使用一个列表作为键
- ? [blue, reg, green]: Color
- # 等价于
- ? - blue
- - reg
- - gree
- : Color
组合表示。每个结构都可以嵌套组成复杂的表示结构。
Color:
- blue
- red
- green
# 相当于 (也是 JSON 的表示)
{Color: [blue, red, green]}
div:
- border: {color: red, width: 2px}
- background: {color: green}
- padding: [0, 10px, 0, 10px]
# 使用缩进表示的键值表与列表项
items:
- item: cpu
model: i3
price: ¥800.00
- item: HD
model: WD
price: ¥450.00
# 上面使用 “-” 前导与缩进来表示多个列表项,相当于下面的JSON表示
items: [{item:cpu, model:i3, price:¥800.00}, {item:HD, model:WD, price: ¥450.00}]
- 使用 “:”(冒号) + 空格表示单个键值对
规范六:文本块
使用 “|” 和文本内容缩进表示的块:保留块中已有的回车换行。相当于段落块
- yaml: | # 注意 ":" 与 "|" 之间的空格
- JSON的语法其实是YAML的子集,大部分的JSON文件都可以被YAML的解释器解释。
- 如果你想更深入的学习YAML,我建议你去 http://www.yaml.org 看看
使用 “>” 和文本内容缩进表示的块:将块中回车替换为空格,最终连接成一行。
- yaml: > # 注意 ":" 与 ">" 之间的空格,另外可以使用空行来分段落
- JSON的语法其实是YAML的子集,
- 大部分的JSON文件都可以被YAML的解释器解释。
- 如果你想更深入的学习YAML,我建议你去 http://www.yaml.org 看看
使用定界符“”(双引号)、‘’(单引号)或回车表示的块:最终表示成一行。
- yaml: # 使用回车的多行,最终连接成一行。
- JSON的语法其实是YAML的子集,
- 大部分的JSON文件都可以被YAML的解释器解释。
- yaml: # 使用了双引号,双引号的好处是可以转义,即在里面可以使用特殊符号
- "JSON的语法其实是YAML的子集,
- 大部分的JSON文件都可以被YAML的解释器解释。"
规范七:数据类型的约定
对一些常用数据类型的表示格式进行了约定,包括:
- integer: 12345 # 整数标准形式
- octal: 0o34 # 八进制表示,第二个是字母 o
- hex: 0xFF # 十六进制表示
- float: 1.23e+3 # 浮点数
- fixed: 13.67 # 固定小数
- minmin: -.inf # 表示负无穷
- notNumber: .NaN # 无效数字
- null: # 空值
- boolean: [true, false] # 布尔值
- string: '12345' # 字符串
- date: 2015-08-23 # 日期
- datetime: 2015-08-23T02:02:00.1z # 日期时间
- iso8601: 2015-08-23t21:59:43.10-05:00 # iso8601 日期格式
- spaced: 2015-08-23 21:59:43.10 -5 # ?
“!”(叹号)显式指示类型,或自定义类型标识。单叹号通常是自定义类型,双叹号是内置类型
- isString: !!str 2015-08-23 # 强调是字符串不是日期数据
- picture: !!binary | # Base64 图片
- R0lGODlhDAAMAIQAAP//9/X
- 17unp5WZmZgAAAOfn515eXv
- Pz7Y6OjuDg4J+fn5OTk6enp
- 56enmleECcgggoBADs=
- #下面是内置类型
- !!int # 整数类型
- !!float # 浮点类型
- !!bool # 布尔类型
- !!str # 字符串类型
- !!binary # 也是字符串类型
- !!timestamp # 日期时间类型
- !!null # 空值
- !!set # 集合
- !!omap, !!pairs # 键值列表或对象列表
- !!seq # 序列,也是列表
- !!map # 键值表
- #下面是一些例子:
- --- !!omap
- - Mark: 65
- - Sammy: 63
- - Key: 58
- --- !!set # 注意,“?”表示键为列表,在这里列表为 null
- ? Mark
- ? Sammy
- ? Key
- # 下面是自定义的类型或标识
- %TAG ! tag:clarkevans.com,2002: # % 是指令符号
- --- !shape
- # Use the ! handle for presenting
- # tag:clarkevans.com,2002:circle
- - !circle
- center: &ORIGIN {x: 73, y: 129}
- radius: 7
- - !line
- start: *ORIGIN
- finish: { x: 89, y: 102 }
- - !label
- start: *ORIGIN
- color: 0xFFEEBB
- text: Pretty vector drawing.
规范八:锚点与引用,定义数据的复用。
- 第一步:使用 “&” 定义数据锚点(即要复制的数据)
- 第二步:使用 “*” 引用上述锚点数据(即数据的复制目的地)
- ---
- hr:
- - Mark McGwire
- # Following node labeled SS
- - &SS Sammy Sosa # 定义要复制的数据
- rbi:
- - *SS # Subsequent occurrence 这里是数据复制目标
- - Ken Griffey
人类容易阅读
可用于不同程序间的数据交换
适合描述程序所使用的数据结构,特别是脚本语言
丰富的表达能力与可扩展性
易于使用
1.2 YAML 与 XML、JSON
YAML 与 XML
- 具有 XML 同样的优点,但比 XML 更加简单、敏捷等
YAML 与 JSON
JSON 可以看作是 YAML 的子集,也就是说 JSON 能够做的事情,YAML 也能够做
YAML 能表示得比 JSON 更加简单和阅读,例如“字符串不需要引号”。所以 YAML 容易可以写成 JSON 的格式,但并不建议这种做
YAML 能够描述比 JSON 更加复杂的结构,例如“关系锚点”可以表示数据引用(如重复数据的引用)。
1.3 YAML 组织结构
YAML 文件可以由一或多个文档组成(也即相对独立的组织结构组成),文档间使用“---”(三个横线)在每文档开始作为分隔符。同时,文档也可以使用“...”(三个点号)作为结束符(可选)。如下图所示:
<br/>
如果只是单个文档,分隔符“---”可省略。
每个文档并不需要使用结束符“...”来表示结束,但是对于网络传输或者流来说,作为明确结束的符号,有利于软件处理。(例如不需要知道流关闭就能知道文档结束) <br/>
YAML 认为数据由以下三种结构组成:(每个文档由三种结构混合组成)
标量 (相当于数据类型)
序列 (相当于数组和列表)
键值表(相当于 Map 表)
2. YAML 编写规范
规范一:文档使用 Unicode 编码作为字符标准编码,例如 UTF-8
规范二:使用“#”来表示注释内容
- # 客户订单
- date: 2015-02-01
- customer:
- - name: Jai
- items:
- - no: 1234 # 订单号
- - descript: cpu
规范三:使用空格作为嵌套缩进工具。通常建议使用两个空格缩进,不建议使用 tab (甚至不支持)
规范四:序列表示
- 使用“-”(横线) + 单个空格表示单个列表项
- --- # 文档开始
- - 第一章 简介
- - 第二章 设计目录
- 使用"[]"表示一组数据
- --- # 文档开始
- [blue, red, green]
- 组合表示。每个结构都可以嵌套组成复杂的表示结构。
- --- # 文档开始
- - [blue, red, green] # 列表项本身也是一个列表
- - [Age, Bag]
- - site: {osc:www.oschina.net, baidu: www.baidu.com} # 这里是同 键值表 组合表示
- 使用“-”(横线) + 单个空格表示单个列表项
规范五:键值表
- 使用 “:”(冒号) + 空格表示单个键值对
- # 客户订单
- date: 2015-02-01
- customer:
- - name: Jai
- items:
- - no: 1234 # 订单号
- - descript: cpu
- - price: ¥800.00
- 使用"{}"表示一个键值表
- # 客户订单
- date: 2015-02-01
- customer:
- - name: Jai
- items: {no: 1234, descript: cpu, price: ¥800.00}
- "? " 问号+空格表示复杂的键。当键是一个列表或键值表时,就需要使用本符号来标记。
- # 使用一个列表作为键
- ? [blue, reg, green]: Color
- # 等价于
- ? - blue
- - reg
- - gree
- : Color
组合表示。每个结构都可以嵌套组成复杂的表示结构。
Color:
- blue
- red
- green
# 相当于 (也是 JSON 的表示)
{Color: [blue, red, green]}
div:
- border: {color: red, width: 2px}
- background: {color: green}
- padding: [0, 10px, 0, 10px]
# 使用缩进表示的键值表与列表项
items:
- item: cpu
model: i3
price: ¥800.00
- item: HD
model: WD
price: ¥450.00
# 上面使用 “-” 前导与缩进来表示多个列表项,相当于下面的JSON表示
items: [{item:cpu, model:i3, price:¥800.00}, {item:HD, model:WD, price: ¥450.00}]
- 使用 “:”(冒号) + 空格表示单个键值对
规范六:文本块
使用 “|” 和文本内容缩进表示的块:保留块中已有的回车换行。相当于段落块
- yaml: | # 注意 ":" 与 "|" 之间的空格
- JSON的语法其实是YAML的子集,大部分的JSON文件都可以被YAML的解释器解释。
- 如果你想更深入的学习YAML,我建议你去 http://www.yaml.org 看看
使用 “>” 和文本内容缩进表示的块:将块中回车替换为空格,最终连接成一行。
- yaml: > # 注意 ":" 与 ">" 之间的空格,另外可以使用空行来分段落
- JSON的语法其实是YAML的子集,
- 大部分的JSON文件都可以被YAML的解释器解释。
- 如果你想更深入的学习YAML,我建议你去 http://www.yaml.org 看看
使用定界符“”(双引号)、‘’(单引号)或回车表示的块:最终表示成一行。
- yaml: # 使用回车的多行,最终连接成一行。
- JSON的语法其实是YAML的子集,
- 大部分的JSON文件都可以被YAML的解释器解释。
- yaml: # 使用了双引号,双引号的好处是可以转义,即在里面可以使用特殊符号
- "JSON的语法其实是YAML的子集,
- 大部分的JSON文件都可以被YAML的解释器解释。"
规范七:数据类型的约定
对一些常用数据类型的表示格式进行了约定,包括:
- integer: 12345 # 整数标准形式
- octal: 0o34 # 八进制表示,第二个是字母 o
- hex: 0xFF # 十六进制表示
- float: 1.23e+3 # 浮点数
- fixed: 13.67 # 固定小数
- minmin: -.inf # 表示负无穷
- notNumber: .NaN # 无效数字
- null: # 空值
- boolean: [true, false] # 布尔值
- string: '12345' # 字符串
- date: 2015-08-23 # 日期
- datetime: 2015-08-23T02:02:00.1z # 日期时间
- iso8601: 2015-08-23t21:59:43.10-05:00 # iso8601 日期格式
- spaced: 2015-08-23 21:59:43.10 -5 # ?
“!”(叹号)显式指示类型,或自定义类型标识。单叹号通常是自定义类型,双叹号是内置类型
- isString: !!str 2015-08-23 # 强调是字符串不是日期数据
- picture: !!binary | # Base64 图片
- R0lGODlhDAAMAIQAAP//9/X
- 17unp5WZmZgAAAOfn515eXv
- Pz7Y6OjuDg4J+fn5OTk6enp
- 56enmleECcgggoBADs=
- #下面是内置类型
- !!int # 整数类型
- !!float # 浮点类型
- !!bool # 布尔类型
- !!str # 字符串类型
- !!binary # 也是字符串类型
- !!timestamp # 日期时间类型
- !!null # 空值
- !!set # 集合
- !!omap, !!pairs # 键值列表或对象列表
- !!seq # 序列,也是列表
- !!map # 键值表
- #下面是一些例子:
- --- !!omap
- - Mark: 65
- - Sammy: 63
- - Key: 58
- --- !!set # 注意,“?”表示键为列表,在这里列表为 null
- ? Mark
- ? Sammy
- ? Key
- # 下面是自定义的类型或标识
- %TAG ! tag:clarkevans.com,2002: # % 是指令符号
- --- !shape
- # Use the ! handle for presenting
- # tag:clarkevans.com,2002:circle
- - !circle
- center: &ORIGIN {x: 73, y: 129}
- radius: 7
- - !line
- start: *ORIGIN
- finish: { x: 89, y: 102 }
- - !label
- start: *ORIGIN
- color: 0xFFEEBB
- text: Pretty vector drawing.
规范八:锚点与引用,定义数据的复用。
- 第一步:使用 “&” 定义数据锚点(即要复制的数据)
- 第二步:使用 “*” 引用上述锚点数据(即数据的复制目的地)
- ---
- hr:
- - Mark McGwire
- # Following node labeled SS
- - &SS Sammy Sosa # 定义要复制的数据
- rbi:
- - *SS # Subsequent occurrence 这里是数据复制目标
- - Ken Griffey
1.1 YAML 的设计目标:
人类容易阅读
可用于不同程序间的数据交换
适合描述程序所使用的数据结构,特别是脚本语言
丰富的表达能力与可扩展性
易于使用
1.2 YAML 与 XML、JSON
YAML 与 XML
- 具有 XML 同样的优点,但比 XML 更加简单、敏捷等
YAML 与 JSON
JSON 可以看作是 YAML 的子集,也就是说 JSON 能够做的事情,YAML 也能够做
YAML 能表示得比 JSON 更加简单和阅读,例如“字符串不需要引号”。所以 YAML 容易可以写成 JSON 的格式,但并不建议这种做
YAML 能够描述比 JSON 更加复杂的结构,例如“关系锚点”可以表示数据引用(如重复数据的引用)。
1.3 YAML 组织结构
YAML 文件可以由一或多个文档组成(也即相对独立的组织结构组成),文档间使用“---”(三个横线)在每文档开始作为分隔符。同时,文档也可以使用“...”(三个点号)作为结束符(可选)。如下图所示:
<br/>
如果只是单个文档,分隔符“---”可省略。
每个文档并不需要使用结束符“...”来表示结束,但是对于网络传输或者流来说,作为明确结束的符号,有利于软件处理。(例如不需要知道流关闭就能知道文档结束) <br/>
YAML 认为数据由以下三种结构组成:(每个文档由三种结构混合组成)
标量 (相当于数据类型)
序列 (相当于数组和列表)
键值表(相当于 Map 表)
2. YAML 编写规范
规范一:文档使用 Unicode 编码作为字符标准编码,例如 UTF-8
规范二:使用“#”来表示注释内容
- # 客户订单
- date: 2015-02-01
- customer:
- - name: Jai
- items:
- - no: 1234 # 订单号
- - descript: cpu
规范三:使用空格作为嵌套缩进工具。通常建议使用两个空格缩进,不建议使用 tab (甚至不支持)
规范四:序列表示
- 使用“-”(横线) + 单个空格表示单个列表项
- --- # 文档开始
- - 第一章 简介
- - 第二章 设计目录
- 使用"[]"表示一组数据
- --- # 文档开始
- [blue, red, green]
- 组合表示。每个结构都可以嵌套组成复杂的表示结构。
- --- # 文档开始
- - [blue, red, green] # 列表项本身也是一个列表
- - [Age, Bag]
- - site: {osc:www.oschina.net, baidu: www.baidu.com} # 这里是同 键值表 组合表示
- 使用“-”(横线) + 单个空格表示单个列表项
规范五:键值表
- 使用 “:”(冒号) + 空格表示单个键值对
- # 客户订单
- date: 2015-02-01
- customer:
- - name: Jai
- items:
- - no: 1234 # 订单号
- - descript: cpu
- - price: ¥800.00
- 使用"{}"表示一个键值表
- # 客户订单
- date: 2015-02-01
- customer:
- - name: Jai
- items: {no: 1234, descript: cpu, price: ¥800.00}
- "? " 问号+空格表示复杂的键。当键是一个列表或键值表时,就需要使用本符号来标记。
- # 使用一个列表作为键
- ? [blue, reg, green]: Color
- # 等价于
- ? - blue
- - reg
- - gree
- : Color
组合表示。每个结构都可以嵌套组成复杂的表示结构。
Color:
- blue
- red
- green
# 相当于 (也是 JSON 的表示)
{Color: [blue, red, green]}
div:
- border: {color: red, width: 2px}
- background: {color: green}
- padding: [0, 10px, 0, 10px]
# 使用缩进表示的键值表与列表项
items:
- item: cpu
model: i3
price: ¥800.00
- item: HD
model: WD
price: ¥450.00
# 上面使用 “-” 前导与缩进来表示多个列表项,相当于下面的JSON表示
items: [{item:cpu, model:i3, price:¥800.00}, {item:HD, model:WD, price: ¥450.00}]
- 使用 “:”(冒号) + 空格表示单个键值对
规范六:文本块
使用 “|” 和文本内容缩进表示的块:保留块中已有的回车换行。相当于段落块
- yaml: | # 注意 ":" 与 "|" 之间的空格
- JSON的语法其实是YAML的子集,大部分的JSON文件都可以被YAML的解释器解释。
- 如果你想更深入的学习YAML,我建议你去 http://www.yaml.org 看看
使用 “>” 和文本内容缩进表示的块:将块中回车替换为空格,最终连接成一行。
- yaml: > # 注意 ":" 与 ">" 之间的空格,另外可以使用空行来分段落
- JSON的语法其实是YAML的子集,
- 大部分的JSON文件都可以被YAML的解释器解释。
- 如果你想更深入的学习YAML,我建议你去 http://www.yaml.org 看看
使用定界符“”(双引号)、‘’(单引号)或回车表示的块:最终表示成一行。
- yaml: # 使用回车的多行,最终连接成一行。
- JSON的语法其实是YAML的子集,
- 大部分的JSON文件都可以被YAML的解释器解释。
- yaml: # 使用了双引号,双引号的好处是可以转义,即在里面可以使用特殊符号
- "JSON的语法其实是YAML的子集,
- 大部分的JSON文件都可以被YAML的解释器解释。"
规范七:数据类型的约定
对一些常用数据类型的表示格式进行了约定,包括:
- integer: 12345 # 整数标准形式
- octal: 0o34 # 八进制表示,第二个是字母 o
- hex: 0xFF # 十六进制表示
- float: 1.23e+3 # 浮点数
- fixed: 13.67 # 固定小数
- minmin: -.inf # 表示负无穷
- notNumber: .NaN # 无效数字
- null: # 空值
- boolean: [true, false] # 布尔值
- string: ‘12345‘ # 字符串
- date: 2015-08-23 # 日期
- datetime: 2015-08-23T02:02:00.1z # 日期时间
- iso8601: 2015-08-23t21:59:43.10-05:00 # iso8601 日期格式
- spaced: 2015-08-23 21:59:43.10 -5 # ?
“!”(叹号)显式指示类型,或自定义类型标识。单叹号通常是自定义类型,双叹号是内置类型
- isString: !!str 2015-08-23 # 强调是字符串不是日期数据
- picture: !!binary | # Base64 图片
- R0lGODlhDAAMAIQAAP//9/X
- 17unp5WZmZgAAAOfn515eXv
- Pz7Y6OjuDg4J+fn5OTk6enp
- 56enmleECcgggoBADs=
- #下面是内置类型
- !!int # 整数类型
- !!float # 浮点类型
- !!bool # 布尔类型
- !!str # 字符串类型
- !!binary # 也是字符串类型
- !!timestamp # 日期时间类型
- !!null # 空值
- !!set # 集合
- !!omap, !!pairs # 键值列表或对象列表
- !!seq # 序列,也是列表
- !!map # 键值表
- #下面是一些例子:
- --- !!omap
- - Mark: 65
- - Sammy: 63
- - Key: 58
- --- !!set # 注意,“?”表示键为列表,在这里列表为 null
- ? Mark
- ? Sammy
- ? Key
- # 下面是自定义的类型或标识
- %TAG ! tag:clarkevans.com,2002: # % 是指令符号
- --- !shape
- # Use the ! handle for presenting
- # tag:clarkevans.com,2002:circle
- - !circle
- center: &ORIGIN {x: 73, y: 129}
- radius: 7
- - !line
- start: *ORIGIN
- finish: { x: 89, y: 102 }
- - !label
- start: *ORIGIN
- color: 0xFFEEBB
- text: Pretty vector drawing.
规范八:锚点与引用,定义数据的复用。
- 第一步:使用 “&” 定义数据锚点(即要复制的数据)
- 第二步:使用 “*” 引用上述锚点数据(即数据的复制目的地)
- ---
- hr:
- - Mark McGwire
- # Following node labeled SS
- - &SS Sammy Sosa # 定义要复制的数据
- rbi:
- - *SS # Subsequent occurrence 这里是数据复制目标
- - Ken Griffey
规范一:文档使用 Unicode 编码作为字符标准编码,例如 UTF-8
规范二:使用“#”来表示注释内容
- # 客户订单
- date: 2015-02-01
- customer:
- - name: Jai
- items:
- - no: 1234 # 订单号
- - descript: cpu
规范三:使用空格作为嵌套缩进工具。通常建议使用两个空格缩进,不建议使用 tab (甚至不支持)
规范四:序列表示
- 使用“-”(横线) + 单个空格表示单个列表项
- --- # 文档开始
- - 第一章 简介
- - 第二章 设计目录
- 使用"[]"表示一组数据
- --- # 文档开始
- [blue, red, green]
- 组合表示。每个结构都可以嵌套组成复杂的表示结构。
- --- # 文档开始
- - [blue, red, green] # 列表项本身也是一个列表
- - [Age, Bag]
- - site: {osc:www.oschina.net, baidu: www.baidu.com} # 这里是同 键值表 组合表示
规范五:键值表
- 使用 “:”(冒号) + 空格表示单个键值对
- # 客户订单
- date: 2015-02-01
- customer:
- - name: Jai
- items:
- - no: 1234 # 订单号
- - descript: cpu
- - price: ¥800.00
- 使用"{}"表示一个键值表
- # 客户订单
- date: 2015-02-01
- customer:
- - name: Jai
- items: {no: 1234, descript: cpu, price: ¥800.00}
- "? " 问号+空格表示复杂的键。当键是一个列表或键值表时,就需要使用本符号来标记。
- # 使用一个列表作为键
- ? [blue, reg, green]: Color
- # 等价于
- ? - blue
- - reg
- - gree
- : Color
组合表示。每个结构都可以嵌套组成复杂的表示结构。
Color:
- blue
- red
- green
# 相当于 (也是 JSON 的表示)
{Color: [blue, red, green]}
div:
- border: {color: red, width: 2px}
- background: {color: green}
- padding: [0, 10px, 0, 10px]
# 使用缩进表示的键值表与列表项
items:
- item: cpu
model: i3
price: ¥800.00
- item: HD
model: WD
price: ¥450.00
# 上面使用 “-” 前导与缩进来表示多个列表项,相当于下面的JSON表示
items: [{item:cpu, model:i3, price:¥800.00}, {item:HD, model:WD, price: ¥450.00}]
规范六:文本块
使用 “|” 和文本内容缩进表示的块:保留块中已有的回车换行。相当于段落块
- yaml: | # 注意 ":" 与 "|" 之间的空格
- JSON的语法其实是YAML的子集,大部分的JSON文件都可以被YAML的解释器解释。
- 如果你想更深入的学习YAML,我建议你去 http://www.yaml.org 看看
使用 “>” 和文本内容缩进表示的块:将块中回车替换为空格,最终连接成一行。
- yaml: > # 注意 ":" 与 ">" 之间的空格,另外可以使用空行来分段落
- JSON的语法其实是YAML的子集,
- 大部分的JSON文件都可以被YAML的解释器解释。
- 如果你想更深入的学习YAML,我建议你去 http://www.yaml.org 看看
使用定界符“”(双引号)、‘’(单引号)或回车表示的块:最终表示成一行。
- yaml: # 使用回车的多行,最终连接成一行。
- JSON的语法其实是YAML的子集,
- 大部分的JSON文件都可以被YAML的解释器解释。
- yaml: # 使用了双引号,双引号的好处是可以转义,即在里面可以使用特殊符号
- "JSON的语法其实是YAML的子集,
- 大部分的JSON文件都可以被YAML的解释器解释。"
规范七:数据类型的约定
对一些常用数据类型的表示格式进行了约定,包括:
- integer: 12345 # 整数标准形式
- octal: 0o34 # 八进制表示,第二个是字母 o
- hex: 0xFF # 十六进制表示
- float: 1.23e+3 # 浮点数
- fixed: 13.67 # 固定小数
- minmin: -.inf # 表示负无穷
- notNumber: .NaN # 无效数字
- null: # 空值
- boolean: [true, false] # 布尔值
- string: ‘12345‘ # 字符串
- date: 2015-08-23 # 日期
- datetime: 2015-08-23T02:02:00.1z # 日期时间
- iso8601: 2015-08-23t21:59:43.10-05:00 # iso8601 日期格式
- spaced: 2015-08-23 21:59:43.10 -5 # ?
“!”(叹号)显式指示类型,或自定义类型标识。单叹号通常是自定义类型,双叹号是内置类型
- isString: !!str 2015-08-23 # 强调是字符串不是日期数据
- picture: !!binary | # Base64 图片
- R0lGODlhDAAMAIQAAP//9/X
- 17unp5WZmZgAAAOfn515eXv
- Pz7Y6OjuDg4J+fn5OTk6enp
- 56enmleECcgggoBADs=
- #下面是内置类型
- !!int # 整数类型
- !!float # 浮点类型
- !!bool # 布尔类型
- !!str # 字符串类型
- !!binary # 也是字符串类型
- !!timestamp # 日期时间类型
- !!null # 空值
- !!set # 集合
- !!omap, !!pairs # 键值列表或对象列表
- !!seq # 序列,也是列表
- !!map # 键值表
- #下面是一些例子:
- --- !!omap
- - Mark: 65
- - Sammy: 63
- - Key: 58
- --- !!set # 注意,“?”表示键为列表,在这里列表为 null
- ? Mark
- ? Sammy
- ? Key
- # 下面是自定义的类型或标识
- %TAG ! tag:clarkevans.com,2002: # % 是指令符号
- --- !shape
- # Use the ! handle for presenting
- # tag:clarkevans.com,2002:circle
- - !circle
- center: &ORIGIN {x: 73, y: 129}
- radius: 7
- - !line
- start: *ORIGIN
- finish: { x: 89, y: 102 }
- - !label
- start: *ORIGIN
- color: 0xFFEEBB
- text: Pretty vector drawing.
规范八:锚点与引用,定义数据的复用。
- 第一步:使用 “&” 定义数据锚点(即要复制的数据)
- 第二步:使用 “*” 引用上述锚点数据(即数据的复制目的地)
- ---
- hr:
- - Mark McGwire
- # Following node labeled SS
- - &SS Sammy Sosa # 定义要复制的数据
- rbi:
- - *SS # Subsequent occurrence 这里是数据复制目标
- - Ken Griffey
YAML 语言格式的更多相关文章
- [转帖]yaml语言格式
yaml语言格式 YAML是"YAML Ain't a Markup Language"(YAML不是一种标记语言),强调这种语言以数据做为中心,而不是以置标语言为重点. 转载2篇 ...
- yaml语言格式
YAML是"YAML Ain't a Markup Language"(YAML不是一种标记语言),强调这种语言以数据做为中心,而不是以置标语言为重点. 转载2篇比较好的关于yam ...
- YAML 语言语法
发现很多开源的软件的配置文件都使用了这种语言来描述,据说是简单强大,很不巧,ansible也使用了这种语言来描述配置,学习ansible之前,先学习一下YAML语言. YAML基本语法规则如下: 大小 ...
- 转:spring boot log4j2配置(使用log4j2.yml文件)---YAML 语言教程
转:spring boot log4j2配置(使用log4j2.yml文件) - CSDN博客http://blog.csdn.net/ClementAD/article/details/514988 ...
- YAML 语言教程
编程免不了要写配置文件,怎么写配置也是一门学问. YAML 是专门用来写配置文件的语言,非常简洁和强大,远比 JSON 格式方便. 本文介绍 YAML 的语法,以 JS-YAML 的实现为例.你可以去 ...
- YAML 语言教程(转载)
用YAML语言读取配置是最快的,之前的suricata中用yaml读取了配置,并且在代码运行期间,对配置进行了维护,所以抽点时间,来了解一下YAML语言编程,下文虽然对YAML语言和JAVAScrip ...
- Ansible 小手册系列 八(Yaml 语法格式)
YAML 语言(发音 /ˈjæməl/ )的设计目标,就是方便人类读写.它实质上是一种通用的数据串行化格式. 它的基本语法规则如下. • 大小写敏感 • 使用缩进表示层级关系 • 缩进时不允许使用Ta ...
- YAML语言简明教程
编程免不了要写配置文件,如果你还在用xml/ini/json,就有点过时了,怎么写配置也是一门学问. YAML 是专门用来写配置文件的语言,非常简洁和强大,远比 JSON 格式方便. 本文介绍 YAM ...
- 学习笔记:yaml语言教程
目录 1.YAML基本概念 1.1 简介 1.2 基本语法 1.3 支持的数据结构: 1.4 注意点 2.数据结构 2.1 字典 2.2 数组 2.3 纯量 2.4 强制类型转换,双! 2.5 字符串 ...
随机推荐
- 走进JavaWeb技术世界12:从手动编译打包到项目构建工具Maven
小李的Build之路(上) 转自: 刘欣 码农翻身 2016-07-10 摘要:手工Build的烦恼要不是为了和女朋友留在一个城市,小李肯定去北上广奋斗去了.现在他只能留在这个2.5线城市,进入这家软 ...
- 个人学习分布式专题(二)分布式服务治理之分布式协调技术Zookeeper
分布式协调技术Zookeeper 2.1 zookeeper集群安装部署(略) 2.2 zookeeper的基本原理,数据模型 2.3 zookeeper Java api的使用 2.4 zookee ...
- 第四章 基本TCP套接字编程 第五章 TCP客户/服务器程序实例
TCP客户与服务器进程之间发生的重大事件时间表 TCP服务器 socket() --- bind() --- listen() --- accept() --- read() --- write -- ...
- arcgis python ListEnvironments 函数可返回地理处理环境名称列表。
import arcpy environments = arcpy.ListEnvironments() # Sort the environment names environments.sort( ...
- Access the value of a member expression
Access the value of a member expression 解答1 You can compile and invoke a lambda expression whose bod ...
- PHP中的符号 ->、=> 和 :: 分别表示什么意思?
php新手经常碰到的问题,->.=> 和 :: 这三个家伙是什么分别都是做什么的啊!看着就很晕. 没关系,下面我们做一下详细的解释,如果你有C++,Perl基础,你会发现这些家伙和他们里面 ...
- 009-Linux nohup
一.基础概述 1./dev/null 可以将/dev/null看作"黑洞". 它非常等价于一个只写文件. 所有写入它的内容都会永远丢失. 而尝试从它那儿读取内容则什么也读不到. 然 ...
- office激活方式,超简单
只需要安装个小小的程序,亲测安全可靠 详情点击下方链接 https://blog.csdn.net/weixin_40941966/article/details/80872533
- c# 调用mysql数据库验证用户名和密码
使用mysql数据库验证用户名和密码时,如果用户名是中文,一直查不到数据 需要把app.config 中修改为 数据库统一设置utf8编码格式,连接数据库的时候设置编码Charset=utf8可以避免 ...
- 重新学习微信小程序
基础学习: 传送门:http://www.jianshu.com/p/1cec15a81722 这个简书博客介绍的很详细,今天思思重新学习了一下. 一路到最后只遇到一个坑,还是自己不仔细.这里记录下: ...