Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Zola
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Zola ist ein Generator für statische Websites, der als ein einziges Programm ohne weitere Abhängigkeiten auskommt. Er wandelt Markdown-Dateien mit Hilfe von Vorlagen in fertiges HTML um und bringt Vorschau-Server, Sass-Übersetzung, Syntaxhervorhebung und Suchindex gleich mit.
Vorbemerkungen
- Warum nicht apt oder Snap: Ubuntu 26.04 enthält kein Paket
zola. Im Snap Store gibt es Zola nur im Testkanaledge, nicht als stabile Version. Diese Anleitung verwendet deshalb die fertige Programmdatei, die das Zola-Projekt auf GitHub veröffentlicht. Sie wird nach/usr/local/binkopiert. Dort liegen selbst installierte Programme, getrennt von den Paketen aus apt. - Version: Getestet mit Zola 0.23.6. Steht auf der Release-Seite eine neuere Version, ersetzt du
0.23.6in den Befehlen durch die neue Nummer. - Design: Zola bringt kein fertiges Design mit. Ohne Vorlagen zeigt die Website nur eine Willkommensseite. In dieser Anleitung legst du drei kleine Vorlagen selbst an. Fertige Designs findest du unter https://www.getzola.org/themes/.
- Port: Die Vorschau läuft auf Port 1111, nur vom eigenen Rechner aus erreichbar.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuellen Paketversionen kennt.
sudo apt update
2. curl installieren
Mit curl lädst du die Programmdatei herunter. Meist ist es schon installiert. Dann meldet apt nur, dass es bereits die neueste Version ist.
sudo apt install curl
3. Archiv herunterladen
Lädt die Linux-Version für 64-Bit-Intel/AMD-Prozessoren nach /tmp. -L folgt der Weiterleitung von GitHub zum eigentlichen Download.
curl -L -o /tmp/zola.tar.gz https://github.com/getzola/zola/releases/download/v0.23.6/zola-v0.23.6-x86_64-unknown-linux-gnu.tar.gz
Prüfen: Die Datei ist rund 16 MB groß.
ls -lh /tmp/zola.tar.gz
4. Prüfsumme kontrollieren
Die Prüfsumme zeigt, ob die Datei vollständig und unverändert angekommen ist.
sha256sum /tmp/zola.tar.gz
Prüfen: Bei Version 0.23.6 lautet die Ausgabe 8f5132b3522412d04e395e0b25f6d68613ad272a873e54a2b3ebf664873024a4. Bei einer neueren Version vergleichst du mit dem Wert, den GitHub auf der Release-Seite unter „Assets“ neben der Datei zola-v…-x86_64-unknown-linux-gnu.tar.gz anzeigt (sha256:…).
5. Programm auspacken
Das Archiv enthält neben dem Programm zola noch Lizenztexte und Hilfedateien. Der Name zola am Ende sorgt dafür, dass nur das Programm nach /usr/local/bin ausgepackt wird.
sudo tar -xzf /tmp/zola.tar.gz -C /usr/local/bin zola
Prüfen: Die Ausgabe lautet zola 0.23.6.
zola --version
6. Archiv löschen
Das heruntergeladene Archiv wird nicht mehr gebraucht.
rm /tmp/zola.tar.gz
Eine Website anlegen
7. Grundgerüst erzeugen
Legt den Ordner ~/meineseite mit der Einstellungsdatei zola.toml und den leeren Ordnern content (Texte), templates (Vorlagen), static (Bilder und andere Dateien), sass und themes an.
zola init ~/meineseite
Der Assistent stellt drei Fragen. Drücke jedes Mal Enter, um den Vorschlag zu übernehmen:
| Frage | Eingabe |
|---|---|
What is the URL of your site? | Enter (https://example.com, später änderbar) |
Do you want to enable Sass compilation? | Enter (ja) |
Do you want to build a search index of the content? | Enter (nein) |
Prüfen: Die Ausgabe enthält Done! Your site was created in …/meineseite.
8. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meineseite
9. Titel und Sprache einstellen
In zola.toml stehen die Einstellungen der Website.
nano zola.toml
Gehe in die Zeile base_url = "https://example.com" und drücke am Zeilenende Enter. Füge dort diese zwei Zeilen ein (Strg+Umschalt+V):
title = "Meine Website"
default_language = "de"
Die Zeilen müssen oberhalb von [markdown] stehen. Alles unter einer Zeile in eckigen Klammern gehört zu diesem Abschnitt. Speichere mit Strg+O und Enter und beende nano mit Strg+X.
10. Grundvorlage anlegen
Zola verwendet die Vorlagensprache Tera. In base.html steht das Gerüst, das alle Seiten gemeinsam haben: Kopfbereich, einfache Gestaltung und der Titel der Website als Überschrift. {% block content %} ist der Platz, den die anderen Vorlagen füllen.
nano templates/base.html
Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:
<!DOCTYPE html>
<html lang="{{ lang }}">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>{% block title %}{{ config.title }}{% endblock %}</title>
<style>
body { max-width: 42rem; margin: 2rem auto; padding: 0 1rem; font-family: sans-serif; line-height: 1.6; }
header a { color: inherit; text-decoration: none; }
.datum { color: #666; font-size: 0.9rem; }
</style>
</head>
<body>
<header><h1><a href="{{ get_url(path='/') }}">{{ config.title }}</a></h1></header>
<main>{% block content %}{% endblock %}</main>
</body>
</html>
11. Vorlage für die Startseite anlegen
Die Startseite zeigt den Begrüßungstext und darunter eine Liste aller Beiträge mit Datum.
nano templates/index.html
Füge diesen Inhalt ein, speichere und beende nano:
{% extends "base.html" %}
{% block content %}
{{ section.content | safe }}
<ul>
{% for page in section.pages %}
<li><a href="{{ page.permalink }}">{{ page.title }}</a> <span class="datum">{{ page.date | date(format="%d.%m.%Y") }}</span></li>
{% endfor %}
</ul>
{% endblock %}
extends "base.html"– übernimmt das Gerüst aus Schritt 10.section.pages– alle Beiträge im Ordnercontent.| safe– gibt das aus Markdown erzeugte HTML unverändert aus, statt die spitzen Klammern zu maskieren.
12. Vorlage für einzelne Beiträge anlegen
Zeigt Titel, Datum und Text eines Beitrags.
nano templates/page.html
Füge diesen Inhalt ein, speichere und beende nano:
{% extends "base.html" %}
{% block title %}{{ page.title }} – {{ config.title }}{% endblock %}
{% block content %}
<h2>{{ page.title }}</h2>
<p class="datum">{{ page.date | date(format="%d.%m.%Y") }}</p>
{{ page.content | safe }}
{% endblock %}
13. Text der Startseite anlegen
Die Datei _index.md (mit Unterstrich) gehört zur Startseite. Der Bereich zwischen den +++-Zeilen enthält Einstellungen im TOML-Format. sort_by = "date" sortiert die Beiträge nach Datum, die neuesten zuerst.
nano content/_index.md
Füge diesen Inhalt ein, speichere und beende nano:
+++
sort_by = "date"
+++
Willkommen auf meiner Website.
14. Einen Beitrag schreiben
Jede andere Markdown-Datei in content ist ein Beitrag. Aus dem Dateinamen wird die Adresse, hier /erster-beitrag/.
nano content/erster-beitrag.md
Füge diesen Inhalt ein, speichere und beende nano:
+++
title = "Mein erster Beitrag"
date = 2026-09-26
+++
Diese Seite wurde mit **Zola** gebaut.
15. Vorschau starten
zola serve baut die Website und startet einen kleinen Webserver. Jede gespeicherte Änderung an Texten, Vorlagen oder zola.toml baut die Seite sofort neu und lädt sie im Browser automatisch neu.
zola serve
Prüfen: Die Ausgabe enthält Creating 1 pages und Web server is available at http://127.0.0.1:1111. Öffne http://localhost:1111 im Browser. Oben steht „Meine Website“, darunter der Begrüßungstext und der Beitrag mit Datum.
Beende die Vorschau mit Strg+C. Ist Port 1111 schon belegt, startest du die Vorschau mit zola serve --port 1112.
16. Website für die Veröffentlichung bauen
Trage vorher in zola.toml bei base_url die echte Adresse deiner Website ein, sonst zeigen die Links auf example.com. Der Befehl schreibt die fertige Website in den Ordner public.
zola build
Prüfen: Im Ordner public liegen index.html, 404.html, sitemap.xml und der Ordner erster-beitrag.
ls public
Den Inhalt von public kann jeder Webserver ausliefern, zum Beispiel wie in Statische Website mit nginx beschrieben.
Aktualisieren
1. Neue Version herunterladen
Ersetze 0.23.6 an beiden Stellen durch die neue Versionsnummer.
curl -L -o /tmp/zola.tar.gz https://github.com/getzola/zola/releases/download/v0.23.6/zola-v0.23.6-x86_64-unknown-linux-gnu.tar.gz
2. Prüfsumme kontrollieren
Vergleiche die Ausgabe mit dem Wert auf der Release-Seite, wie in Schritt 4 der Installation.
sha256sum /tmp/zola.tar.gz
3. Programm ersetzen
Überschreibt die alte Programmdatei. Deine Websites bleiben unverändert.
sudo tar -xzf /tmp/zola.tar.gz -C /usr/local/bin zola
Prüfen: zola --version zeigt die neue Versionsnummer. Lies vor dem Aktualisieren die Änderungsliste auf der Release-Seite. Neue Versionen ändern gelegentlich Einstellungen, die dann in zola.toml angepasst werden müssen.
4. Archiv löschen
rm /tmp/zola.tar.gz
Deinstallieren
1. Programm löschen
Zola besteht nur aus dieser einen Datei.
sudo rm /usr/local/bin/zola
Prüfen: Die Ausgabe meldet, dass der Befehl bzw. die Datei nicht gefunden wurde.
zola --version
2. Website löschen (optional)
Entfernt Einstellungen, Vorlagen, Texte und die gebaute Website. Achtung: Wer die Texte behalten will, kopiert vorher den Ordner ~/meineseite/content.
rm -r ~/meineseite
curl bleibt installiert, weil andere Programme und Anleitungen es ebenfalls verwenden.
Quellen und Lizenz
- Offizielle Dokumentation: https://www.getzola.org/documentation/
- Lizenz: Zola steht unter der MIT.
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Open Knowledge (Freies Wissen): Alle Texte stehen unter der freien Lizenz Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen 4.0 International (CC BY-SA 4.0) und können frei gelesen, geteilt und weiterverarbeitet werden.