Syntax
Example 4.20. Separation Spaces
{
· 
first:
· 
Sammy,
· 
last:
· 
Sosa
· 
}:
¯
# Statistics:
··
hr:
··# Home runs
···· 
65
·· 
avg:
·# Average
····
0.278
Legend:
s-separate-spaces
s-separate-lines(n)
s-indent(n)
%YAML 1.1
---
!!map {
?!!map {
?!!str "first" : !!str "Sammy",
?!!str "last" : !!str "Sosa"
}
:!!map {
?!!str "hr" : !!int "65",
?!!str "avg"
: !!float "0.278"
}
}
4.2.5. Ignored Line Prefix
YAML discards the “empty” prefix of each scalar content line. This prefix always includes the indentation, and depending on the scalar style may also include all leading white space. The ignored prefix is a presentation detail and must never be considered part of a node's content information.
[76] s-ignored-prefix(n,s) ::= s |
= plain |
s |
= double |
s |
= single |
s |
= literal |
s |
= folded |
Þs-ignored-prefix-plain(n)
Þs-ignored-prefix-quoted(n)
Þs-ignored-prefix-quoted(n)
Þs-ignored-prefix-block(n)
Þs-ignored-prefix-block(n)
•Plain scalars must not contain any tab characters, and all leading spaces are always discarded.
[77] s-ignored-prefix-plain(n) ::= s-indent(n) s-ignored-space*
•Quoted scalars may contain tab characters. Again, all leading white space is always discarded.
[78] s-ignored-prefix-quoted(n) ::= s-indent(n) s-ignored-white*
•Block scalars rely on indentation; hence leading white space, if any, is not discarded.
[79] s-ignored-prefix-block(n) ::= s-indent(n)
34
XSL• FO
RenderX
Syntax
Example 4.21. Ignored Prefix
plain: text 
·· 
lines
quoted: "text 
··→ 
lines" block: |
··
text
··
·→lines
Legend:
s-ignored-prefix-plain(n)
s-ignored-prefix-quoted(n)
s-ignored-prefix-block(n)
s-indent(n)
%YAML 1.1
---
!!map {
? !!str "plain"
:!!str "text lines", ? !!str "quoted"
:!!str "text lines", ? !!str "block"
:!!str "text·→lines\n"
}
An empty line line consists of the ignored prefix followed by a line break. When trailing block scalars, such lines can also be interpreted as (empty) comment lines. YAML provides a chomping mechanism to resolve this ambiguity.
[80] l-empty(n,s) ::= ( s-indent(<n) | s-ignored-prefix(n,s) ) b-normalized
Example 4.22. Empty Lines
|
%YAML 1.1 |
|
- foo |
--- |
|
·↓ |
!!seq { |
|
bar |
!!str "foo\nbar", |
|
!!str "foo\n\nbar" |
||
- |- |
||
} |
||
foo |
||
·↓ |
Legend: |
|
bar |
||
|
||
··↓ |
l-empty(n,s) |
|
l-comment |
||
|
4.2.6. Line Folding
Line folding allows long lines to be broken for readability, while retaining the original semantics of a single long line. When folding is done, any line break ending an empty line is preserved. In addition, any specific line breaks are also preserved, even when ending a non-empty line.
[81] b-l-folded-specific(n,s) ::= b-specific l-empty(n,s)*
Hence, folding only applies to generic line breaks that end non-empty lines. If the following line is also not empty, the generic line break is converted to a single space (#x20).
[82] b-l-folded-as-space ::= b-generic
35
XSL• FO
RenderX