Wiki CLI builds each article into HTML using a page layout file. Two levels apply:

1. Site default — site.layout in Wiki Configuration (for example layouts/wikipedia.html)

2. Per-page override — optional wazoo:layout frontmatter on a single markdown file (.html only)

site.layout

Set the path in wiki.yml (or wiki.yaml) relative to the directory that contains the config file:

site:

  layout: layouts/wikipedia.html

wiki init with --site-layout wikipedia (default) copies layouts/wikipedia.html and assets/wikipedia.css from the packaged bundle. With --site-layout minimal, site.layout is omitted and Wiki CLI uses the packaged index.html layout.

wazoo:layout

Override the site default for one page:

type: schema:Person

wazoo:layout: layouts/article.html

givenName: Ethan

familyName: Davidson

When wazoo:layout is omitted, the page uses site.layout. Layout files must exist and end in .html. wiki check reports missing wazoo:layout paths as errors.

wazoo:layout is ordinary frontmatter: it appears in the RDF graph, infobox, and metadata pane like other properties.

Layout tokens

Layout files use %wiki.*% token substitution (not Jinja). The canonical reference is Layout tokens in Wiki Configuration — a full table of every %wiki.*% token, its source field, and whether the value is HTML-escaped, pre-built markup, or raw JSON.

Custom logos and favicons are layout markup plus wiki.assets overrides; see Custom logos and icons in Wiki_Configuration.

Related

• Wiki Subcommand build

• Wiki Subcommand serve

• Style Guide