Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Nikola
Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).
Nikola ist ein Generator für statische Websites und Blogs in Python. Er bringt ein fertiges Design, Archiv, Kategorien, Schlagwörter, RSS-Feed, Bildergalerien und deutsche Beschriftungen mit und baut bei Änderungen nur die Seiten neu, die sich wirklich geändert haben.
Vorbemerkungen
- Kein apt-Paket: Nikola ist nicht in den Ubuntu-Paketquellen enthalten. Diese Anleitung installiert es deshalb mit
pipin eine virtuelle Umgebung (venv), einen eigenen Ordner nur für dieses Projekt, siehe Python. Das System-Python bleibt so unverändert. - Version: Getestet mit Nikola 8.3.3 und Python 3.14 aus Ubuntu 26.04.
- Keine automatische Vorschau: Der Befehl
nikola auto, der die Website bei jeder Änderung neu baut, bricht in Version 8.3.3 unter Python 3.14 mit einem Fehler ab. Diese Anleitung verwendet deshalbnikola buildzum Bauen undnikola servefür die Vorschau. - Port: Die Vorschau läuft auf Port 8000, nur vom eigenen Rechner aus erreichbar. Läuft dort schon ein anderes Programm, z. B. aus der Pelican-Anleitung, hängst du an den Befehl in Schritt 12
--port 8001an.
Installation
1. Paketlisten aktualisieren
Damit apt die aktuelle Version von python3-venv kennt.
sudo apt update
2. Werkzeug für virtuelle Umgebungen installieren
python3-venv enthält das Werkzeug, mit dem Python virtuelle Umgebungen anlegt. Python selbst ist unter Ubuntu schon installiert.
sudo apt install python3-venv
3. Projektordner anlegen
In diesem Ordner liegen später die virtuelle Umgebung, die Einstellungen und alle Beiträge.
mkdir ~/meinnikola
4. In den Projektordner wechseln
Alle weiteren Befehle werden hier ausgeführt.
cd ~/meinnikola
5. Virtuelle Umgebung anlegen
Legt die Umgebung im Unterordner .venv an.
python3 -m venv .venv
6. Virtuelle Umgebung einschalten
Danach verwenden pip und nikola in diesem Terminal die Programme aus .venv. In einem neuen Terminal wiederholst du die Schritte 4 und 6.
source .venv/bin/activate
Prüfen: Vor der Eingabeaufforderung steht jetzt (.venv).
7. Nikola installieren
Installiert Nikola mit allem, was es für Markdown, das Standard-Design und die Vorschau braucht.
pip install Nikola
Prüfen: Die Ausgabe lautet Nikola v8.3.3 (oder eine neuere Nummer).
nikola version
Eine Website anlegen
8. Grundgerüst erzeugen
Der Punkt steht für den aktuellen Ordner. Der Assistent fragt einige Angaben ab, schreibt sie in die Einstellungsdatei conf.py und legt die Ordner posts (Blogbeiträge), pages (feste Seiten wie „Über mich“), images, galleries, files und listings an.
nikola init .
Beantworte die Fragen so:
| Frage | Eingabe |
|---|---|
Site title | Meine Website |
Site author | dein Name |
Site author's e-mail | deine E-Mail-Adresse (erscheint im RSS-Feed) |
Site description | ein kurzer Satz über die Website |
Site URL | Enter (https://example.com/, später in conf.py änderbar) |
Enable pretty URLs …? | Enter (ja, Adressen wie /posts/titel/) |
Language(s) to use | de |
Time zone | Enter (Nikola schlägt die Zeitzone des Rechners vor, z. B. Europe/Berlin) |
Use this time zone? | Enter (ja) |
Comment system | Enter (keine Kommentare) |
Prüfen: Die Ausgabe endet mit That's it, Nikola is now configured.
9. Einen Beitrag anlegen
new_post legt im Ordner posts eine neue Datei mit allen Metadaten und dem aktuellen Datum an. -f markdown wählt Markdown als Format, -t setzt den Titel. Aus dem Titel bildet Nikola den Dateinamen und die Adresse.
nikola new_post -f markdown -t "Mein erster Beitrag"
Prüfen: Die Datei posts/mein-erster-beitrag.md ist vorhanden.
ls posts
10. Beitrag schreiben
nano posts/mein-erster-beitrag.md
Oben in der Datei steht ein Kommentarblock (<!-- bis -->) mit den Metadaten. Gehe in die Zeile .. tags: und schreibe dahinter nikola, blog. Ersetze ganz unten den Platzhaltertext Schreibe hier deinen Eintrag hin. durch deinen Text, zum Beispiel:
Diese Seite wurde mit **Nikola** gebaut.
Speichere mit Strg+O und Enter und beende nano mit Strg+X.
11. Website bauen
Liest Beiträge und Seiten und schreibt die fertige Website in den Ordner output. Beim ersten Mal kopiert Nikola auch das Design dorthin, jedes weitere Mal baut es nur die geänderten Seiten neu.
nikola build
Prüfen: Im Ordner output liegen unter anderem index.html, archive.html, rss.xml und der Ordner posts.
ls output
12. Vorschau starten
Startet einen kleinen Webserver für den Ordner output. Ohne -a 127.0.0.1 wäre die Vorschau im ganzen Netzwerk erreichbar.
nikola serve -a 127.0.0.1
Prüfen: Die Ausgabe enthält Serving on http://127.0.0.1:8000/. Öffne http://localhost:8000 im Browser. Oben steht „Meine Website“, darunter der Beitrag mit Datum und Schlagwörtern.
Beende die Vorschau mit Strg+C. Nach jeder Änderung an Beiträgen oder conf.py rufst du nikola build erneut auf und lädst die Seite im Browser neu.
13. Website für die Veröffentlichung vorbereiten
In conf.py stehen alle Einstellungen, gut kommentiert.
nano conf.py
Suche mit Strg+W nach SITE_URL = und ersetze https://example.com/ durch die echte Adresse deiner Website, sonst zeigen RSS-Feed und Sitemap auf example.com. Speichere mit Strg+O und Enter, beende nano mit Strg+X und baue die Website mit nikola build neu.
Den Inhalt von output kann jeder Webserver ausliefern, zum Beispiel wie in Statische Website mit nginx beschrieben.
Aktualisieren
1. In den Projektordner wechseln
cd ~/meinnikola
2. Virtuelle Umgebung einschalten
source .venv/bin/activate
3. Neue Version installieren
Einstellungen und Beiträge bleiben erhalten.
pip install --upgrade Nikola
Prüfen: nikola version zeigt die neue Versionsnummer. Danach mit nikola build neu bauen.
Deinstallieren
1. Virtuelle Umgebung ausschalten
Falls sie im aktuellen Terminal noch eingeschaltet ist.
deactivate
2. Projektordner löschen
Entfernt Nikola, die Einstellungen, alle Beiträge und die gebaute Website. Achtung: Wer die Beiträge behalten will, kopiert vorher die Ordner ~/meinnikola/posts und ~/meinnikola/pages.
rm -r ~/meinnikola
Prüfen: Der Ordner ist verschwunden.
ls ~/meinnikola
python3-venv bleibt installiert, weil andere Anleitungen es ebenfalls verwenden.
Quellen und Lizenz
- Offizielle Dokumentation: https://getnikola.com/documentation.html
- Lizenz: Nikola 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.