Skip to content

Commit 88dec4e

Browse files
committed
fix: Wrap all Liquid syntax examples in raw tags for Jekyll compatibility
- Fix Jekyll build failure by wrapping unescaped Liquid syntax in {% raw %}...{% endraw %} - Prevents Jekyll from parsing documentation examples as live Liquid code - Resolves GitHub Pages deployment issues on master branch
1 parent 94eae7b commit 88dec4e

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

docs/usage.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -607,8 +607,10 @@ When encountering template errors, follow these steps:
607607

608608
2. **Validate Template Syntax:** Use proper Jinja2 syntax
609609
```text
610+
{% raw %}
610611
Correct: {% if items %}...{% endif %}
611612
Wrong: {% if items %}...{% end %}
613+
{% endraw %}
612614
```
613615

614616
3. **Check Data Types:** Ensure operations match data types
@@ -620,8 +622,10 @@ When encountering template errors, follow these steps:
620622

621623
4. **Use Optional Variables:** Handle optional data gracefully
622624
```text
625+
{% raw %}
623626
Safe: {% if customer.email %}{{customer.email}}{% endif %}
624627
Risky: {{customer.email}} (fails if email is missing)
628+
{% endraw %}
625629
```
626630

627631
#### Common Error Scenarios
@@ -635,9 +639,11 @@ When encountering template errors, follow these steps:
635639

636640
##### Invalid Template Syntax
637641
```bash
642+
{% raw %}
638643
# Template contains unclosed tags: {% for item in items %}...
639644
# Missing: {% endfor %}
640645
# Error: "unexpected 'end of template'"
646+
{% endraw %}
641647
```
642648

643649
##### Data Type Issues

0 commit comments

Comments
 (0)