Page-level Configuration Reference
This page documents the [extra] front-matter keys Tapestry reads on individual pages (e.g. content/about.md, a blog post). These override their site-level equivalents where noted. For Zola's own standard front matter (title, description, date, updated, authors, draft, weight, slug, path, template, insert_anchor_links, [taxonomies], and so on), see Standard Zola front matter at the bottom of this page.
sidebar
+++
title = "My Page"
# [extra]
# sidebar = "sidebar-snippet.md" # custom content
# sidebar = false # force off
+++The single-article template's columns 9–12 sidebar region is content-driven, not unconditionally reserved:
- Left unset, a sidebar renders automatically once the page has 2 or more headings, as an "on this page" table of contents.
- Set to a string, that path is loaded as a colocated Markdown snippet (relative to the page's own directory) and rendered into the sidebar instead of/alongside the auto TOC.
- Set to
false, no sidebar renders regardless of heading count or a custom snippet, and the article reclaims the full 12 columns.
stylesheets
+++
[extra]
stylesheets = ["css/one-off-page-style.css"]
+++Additive with the site- and section-level stylesheets — see site-configuration.md. All three levels' stylesheets are linked together, not just the most specific one.
katex
+++
[extra]
katex = true
+++Overrides the site- and section-level katex setting for this page only — see site-configuration.md for the full precedence chain. An explicit true/false here always wins over whatever is set at the section or site level.
social_media_image
+++
[extra.social_media_image]
path = "share-card.png"
alt_text = "A diagram of the proposed architecture."
+++pathis a colocated image (relative to the page's own directory), automatically resized to 1200×675 and emitted asog:image/twitter:cardmeta tags.alt_textis optional but recommended; it becomesog:image:alt.- If unset, the page falls back to the section-level
social_media_image(see section-configuration.md), if any.
extra.copy_button is a leftover terminus key. Tapestry deliberately ships no copy-to-clipboard JavaScript (per CONSTITUTION.md §2), so setting it here or at the section/site level is a silent no-op.
Quick reference
| Key | Type | Default | Notes |
|---|---|---|---|
sidebar | string | bool | auto (TOC if ≥2 headings) | Custom snippet path, or false to force off. |
stylesheets | array of paths | [] | Additive with section/site level. |
katex | bool | inherited | Overrides section/site level for this page. |
social_media_image.path | path | unset | Colocated image, resized to 1200×675 for og:image. |
social_media_image.alt_text | string | unset | og:image:alt. |
copy_button | bool | — | Inert (terminus leftover). |
Standard Zola front matter
Keys like title, description, date, updated, authors, draft, weight, slug, path, template, insert_anchor_links, and [taxonomies] are standard Zola front matter, not Tapestry-specific — see Zola's own page content documentation for the full reference.