Wie diese Seite gebaut ist#

Die Seite laeuft auf Hugo mit dem Theme hugo-book und wird auf GitHub Pages deployed. Diese Seite ist gleichzeitig Referenz fuer das Setup und Demo der Theme-Shortcodes.

Struktur#

myl3z.me/
├── hugo.toml              # eine Config, beide Sprachen
├── content.en/            # Standardsprache → myl3z.me/
│   ├── docs/              # Sidebar-Baum
│   └── posts/             # datierte Eintraege, ein Ordner je Projekt
├── content.de/            # → myl3z.me/de/
├── assets/_custom.scss    # eigene Styles
├── layouts/posts/         # Blog-Liste und -Feed, siehe unten
├── themes/hugo-book/      # Git-Submodule, gepinnt auf v13
└── .github/workflows/hugo.yml

Uebersetzungen werden ueber den Pfad zugeordnet: content.en/docs/tooling/site-setup.md und content.de/docs/tooling/site-setup.md sind dieselbe Seite in zwei Sprachen. Der Sprachumschalter erscheint nur, wenn die Uebersetzung existiert — es muss also nicht alles doppelt geschrieben werden.

Schreiben#

  1. Seite anlegen#

    hugo new docs/linux/systemd-timers.md nutzt den Archetype des Themes und schreibt das Front Matter inklusive weight, das die Reihenfolge in der Sidebar steuert.

  2. Vorschau#

    hugo server -D liefert die Seite inklusive Entwuerfe unter localhost:1313 mit Live-Reload.

  3. Veroeffentlichen#

    Push auf main. Die GitHub Action baut und deployed — kein manueller Schritt.

Seiten mit draft: true fehlen im Produktions-Build. Der Schalter -D macht sie lokal sichtbar.

Blog nach Projekten#

Datierte Eintraege liegen unter content.*/posts/<projekt>/, aktuell homelab/ und shop/. Jeder Projektordner hat eine _index.md mit kurzer Beschreibung und bekommt dadurch eine eigene Uebersichtsseite und einen eigenen RSS-Feed. /posts/ bleibt das Dach und zeigt alle Eintraege gemeinsam, neueste zuerst.

Damit das funktioniert, liegen zwei Templates im Projekt statt im Theme:

DateiWarum
layouts/posts/list.htmlGibt den Text der _index.md ueber der Liste aus und paginiert rekursiv, damit /posts/ die Eintraege aus allen Projektordnern zeigt
layouts/posts/list.rss.xmlGleiches Problem im Feed: Hugos Standard nimmt nur direkte Kindseiten, der Dach-Feed waere sonst leer

Ein neues Projekt ist ein Ordner mit _index.md — dazu ein Menue-Eintrag mit parent = 'blog' in der hugo.toml.

Lokale Befehle#

hugo server -D              # inkl. Entwuerfe, Live-Reload
hugo server --navigateToChanged
hugo --minify --gc          # das laeuft in der Action
hugo --printPathWarnings    # findet kaputte Links und verirrte Dateien
cd themes/hugo-book
git fetch --tags
git checkout v14           # Breaking Changes zwischen Majors — Changelog lesen
cd ../..
git commit -am "chore: bump hugo-book to v14"

Das Theme bringt Breaking Changes zwischen Major-Releases. Das Submodule ist bewusst auf einen Tag gepinnt — Updates passieren, wenn sie gewollt sind, nicht beim naechsten Klon.

Calendar August 21, 2026
Edit Seite bearbeiten
Backward KI & Tooling