Hugo ist ein einziges Binary. Du lädst es herunter, legst es in den PATH, rufst hugo auf, und in public/ liegt deine fertige Seite: HTML, CSS, Bilder. Eine Runtime oder einen Paketmanager brauchst du dafür nicht, und auch kein Lockfile, das beim nächsten Checkout eine andere Meinung hat. Geschrieben ist es in Go, und es beendet sich, sobald der Build durch ist. Das ist der Grund, warum Leute bei Hugo bleiben. Es ist auch der Grund, warum das Kontaktformular gleich schwierig wird.
Was Hugo schnell macht
Der ehrliche Vergleich ist Jekyll, und er fällt unangenehm deutlich aus. Bei Jekyll installierst du weniger ein Programm als eine Umgebung, die gepflegt werden will: eine Ruby-Version, ein Version-Manager, ein Gemfile, ein Gemfile.lock, bundle install, native Extensions, die einen C-Compiler erwarten, und bundle exec vor jedem Befehl, damit du die Version aus dem Lockfile erwischst. Bei Hugo ist die Antwort auf “welche Version läuft hier eigentlich” eine Datei, die deine CI herunterlädt, gegen die Prüfsumme hält und ausführt.
Dazu kommt die Geschwindigkeit, die du im Arbeitsrhythmus tatsächlich merkst. hugo server baut nur neu, was sich geändert hat, hält das Ergebnis im Speicher und hat den Livereload meist geschickt, bevor du vom Editor zum Browser geschaut hast. Bei tausend Seiten entscheidet das darüber, ob du kurz etwas ausprobierst oder dir währenddessen einen Kaffee holst.
In dem einen Binary steckt mehr, als seine Größe vermuten lässt: Taxonomien, mehrsprachige Seiten, Bildverarbeitung mit .Resize und .Fill, eine Asset-Pipeline, die SCSS übersetzt, minifiziert und Fingerprints anhängt. Für den eingebauten SCSS-Transpiler brauchst du die Extended-Edition, ebenfalls ein Download. Für nichts davon installierst du ein Plugin; Hugo hat keine Plugin-API.
Die Nachteile gehören dazu. Go-Templates sind Geschmackssache: {{ with }}, {{ range }}, die Pipes, und der Punkt, der ständig den Kontext wechselt. Und mit 0.146 hat Hugo die Layout-Struktur umgebaut - _default wird nicht mehr gebraucht, aus partials wurde _partials, aus shortcodes wurde _shortcodes. Wer ein älteres Theme mitschleppt, hat das gemerkt. Und Jekyll ist nicht überall die schlechtere Wahl: Wenn dein Team ohnehin Ruby schreibt oder deine Seite auf GitHub Pages liegt, das Jekyll nativ baut, ohne dass du dafür eine CI konfigurierst, gewinnst du mit dem Wechsel wenig.
Ein Generator hat keine Laufzeit
Dann steht das Kontaktformular auf der Liste. hugo läuft, schreibt public/ und beendet sich, womit der Prozess auch schon wieder verschwunden ist. Wenn drei Stunden später jemand auf Absenden klickt, ist von Hugo nichts mehr da, das diesen POST entgegennimmt. Dein Webserver oder dein CDN liefert Dateien aus; ein POST auf eine HTML-Datei bekommt ein 405 zurück, oder schlimmer, ein 200 und sonst nichts.
Das ist so gewollt. Hugo ist schnell und langweilig zu betreiben, weil es zur Auslieferungszeit nichts tut. Es gibt keinen Request-Lifecycle, in den du dich einhängen könntest, und entsprechend auch keine Routen oder Middleware. hugo server ändert daran nichts, der ist fürs Entwickeln gedacht und nicht fürs offene Internet.
Hugo kann durchaus mit der Außenwelt sprechen. resources.GetRemote holt Daten über HTTP, allerdings nur zur Build-Zeit. Die Anfrage passiert, während du baust, und nicht, während jemand deine Seite liest, was für ein Formular zu spät ist.
Deshalb endet fast jede Hugo-Anleitung zum Kontaktformular an derselben Stelle. Sie erklärt Markup und Partial, und dann kommt der Satz, dass du dafür jetzt einen Dienst brauchst. Das liegt weniger an Bequemlichkeit als daran, dass es in Hugo an dieser Stelle schlicht nichts mehr zu erklären gibt. Die Alternativen laufen alle auf ein zweites System hinaus, etwa eine Serverless-Function oder ein PHP-Skript, weil ohnehin ein Webserver läuft. Jede davon nimmt dir das Deployment aus einem einzigen Ordner wieder weg.
Der Anschluss
Der POST muss also dorthin, wo etwas läuft, und dafür genügt ein action auf eine fremde Domain - dagegen hat noch nie ein Browser etwas gehabt. Bei Hugo ist so eine URL eine Konstante wie baseURL auch, und Konstanten gehören in die Site-Konfiguration.
baseURL = 'https://example.com/'
title = 'example.com'
[params]
formEndpoint = 'https://api.formdall.de/api/v1/f/kx92m4'Die URL steht damit an genau einer Stelle statt in jedem Template, das ein Formular zeigt; für Staging tauschst du eine Zeile. Das Formular selbst ist ein Partial - seit 0.146 unter layouts/_partials/:
<!-- Endpoint kommt aus hugo.toml, nicht aus dem Markup -->
<form action="{{ site.Params.formEndpoint }}" method="POST">
<label for="name">Name</label>
<input id="name" name="name" required>
<label for="email">E-Mail</label>
<input id="email" name="email" type="email" required>
<label for="message">Nachricht</label>
<textarea id="message" name="message" rows="6"></textarea>
<button type="submit">Absenden</button>
</form>Client-JavaScript und einen zweiten Deploy-Schritt braucht das nicht. Ein {{ partial "contact-form.html" . }} in einem Template, und die Seite hat ein Formular; wenn du es aus Markdown heraus setzen willst, wickelst du das Partial in einen Shortcode unter layouts/_shortcodes/ und schreibst {{< contact-form >}} in den Text.
Wohin der Besucher nach dem Absenden geht, stellst du pro Formular ein - meist auf /danke/, und diese Seite ist bei dir schlicht content/danke.md, die im selben Build entsteht. Soll das Formular ohne Seitenwechsel abschicken, schickt dein Skript den POST mit Accept: application/json los und liest die Antwort als JSON; am formEndpoint in der hugo.toml ändert sich dafür nichts. Und wenn du dir das Tippen sparen willst: create_form erzeugt das Formular samt Feldern, get_embed gibt dir das fertige Partial zurück, und dein Editor legt es unter layouts/_partials/ ab.
Was du damit nicht baust
Die Arbeit, die Hugo nicht übernehmen kann, weil zur Auslieferungszeit nichts von ihm läuft, passiert bei uns. Eine Einsendung durchläuft eine Kette von Prüfungen, bevor sie in deinem Posteingang landet. Wo sie eine Hürde braucht, hosten wir das Proof-of-Work-Captcha selbst; es setzt keine Cookies, trackt niemanden und läuft auf unseren Servern statt bei einem US-Anbieter. In public/ liegt davon keine einzige Datei; deine Seite bleibt die Sammlung statischer Dateien, als die Hugo sie geschrieben hat.
Die Server stehen in Deutschland. Was der Besucher abgeschickt hat, liegt dort verschlüsselt, und seine IP existiert in der Anwendung nur als Hash, der täglich wechselt. Server-Logs löschen wir nach 14 Tagen. Läuft eine Frist ab, holt der tägliche Löschlauf die Einsendung physisch aus der Datenbank - kein Feld, in dem sie als gelöscht markiert weiterlebt. Verlangt jemand nach Art. 15 Auskunft über seine Daten oder nach Art. 17 ihre Löschung, ist das ein Klick auf die E-Mail-Adresse; dein eigenes Konto lädst du als ZIP herunter. Und sollen die Einsendungen zusätzlich in dein eigenes System laufen, geht der Webhook HMAC-signiert raus, mit SSRF-Schutz gegen interne Ziele. Wie das mit n8n aussieht, zeigt der Ratgeber n8n-Webhook mit KI-Agent.
Nichts davon ist unmöglich selbst zu bauen. Du merkst erst beim Bauen, was alles daran hängt: SPF, DKIM und DMARC einrichten, die Domain-Reputation pflegen, Bounces auswerten, die Spam-Regeln nachziehen, wenn die nächste Welle anders aussieht. Der Unterschied zu Hugo ist, wie lange das laufen muss. Ein Build dauert ein paar Sekunden, so ein Dienst muss dauerhaft erreichbar sein und gepflegt werden, und das ist ein anderer Aufwand als “hugo aufrufen und fertig”. Drei Formulare und 100 Einsendungen im Monat sind kostenlos.