```
-### Valid Characters
+### Valid characters
Variables must start with an alpha character or underscore, followed by any number of additional uppercase or lowercase alphanumeric characters, hyphens, or underscores, but must not end with a hyphen. Spaces or other special characters are not allowed. A valid variable name matches this regex `[_A-Za-z][-_0-9A-Za-z]*[_A-Za-z0-9]`.
@@ -181,7 +181,7 @@ songs:
```
-#### Next / Previous
+#### Next / previous
While in a loop, you can get the respective iterations using the `next` or `prev` variables.
@@ -238,7 +238,8 @@ You can access the keys inside the dictionary "colon", "dot", or "bracket" notat
I live in {{ mailing_address:city }}. It's in {{ mailing_address:province }}.
```
-#### Multi-Dimensional Arrays
+#### Multi-dimensional arrays
+
More complex data is stored in objects or arrays inside arrays. This is usually called a multi-dimensional array.
``` yaml
@@ -293,7 +294,7 @@ Tony Hawk
Rodney Mullen
Bob Burnquist
```
-#### Dynamic Access
+#### Dynamic access
If you don't know the names of the keys inside the array – which can happen when working with dynamic or user submitted data – you can access the elements dynamically using variables for the key names.
@@ -385,7 +386,7 @@ There are more than 150 built-in [modifiers](/reference/modifiers) that can do a
You can even create [Macros](/modifiers/macro) to combine sets of often used modifiers into one, new reusable one.
-### Creating Variables
+### Creating variables
You can now set variables by using the assignment operator, `=`.
@@ -416,7 +417,7 @@ You can also create arrays, if you find the need. Keep in mind that more complex
```
-#### Sub-Expressions
+#### Sub-expressions
You can assign sub-expressions or interpolated statements to variables too. In this example, you can use `{{ items }}` as if it were the actual Collection Tag. Because it is.
@@ -431,7 +432,7 @@ You can assign sub-expressions or interpolated statements to variables too. In t
```
-### Truthy and Falsy
+### Truthy and falsy
All variables are considered "truthy" if they exist _and_ contain a value. Variables that _don't_ exist, contain an empty string, or are structured and empty (e.g. an empty array or object) are considered "falsy".
@@ -480,7 +481,7 @@ Just remember: **never render user-submitted data without escaping it first!**
An operator is a special symbol or phrase that you use to check, change, or combine values. For example, the addition operator (`+`) adds numbers, as in `1 + 2`. Statamic supports many of the operators you may already know from PHP, and adds a few new ones to make your life as a developer easier.
-### Control Flow
+### Control flow
Statamic provides a variety of control flow statements. These include `if`, `else`, `or`, `unless`, and `switch` statements to run different branches of template code based on defined conditions.
@@ -594,7 +595,7 @@ Logical operators join two or more expressions to create compound conditions.
| Xor | `$a xor $b` | `true` if either `$a` or `$b` is `true`, but not both. |
-### Ternary Statements {#ternary}
+### Ternary statements {#ternary}
Ternary statements let you write a simple condition and return one value if `true` and another if `false`, all in one expression.
@@ -619,7 +620,7 @@ The null coalescing operator (`$a ?? $b`) considers each variable in a statement
{{ meta_title ?? title ?? "Someone Forgot the Title" }}
```
-### The Gatekeeper (Truthy Assignment) {#gatekeeper}
+### The Gatekeeper (Truthy assignment) {#gatekeeper}
The Gatekeeper operator (`a ?= b`) will execute an expression **if and only if** it passes a "truthy" check. It doesn't exist in any programming language — we invented this one. Enjoy!
@@ -697,7 +698,7 @@ This is how you create variables as well as increment, decrement, or otherwise m
| Division | `$a /= $b` | Assigns the quotient of `$a` and `$b` to `$a`. |
| Modulus | `$a %= $b` | Assigns the remainder of `$a` divided by `$b` to `$a`. |
-### Self-Iterating Assignments
+### Self-iterating assignments
The left assignment operator has a super power not shared by the others. If the value of the **right-hand** expression returns a value that can be iterated (arrays, objects, etc.), the captured variable name can be used as a tag pair to iterate the returned value immediately.
@@ -707,7 +708,7 @@ The left assignment operator has a super power not shared by the others. If the
{{ /pages }}
```
-## Advanced Operators
+## Advanced operators
These operators are here for the edge cases, the wild ideas, and the unexpected client requests at midnight the night before a site launch. **These are the data wangjanglers.**
@@ -855,7 +856,7 @@ players:
Terry Mills
```
-#### Group Collection Entries by Year
+#### Group collection entries by year
```
{{ blog = {collection:blog} groupby (date|format('Y') 'year') as 'entries' }}
@@ -946,7 +947,7 @@ Multiple expressions or statements can be performed inside a single Antlers tag
19 years
```
-## Expressions and Statements
+## Expressions and statements
If you want the computer science answer, an "expression" is a combination of values and functions that are combined and interpreted to create new values, whereas a "statement" is a standalone unit of execution that doesn't return anything. 🥱
@@ -1024,7 +1025,7 @@ You may optionally disambiguate your tags by prefixing them with a `%` percent s
{{ %collection:blog }}
```
-### Tag Parameters
+### Tag parameters
Most Tags can be configured through the use of Parameters, which accepts arguments — much like an HTML attribute. In following example, the [SVG Tag](/tags/svg) is accepting a filename and string of classes to apply while rendering an inline `
'
+ : '';
return new HtmlElement(
'div',
@@ -53,6 +54,7 @@ public function render(Node $node, ChildNodeRendererInterface $childRenderer): \
"\n".
$title."\n".
$content.
+ $mascot.
"\n"
);
}
@@ -68,10 +70,10 @@ private function renderWatch(Hint $node, ChildNodeRendererInterface $childRender
return new HtmlElement(
'div',
$attrs,
- ''.
- $caption
+ '