Wie Blöcke aufgelöst werden
Kirby speichert ein Blocks-Feld als JSON. Ein Bild-Block enthält eine Datei-UUID wie file://BYXR0pvumEbfTknP, ein Link in einem Text-Block zeigt auf einen Permalink wie /@/page/…. Mit beidem kann ein Frontend nichts anfangen. Deshalb löst Cacao Kit sie im Backend auf, und jeder Block kommt fertig zum Rendern an.
Eine Abfrage für die Catch-all-Route
Die Catch-all-Route schickt für jede Seite, die sie rendert, eine KQL-Abfrage mit derselben Auswahl. Die Auswahl umfasst page.blocks.toResolvedBlocks und page.layouts.toResolvedLayouts, zwei Feldmethoden von Kirby Headless. Diese wandeln das Feld in Blöcke oder Layouts um und lassen drei Resolver über jeden Block laufen: einen für Dateien, einen für Seiten und die eigenen Resolver aus site/config/blocks-resolver.php.

srcset geschickt.Bilder
Welche Felder der Datei-Resolver verarbeitet, lässt sich einstellen; ab Werk ist es das Feld image des Bild-Blocks. Der Eintrag defaultResolvers in derselben Konfigurationsdatei bestimmt, was aus einer Datei wird: URL, Breite, Höhe, srcset und Alternativtext.
Eigene Resolver
Ein eigener Resolver hat einen Schlüssel der Form <block>:<feld> und ersetzt den Wert dieses Felds. text:text macht aus Permalinks Pfade: Dieser Link zur Seite „Über das Projekt“ ist als Permalink gespeichert und kommt als einfacher Pfad an. Er funktioniert auch dann noch, wenn sich der Slug der Seite ändert.
cards:cards gibt jeder Karte ein responsives Bild und einen Link. notes-grid:notes geht noch einen Schritt weiter: Der Block speichert keine Inhalte, und der Resolver füllt ihn mit den gelisteten Notizen – Titel, Pfad, Datum und ein Vorschaubild, in der angefragten Sprache. Deshalb kostet das Notizen-Raster auf der Startseite keine zusätzliche Anfrage.