Layout: Seiten in eine Vorlage einbetten
Lektion 5 von 7
Die ganze Seite zusammenbauen
Eine echte HTML-Seite braucht <!DOCTYPE html>, <head>, <title> und
<body>. Unsere render_page-Funktion baut das vollständige Dokument:
pub fn render_page(title: &str, blocks: &[Block]) -> String {
let body: String = blocks
.iter()
.map(render_block)
.collect::<Vec<_>>()
.join("\n");
format!(
"<!DOCTYPE html>\n<html>\n<head><meta charset=\"utf-8\">\
\n<title>{}</title></head>\n<body>\n{}\n</body>\n</html>\n",
escape(title),
body
)
}
blocks.iter().map(render_block) wandelt jeden Block in HTML um
(map), sammelt das Ergebnis (collect) und fügt die Teile mit \n zusammen
(join) — ein Paradebeispiel für die Iterator-Werkzeuge aus Modul 10.
In einen Writer schreiben (I/O)
Statt nur Strings zu liefern, nutzen wir das Write-Trait (Modul 18) — so
können wir in Vec<u8>, Dateien oder sogar Netzwerk-Streams schreiben:
use std::io::Write;
pub fn build_to_writer<W: Write>(
w: &mut W,
title: &str,
blocks: &[Block],
) -> std::io::Result<()> {
let html = render_page(title, blocks);
w.write_all(html.as_bytes())
}
<W: Write> ist ein generischer Parameter: Die Funktion akzeptiert jeden
Schreiber, der das Write-Trait erfüllt.
Generisch über Write = maximale Wiederverwendung
Dank W: Write ist unser Builder nicht an konkrete Ausgaben gekoppelt: Im
Sandbox-Test schreiben wir in einen Vec<u8>, in der CLI-Version in eine
Datei via std::fs::File — beides implementiert Write. Ein Interface, viele
Ziele (Modul 8, 18).
⚠ Häufiger Fehler:
writedarf weniger Bytes schreiben als verlangt und verrät das nur über den Rückgabewert — werwrite_alldurchwriteersetzt und die zurückgegebene Länge ignoriert, schneidet den HTML-Output still ab.write_allschreibt intern so lange, bis wirklich alles draußen ist.
✅ Wichtige Erkenntnisse
Haken setzen, um deinen Lernfortschritt zu markieren:
Rufe dir die Kernpunkte in Erinnerung, bevor du die Liste aufdeckst.
Erinnerungstraining
Tippe den fehlenden Begriff aus dem Gedächtnis ein und prüfe.