Wie man

Installieren und verwenden Sie den Zola Static Site Generator

Installieren und verwenden Sie den Zola Static Site Generator

Ein statischer Site-Generator (SSG) ist ein Tool, das eine vollständige statische HTML-Website basierend auf Rohdaten und einer Reihe von Vorlagen generiert. Zola ist ein solches Werkzeug ähnlich wie Hugo, Pelican und Jekyll. Es ist in Rust geschrieben und verwendet die Tera-Template-Engine, die Jinja2, Django-Templates, Liquid und Twig ähnelt. Der Inhalt ist in CommonMark geschrieben, einer stark definierten, hochkompatiblen Spezifikation von Markdown. Quelle: Zola-Website

Es ist zu beachten, dass statische Sites im Vergleich zu anderen Sites daher sehr schnell sind und keine Datenbanken benötigen, was das Hosten erleichtert. In diesem Handbuch werden wir Zola installieren und verwenden, um eine einfache statische Seite zu erstellen. Zuallererst sollten wir mit der Installation beginnen und dann mit der Erstellung und Befüllung der statischen Site fortfahren.

Zola unter Linux installieren | Mac OS

Das Team von Zola hat fantastische Arbeit geleistet, indem es dafür gesorgt hat, dass viele Distributionen und Betriebssysteme problemlos auf Zola zugreifen können. Wir können Zola wie folgt auf verschiedenen Plattformen installieren.

Mac OS

Wenn Sie auf einem Mac sind, können Sie Zola von Brew so holen:

brauen installieren zola

Arch Linux

Gläubige Benutzer von Arch Linux werden etwas zu sagen haben, wenn wir ihnen mitteilen, dass Zola in den offiziellen Arch Linux-Repositorys verfügbar ist. Ein einfacher Befehl reicht aus, um es herunterzuladen und zu installieren. Führen Sie den folgenden Befehl aus, um es zu erledigen.

sudo pacman -S zola

Alpine Linux

Für diejenigen, die Alpine Linux bevorzugen, ist Zola im offiziellen Alpine Linux-Repository verfügbar, vorerst nur in der Edge-Version. Sie können es also wie folgt installieren:

apk zola hinzufügen --repository http://dl-cdn.alpinelinux.org/alpine/edge/community/

Fedora

An alle Fedora-Liebhaber, ihr werdet nicht zurückgelassen. Zola ist seit Fedora 29 in den offiziellen Repositories verfügbar! Laden Sie es wie folgt in Ihren Computer/Server:

sudo dnf installieren zola

Leeres Linux

Fans der Leere, hier ist eure Zeit. Sie werden erfreut sein zu hören, dass Zola in den offiziellen Void Linux-Repositorys verfügbar ist. Sie werden es also einfach wie andere Anwendungen wie diese installieren:

sudo xbps-install zola

FreeBSD

Trotzdem bleibt FreeBSD nicht zurück. Zola ist im offiziellen Paket-Repository verfügbar. Alle Benutzer von FreeBSD, die Zola verwenden möchten, können es so einfach installieren, wie diesen Befehl ausführen:

pkg installieren zola

OpenBSD

Außerdem ist Zola im offiziellen Paket-Repository von OpenBSD verfügbar. Um es auf dem OpenBSD-Betriebssystem zu installieren, reicht es aus, den folgenden Befehl auszuführen.

doas pkg_add zola

Snapcraft

Wenn Sie Zola aus dem einen oder anderen Grund in keinem der Repositorys wie in Ubuntu finden können, können Sie den Snap Store verwenden. Zola ist auf Snapcraft verfügbar und vorausgesetzt, Sie haben Snap installiert, können Sie Zola wie folgt installieren:

sudo snap install --edge zola

Verwenden des Zola Static Site Generators

Abhängig von dem Betriebssystem oder der Distribution, die Sie derzeit verwenden, glauben wir, dass Zola jetzt installiert und einsatzbereit ist. Wie Sie sich vielleicht vorstellen können, werden wir sofort in die Details der Funktionsweise von Zola springen und dies tun, indem wir eine einfache Site erstellen. Wir hoffen, dass es Ihnen mit dem Beispiel leichter fällt, darauf aufzubauen und Ihre vollwertigen Websites zu erstellen. Lasst uns beginnen:

Schritt 1: Initialisieren Sie Ihren Blog oder Ihre Website

Der erste Schritt besteht darin, Ihren Blog oder Ihre Website zu initialisieren, da Zola im Gegensatz zu einigen statischen Site-Generatoren keine Annahmen über die Struktur Ihrer Site macht. Ihnen werden ein paar Fragen gestellt, damit Zola herausfinden kann, wie es die meisten Dinge bestellt, die Sie benötigen. Initialisieren Sie Ihre Website wie folgt. Sie können ersetzen“Computingforgeeksite” mit beliebigem Namen.

