So erstellen Sie ein Blog mit Hugo

• Einführung
• Voraussetzungen
• Schritt 1: Installieren Sie das Hugo-Programm
• Schritt 2: Erstellen Sie Ihre Site
• Schritt 3: Installieren Sie Themen aus dem Hugo-Repository
• Schritt 4: Nehmen Sie einige grundlegende Konfigurationsänderungen vor
• Schritt 5: Verfassen Sie Ihre Inhalte
• Schritt 6: Passen Sie Ihre Inhalte mit dem Hugo-Server an
• Schritt 7: Veröffentlichen Sie Ihre Site

Einführung

Hugo ist ein statischer Site-Generator mit blitzschneller Rendergeschwindigkeit und hervorragender Benutzerfreundlichkeit. Dank all seiner inhaltsorientierten Funktionen können Sie sich immer darauf konzentrieren, Inhalte zu erstellen, anstatt die Umgebung zu erstellen:

• Mit Hugo können Sie in wenigen Minuten eine statische Site erstellen, die überall ausgeführt werden kann, ohne langwierige Abhängigkeiten oder Datenbanken zu berücksichtigen.
• Sie können Ihre Inhalte in Markdown, dem bequemsten Schreibstil, erstellen und die Änderungen, die Sie im Web vorgenommen haben, sofort anzeigen.
• Darüber hinaus können Sie das wohlhabende Themen-Repository von Hugo und die schnell wachsende Community optimal nutzen.

In diesem Tutorial werde ich Ihnen zeigen, wie Sie Hugo installieren und verwenden, um eine statische Blog-Site auf einer CentOS-basierten Vultr LEMP-Serverinstanz zu erstellen.

Voraussetzungen

Melden Sie sich bei Ihrer Instanz als Nicht-Root-Benutzer mit Sudo-Berechtigungen an. In diesem Artikel erfahren Sie, wie Sie einen solchen Benutzer erstellen .

Schritt 1: Installieren Sie das Hugo-Programm

Hugo kann auf fast allen Mainstream-Plattformen installiert werden. Für CentOS müssen Sie nur die neueste Programmdatei in ein .tar.gzArchiv herunterladen und an einen geeigneten Ort entpacken. Zum Zeitpunkt des Schreibens ist die neueste Version 0.15.

sudo yum update -y
sudo yum install git -y
cd ~
wget https://github.com/spf13/hugo/releases/download/v0.15/hugo_0.15_linux_amd64.tar.gz
tar -zxvf hugo_0.15_linux_amd64.tar.gz
sudo mv hugo_0.15_linux_amd64/hugo_0.15_linux_amd64 /usr/local/bin/hugo

Testen Sie Ihre Installation mit dem folgenden Befehl:

 hugo version

Schritt 2: Erstellen Sie Ihre Site

Mit Hugo können Sie Ihre Site aus einem beliebigen Ordner auf Ihrem Server erstellen. Hier habe ich eine Site im Verzeichnis mysite/unter meinem Home-Verzeichnis erstellt.

cd ~
hugo new site ~/mysite

Führen Sie die folgenden Befehle aus, um die Architektur der Site anzuzeigen:

cd mysite
ls -lF

Wie Sie sehen, ähnelt die aktuelle Architektur der Site:

Archetypen /

config.toml

Inhalt/

Daten/

Layouts /

statisch/

Mit zwei weiteren zu erstellenden Verzeichnissen themes/und public/ist die gesamte Architektur einer Hugo-Site kompakt und dennoch umfassend.

Beachten Sie zunächst, dass Ihr Inhalt im Verzeichnis gespeichert werden sollte content/.

Schritt 3: Installieren Sie Themen aus dem Hugo-Repository

Führen Sie die folgenden Befehle aus, um alle Designs aus dem Hugo-Repository zu installieren. Diese erstellen ein Verzeichnis mit dem Namen themes/in Ihrem Site-Verzeichnis und laden alle Themen aus dem Hugo-Themen-Repo herunter.

cd ~/mysite/
git clone --depth 1 --recursive https://github.com/spf13/hugoThemes.git themes

Wenn Sie nur ein einzelnes Thema installieren möchten, besuchen Sie das Hugo-Themen-Repo , um Ihr Lieblingsthema zu bestimmen. Kopieren Sie die URL und fügen Sie sie in den folgenden git cloneBefehl ein.

cd ~/mysite/
mkdir themes
cd themes
git clone https://github.com/jaden/twentyfourteen

Schritt 4: Nehmen Sie einige grundlegende Konfigurationsänderungen vor

