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 index.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: index.html

By default, if site.layout is omitted, Wiki CLI uses the built-in minimal fallback index.html layout. Set site.layout to your custom layout path to configure a customized page shell.

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 like other properties.

Layout slots

Layout files use %wiki.*% slot substitution (not Jinja). The canonical reference is Layout slots in Wiki Configuration.

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