神马文学网五分钟认识yaml
来源：百度文库 编辑：神马文学网 时间：2024/04/28 22:13:32
5分钟认识YAML
翻译：liubin http://www.ruby-cn.org/
原文：http://yaml.kwiki.org/index.cgi?HomePage
文档位置：http://www.ruby-cn.org/articles/yaml_in_5_minutes.html
2004/11/11
译者注：在开始之前，也许，你想先看看yaml的基本概念，如果是，请点这里：http://www.ruby-cn.org/articles/what_is_yaml.html
第一分钟：一个简单的列表
你的朋友给你寄了一封如下的信件：
- Memoirs Found in a Bathtub- Snow Crash- Ghost World
同时，他也要求你按照上面的顺序来阅读这些书，他想和你探讨关于这些书的内容。
在YAML中，这些有顺序的列表（list）叫做序列（sequence）。序列包括了一组有顺序的数据，当你在程序中载入这个序列，它们的顺序保持不变。
在很多比较灵活的语言中，你可以用指定索引的方式访问这个序列及其中的值。以0开头的表示这个序列的第一项。
在PHP, Perl, 或 Ruby中，可以这样：
print $book_list[0];
打印结果如下：
Memoirs Found in a Bathtub
这也是上面书籍列表的第一项。
其他列表
列表（Lists）可以包括各种数据：
---- 1 # Numbers- Snow Crash # Strings- 2003-07-24 # Dates
上面的列表以三个"-"开头，这三个"-"是文档分割符（document separator），它表示了一段YAML文档的开始。当然，你也可以划分多个文档，比如：
---- Harry Potter and the Prisoner of Azkaban- Harry Potter and the Goblet of Fire- Harry Potter and the Order of the Phoenix---- Memoirs Found in a Bathtub- Snow Crash- Ghost World
第二分钟：一个简单的字典
当你沉浸在阅读 Harry Potter 时，你的朋友又寄来了新的列表，这次列表包括了作者的名字：
Stanislaw Lem: Memoirs Found in a BathtubNeal Stephenson: SnowcrashDaniel Clowes: Ghost World
上面的字典没有顺序，但是每个作者都对应一本书的名字。你的朋友希望你可以根据作者找到你想要的书。（注意前面没有"-"）
在YAML中，这样的字典结构称为 map，map通常用来存放成对的数据，冒号左面的称为key，右面的叫做value。
key 用作从map中取数据的索引。
在PHP 或 Ruby中，可以这样写：
print $books_by_author[‘Daniel Clowes‘];
将打印如下内容:
Ghost WorldSequence中的Map
你的朋友寄给你了一份更新的列表，包括了作者，书名，并且有一定的顺序，希望你能按照这个顺序来阅读。
---- Stanislaw Lem: Memoirs Found in a Bathtub- Neal Stephenson: Snowcrash- Daniel Clowes: Ghost World
上面的序列中，每一项都是一个map，当一种集合（collection ）包括另一种集合时，称作嵌套（nesting）。
第三分钟：邮箱里的东西
第三分钟我们先放慢一下速度，老师让你朋友这么打扰你我想过不多久你肯定会被气疯的。
冉我们来看看你的信箱。你住在一个公寓里，你的信箱只有一个小口可以投信，旁边是其他的几百个信箱。
你检查一下自己的信箱发现了五封信。两封是给你的邻居Jim O‘Connor的，一封是给一个叫做"Hank Bros.: the Car Wash!"的公司的，其他的两封信是你自己的。
你打算对自己邮箱里多出来的信进行投诉，你打算给邮局发送一封信，让他们看看这给你带来了多大的麻烦。
你开始了一个新的YAML文档，里面包括今天的日期，和你的信箱里的信件：
---date: 2003-07-25letters to: "Hank Bros.: the Car Wash!": 1 Jim O‘Connor: 2 Myself: 2
这个例子里，一个map嵌套了另一个map，第一个MAP的key是，它的值是letters to 一个被嵌套的MAP，第二个MAP是缩进排列的。
在PHP或者RUBY中，可以这样访问：
print $mailbox[‘letters to‘][‘Myself‘];
将会打印:
2
你也发现了，"Hank Bros.: the Car Wash!"用双银号扩起来了，这是因为这里面包括了冒好。否则，会引起麻烦的，你将可能弄不清哪个是key 哪个是value。
第四分钟：更多消息
你从邮局得到了一些解释：
---Concerning Car Washes: > We are sorry to have misplaced this letter. We were told by a reliable source that you were the owner of "Hank Bros.: the Car Wash!". Sorry.
邮局工作有误，但这也向我们展示了YAML的另一个特点：块（block ）。在他们的信息里，用到了block。
在 YAML中，一个 block 是一段文本，它们缩进一个或多个空格。
注意这个大于号： >。它表示一个“folded block”的开始。所谓folded block，就是一行一行紧挨着句子将组成一个段落，这个段落就像我们读课文那样可以阅读的。
上面的消息在YAML 阅读器看来将分为两行，由一个回车换行分割。
Controlling Words
上面的消息还没完，这是后面的：
Concerning "Jim O‘Connor": | You are receiving Jim O‘Connor‘s mail for several reasons: - The nameplate on your mailbox still says his name. - He has told our postman that you screen his mail. - He is living in your ceiling. - He held a raygun to the postmans head.
这看起来有点古怪，邮局的人用一个竖线，取代了原来的大于号，这有什么不同吗？
一个竖线（也称管道pipe），表示了一个literal block的开始。 literal block 表示每个句子自成一节，这个块将会像计算机读取那样，都是字面值。
YAML 阅读器会把上面的块当作5行（第一行是空行）。
第五分钟：这就是全部吗？
到现在，看起来YAML也就这么多东西而已，它只是一些列表和字典组成的集合而已？
这只是我们五分钟能谈论到的最基本的东西，在继续之前，来看最后一个概念。
这里是一个人读这个五分钟教程所用时间的纪录：
---name: Dirk Hockeybranchminutes spent: - 1.02 - 1.34 - 0.7 - 0.89 - 0.94
上面我们用一个序列 (sequence)嵌套在了一个map中，序列中的每项代表了在第几步所用的时间。如果每个人都把自己阅读的时间像这样寄给我们，那我们需要给本教程准备一个更准确的名字，比如YAML in Five-Point-One-Two Minutes。这将有点华而不实。（我们可能需要很多的篇幅来写这样的文档。）
一个机灵的YAML用户可能会用 inline sequence来记录它们所用的时间：
---name: Dirk Hockeybranchminutes spent: [1.02, 1.34, 0.7, 0.89, 0.94]
对于短的列表，你可以把它们都房在一行里，各项之间用逗号分割，最后用中括号括起来。
Inline maps 也类似:
---minutes spent: {one: 1.02, two: 1.34, three: 0.7, four: 0.89, five: 0.94}
以上也要谨慎使用，BLOCK在inline sequences 或 Inline maps 中不能使用。
结论
看看时间，多长时间了？五分钟？还是十分钟？
如果你想更深入的学习YAML，我建议你去看看YAML Cookbook，一本非常好的手册，它将会更详细的讲解YAML，你一定会惊奇于YAML提供的功能。
最后，谢谢你花时间来阅读这篇文章
翻译：liubin http://www.ruby-cn.org/
原文：http://yaml.kwiki.org/index.cgi?HomePage
文档位置：http://www.ruby-cn.org/articles/yaml_in_5_minutes.html
2004/11/11
译者注：在开始之前，也许，你想先看看yaml的基本概念，如果是，请点这里：http://www.ruby-cn.org/articles/what_is_yaml.html
第一分钟：一个简单的列表
你的朋友给你寄了一封如下的信件：
- Memoirs Found in a Bathtub- Snow Crash- Ghost World
同时，他也要求你按照上面的顺序来阅读这些书，他想和你探讨关于这些书的内容。
在YAML中，这些有顺序的列表（list）叫做序列（sequence）。序列包括了一组有顺序的数据，当你在程序中载入这个序列，它们的顺序保持不变。
在很多比较灵活的语言中，你可以用指定索引的方式访问这个序列及其中的值。以0开头的表示这个序列的第一项。
在PHP, Perl, 或 Ruby中，可以这样：
print $book_list[0];
打印结果如下：
Memoirs Found in a Bathtub
这也是上面书籍列表的第一项。
其他列表
列表（Lists）可以包括各种数据：
---- 1 # Numbers- Snow Crash # Strings- 2003-07-24 # Dates
上面的列表以三个"-"开头，这三个"-"是文档分割符（document separator），它表示了一段YAML文档的开始。当然，你也可以划分多个文档，比如：
---- Harry Potter and the Prisoner of Azkaban- Harry Potter and the Goblet of Fire- Harry Potter and the Order of the Phoenix---- Memoirs Found in a Bathtub- Snow Crash- Ghost World
第二分钟：一个简单的字典
当你沉浸在阅读 Harry Potter 时，你的朋友又寄来了新的列表，这次列表包括了作者的名字：
Stanislaw Lem: Memoirs Found in a BathtubNeal Stephenson: SnowcrashDaniel Clowes: Ghost World
上面的字典没有顺序，但是每个作者都对应一本书的名字。你的朋友希望你可以根据作者找到你想要的书。（注意前面没有"-"）
在YAML中，这样的字典结构称为 map，map通常用来存放成对的数据，冒号左面的称为key，右面的叫做value。
key 用作从map中取数据的索引。
在PHP 或 Ruby中，可以这样写：
print $books_by_author[‘Daniel Clowes‘];
将打印如下内容:
Ghost WorldSequence中的Map
你的朋友寄给你了一份更新的列表，包括了作者，书名，并且有一定的顺序，希望你能按照这个顺序来阅读。
---- Stanislaw Lem: Memoirs Found in a Bathtub- Neal Stephenson: Snowcrash- Daniel Clowes: Ghost World
上面的序列中，每一项都是一个map，当一种集合（collection ）包括另一种集合时，称作嵌套（nesting）。
第三分钟：邮箱里的东西
第三分钟我们先放慢一下速度，老师让你朋友这么打扰你我想过不多久你肯定会被气疯的。
冉我们来看看你的信箱。你住在一个公寓里，你的信箱只有一个小口可以投信，旁边是其他的几百个信箱。
你检查一下自己的信箱发现了五封信。两封是给你的邻居Jim O‘Connor的，一封是给一个叫做"Hank Bros.: the Car Wash!"的公司的，其他的两封信是你自己的。
你打算对自己邮箱里多出来的信进行投诉，你打算给邮局发送一封信，让他们看看这给你带来了多大的麻烦。
你开始了一个新的YAML文档，里面包括今天的日期，和你的信箱里的信件：
---date: 2003-07-25letters to: "Hank Bros.: the Car Wash!": 1 Jim O‘Connor: 2 Myself: 2
这个例子里，一个map嵌套了另一个map，第一个MAP的key是，它的值是letters to 一个被嵌套的MAP，第二个MAP是缩进排列的。
在PHP或者RUBY中，可以这样访问：
print $mailbox[‘letters to‘][‘Myself‘];
将会打印:
2
你也发现了，"Hank Bros.: the Car Wash!"用双银号扩起来了，这是因为这里面包括了冒好。否则，会引起麻烦的，你将可能弄不清哪个是key 哪个是value。
第四分钟：更多消息
你从邮局得到了一些解释：
---Concerning Car Washes: > We are sorry to have misplaced this letter. We were told by a reliable source that you were the owner of "Hank Bros.: the Car Wash!". Sorry.
邮局工作有误，但这也向我们展示了YAML的另一个特点：块（block ）。在他们的信息里，用到了block。
在 YAML中，一个 block 是一段文本，它们缩进一个或多个空格。
注意这个大于号： >。它表示一个“folded block”的开始。所谓folded block，就是一行一行紧挨着句子将组成一个段落，这个段落就像我们读课文那样可以阅读的。
上面的消息在YAML 阅读器看来将分为两行，由一个回车换行分割。
Controlling Words
上面的消息还没完，这是后面的：
Concerning "Jim O‘Connor": | You are receiving Jim O‘Connor‘s mail for several reasons: - The nameplate on your mailbox still says his name. - He has told our postman that you screen his mail. - He is living in your ceiling. - He held a raygun to the postmans head.
这看起来有点古怪，邮局的人用一个竖线，取代了原来的大于号，这有什么不同吗？
一个竖线（也称管道pipe），表示了一个literal block的开始。 literal block 表示每个句子自成一节，这个块将会像计算机读取那样，都是字面值。
YAML 阅读器会把上面的块当作5行（第一行是空行）。
第五分钟：这就是全部吗？
到现在，看起来YAML也就这么多东西而已，它只是一些列表和字典组成的集合而已？
这只是我们五分钟能谈论到的最基本的东西，在继续之前，来看最后一个概念。
这里是一个人读这个五分钟教程所用时间的纪录：
---name: Dirk Hockeybranchminutes spent: - 1.02 - 1.34 - 0.7 - 0.89 - 0.94
上面我们用一个序列 (sequence)嵌套在了一个map中，序列中的每项代表了在第几步所用的时间。如果每个人都把自己阅读的时间像这样寄给我们，那我们需要给本教程准备一个更准确的名字，比如YAML in Five-Point-One-Two Minutes。这将有点华而不实。（我们可能需要很多的篇幅来写这样的文档。）
一个机灵的YAML用户可能会用 inline sequence来记录它们所用的时间：
---name: Dirk Hockeybranchminutes spent: [1.02, 1.34, 0.7, 0.89, 0.94]
对于短的列表，你可以把它们都房在一行里，各项之间用逗号分割，最后用中括号括起来。
Inline maps 也类似:
---minutes spent: {one: 1.02, two: 1.34, three: 0.7, four: 0.89, five: 0.94}
以上也要谨慎使用，BLOCK在inline sequences 或 Inline maps 中不能使用。
结论
看看时间，多长时间了？五分钟？还是十分钟？
如果你想更深入的学习YAML，我建议你去看看YAML Cookbook，一本非常好的手册，它将会更详细的讲解YAML，你一定会惊奇于YAML提供的功能。
最后，谢谢你花时间来阅读这篇文章