Content shortcodes

Tera shortcodes Bifrost exposes to markdown content — invoked as `{%/* name(args) */%}…{%/* end */%}` (paired) or `{%/* name(args) */%}` (inline).

11 pages in this section

Content shortcodes live in themes/bifrost/templates/shortcodes/. They are Tera shortcodes — Zola’s mechanism for letting markdown authors invoke template logic from inside content files. They differ from macros in three ways:

  1. Called from markdown, not templates: wiki(slug="elohim") %}Elohim{% end.
  2. Two flavours: paired (with end, takes a body) and inline (single tag, no body).
  3. Stable contract: shortcode arg names are part of the content contract — renaming an arg breaks every markdown file that uses it.

The shortcode layer is what content authors see. Adding a new shortcode is a content-authoring change, not just a template change — document the arg signature here when you add one.

  • wiki Canon-internal link to a wiki entry. Paired-tag, body is the visible label.
  • library Library-quote block. Paired-tag, body is the quoted text. Auto-resolves book metadata + deep-link from `book`/`chapter`/`verse` args.
  • libref Inline library-reference link. Paired-tag, body is the visible label. The inline counterpart to the `library` blockquote shortcode.
  • cite Inline citation marker — superscript pill that anchors to the matching `#ref-<id>` entry in the references list.
  • definition Glossary-style definition box. Paired-tag, body is the definition.
  • info Generic info / note / warning callout box. Paired-tag with optional title and icon.
  • figure Image + caption block with AVIF/WebP responsive sources. Inline tag, takes src / alt / caption.
  • diagram Inline, theme-aware SVG figure that localizes to the page language. Inline tag, takes name / caption / alt.
  • link i18n-aware link with auto external-detection — drop-in alternative to a markdown link when you need language-prefix resolution.
  • ref + reference Two thin reference-marker shortcodes. `ref` is number-only; `reference` supports both keys and numbers.
  • author Author-attributed blockquote — body is the quote, author profile renders from `authors.toml`.

Edit this page on GitHub