cd ~ zola init computingforgeeksite

Die folgenden Fragen werden auftreten, nachdem Sie diesen Befehl ausgeführt haben

> Wie lautet die URL Ihrer Website?? (https://Beispiel.com): //computingforgeeks.com > Möchten Sie die Sass-Kompilierung aktivieren?? [J/n]: > Möchten Sie das Syntax-Highlighting aktivieren?? [y/N]: > Möchten Sie einen Suchindex des Inhalts erstellen? [j/n]: Fertig! Ihre Website wurde in /home/vagrant/computingforgeeksite erstellt

Wenn Sie mit der Beantwortung der Fragen fertig sind, sollten Sie nun ein „Computingforgeeksite”-Verzeichnis mit folgender Struktur:

├── konfigurieren.toml ├── Inhalt ├── sass ├── statisch ├── Vorlagen └── Themen

Um zu beweisen, dass unser Zola funktioniert, können wir den Zola-Entwicklungsserver mit dem folgenden Befehl starten:

$ cd ~/computingforgeeksite $ zola servieren -i 172.23.209.227 Baustelle… -> 0 Seiten (0 verwaiste), 0 Abschnitte erstellen und 0 Bilder verarbeiten

Wenn Sie Ihren Browser öffnen und die ID an den Domainnamen oder die IP-Adresse Ihres Servers (http://Domainname|IP-Adresse:1111). Wenn sich Ihr Server an einem Remote-Standort befindet und eine Firewall ausgeführt wird, sollten Sie Port 1111 zulassen. Sie sollten eine Seite sehen, die der unten geteilten ähnelt.

Schritt 2: Beispiel-Homepage erstellen

Wie im einleitenden Abschnitt dieses Handbuchs erwähnt, verwendet Zola die Tera-Template-Engine, die Jinja2, Django-Templates, Liquid und Twig . ähnelt. Wir werden sehen, wie diese Templating-Engine hier funktioniert. Lassen Sie uns zum Vorlagenverzeichnis navigieren und dann eine Basisvorlage erstellen, die von anderen Seiten wiederverwendet wird.

$ cd ~/computingforgeeksite/templates $ vim base.html     ComputingForGeeks-Blog   
% block content % % endblock % ##Dieser Abschnitt nutzt die Vorteile der Tera-Vorlagen-Engine. Andere Seiten werden hier eingefügt.

Diese Basisvorlage kann um weitere Seiten erweitert werden, sodass die sich wiederholenden Abschnitte einfach von dieser Basisseite bearbeitet werden. Andere Seiten konzentrieren sich auf die spezifischen Funktionen, für die sie entwickelt wurden. Um zu sehen, wie das geht, erstellen wir eine Indexseite, die diese Basisvorlage erweitert.

Erstellen Sie im selben Vorlagenverzeichnis einen Index.html-Datei

% erweitert "base .".html" % % Blockinhalt % 

ComputingForGeeks-Seite, die die Basisvorlage mit der Tera-Vorlagen-Engine erweitert.

% Endblock-Inhalt %

Der Text zwischen den % Blockinhalt % und % Endblockinhalt % Tags werden in die Basisvorlage eingefügt injected.
An dieser Stelle, wenn wir unseren Zola-Server starten und besuchen http://Domainname|IP-Adresse:1111, Wir werden eine Seite wie unten sehen:

Schritt 3: Hinzufügen von Inhalten

In Zola gibt es etwas namens a "Sektion“. Ein Abschnitt wird immer dann erstellt, wenn ein Verzeichnis (oder Unterverzeichnis) im Inhaltsverzeichnis ein „_Index.md" Datei. Wenn ein Verzeichnis kein . enthält _Index.md Datei wird kein Abschnitt erstellt, aber Markdown-Dateien in diesem Verzeichnis erstellen weiterhin Seiten (bekannt als verwaiste Seiten).

Bevor wir fortfahren, beginnen wir mit der Erstellung eines „Seite? ˅” Unterverzeichnis im Inhaltsverzeichnis erstellen Sie dann ein “_Index.md” Datei drin.

Diese Datei sagt Zola, dass „Seite? ˅” ist ein Abschnitt, in dem Inhalte in Zola . kategorisiert werden.

mkdir ~/computingforgeeksite/content/site

Innerhalb der _Index.md Datei haben wir die Möglichkeit, einige Variablen zu übergeben, die wir auf unseren Seiten verwenden können. Lassen Sie uns darin die folgenden Variablen im TOML-Format setzen:

$ cd ~/computingforgeeksite/content/site $ vim _index.md +++ title = "Glossar of Geeks blog posts" sort_by = "date" template = "site.html" page_template = "site-page.html" +++ ##Blog-Beiträge hier

Schritt 4: Site-Vorlagen erstellen

Nachdem wir unsere „_Index.md” Datei, nach der gesucht werden soll”Seite? ˅.html” Vorlage als Basisvorlage zum Auflisten der Markdown-Dateien in diesem Abschnitt und laden Sie “Website-Seite.html” als Vorlage für einzelne Markdown-Site-Dateien erstellen wir diese Dateien in “Vorlagen" Verzeichnis.

$ cd ~/computingforgeeksite/templates $ nanosite.html % erweitert "base.html" % % Blockinhalt % 

Sektion.Titel

% Endblock-Inhalt %

Seite? ˅.html erweitert die Basis.html, aber dieses Mal verwenden wir diese Vorlage, um die Blog-Posts aufzulisten. Der Titel, den wir im _index . gesetzt haben.md-Datei oben steht uns zur Verfügung als Sektion.Titel . In der Liste unter dem Titel durchlaufen wir alle Seiten in unserem Abschnitt (Site-Verzeichnis) und geben den Seitentitel und die URL mit . aus Seite.Titel und Seite.Dauerlink | sicher , beziehungsweise.

An diesem Punkt, wenn wir den Zola-Server starten und unseren Browser auf http://Domainname|IP-Adresse:1111/Seite? ˅, Wir sollten nur den Titel wie folgt sehen:

Schritt 5: Markdown-Inhalt erstellen

Die Seiten, die wir in den Abschnittsbereich laden, sind im Markdown-Format und müssen sich im Verzeichnis „Site“ befinden. Erstellen Sie im Site-Verzeichnis eine Datei namens blog1.md mit folgendem Inhalt:

$ cd ~/computingforgeeksite/content/site $ nano blog1.md +++ title = "Meine erste Webseite" date = 2021-04-18 +++ Dies ist mein erster Blogbeitrag zum Thema Computing für Geeks.

Der Titel und das Datum werden uns auf der Site-Seite zur Verfügung gestellt.HTML-Vorlage als Seite.Titel und Seite.Datum , beziehungsweise. Alle Texte unter dem Abschluss +++ steht uns zur Verfügung als Seite.Inhalt .

An diesem Punkt, wenn wir den Zola-Server starten und unseren Browser auf http://Domainname|IP-Adresse:1111/Seite? ˅, Wir sollten den Titel und den ersten Markdown-Dateititel als Hyperlink wie folgt sehen:

Lassen Sie uns hinzufügen Website-Seite.html Datei am selben Ort

% erweitert "base .".html" % % Blockinhalt % 

Seite.Titel

Seite.Datum

Seite.Inhalt | sicher % Endblock-Inhalt %

Nachdem wir diese Vorlage hinzugefügt haben, können wir den Zola-Server starten und wenn wir unseren Browser auf http://Domainname|IP-Adresse:1111/site/bolg1, Wir sollten den gesamten Inhalt der Markdown-Datei wie unten dargestellt sehen:

Schritt 6: Bereitstellen von fertigen Dateien

Nachdem wir mit dem Stylen und Tunen oder Bloggen fertig sind, ist es an der Zeit, es deinen Freunden zu zeigen. Der Zola-Server kann verwendet werden, um Ihre Site mit dem „Zola bauen" Befehl. Der Befehl erstellt die Site im öffentlichen / Ordner, den Sie einfach in Ihren Webserver, Vercel, Netlify, GitHub Pages usw. kopieren können.

Dies ist die endgültige Dateistruktur für dieses untersuchte Beispiel.

├── konfigurieren.toml ├── Inhalt/ │ └── Blog/ │ ├── _index.md └── blog1.md ├── sass/ ├── statisch/ ├── Vorlagen/ │ ├── Basis.html │ ├── Website-Seite.html │ ├── Website.html │ └── index.html └── Themen/

Abschließende Bemerkungen

Das ist nur die Spitze des Eisbergs über Zola. Es kommt mit so viel mehr wie Themen, Integration mit CSS-Frameworks und vielem mehr. Sie können mehr über Zola auf seiner Hauptwebseite erfahren, während Sie sich darauf vorbereiten, diesen wunderbaren statischen Site-Generator zu beherrschen.

So blockieren Sie den TCP- oder UDP-Port mithilfe der Windows-Firewall
Die Windows-Firewall ist eine von Microsoft entwickelte Anwendung, die Informationen, die aus dem Internet auf Ihren Computer gelangen, filtert und al...
Fix - Es gab ein Problem beim Starten von StartupCheckLibrary.dll
StartupCheckLibrary.dll-Datei ist eine Systemdatei, die sich im Ordner System32 befindet. Nachdem Sie ein Update auf Ihrem Windows installiert haben, ...
So entfernen Sie Puawin32/Presenoker unter Windows 10
Die Aufgabe des Windows Defender (integriertes Antivirenprogramm für Windows 10) besteht darin, potenzielle Bedrohungen auf Ihrem Computer zu blockier...