nodes.structure

Type declaration: {% template page: Page, site: Site %}

Template inheritance: {% extends "base.html" %}

Literal framework metadata attached to a block or fragment.

Named block for inheritance: {% block name %}...{% end %}

Setup block for macros/variables available during render_block().

Imports block — {% imports %}...{% end %}.

Same semantics as {% globals %} but signals intent: these imports are for fragment/block scope. Compiles to _globals_setup.

Include another template: {% include "partial.html" %}

Import functions from template: {% import "funcs.html" as f %}

Import specific functions: {% from "funcs.html" import button, card %}

Root node representing a complete template.

Fragment caching: {% cache key %}...{% end %}

Jinja2-style context manager: {% with x = expr %}...{% end %}

Conditional with block: {% with expr as name %}...{% end %}

Embed template with block overrides: {% embed 'card.html' %}...{% end %}

Push content to a named stack: {% push "scripts" %}...{% end %}

Content is collected during rendering and emitted where the corresponding{% stack "scripts" %}appears.

Emit collected stack content: {% stack "scripts" %}

Outputs all content pushed to the named stack via{% push %}.

Provide a value to descendant consumers.

{% provide key = expr %}...{% endprovide %}pushes value onto a per-key stack inRenderContext. Any descendant macro can read it viaconsume("key"). Stack-based for nesting: inner provides shadow outer ones for the same key.

Variable binding in {% trans name=expr %}.

Binds a template expression to a simple name for use inside the trans body as {{ name }}.

{% trans %}...{% endtrans %} block.

Represents a translatable string region. The singular field holds the message ID with %(name)s placeholders. When {% plural %} is present, the plural field holds the plural form and count_expr provides the ngettext dispatch value.