docs: replace Jinja2-style block endings with {% end %} in Kida examples

lbliii · cursoragent · lbliii · commit 1e15d0990a6e · 2026-02-08T11:18:30.000-05:00
Kida uses unified {% end %} for all block endings. Updated all Kida code
examples to use {% end %} instead of {% endblock %}, {% endfor %},
{% endmacro %}, and {% endcall %}. Jinja2 "before" examples in migration
docs correctly retain old syntax.

Co-authored-by: Cursor &lt;cursoragent@cursor.com&gt;
diff --git a/site/content/docs/content/authoring/linking.md b/site/content/docs/content/authoring/linking.md
@@ -457,7 +457,7 @@ All linking methods use O(1) lookups from pre-built indexes:
 <nav>
   {% for item in site.menus.main %}
     <a href="{{ item.url }}">{{ item.name }}</a>
-  {% endfor %}
+  {% end %}
 </nav>
 ```
 
@@ -480,7 +480,7 @@ All linking methods use O(1) lookups from pre-built indexes:
   <ul>
     {% for page in related %}
       <li>{{ ref(page.path) }}</li>
-    {% endfor %}
+    {% end %}
   </ul>
 {% end %}
 ```
diff --git a/site/content/docs/content/reuse/filtering.md b/site/content/docs/content/reuse/filtering.md
@@ -114,7 +114,7 @@ Here are all our Python tutorials.
     {% end %}
   </div>
 
-{% endblock %}
+{% end %}
 ```
 
 ## Summary
diff --git a/site/content/docs/reference/kida-syntax.md b/site/content/docs/reference/kida-syntax.md
@@ -251,10 +251,10 @@ Make a variable from an inner scope available to the outer scope:
   <article>
     {{ page.content | safe }}
   </article>
-{% endblock %}
+{% end %}
 ```
 
-**Note**: Kida uses `{% endblock %}` for blocks (Jinja2 compatibility), but `{% end %}` works too.
+**Note**: Kida uses `{% end %}` as the preferred block ending. `{% endblock %}` is also accepted for Jinja2 compatibility.
 
 ### Includes
 
@@ -319,7 +319,7 @@ Kida functions can access variables from their surrounding context automatically
 
 {% call card(page) %}
   <p>Custom content here</p>
-{% endcall %}
+{% end %}
 ```
 
 ## Filters and Pipeline
@@ -936,7 +936,7 @@ Kida can parse Jinja2 syntax via compatibility mode. Most Jinja2 templates work
       {{ build_sidebar(site.pages) }}
     </aside>
   {% end %}
-{% endblock %}
+{% end %}
 ```
 
 ## See Also
diff --git a/site/content/docs/theming/templating/_index.md b/site/content/docs/theming/templating/_index.md
@@ -46,7 +46,7 @@ Bengal searches: **Your project** → **Theme** → **Bengal defaults**
   <h1>{{ page.title }}</h1>
   {{ page.content | safe }}
 </article>
-{% endblock %}
+{% end %}
 ```
 :::
 
@@ -56,12 +56,12 @@ Bengal searches: **Your project** → **Theme** → **Bengal defaults**
 <!DOCTYPE html>
 <html>
 <head>
-  <title>{% block title %}{{ page.title }}{% endblock %}</title>
+  <title>{% block title %}{{ page.title }}{% end %}</title>
 </head>
 <body>
-  {% block header %}{% include "partials/header.html" %}{% endblock %}
-  {% block content %}{% endblock %}
-  {% block footer %}{% include "partials/footer.html" %}{% endblock %}
+  {% block header %}{% include "partials/header.html" %}{% end %}
+  {% block content %}{% end %}
+  {% block footer %}{% include "partials/footer.html" %}{% end %}
 </body>
 </html>
 ```
@@ -86,7 +86,7 @@ Bengal searches: **Your project** → **Theme** → **Bengal defaults**
 | Concept | Syntax | Purpose |
 |---------|--------|---------|
 | **Extends** | `{% extends "base.html" %}` | Inherit from parent template |
-| **Block** | `{% block name %}...{% endblock %}` | Replaceable section |
+| **Block** | `{% block name %}...{% end %}` | Replaceable section |
 | **Include** | `{% include "partial.html" %}` | Insert another template |
 | **Variable** | `{{ page.title }}` | Output a value |
 | **Filter** | `{{ text \| truncate(100) }}` | Transform a value |
diff --git a/site/content/docs/theming/templating/image-processing.md b/site/content/docs/theming/templating/image-processing.md
@@ -128,7 +128,7 @@ You can create a reusable responsive image pattern in your templates:
      sizes="{{ sizes }}"
      alt="{{ alt }}"
      loading="{{ loading }}" />
