Front matter
The keys para.site reads from a document’s metadata.
A document’s metadata is pandoc’s: YAML front matter in Markdown, the first raw cell of a notebook. pandoc’s own keys keep pandoc’s meaning; where Quarto has the same idea, para.site uses Quarto’s name.
| key | meaning |
|---|---|
title, subtitle, author, abstract |
pandoc’s |
lang |
the page’s language, a BCP 47 tag (see languages); a translation’s comes from its file name |
date |
when it was first published; a post needs one. An ISO 8601 date or date-time, in the site’s time zone unless it says otherwise |
date-modified |
when its content last changed, by hand. A post’s copyright runs from date to date-modified |
description |
one or two plain sentences, for listings, <meta name="description"> and search; shown under the title. Without one, the subtitle is used |
category |
one per post, a path (so-uk/meetings). It defaults to the source’s folder, so it is rarely written; a category lists its subcategories’ posts too |
tags |
a list; each tag has a page |
draft: true |
built only with --include-draft, and never listed |
image, image-alt |
its thumbnail in listings, from the site’s root, and the thumbnail’s text (else the title) |
format |
its output profiles (see output profiles) |
format-links |
which of its other outputs an output links to, by each profile’s label: true all, false none, or a list of profile names. Without it, slides link to the page beside them (Report) |
output-file |
an output’s file name, in its folder, as an exception to the URL rules: at the top level the first output’s, under format: NAME: that output’s |
Keys from parasite ≤ 0.1
para.site warns about these and otherwise ignores them:
| key | instead |
|---|---|
<!-- more --> (a teaser) |
description |
status: draft |
draft: true |
status: featured |
nothing: the front page shows the newest posts |
previewimage |
image |
slug, pretty_url, url_type |
the source’s path |
type |
nothing |
sidebar_toc |
toc |
temp |
nothing |