summaryrefslogtreecommitdiffstats
path: root/docs/docsite/rst/reference_appendices/YAMLSyntax.rst
diff options
context:
space:
mode:
authorBas <bas.meijer@me.com>2020-02-14 18:18:13 +0100
committerGitHub <noreply@github.com>2020-02-14 18:18:13 +0100
commitf35293c052b78a48d09ff8cb13f79790b3db219a (patch)
tree6c3bd3d620e82ae215cf68cf07842b48c97a029b /docs/docsite/rst/reference_appendices/YAMLSyntax.rst
parentvmware_host_firewall_manager: avoid ansible.netcommon dep (#67386) (diff)
downloadansible-f35293c052b78a48d09ff8cb13f79790b3db219a.tar.xz
ansible-f35293c052b78a48d09ff8cb13f79790b3db219a.zip
Update YAMLSyntax.rst with yamllint (#66622)
* Update YAMLSyntax.rst with yamllint Co-authored-by: Sandra McCann <samccann@redhat.com>
Diffstat (limited to '')
-rw-r--r--docs/docsite/rst/reference_appendices/YAMLSyntax.rst41
1 files changed, 21 insertions, 20 deletions
diff --git a/docs/docsite/rst/reference_appendices/YAMLSyntax.rst b/docs/docsite/rst/reference_appendices/YAMLSyntax.rst
index 7a689b0a60..7d43966403 100644
--- a/docs/docsite/rst/reference_appendices/YAMLSyntax.rst
+++ b/docs/docsite/rst/reference_appendices/YAMLSyntax.rst
@@ -5,7 +5,7 @@ YAML Syntax
===========
This page provides a basic overview of correct YAML syntax, which is how Ansible
-playbooks (our configuration management language) are expressed.
+playbooks (our configuration management language) are expressed.
We use YAML because it is easier for humans to read and write than other common
data formats like XML or JSON. Further, there are libraries available in most
@@ -18,7 +18,7 @@ is used in practice.
YAML Basics
-----------
-For Ansible, nearly every YAML file starts with a list.
+For Ansible, nearly every YAML file starts with a list.
Each item in the list is a list of key/value pairs, commonly
called a "hash" or a "dictionary". So, we need to know how
to write lists and dictionaries in YAML.
@@ -40,21 +40,21 @@ A dictionary is represented in a simple ``key: value`` form (the colon must be f
# An employee record
martin:
- name: Martin D'vloper
- job: Developer
- skill: Elite
+ name: Martin D'vloper
+ job: Developer
+ skill: Elite
More complicated data structures are possible, such as lists of dictionaries, dictionaries whose values are lists or a mix of both::
# Employee records
- - martin:
+ - martin:
name: Martin D'vloper
job: Developer
skills:
- python
- perl
- pascal
- - tabitha:
+ - tabitha:
name: Tabitha Bitumen
job: Developer
skills:
@@ -80,6 +80,8 @@ Ansible doesn't really use these too much, but you can also specify a boolean va
likes_emacs: TRUE
uses_cvs: false
+Use lowercase 'true' or 'false' for boolean values in dictionaries if you want to be compatible with default yamllint options.
+
Values can span multiple lines using ``|`` or ``>``. Spanning multiple lines using a "Literal Block Scalar" ``|`` will include the newlines and any trailing spaces.
Using a "Folded Block Scalar" ``>`` will fold newlines to spaces; it's used to make what would otherwise be a very long line easier to read and edit.
In either case the indentation will be ignored.
@@ -117,18 +119,18 @@ This really has nothing to do with Ansible, but will give you a feel for the for
skill: Elite
employed: True
foods:
- - Apple
- - Orange
- - Strawberry
- - Mango
+ - Apple
+ - Orange
+ - Strawberry
+ - Mango
languages:
- perl: Elite
- python: Elite
- pascal: Lame
+ perl: Elite
+ python: Elite
+ pascal: Lame
education: |
- 4 GCSEs
- 3 A-Levels
- BSc in the Internet of Things
+ 4 GCSEs
+ 3 A-Levels
+ BSc in the Internet of Things
That's all you really need to know about YAML to start writing `Ansible` playbooks.
@@ -152,7 +154,7 @@ Because of this, the following is going to result in a YAML syntax error::
You will want to quote hash values using colons followed by a space or the end of the line::
foo: 'somebody said I should put a colon here: so I did'
-
+
windows_drive: 'c:'
...and then the colon will be preserved.
@@ -160,7 +162,7 @@ You will want to quote hash values using colons followed by a space or the end o
Alternatively, you can use double quotes::
foo: "somebody said I should put a colon here: so I did"
-
+
windows_drive: "c:"
The difference between single quotes and double quotes is that in double quotes
@@ -238,4 +240,3 @@ value::
implementing
`YAML 1.2 Specification <https://yaml.org/spec/1.2/spec.html>`_
For completeness, YAML 1.2 is the successor of 1.1
-