WordPressEscape

Startseite / Leitfaden

Workbench

528.854 WordPress-Seiten zu Hugo migrieren: Engineering-Notizen

Hier stehen die Arbeitsnotizen zur Migration von Unlimited Charters, unserer internen Schwester-Website, von WordPress zu Hugo im Mai 2026. Die geschäftliche Zusammenfassung findet sich in der Fallstudie; hier geht es um den praktischen Teil für alle, die die Arbeit umsetzen müssen: Was bei einer halben Million Seiten schiefging, welche Befehle uns Probleme bereiteten und welche Prüfungen wir inzwischen bei jeder Website durchführen - unabhängig von ihrer Größe.

6 Min. Lesezeit 9 Abschnitte Für gute Rankings gemacht
Auf dieser Seite
  1. Kontext
  2. Template-Bestand vor den Inhalten erfassen
  3. Partitionierte Builds und die Tücken des Dateisystems
  4. Performance-Fixes als Template-Änderung plus Durchlauf über den gesamten Bestand
  5. Cloudflare-Einstellungen, die entscheidend waren
  6. Schema- und SEO-Details
  7. Lead-Erfassung darf nicht verloren gehen
  8. Was wir anders machen würden
  9. Quellen und weiterführende Informationen
  10. Häufig gestellte Fragen
Kurzantwort

In dieser Größenordnung liegen die Probleme eher im Dateisystem und im Ablauf als in Hugo selbst: Builds müssen partitioniert werden, ausgelagerte Inhalte müssen außerhalb von Hugos Content-Mount liegen, zwei Verschiebeprozesse dürfen niemals im selben Verzeichnis laufen, und jede Korrektur muss sowohl als Template-Änderung als auch als skriptbasierter Durchlauf über den gesamten Bestand umgesetzt werden. Die größten Performancegewinne brachten korrekte Bildabmessungen, synchron eingebundenes kritisches CSS, ein nicht verzögert geladenes LCP-Bild, ein verzögert geladenes Angebots-Widget mit reserviertem Platz sowie das Deaktivieren von Cloudflare Email Obfuscation.

01

Kontext

Unlimited Charters gehört derselben Unternehmensgruppe wie WordPressEscape. Dabei handelte es sich um unsere eigene Testmigration mit vollständigem Serverzugriff. Die Website umfasste etwas mehr als eine halbe Million URLs, größtenteils auf Templates basierende Standortseiten sowie Übersichtsseiten, Flottenseiten und einen Blog. Ziel war ein Hugo-Build, der als statische Dateien hinter Cloudflare ausgeliefert wird und bei dem jeder bestehende Pfad erhalten bleibt.

02

Template-Bestand vor den Inhalten erfassen

Wir begannen damit, URLs nach dem WordPress-Template zu gruppieren, mit dem sie gerendert wurden - nicht nach URL-Mustern. Für jede Gruppe trafen wir eine Entscheidung: Entweder wird sie als Hugo-Layout neu aufgebaut oder vorerst als statischer Snapshot der WordPress-Ausgabe ausgeliefert. Indem wir die stark frequentierten Gruppen zuerst neu aufbauten und Sonderfälle als Snapshots übernahmen, blieb das Projekt in Bewegung, ohne durch die lange Liste individueller Seiten ausgebremst zu werden.

Ein wichtiger Stolperstein: Unter WordPress entspricht der URL-Pfad nicht immer dem post_name-Slug. Übergeordnete Seiten, individuelle Rewrite-Regeln und alte Importe erzeugten Pfade, die nicht mit dem Slug übereinstimmten. Deshalb musste der Pfad aus dem Crawl stammen, nicht aus der Datenbank.

03

Partitionierte Builds und die Tücken des Dateisystems

