参考http://www.ruanyifeng.com/blog/2016/07/yaml.html
基本语法规则如下。
• 大小写敏感
• 使用缩进表示层级关系
• 缩进时不允许使用Tab键,只允许使用空格。
• 缩进的空格数目不重要,只要相同层级的元素左侧对齐即可
支持的数据结构有三种。
• 对象:键值对的集合,又称为映射(mapping)/ 哈希(hashes) / 字典(dictionary)
• 数组:一组按次序排列的值,又称为序列(sequence) / 列表(list)
• 纯量(scalars):单个的、不可再分的值
下面只记录一些比较特别的表示,详细内容可看链接
1.null用~表示,如
parent: ~
2.时间,日期
时间采用 ISO8601 格式:
iso8601: 2001-12-14t21:59:43.10-05:00
转成JavaScript为:
{ iso8601: new Date('2001-12-14t21:59:43.10-05:00') }
日期采用复合 iso8601 格式的年、月、日表示;
date: 1976-07-31
转为 JavaScript 如下:
{ date: new Date('1976-07-31') }
3.强制转换类型——使用两个感叹号
e: !!str 123 f: !!str true
转为 JavaScript 如下
{ e: '123', f: 'true' }
4.字符串
1)字符串默认不使用引号表示,如:
str: 这是一行字符串
转为 JavaScript 如下:
{ str: '这是一行字符串' }
2)如果字符串之中包含空格或特殊字符,需要放在引号之中,如:
str: '内容: 字符串'
转为 JavaScript 如下:
{ str: '内容: 字符串' }
3)单引号之中如果还有单引号,必须连续使用两个单引号转义。
str: 'labor''s day'
4)字符串可以写成多行,从第二行开始,必须有一个单空格缩进。换行符会被转为空格。
str: 这是一段
多行
字符串
转为 JavaScript 如下:
{ str: '这是一段 多行 字符串' }
5)多行字符串可以使用 | 保留换行符,也可以使用 > 折叠换行。(没有则是空格连成一句)
this: | Foo Bar that: > Foo Bar
转为 JavaScript 代码如下:
{ this: 'Foo\nBar\n', that: 'Foo Bar\n' }
6) +表示保留文字块末尾的换行,-表示删除字符串末尾的换行。
s1: | Foo s2: |+ Foo s3: |- Foo
转为 JavaScript 代码如下:
{ s1: 'Foo\n', s2: 'Foo\n\n\n', s3: 'Foo' }
5.引用
锚点&和别名*,可以用来引用。
defaults: &defaults #这个冒号后面必须是一个空格 adapter: postgres host: localhost development: database: myapp_development <<: *defaults test: database: myapp_test <<: *defaults
&
用来建立锚点(defaults
),<<
表示合并到当前数据,*
用来引用锚点
所以等同于下面的代码:
defaults:
adapter: postgres
host: localhost
development:
database: myapp_development
adapter: postgres
host: localhost
test:
database: myapp_test
adapter: postgres
host: localhost
另一个例子为:
- &showell Steve - Clark - Brian - Oren - *showell
转为 JavaScript 代码如下:
[ 'Steve', 'Clark', 'Brian', 'Oren', 'Steve' ]