Templates

Design your site with Jinja2 templates

Templates define how content becomes HTML. Hwaro uses Crinja, a Jinja2-compatible engine.

Template Directory

templates/
├── base.html           # Base layout
├── page.html           # Regular pages
├── section.html        # Section index pages
├── index.html          # Homepage (optional)
├── taxonomy.html       # Taxonomy listing
├── taxonomy_term.html  # Taxonomy term page
├── 404.html            # Error page
├── shortcodes/         # Shortcode templates
└── hooks/              # Markdown render-element overrides (link/image/heading/codeblock)

The shortcodes/ directory contains reusable components you can embed in Markdown. See Writing: Shortcodes for usage and how to create custom shortcodes.

Beyond HTML, a page/section can additionally render sibling templates/page.<fmt>.jinja / templates/section.<fmt>.jinja files (JSON, XML, TXT, CSV) enabled via [outputs] — see Output Formats.

The hooks/ directory overrides how individual Markdown elements render — see Render Hooks.

Template Selection

Quick Example

{% extends "base.html" %}

{% block content %}
<article>
  <h1>{{ page.title }}</h1>
  <time>{{ page.date }}</time>
  {{ content | safe }}
</article>
{% endblock %}

In this section