Entwicklung

Seitenlayouts und Seitenteile

Den HTML-Rahmen der Seiten mit Direktiven aufbauen.

Jede Seite wird in ein Seitenlayout gesetzt, das das HTML-Dokument um den Inhalt liefert. Seitenteile wie Header und Footer sind wiederverwendbare Stücke darin.

Seitenlayouts mit den Ordnern head und layouts — Gestaltung → Seitenlayouts

Seitenlayout default.html im Code-Editor mit eingebundenen Seitenteilen — Seitenlayout im Code-Editor: Direktiven sind farbig hervorgehoben

Seitenlayouts gelten für alle Projekte: /config/layouts/<name>.html, bearbeitet unter Gestaltung → Seitenlayouts. Standard ist default.
Seitenteile gibt es je Projekt: <projekt>/.bloqy/partials/<name>.html, bearbeitet im Projekt unter Einstellungen → Seitenteile. Header und Footer sind Pflicht.

Direktiven

Direktiven sind HTML-Kommentare, die bloqy beim Ausliefern ersetzt:

Direktive	Ergebnis
`<!-- bloqy:content -->`	Inhalt der Seite (Pflicht im Seitenlayout)
`<!-- bloqy:head -->`	kompletter Kopfbereich mit Titel, Meta, Canonical, hreflang, Open Graph, Stylesheets
`<!-- bloqy:scripts -->`	Skripte vor `</body>`
`<!-- bloqy:partial header -->`	ein Seitenteil
`<!-- bloqy:menu main -->`	ein Menü des Projekts
`<!-- bloqy:search -->`, `bloqy:languages`, `bloqy:breadcrumb`, `bloqy:logo`	Suche, Sprachumschalter, Brotkrumen, Logo
`<!-- bloqy:field name -->`	Wert eines Seitenfelds

Platzhalter: {{text.<name>}} (Texte je Sprache), {{site.name}}, {{project.home}}, {{project.name}}.

Seitentypen

Ein Seitenlayout mit einer Datei <name>.json mit Feldern ist ein Seitentyp: Seiten dieses Typs bekommen eigene Seitenfelder (z. B. Datum und Ort für Termine).

Beim Speichern entfernt bloqy PHP, <script>, Event-Handler und javascript:-Links. Die vorige Fassung bleibt als Version erhalten.

Den Kopfbereich passt du über Kopfbereich anpassen an (eigene Fassungen in /config/head/). Mehr in docs/layouts-und-partials.md.