Alle Seiten in einem einzigen Durchlauf zu rendern, war langsam und machte jede kleine Änderung teuer. Deshalb partitionierten wir den Prozess: Die Quelldateien, die wir nicht bauten, wurden in ein temporäres Verzeichnis verschoben, anschließend wurde eine Teilmenge gebaut, deployt und danach wiederhergestellt. Vier Stolperfallen kosteten uns Zeit:

  1. Das temporäre Verzeichnis muss außerhalb von Hugos Content-Mount liegen. Befindet es sich irgendwo unterhalb des eingebundenen Content-Verzeichnisses, durchsucht Hugo weiterhin jede Datei und die Partitionierung bringt keinen Vorteil.
  2. rsync --exclude=index.html schließt auf jeder Verzeichnisebene alle index.html-Dateien aus, nicht nur die oberste. Verankern Sie das Muster (--exclude=/index.html).
  3. Zwei parallele Verschiebeprozesse im selben Verzeichnis verschachteln es. Zwei gleichzeitig laufende Wiederherstellungsprozesse erzeugten etwa 367.000 Verzeichnisse, die eine Ebene zu tief lagen. Die Produktion funktionierte trotzdem, weil sie die fertige Ausgabe auslieferte; ein einzelner skriptgesteuerter Verschiebevorgang korrigierte die Struktur. Ein Lock stellt sicher, dass immer nur ein Prozess für das Verzeichnis zuständig ist.
  4. mv dir/* target/ scheitert bei dieser Größe (Argumentliste zu lang). Verwenden Sie stattdessen find ... -exec mv -t target {} +.
# einige Seiten rendern, ohne alles neu zu bauen
flock /tmp/uc-content.lock bash -c '
  mv content/migrated/* ../stash/            # temporäres Verzeichnis AUSSERHALB des Content-Mounts
  for s in $(cat targets.txt); do mv ../stash/$s content/migrated/; done
  hugo --minify -d ../staged
  find ../stash -mindepth 1 -maxdepth 1 -exec mv -t content/migrated/ {} +
'
04

Performance-Fixes als Template-Änderung plus Durchlauf über den gesamten Bestand

Jede Korrektur bestand aus zwei Teilen: Wir passten das Hugo-Template so an, dass zukünftige Builds korrekt waren, und korrigierten das bereits erzeugte HTML, damit wir für den Rollout keinen vollständigen Rebuild benötigten. Am wichtigsten waren:

  • Bildabmessungen. Ein Template setzte width="1600" height="700" fest, während das CSS ein anderes Seitenverhältnis verwendete. Wir korrigierten dies auf 527.815 Seiten. Breite und Höhe müssen dem gerenderten Seitenverhältnis entsprechen, sonst reserviert der Browser den falschen Platz (CLS optimieren).
  • Widersprüchliche aspect-ratio-Regeln für denselben Selektor in zwei Stylesheets; wir führten sie zu einer einzigen Regel zusammen.
  • Kritisches CSS in der asynchronen Datei. Für den ersten Seitenaufbau benötigte Mobile-Regeln befanden sich in einem verzögert geladenen Stylesheet und verursachten ein spätes Neulayout. Wir verschoben sie in das synchron geladene Stylesheet.
  • Lazy geladenes Hero-Bild. loading="lazy" beim Bild „above the fold“ verzögerte das LCP. Wir ersetzten es durch fetchpriority="high" (LCP optimieren).
  • Zu große LCP-Bilder wurden durch kleinere Varianten ersetzt. Das sparte pro Seite 50 bis 440 KB.
  • Angebots-Widget: Es wird bei der ersten Interaktion geladen (mit einem Fallback nach Ablauf eines Timeouts), während sein Container 480 px Höhe reserviert (auf Mobilgeräten 560 px). Zuvor verschob das Einfügen des Widgets die Seite um einen CLS-Wert von etwa 0,54.
05

Cloudflare-Einstellungen, die entscheidend waren

  • Email Obfuscation deaktivieren. Der Decoder durchläuft nach dem Laden das DOM und schreibt E-Mail-Links um, was sich als Layout Shift bemerkbar machte. Es war die beständigste CLS-Quelle, die wir gefunden haben.
  • Rocket Loader deaktivieren. Die Funktion ordnet Skripte neu und störte das verzögerte Laden.
  • Nach jedem Deployment den Cache leeren. Edge-Caches enthielten veraltetes HTML. Durch das Leeren nach Pfad vermieden wir, nach einem Deployment veraltete Seiten auszuliefern (Cloudflare-Dokumentation zum Leeren des Caches).
  • Produktion messen, nicht Staging. Staging ohne dieselben Cloudflare-Einstellungen lieferte Laborwerte, die nicht mit der Produktion übereinstimmten.
06

Schema- und SEO-Details

  • Die Search Console meldete Fehler in den strukturierten Daten, weil eine Service-Entität aggregateRating und review enthielt. Wir entfernten beide Angaben, statt sie zwanghaft validierbar zu machen. Markup muss die Inhalte widerspiegeln, die Nutzer sehen können (Richtlinien für strukturierte Daten).
  • Blogbeiträge wurden zunächst mit dem Standort-Template gerendert und erbten dadurch den falschen Schema-Typ. Jetzt definiert jedes Template seine eigene Entität.
  • 35 inkonsistente Pfade für Flotten- und Serviceseiten erhielten permanente Weiterleitungen auf die korrekten verschachtelten Seiten (Weiterleitungen).
  • Medien wurden von /wp-content/uploads/ nach /uploads/ verschoben und mit einer einzigen 301-Regel weitergeleitet. Ein paralleler sed-Durchlauf schrieb innerhalb weniger Minuten 528.852 von 528.854 Dateien um.
  • Yoast wurde entfernt, sobald Hugo Sitemap, Schema, Meta-Tags und robots.txt erzeugte.
find static-v5 -name '*.html' -print0 \
  | xargs -0 -P 8 -n 500 sed -i 's|/wp-content/uploads/|/uploads/|g'
07

Lead-Erfassung darf nicht verloren gehen

Das Angebotsformular sorgt für den Umsatz der Website und erhielt deshalb eigene Prüfungen: Das Widget-Mount muss im fertigen HTML jeder Seite vorhanden sein, auf der es benötigt wird, die Feldnamen müssen mit den Erwartungen des Intake-Endpunkts übereinstimmen, und ein Deployment, bei dem ein Verzeichnis ersetzt wird, darf die eigenständige Angebotsseite nicht löschen. Ein Cut-over, bei dem die Lead-Erfassung unbemerkt ausfällt, sieht in allen SEO-Kennzahlen erfolgreich aus, während das Unternehmen Anfragen verliert.

08

Was wir anders machen würden

  1. Email Obfuscation vor der ersten CLS-Messung deaktivieren.
  2. Den Build vom ersten Tag an partitionieren.
  3. Das Content-Verzeichnis vom ersten Tag an sperren.
  4. Das Muster „Template plus Durchlauf über den gesamten Bestand“ vor der ersten Korrektur dokumentieren, nicht erst nach der fünften.
  5. Die Prüfung der Felddaten (CrUX) in die Launch-Checkliste aufnehmen, weil Laborwerte aus dem Staging nicht der Produktion entsprechen.

Die geschäftliche Perspektive auf dasselbe Projekt - einschließlich der Inhalte, die wir auf WordPress belassen haben - steht in der Fallstudie.

09

Quellen und weiterführende Informationen

Häufig gestellte Fragen

Handelt es sich um eine Kundenmigration?

Nein. Unlimited Charters ist eine interne Schwester-Website, die derselben Unternehmensgruppe wie WordPressEscape gehört. Sie ist unser eigener Testfall.

Kann Hugo eine halbe Million Seiten verarbeiten?

Ja, aber vollständige Rebuilds dauern lange genug, dass partitionierte Builds und ein sorgfältiger Umgang mit Dateien entscheidend sind. Die meisten unserer Probleme waren Probleme im Dateisystem und im Ablauf, keine Hugo-Fehler.

Was verursachte den stärksten Layout Shift?

Das Einfügen des Angebots-Widgets ohne reservierten Platz (auf Übersichtsseiten etwa 0,54 CLS) sowie Cloudflare Email Obfuscation, das die Seite nach dem Laden umschrieb.

Gelten diese Erkenntnisse auch für kleine Websites?

Ja. Dieselben Prüfungen - URL-Parität, Bildabmessungen, kritisches CSS, ein nicht verzögert geladenes Hero-Bild und verzögert geladene Widgets - gelten auch für eine Website mit 40 Seiten. Sie laufen dort nur in Minuten statt in Stunden.

Meine Website kostenlos scannen

Prüfen, ob Ihre Website ebenfalls dafür geeignet ist

Das kostenlose 60-Sekunden-Audit zeigt Ihre tatsächliche PageSpeed-Bewertung, die genaue Seitenanzahl, SEO-Lücken und die WordPress-Funktionen, die ersetzt werden müssen. Anschließend baut WordPressEscape Ihre Website mit Hugo neu auf, behält alle URLs bei und übergibt Ihnen ab dem ersten Tag den Quellcode - genau wie bei UC.

Meine Website kostenlos scannen
Weiterlesen
Alle Anleitungen33
Verwandte SuchanfragenWordPress-zu-Hugo-Migration528.854 Seiten (interner Test)Partitionierter Hugo-BuildCloudflare-CLS-FixSchema-BereinigungURL-Parität