render_page

readSeit v1.0

Rendert eine Seite einer Publikation genau so, wie sie veröffentlicht wird, mit einem Bericht darüber, was funktioniert hat.

Der Unterschied zu preview_rendering: Hier geht es durch die Publikation — ihre Navigationsbäume entscheiden, welche Seiten es überhaupt gibt, und ihre Rendering-Auswahl entscheidet, welche Vorlage welchen Typ darstellt. Damit beantwortet dieses Tool auch die Frage „ist dieses Element überhaupt eine Seite dieser Publikation?” — nach etwas zu fragen, das nicht in der Seitenstruktur steht, ist ein Fehler und keine leere Seite.

Die Seite kann ein Element sein, ein Zweig eines Navigationsbaums (ein Zweig mit Titel ist eine Seite für sich) oder das Wort „homepage”. Lesen Sie wie bei preview_rendering die Diagnosen — ein Abschnitt, der nichts gefunden hat, hinterlässt im gerenderten Text keine Spur.

Parameter

Name	Typ	Pflichtfeld	Standard	Beschreibung
`publication`	`String`	✓		Die Publikation, zu der die Seite gehört, per ID, Slug oder Name.
`page`	`String`	✓		Welche Seite gerendert werden soll: ein Element per ID, Auto-ID oder Bezeichnung; ein Zweig eines Navigationsbaums per Zweig-ID (ein Zweig mit Titel ist eine Seite für sich — Zweig-IDs liefert get_tree_details); oder das Wort „homepage”. Nach etwas zu fragen, das nicht in der Seitenstruktur der Publikation steht, ist ein Fehler und keine leere Seite.
`locale`	`String`	—		Rendert die Seite in dieser Sprache (zum Beispiel „de”).
`format`	`String`	—	markdown	Format der zurückgegebenen Seite: „markdown” ist die lesbare, gut vergleichbare Fassung; „html” ist das, was der Viewer zeigt.

Beispielanfrage

{"publication": "service-handbook", "page": "SRV-12", "format": "markdown"}

Beispielantwort

{"content": "# Payment Capture\n\n...", "format": "markdown", "page": {"id": "9f0c...", "label": "Payment Capture", "kind": "node"}, "diagnostics": []}