hugo-codeberg-pages-template/content/ersteseite.md
2024-04-26 16:33:43 +00:00

3.6 KiB

title author description lang dir licence
Deployment von Hugo auf Codeberg Pages via Woodpecker CI Jörg Lohrer Mit Codeberg-Pages eine eigene Webseite hosten de ltr CC-BY

Deployment von Hugo auf Codeberg Pages via Woodpecker CI

Anleitung zur Erstellung einer Hugo-Website auf Codeberg Pages

Diese Anleitung zeigt Dir Schritt für Schritt, wie Du eine Hugo-Website auf Codeberg Pages erstellen kannst.

Voraussetzungen:

Schritte

1. Forke das Template Repository

2. Ändere die hugo.toml-Datei

Öffne die hugo.toml-Datei i main-Branch deines Repositorys. Ändere die erste Zeile in folgendem Format:
baseURL = 'https://UserName.codeberg.page/RepoName Ersetze UserName durch Deinen Codeberg-Benutzernamen und RepoName durch den gewünschten Namen deiner Website gleichlautend mit dem Namen des Repository.

3. Generiere einen Zugriffstoken:

Melden Dich bei Deinem Codeberg-Konto an und navigiere zu Einstellungen > Anwendungen: https://codeberg.org/user/settings/applications. Klicke auf die Schaltfläche "Neue Anwendung erstellen". Geb Deiner Anwendung einen Namen, z. B. "Hugo-Website". Aktiviere die Option "Lesen und Schreiben" unter "repository". Klicke auf die Schaltfläche "Token generieren". Kopiere den generierten Zugriffstoken.

4. Füge das Repository zu einer neuen Pipeline hinzu

Melde Dich bei CI/CD: https://ci.codeberg.org/ an. Klicke auf die Schaltfläche "+ Repository hinzufügen". Wähle dein Repository aus der Liste aus und klicke auf "Aktivieren". Wähle die Einstellungen zur gerade erstellten Pipeline aus. Klicke auf "Allgemein" und gib bei Pipeline-Pfad .woodpecker.ymlein. Speiche die Einstellung füge zwei Geheimnisse hinzu:

  • Name: codeberg_token - Wert: der in Schritt 3. generierte erstellten Zugriffstoken
  • Name: mail - Wert: Deine Mailadresse

5. Erstelle Markdown-Dateien

Navigiere im Repository zu Verzeichnis /content. Erstelle hier beliebige Markdown-Dateien (*.md). Diese Dateien werden beim Pushen in das Repository automatisch durch zu einer statischen Webseite im pages-Branch verarbeitet

Fertig!

Deine aktualisierte Seite ist unter: https://UserName.codeberg.page/RepoName erreichbar. Sie wird automatisch aktualisiert, wenn Du Änderungen an den (Markdown-)Dateien im main-Branch vornimmst.

Noch ein paar Hinweise

Tipps:

  • Design: Passe die Vorlagendateien im Verzeichnis themes an, um deiner Website einen individuellen Look zu geben.
  • Features: Nutze Hugo-Module, um deine Website zu erweitern.
  • Eigene Domain: Verknüpfe deine Website mit einem eigenen Domainnamen.