Skip to content
Modul 22 — Capstone: Statischer Site-Generator
5

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: write darf weniger Bytes schreiben als verlangt und verrät das nur über den Rückgabewert — wer write_all durch write ersetzt und die zurückgegebene Länge ignoriert, schneidet den HTML-Output still ab. write_all schreibt intern so lange, bis wirklich alles draußen ist.

✅ Wichtige Erkenntnisse

0/3

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.

render_page baut das vollständige Dokument: eingeleitet mit , dann head mit title und body.
blocks.iter().map(render_block) — danach sammelt die Teile in ein Vec, und join("\n") fügt sie zusammen.
Der generische Parameter : Write erlaubt jedes Schreib-Ziel: Vec<u8> im Test, File in der CLI — ein Interface, viele Ziele.
0 von 3 richtig

This site uses essential cookies for Stripe payments. No tracking cookies.