Jede wiederverwendbare Komponente steht in einer eigenen Datei unter
templates/components/. Der Dateiname entspricht dem Komponentennamen.
Komponenten werden in den Templates und im Markdown mit der
Tera-Komponentensyntax aufgerufen:
{{ <name argument={wert} /> }}
Strings werden als argument="text" übergeben, Variablen und Ausdrücke
in geschweiften Klammern (level={level + 1}).
Im Markdown stehen page, get_page und get_section nicht zur
Verfügung. Komponenten, die ein Seitenobjekt benötigen, funktionieren
nur in Templates. Mit load_data lassen sich Daten aus data/ auch im
Markdown laden.
Jede Komponente hat eine eigene Seite mit Argumenten, Code-Beispiel und gerenderter Vorschau. Die Liste unten wird von Zola aus den Seiten dieser Section erzeugt.
Komponenten
| Komponente | Argumente | Zweck |
|---|---|---|
antisearch |
text |
Verschleiert Text (vor allem Namen) für Suchmaschinen durch zusätzliche unsichtbare <i>-Zeichen. |
articles_preview |
page |
Vorschau eines Artikels in Listen mit Titel, Autoren, Datum, Thumbnail und Text. |
attachments |
files, title |
Zeigt Dateianhänge (PDF, Office, Bilder …) als Liste mit Dateityp-Symbol. |
attachments_item |
path, label |
Einzelner Listeneintrag eines Anhangs mit Dateityp-Symbol (nur intern). |
date_de |
date |
Gibt ein Datum deutsch mit Uhrzeit aus, zum Beispiel „15. Februar 2026 - 20:22“. |
featured_carousel |
articles |
Karussell mit bis zu fünf ausgewählten Artikeln. |
gallery |
page |
Bildergalerie aus page.extra.gallery mit Vollbild-Modal. |
href |
url |
Normalisiert Links: interne Links erhalten genau einen abschließenden Slash. |
image |
src, page, align, width, height, caption |
Bindet ein Bild im Fließtext ein, verkleinert mit resize_image, mit Vollbild-Modal. |
menu_desktop |
items |
Hauptmenü für Desktop (oberste Ebene als Liste, Untermenüs als Dropdown). |
menu_desktop_sub |
items, level |
Rekursives Dropdown-Untermenü für menu_desktop (nur intern). |
menu_mobile |
items, level |
Rekursives Menü für Mobilgeräte mit Auf-/Zuklapp-Buttons. |
pager |
paginator |
Seitennavigation „zurück“, „Seite x von y“, „weiter“ für paginierte Sections. |
password_protected |
id |
Passwortgeschützter Bereich, dessen Inhalt nach Eingabe per JavaScript nachgeladen wird. |
pdf |
src |
Zeigt eine PDF-Datei mit pdf.js an. |
related_pages |
prev, next, page |
Links zur vorherigen (links unten) und nächsten Seite (rechts unten). |
subject_tile |
subject |
Farbige Kachel mit Icon und Fachname für die Fächer-Übersicht. |
table_of_contents |
page |
Hierarchisches, nummeriertes Inhaltsverzeichnis aus den Überschriften einer Seite. |
table_of_contents_list |
items |
Rekursive Liste der Überschriften für table_of_contents (nur intern). |
under_construction |
– | Hinweis „In Bearbeitung“ mit MDI-Symbol. |
youtube |
id |
Bettet ein YouTube-Video datenschutzfreundlich über youtube-nocookie.com ein. |