Die config.tomlin Ihrem Site-Verzeichnis genannte Datei enthält die globale Konfiguration für Ihre Hugo-Site. Bearbeiten Sie die Datei mit einem Texteditor, um einige grundlegende Konfigurationsänderungen vorzunehmen, wie unten aufgeführt. Denken Sie daran, die Werte gemäß Ihren spezifischen Bedingungen zu ersetzen.

baseurl = "http://[YourSiteIP]/"
languageCode = "en-us"
title = "Your Site Name"
theme = "twentyfourteen"

Schritt 5: Verfassen Sie Ihre Inhalte

Geben Sie in Ihrem Site-Verzeichnis den folgenden Befehl ein, um eine Inhaltsseite im Verzeichnis zu erstellen ~/mysite/content/post/.

cd ~/mysite/
hugo new post/about.md

Öffnen Sie die Datei in einem Texteditor. Das Format der Datei sollte wie folgt aussehen.

+++
date = "2015-12-25T03:21:23Z"
draft = true
title = "about"

+++

Zwischen den beiden Zeilen +++liegen die Metainformationen zu Ihrer Inhaltsseite. Hier können Sie die Zeile entfernen draft = trueund die Titelzeile nach Ihren Wünschen ändern.

Fügen Sie in der zweiten +++Zeile den Inhalt hinzu, den Sie auf der Webseite anzeigen möchten. Denken Sie daran, Ihre Inhalte in der Markdown-Sprache zu schreiben.

## This is an H2 headline

Text goes here.

Lassen Sie nach Abschluss dieser Bearbeitung den Texteditor zur späteren Verwendung geöffnet.

Schritt 6: Passen Sie Ihre Inhalte mit dem Hugo-Server an

Sie können den integrierten Webserver von Hugo verwenden, um Ihre Site bereitzustellen, die Ihre Änderungen sofort auf der Webseite anzeigen kann, sobald Sie Ihren Inhalt in einem Texteditor ändern.

Öffnen Sie ein anderes Terminal und konfigurieren Sie die iptablesRegeln so, dass Sie über den Standardport 1313 des Hugo-Servers auf Ihre Site zugreifen können:

sudo iptables -I INPUT -p tcp --dport 1313 -j ACCEPT

Starten Sie den Hugo-Server:

hugo server --bind="[YourServerIP]"

Besuchen Sie Ihre Website über einen Browser:

http://[YourServerIP]:1313

Jetzt können Sie versuchen, den Inhalt der Auslagerungsdatei im vorherigen Terminal zu bearbeiten oder eine Auslagerungsdatei hinzuzufügen / zu entfernen. Sie werden feststellen, dass alle Änderungen im content/Verzeichnis gleichzeitig auf Ihrem Browserbildschirm angezeigt werden. Dies ist eine großartige Funktion für einen vielbeschäftigten Blogger, da Sie Ihre Änderungen immer sofort sehen können, um bessere Kompositionserfahrungen zu erzielen.

Drücken Sie nach Abschluss der Bearbeitung, Ctrl+Cum den Hugo-Server zu stoppen.

Schritt 7: Veröffentlichen Sie Ihre Site

Jetzt ist es Zeit, Ihre Website im Web zu veröffentlichen. Führen Sie die folgenden Befehle aus, und Hugo generiert den gesamten statischen Inhalt, der für die Veröffentlichung im public/Verzeichnis geeignet ist .

cd ~/mysite
hugo

Hinweis : Hugo löscht keine alten Dateien, die zuvor beim Ausführen der obigen Befehle generiert wurden. Um unerwartete Ergebnisse zu vermeiden, können Sie das public/Verzeichnis jederzeit löschen, bevor Sie den hugoBefehl ausführen, oder ein neues Ausgabeziel angeben, wie im folgenden Befehl gezeigt.

hugo --destination=public2

Da der Nginx-Webserver bereits auf dem Server ausgeführt wurde, müssen Sie lediglich den Inhalt des ~/mysite/public/Verzeichnisses oder anderer benutzerdefinierter Zielverzeichnisse in Ihr Webverzeichnis kopieren /usr/share/nginx/html/.

Löschen Sie die Originaldateien:

cd /usr/share/nginx/html/
sudo rm -rf background.jpg index.php logo.png

Kopieren Sie Ihre statischen Site-Dateien in das Webverzeichnis:

cd ~/mysite/public
sudo cp -R ~/mysite/public/. /usr/share/nginx/html/

Das ist es. Jetzt können Sie Ihre superschnelle statische Site über Ihren Browser besuchen : http://[YourServerIP].

Um weitere Details zu sehen, verwenden Sie den Befehl hugo helpoder besuchen Sie die offizielle Website von Hugo .