From dc09a034f5f4f8eb80d352a1b4b0a996f9b6d1fe Mon Sep 17 00:00:00 2001 From: geekpi Date: Thu, 23 Sep 2021 08:41:31 +0800 Subject: [PATCH] translating --- sources/tech/20210917 Start using YAML now.md | 129 ------------------ .../tech/20210917 Start using YAML now.md | 129 ++++++++++++++++++ 2 files changed, 129 insertions(+), 129 deletions(-) delete mode 100644 sources/tech/20210917 Start using YAML now.md create mode 100644 translated/tech/20210917 Start using YAML now.md diff --git a/sources/tech/20210917 Start using YAML now.md b/sources/tech/20210917 Start using YAML now.md deleted file mode 100644 index 3b626bad09..0000000000 --- a/sources/tech/20210917 Start using YAML now.md +++ /dev/null @@ -1,129 +0,0 @@ -[#]: subject: "Start using YAML now" -[#]: via: "https://opensource.com/article/21/9/intro-yaml" -[#]: author: "Ayush Sharma https://opensource.com/users/ayushsharma" -[#]: collector: "lujun9972" -[#]: translator: "geekpi" -[#]: reviewer: " " -[#]: publisher: " " -[#]: url: " " - -Start using YAML now -====== -What is YAML, and why is it about time we started using it? -![woman on laptop sitting at the window][1] - -YAML (YAML Ain't Markup Language) is a human-readable data serialization language. Its syntax is simple and human-readable. It does not contain quotation marks, opening and closing tags, or braces. It does not contain anything which might make it harder for humans to parse nesting rules. You can scan your YAML document and immediately know what's going on. - -### YAML features - -YAML has some super features which make it superior to other serialization formats: - - * Easy to skim. - * Easy to use. - * Portable between programming languages. - * Native data structures of Agile languages. - * Consistent model to support generic tools. - * Supports one-pass processing. - * Expressive and extensible. - - - -I will show you YAML's power further with some examples. - -Can you figure out what's going on below? - - -``` -\------- -# My grocery list -groceries: -    - Milk -     - Eggs -     - Bread -     - Butter -... -``` - -The above example contains a simple list of groceries to buy, and it's a fully-formed YAML document. In YAML, strings aren't quoted, and lists need simple hyphens and spaces. A YAML document starts with **\---** and ends with **...**, but they are optional. Comments in YAML begin with a **#**. - -Indentation is key in YAML. Indentation must contain spaces, not tabs. And while the number of spaces required is flexible, it's a good idea to keep them consistent. - -### Basic Elements - -#### Collections - -YAML has two types of collections: _Lists_ (for sequences) and _dictionaries_ (for mappings). Lists are key-value pairs where every value is on a new line, beginning with a hyphen and space. Dictionaries are key-value pairs where every value is a mapping containing a key, a colon and space, and a value. - -For example: - - -``` -# My List -groceries: -    - Milk -     - Eggs -     - Bread -     - Butter - -# My dictionary -contact: - name: Ayush Sharma - email: [myemail@example.com][2] -``` - -Lists and dictionaries are often combined to provide more complex data structures. Lists can contain dictionaries, and dictionaries can contain lists. - -#### Strings - -Strings in YAML don't need quotation marks. Multi-line strings are defined using **|** or **>**. The former preserves newlines, but the latter does not. - -For example: - - -``` -my_string: | -    This is my string. -     It can contain many lines. -     Newlines are preserved. -my_string_2: > -    This is my string. -     This can also contain many lines. -     Newlines aren't preserved and all lines are folded. -``` - -#### Anchors - -YAML can have repeatable blocks of data using node anchors. The **&** character defines a block of data that is later referenced using *****. For example: - - -``` -billing_address: &add1 - house: B1 - street: My Street - -shipping_address: *add1 -``` - -At this point, you know enough YAML to get started. You can play around with the online YAML parser to test yourself. If you work with YAML daily, then [this handy cheatsheet][3] will be helpful. - -* * * - -_This article was originally published on the [author's personal blog][4] and has been adapted with permission._ - --------------------------------------------------------------------------------- - -via: https://opensource.com/article/21/9/intro-yaml - -作者：[Ayush Sharma][a] -选题：[lujun9972][b] -译者：[译者ID](https://github.com/译者ID) -校对：[校对者ID](https://github.com/校对者ID) - -本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 - -[a]: https://opensource.com/users/ayushsharma -[b]: https://github.com/lujun9972 -[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/lenovo-thinkpad-laptop-window-focus.png?itok=g0xPm2kD (young woman working on a laptop) -[2]: mailto:myemail@example.com -[3]: https://yaml.org/refcard.html -[4]: https://notes.ayushsharma.in/2021/08/introduction-to-yaml diff --git a/translated/tech/20210917 Start using YAML now.md b/translated/tech/20210917 Start using YAML now.md new file mode 100644 index 0000000000..a0523859ba --- /dev/null +++ b/translated/tech/20210917 Start using YAML now.md @@ -0,0 +1,129 @@ +[#]: subject: "Start using YAML now" +[#]: via: "https://opensource.com/article/21/9/intro-yaml" +[#]: author: "Ayush Sharma https://opensource.com/users/ayushsharma" +[#]: collector: "lujun9972" +[#]: translator: "geekpi" +[#]: reviewer: " " +[#]: publisher: " " +[#]: url: " " + +现在就开始使用 YAML +====== +什么是 YAML，为什么我们现在应该开始使用它了？ +![woman on laptop sitting at the window][1] + +YAML（YAML Ain't Markup Language）是一种人类可读的数据序列化语言。它的语法很简单，而且是人类可读的。它不包含引号、打开和关闭标签或大括号。它不包含任何可能使人类难以解析嵌套规则的东西。你可以扫描你的 YAML 文档并立即知道发生了什么。 + +### YAML 特性 + +YAML 有一些超级特性，使其优于其他序列化格式： + + * 易于浏览。 + * 易于使用。 + * 可在编程语言之间移植。 + * 敏捷语言的原生数据结构。 + * 支持通用工具的一致的模型。 + * 支持一次性处理。 + * 表现力和可扩展性。 + + + +我将通过一些例子进一步向你展示 YAML 的强大。 + +你能弄清楚下面发生了什么吗？ + + +``` +\------- +# My grocery list +groceries: + - Milk + - Eggs + - Bread + - Butter +... +``` + +上面的例子包含了一个简单的要买的杂货清单，它是一个完全格式化的 YAML 文档。在 YAML 中，字符串不加引号，而列表需要简单的连字符和空格。一个 YAML 文档以 **\---** 开始，以 **...** 结束，但它们是可选的。YAML中的注释以 **#** 开始。 + +缩进是 YAML 的关键。缩进必须包含空格，而不是制表符。虽然所需的空格数量是灵活的，但保持一致是个好主意。 + +### 基本元素 + +#### 集合 + +YAML 有两种类型的集合。_列表_（用于序列）和_字典_（用于映射）。列表是键值对，每个值都在一个新的行中，以连字符和空格开始。字典是键值对，每个值都是一个映射，包含一个键、一个冒号和空格以及一个值。 + +例如： + + +``` +# My List +groceries: + - Milk + - Eggs + - Bread + - Butter + +# My dictionary +contact: +name: Ayush Sharma +email: [myemail@example.com][2] +``` + +列表和字典经常被结合起来，以提供更复杂的数据结构。列表可以包含字典，而字典可以包含列表。 + +#### 字符串 + +YAML 中的字符串不需要加引号。多行字符串可以用 **|** 或 **>** 来定义。前者保留了换行符，而后者则没有。 + +例如： + + +``` +my_string: | + This is my string. + It can contain many lines. + Newlines are preserved. +my_string_2: > + This is my string. + This can also contain many lines. + Newlines aren't preserved and all lines are folded. +``` + +#### 锚点 + +YAML 可以通过节点锚点来获得可重复的数据块。**&** 字符定义了一个数据块，以后可以用 * 来引用。例如： + + +``` +billing_address: &add1 +house: B1 +street: My Street + +shipping_address: *add1 +``` + +到此为止，你对 YAML 的了解足以让你开始工作。你可以使用在线 YAML 解析器来测试。如果你每天都与 YAML 打交道，那么[这个方便的备忘单][3]会对你有所帮助。 + +* * * + +_这篇文章最初发表在[作者的个人博客][4]上，并经授权改编。_ + +-------------------------------------------------------------------------------- + +via: https://opensource.com/article/21/9/intro-yaml + +作者：[Ayush Sharma][a] +选题：[lujun9972][b] +译者：[geekpi](https://github.com/geekpi) +校对：[校对者ID](https://github.com/校对者ID) + +本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 + +[a]: https://opensource.com/users/ayushsharma +[b]: https://github.com/lujun9972 +[1]: https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/lenovo-thinkpad-laptop-window-focus.png?itok=g0xPm2kD (young woman working on a laptop) +[2]: mailto:myemail@example.com +[3]: https://yaml.org/refcard.html +[4]: https://notes.ayushsharma.in/2021/08/introduction-to-yaml