Installation

Folgen Sie einfach dem standardmäßigen Hugo Schnellstart-Verfahren, um schnell loszulegen.

Detaillierte Installationsanweisungen finden Sie unten. Anweisungen zum Aktualisieren des Themes sind ebenfalls verfügbar.

Installation

#

Diese Anweisungen bringen Sie von einem komplett leeren Zustand mit Hugo und Blowfish zum Laufen. Die meisten der in diesem Leitfaden erwähnten Abhängigkeiten können mit dem Paketmanager Ihrer Wahl für Ihre Plattform installiert werden.

Hugo installieren

#

Wenn Sie Hugo noch nicht verwendet haben, müssen Sie es auf Ihrem lokalen Computer installieren. Sie können überprüfen, ob es bereits installiert ist, indem Sie den Befehl hugo version ausführen.

Sie finden detaillierte Installationsanweisungen für Ihre Plattform in der Hugo-Dokumentation.

Blowfish Tools (empfohlen)

#

Wir haben gerade ein neues CLI-Tool veröffentlicht, das Ihnen beim Einstieg mit Blowfish hilft. Es erstellt ein neues Hugo-Projekt, installiert das Theme und richtet die Theme-Konfigurationsdateien für Sie ein. Es befindet sich noch in der Beta-Phase, also melden Sie bitte alle Probleme, die Sie finden.

Installieren Sie das CLI-Tool global mit npm (oder einem anderen Paketmanager):

npx blowfish-tools

oder

npm i -g blowfish-tools

Führen Sie dann den Befehl blowfish-tools aus, um einen interaktiven Durchlauf zu starten, der Sie durch Erstellungs- und Konfigurationsanwendungsfälle führt.

blowfish-tools

Sie können auch den Befehl blowfish-tools new ausführen, um ein neues Hugo-Projekt zu erstellen und das Theme in einem Schritt zu installieren. Weitere Informationen finden Sie in der CLI-Hilfe.

blowfish-tools new mynewsite

Hier ist ein kurzes Video, das zeigt, wie schnell Sie mit dem CLI-Tool mit Blowfish starten können:

Installation ohne CLI

#

Eine neue Website erstellen

#

Führen Sie den Befehl hugo new site mywebsite aus, um eine neue Hugo-Website in einem Verzeichnis namens mywebsite zu erstellen.

Beachten Sie, dass Sie das Projektverzeichnis beliebig benennen können, aber die folgenden Anweisungen gehen davon aus, dass es mywebsite heißt. Wenn Sie einen anderen Namen verwenden, stellen Sie sicher, dass Sie ihn entsprechend ersetzen.

Das Blowfish-Theme herunterladen

#

Es gibt verschiedene Möglichkeiten, das Blowfish-Theme in Ihre Hugo-Website zu installieren. Von der einfachsten bis zur schwierigsten Installation und Wartung sind dies:

• Git-Submodul (empfohlen)
• Hugo-Modul
• Manuelle Dateikopie

Wenn Sie unsicher sind, wählen Sie die Git-Submodul-Methode.

Installation mit Git

#

Diese Methode ist die schnellste und einfachste, um das Theme aktuell zu halten. Neben Hugo und Go müssen Sie auch sicherstellen, dass Git auf Ihrem lokalen Computer installiert ist.

Wechseln Sie in das Verzeichnis Ihrer Hugo-Website (das Sie oben erstellt haben), initialisieren Sie ein neues git-Repository und fügen Sie Blowfish als Submodul hinzu.

cd mywebsite
git init
git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish

Fahren Sie dann mit dem Einrichten der Theme-Konfigurationsdateien fort.

Installation mit Hugo

#

Für diese Methode verwenden Sie Hugo zur Verwaltung Ihrer Themes. Hugo verwendet Go zum Initialisieren und Verwalten von Modulen, stellen Sie also sicher, dass go installiert ist, bevor Sie fortfahren.

1. Laden Sie Go herunter und installieren Sie es. Sie können überprüfen, ob es bereits installiert ist, indem Sie den Befehl go version verwenden.

   Stellen Sie sicher, dass Sie Go Version 1.12 oder höher verwenden, da Hugo dies für die korrekte Funktion von Modulen benötigt.

2. Initialisieren Sie von Ihrem Hugo-Projektverzeichnis (das Sie oben erstellt haben) Module für Ihre Website:

   # Wenn Sie Ihr Projekt auf GitHub verwalten
   hugo mod init github.com/<username>/<repo-name>
   
   # Wenn Sie Ihr Projekt lokal verwalten
   hugo mod init my-project

