breadcrumbs

Render breadcrumb navigation with schema.org BreadcrumbList markup. One convenience macro per section type.

≈ 2 min read 239 words Updated 2026-11-20

On this page

macros/breadcrumbs.html renders the breadcrumb navigation row at the top of every interior page. Each Wheel of Heaven section has its own convenience macro so the breadcrumb structure stays consistent (Home → section → category → page) without per-template duplication.

Source: themes/bifrost/templates/macros/breadcrumbs.html · visual surface: .breadcrumbs

Public API#

Since 2026-11-07 the trail renders in the footer: call the macro inside the template’s trail block and hand the result to page_trail (see Breadcrumbs).

{%/* import "macros/breadcrumbs.html" as breadcrumbs */%}
{%/* block trail */%}{%/* set_global page_trail = breadcrumbs::wiki(page=page, lang=detected_lang) */%}{%/* endblock trail */%}

{{ breadcrumbs::wiki(page=page, lang=detected_lang) }}
{{ breadcrumbs::timeline(page=page, lang=detected_lang) }}
{{ breadcrumbs::library(page=page, lang=detected_lang) }}
{{ breadcrumbs::article(page=page, lang=detected_lang) }}
{{ breadcrumbs::news(page=page, lang=detected_lang) }}
{{ breadcrumbs::resources(page=page, lang=detected_lang) }}
…

Parameters (common to all variants)#

ParamTypeRequiredDefaultWhat
pageTera pageyes—The current page object.
langstringno"en"Language code (use detected_lang).

Markup#

Each macro emits a <nav class="breadcrumbs" aria-label="Breadcrumb"> with schema.org BreadcrumbList markup: every item is an itemListElement with position, name, and item properties so Google can extract the trail for SERP enhancements.

The wiki macro omits the category when it matches the page title after trimming whitespace and ignoring case. For example, Elohim renders Home → Wiki → Elohim, rather than repeating Elohim as both category and page. The remaining positions stay consecutive (1, 2, 3). Distinct categories retain the four-item trail.

The home link uses the brand logomark; section links use the section-icons glyph next to the section name.

Edit this page on GitHub