-{% endmacro %}
+{% end %}
 
 {# Usage #}
 {{ responsive_img('hero.jpg', alt='Hero image', sizes='(max-width: 768px) 100vw, 50vw') }}
diff --git a/site/content/docs/theming/templating/kida/caching/fragments.md b/site/content/docs/theming/templating/kida/caching/fragments.md
@@ -321,7 +321,7 @@ bengal build --verbose
       {% end %}
     {% end %}
   </article>
-{% endblock %}
+{% end %}
 
 {% block sidebar %}
   {% cache "sidebar-nav-" ~ site.nav_version %}
@@ -331,5 +331,5 @@ bengal build --verbose
   {% cache "tag-cloud" %}
     {{ build_tag_cloud(site.tags) }}
   {% end %}
-{% endblock %}
+{% end %}
 ```
diff --git a/site/content/docs/theming/templating/kida/migration/from-jinja.md b/site/content/docs/theming/templating/kida/migration/from-jinja.md
@@ -224,7 +224,7 @@ cp templates/blog/single.html templates/blog/single.html.jinja2
 # Replace all block endings with {% end %}
 sed -i 's/{% endif %}/{% end %}/g' templates/blog/single.html
 sed -i 's/{% endfor %}/{% end %}/g' templates/blog/single.html
-sed -i 's/{% endblock %}/{% endblock %}/g' templates/blog/single.html  # Keep endblock for compatibility
+sed -i 's/{% endblock %}/{% end %}/g' templates/blog/single.html
 ```
 
 ### Step 4: Replace Template Variables
@@ -622,7 +622,7 @@ In strict mode, use `??` to handle undefined variables safely:
         {{ page.content | safe }}
       </article>
   {% end %}
-{% endblock %}
+{% end %}
 ```
 
 ## Next Steps
diff --git a/site/content/docs/theming/templating/kida/syntax/functions.md b/site/content/docs/theming/templating/kida/syntax/functions.md
@@ -110,7 +110,7 @@ Use with `{% call %}` to pass content:
     <button class="btn btn-danger">Delete</button>
     <button class="btn btn-secondary">Cancel</button>
   </div>
-{% endcall %}
+{% end %}
 ```
 
 ## Common Patterns
@@ -257,5 +257,5 @@ Use in templates:
       {{ post_card(post) }}
     {% end %}
   </section>
-{% endblock %}
+{% end %}
 ```
diff --git a/site/content/docs/theming/templating/kida/syntax/operators.md b/site/content/docs/theming/templating/kida/syntax/operators.md
@@ -188,5 +188,5 @@ The `??` operator has lower precedence than `|`, so filters bind to the fallback
     </aside>
   {% end %}
 </article>
-{% endblock %}
+{% end %}
 ```
diff --git a/site/content/docs/theming/templating/kida/syntax/variables.md b/site/content/docs/theming/templating/kida/syntax/variables.md
@@ -168,7 +168,7 @@ Assign array and dict literals directly:
   <main class="{% if show_sidebar %}with-sidebar{% end %}">
     {{ page.content | safe }}
   </main>
-{% endblock %}
+{% end %}
 ```
 
 ### Computed Values
diff --git a/site/content/docs/theming/themes/customize.md b/site/content/docs/theming/themes/customize.md
@@ -410,10 +410,10 @@ Bengal provides a pre-computed navigation tree for efficient template rendering.
           <li>
             <a href="{{ child.href }}">{{ child.title }}</a>
           </li>
-        {% endfor %}
+        {% end %}
       </ul>
     {% end %}
-  {% endfor %}
+  {% end %}
 </nav>
 ```
 
@@ -443,7 +443,7 @@ For section-specific navigation (e.g., docs-only sidebar):
 {% let root = page._section.root if page._section else none %}
 {% for item in get_nav_tree(page, root_section=root) %}
   <a href="{{ item.href }}">{{ item.title }}</a>
-{% endfor %}
+{% end %}
 ```
 
 ### Benefits
diff --git a/site/content/docs/tutorials/content/create-a-tutorial-series.md b/site/content/docs/tutorials/content/create-a-tutorial-series.md
@@ -455,7 +455,7 @@ template: "series-overview.html"
     {% end %}
   </section>
 </article>
-{% endblock %}
+{% end %}
 ```
 
 Add styles:
@@ -667,7 +667,7 @@ Include it in your series page layout:
     {% include "partials/series-nav.html" %}
   </article>
 </div>
-{% endblock %}
+{% end %}
 ```
 :::{/step}
 
diff --git a/site/content/docs/tutorials/theming/getting-started-with-kida.md b/site/content/docs/tutorials/theming/getting-started-with-kida.md
@@ -200,7 +200,7 @@ Create `templates/baseof.html`:
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>{% block title %}{{ site.config.title }}{% endblock %}</title>
+  <title>{% block title %}{{ site.config.title }}{% end %}</title>
 </head>
 <body>
   <header>
@@ -213,7 +213,7 @@ Create `templates/baseof.html`:
   </header>
 
   <main>
-    {% block content %}{% endblock %}
+    {% block content %}{% end %}
   </main>
 
   <footer>
@@ -230,7 +230,7 @@ Create `templates/blog/single.html`:
 ```kida
 {% extends "baseof.html" %}
 
-{% block title %}{{ page.title }} - {{ site.config.title }}{% endblock %}
+{% block title %}{{ page.title }} - {{ site.config.title }}{% end %}
 
 {% block content %}
   <article class="blog-post">
@@ -242,7 +242,7 @@ Create `templates/blog/single.html`:
       {{ page.content | safe }}
     </div>
   </article>
-{% endblock %}
+{% end %}
 ```
 
 ## Step 6: Build a Complete Blog Template
@@ -262,7 +262,7 @@ Create a full-featured blog template:
   |> sort_by('date', reverse=true)
   |> take(5) %}
 
-{% block title %}{{ post.title }} - {{ site.config.title }}{% endblock %}
+{% block title %}{{ post.title }} - {{ site.config.title }}{% end %}
 
 {% block content %}
   <article class="blog-post">
@@ -299,15 +299,15 @@ Create a full-featured blog template:
         <ul>
           {% for related in related_posts %}
             <li>
-              <a href="{{ related.url }}">{{ related.title }}</a>
+              <a href="{{ related.href }}">{{ related.title }}</a>
               <span>{{ related.date | days_ago }} days ago</span>
             </li>
           {% end %}
         </ul>
       </aside>
     {% end %}
   {% end %}
-{% endblock %}
+{% end %}
 ```
 
 ## Step 7: Fragment Caching