3. Fügen Sie das Theme zu Ihrer Konfiguration hinzu, indem Sie eine neue Datei config/_default/module.toml erstellen und Folgendes hinzufügen:

   [[imports]]
   disable = false
   path = "github.com/nunocoracao/blowfish/v2"

4. Starten Sie Ihren Server mit hugo server und das Theme wird automatisch heruntergeladen.

5. Fahren Sie mit dem Einrichten der Theme-Konfigurationsdateien fort.

Manuelle Installation

#

1. Laden Sie die neueste Version des Theme-Quellcodes herunter.

   Von Github herunterladen

2. Entpacken Sie das Archiv, benennen Sie den Ordner in blowfish um und verschieben Sie ihn in das Verzeichnis themes/ im Stammordner Ihres Hugo-Projekts.

3. Fahren Sie mit dem Einrichten der Theme-Konfigurationsdateien fort.

Theme-Konfigurationsdateien einrichten

#

Löschen Sie im Stammordner Ihrer Website die von Hugo generierte Datei hugo.toml. Kopieren Sie die *.toml-Konfigurationsdateien aus dem Theme in Ihren Ordner config/_default/. Dadurch wird sichergestellt, dass Sie alle korrekten Theme-Einstellungen haben und das Theme einfach an Ihre Bedürfnisse anpassen können.

Je nachdem, wie Sie das Theme installiert haben, finden Sie die Theme-Konfigurationsdateien an verschiedenen Stellen:

• Hugo-Module: Im Hugo-Cache-Verzeichnis oder laden Sie eine Kopie herunter von GitHub
• Git-Submodul oder manuelle Installation: themes/blowfish/config/_default

Nachdem Sie die Dateien kopiert haben, sollte Ihr Konfigurationsordner so aussehen:

config/_default/
├─ hugo.toml
├─ languages.en.toml
├─ markup.toml
├─ menus.en.toml
├─ module.toml  # wenn Sie Hugo-Module zur Installation verwendet haben
└─ params.toml

Nächste Schritte

#

Die grundlegende Blowfish-Installation ist nun abgeschlossen. Fahren Sie mit dem Abschnitt Erste Schritte fort, um mehr über die Konfiguration des Themes zu erfahren.

Updates installieren

#

Von Zeit zu Zeit werden neue Versionen veröffentlicht, die Fehlerbehebungen anwenden und neue Funktionen zum Theme hinzufügen. Um diese Änderungen zu nutzen, müssen Sie die Theme-Dateien auf Ihrer Website aktualisieren.

Wie Sie dabei vorgehen, hängt von der Installationsmethode ab, die Sie bei der ursprünglichen Installation des Themes gewählt haben. Anweisungen für jede Methode finden Sie unten.

• Git-Submodul
• Hugo-Modul
• Manuelle Dateikopie

Update mit Git

#

Git-Submodule können mit dem git-Befehl aktualisiert werden. Führen Sie einfach den folgenden Befehl aus und die neueste Version des Themes wird in Ihr lokales Repository heruntergeladen:

git submodule update --remote --merge

Nachdem das Submodul aktualisiert wurde, erstellen Sie Ihre Website neu und überprüfen Sie, ob alles wie erwartet funktioniert.

Update mit Hugo

#

Hugo macht das Aktualisieren von Modulen super einfach. Wechseln Sie einfach in Ihr Projektverzeichnis und führen Sie den folgenden Befehl aus:

hugo mod get -u

Hugo aktualisiert automatisch alle Module, die für Ihr Projekt erforderlich sind. Dies geschieht durch Überprüfung Ihrer module.toml- und go.mod-Dateien. Wenn Sie Probleme mit dem Update haben, überprüfen Sie, ob diese Dateien noch korrekt konfiguriert sind.

Erstellen Sie dann einfach Ihre Website neu und überprüfen Sie, ob alles wie erwartet funktioniert.

Manuelles Update

#

Das manuelle Aktualisieren von Blowfish erfordert, dass Sie die neueste Kopie des Themes herunterladen und die alte Version in Ihrem Projekt ersetzen.

1. Laden Sie die neueste Version des Theme-Quellcodes herunter.

   Von Github herunterladen

2. Entpacken Sie das Archiv, benennen Sie den Ordner in blowfish um und verschieben Sie ihn in das Verzeichnis themes/ im Stammordner Ihres Hugo-Projekts. Sie müssen das vorhandene Verzeichnis überschreiben, um alle Theme-Dateien zu ersetzen.

3. Erstellen Sie Ihre Website neu und überprüfen Sie, ob alles wie erwartet funktioniert.