user-guide/templates-and-metadata/index.md

2.1 KiB

id title description tags lang
templates-and-metadata Templates and metadata Starting points for new pages, structured fields, and page versions.
guide
templates
metadata
en

Templates and metadata

Templates

Templates in the sidebar lists the starting points offered when you create a new page in this space, plus any global templates that apply across all spaces. Space templates can be renamed, have their content edited, and be deleted here — global templates are read-only, shown for reference only.

The easiest way to add a template is from a finished draft: use Save as template … in the editor's status bar to turn its current content into a reusable starting point (see writing-a-page).

This space ships one template, Process runbook. The page example-kernel-update was created from it and then filled in. Templates may use three placeholders that are filled when the page is created: {{titel}} (the new page's title), {{autor}} (you) and {{datum}} (today's date).

Metadata schema

Metadata schema in the sidebar defines which structured extra fields pages in this space carry — for example a process ID, a status, or who released a page. Each field has a type:

Type Meaning
Text free text
Pattern (regex) text that must match a pattern
Choice (fixed, single) one value from a fixed list
Date a date
Multi-select / tags several values, or free tags
Person a person
Automatic (from Git) filled in from Git — last author or last change

Changes to the schema take effect immediately for every page in the space. When a schema is in place, the editor shows a Metadata panel on the draft with a field per schema entry, and flags required fields that are still open.

Page versions

If a space keeps page versions, every release gets a version number and the change note entered at approval time. On a released page, the sidebar shows the current Version and a link to All versions of this page, where you can compare any past version with today's content.