Seitenblock: Format, Ränder, Kopfzeilen

Der Block page: im Front Matter einer Vorlage legt Seitenformat, Ränder, Kopfzeile und Fußzeile fest. Ein Schlüssel, der nicht in der Tabelle steht, schlägt mit Unknown key '<name>' in page block fehl. Wie Sie den Block einsetzen, erklärt die Anleitung Seitenlayout.

Schlüssel

Schreiben Sie margin.top als margin: {top: 20mm}. Dasselbe gilt für die anderen Schlüssel mit Punkt.

Schlüssel	Wert	Wirkung
`size`	Ein CSS-Seitenformat: `A4`, `Letter`, `A4 landscape`, `210mm 297mm`	Das Seitenformat.
`margin.top`	Eine CSS-Länge: `20mm`, `1in`	Der obere Rand.
`margin.right`	Eine CSS-Länge	Der rechte Rand.
`margin.bottom`	Eine CSS-Länge	Der untere Rand.
`margin.left`	Eine CSS-Länge	Der linke Rand.
`header.first`	Text oder `none`	Der Text im oberen mittleren Feld auf Seite 1. `none` leert alle drei oberen Felder auf Seite 1.
`header.rest`	Text	Der Text im oberen mittleren Feld. Auf Seite 1 ersetzt ihn `header.first`. `header.center` schreibt dasselbe Feld und gewinnt, wenn beide gesetzt sind.
`header.left`	Text	Text im oberen linken Feld. `header.first: none` leert es auf Seite 1.
`header.center`	Text	Text im oberen mittleren Feld. `header.first: none` leert es auf Seite 1.
`header.right`	Text	Text im oberen rechten Feld. `header.first: none` leert es auf Seite 1.
`footer.left`	Text	Text im unteren linken Feld auf jeder Seite.
`footer.center`	Text	Text im unteren mittleren Feld auf jeder Seite.
`footer.right`	Text	Text im unteren rechten Feld auf jeder Seite.

Tags in Kopf- und Fußzeilen

Tag	Ergebnis
`{{ page }}`	Die Nummer der aktuellen Seite, ab 1 gezählt.
`{{ pages }}`	Die Zahl der Seiten.
`{{ section }}`	Der Titel der ersten Überschrift auf der Seite, die mit `class="section-title"` oder `data-brevier-section` markiert ist. Hat eine Seite keine solche Überschrift, zeigt sie den Titel der Seiten davor.
`{{ path }}`	Ein Wert aus den Daten, zum Beispiel `{{ firma.name }}`. Hat die Datenstruktur kein solches Feld, bleibt der Text unverändert stehen.

Schreiben Sie die drei Zähler als {{ page }}, {{ pages }} und {{ section }}, mit oder ohne Leerzeichen in den Klammern.

Beispiel

page:
  size: A4
  margin: {top: 45mm, right: 20mm, bottom: 30mm, left: 25mm}
  header:
    first: none
    rest: "{{ section }} · Rechnung {{ rechnung.nummer }}"
  footer:
    center: "Seite {{ page }} von {{ pages }}"

Seiten

Doku

Funktionen

Seitenblock

Schlüssel

Tags in Kopf- und Fußzeilen

Beispiel