Jekyll

Hinweis: Diese Inhalte wurden mit Unterstützung von Künstlicher Intelligenz erstellt und redaktionell überprüft (Transparenzhinweis gemäß Art. 50 EU AI Act).

Jekyll ist ein Generator für statische Websites: Aus Markdown-Dateien, Vorlagen und einer Einstellungsdatei baut er fertige HTML-Seiten, die jeder Webserver ohne Datenbank und ohne Programmiersprache ausliefern kann. Jekyll steckt auch hinter GitHub Pages und eignet sich für Blogs, Projektseiten und Dokumentationen.

Vorbemerkungen

  • Installation über apt: Ubuntu 26.04 enthält Jekyll in der aktuellen Version 4.4.1. Die Anleitung installiert Jekyll deshalb vollständig über apt. Das Standard-Design minima und die Plugins für den Feed und für Suchmaschinen-Angaben kommen als empfohlene Pakete automatisch mit. Ruby-Pakete aus dem Internet (Gems) sind für die Beispielseite nicht nötig.
  • Version: Getestet mit Jekyll 4.4.1, Ruby aus Ubuntu 26.04 und dem Design minima 2.5.1.
  • Port: Die Vorschau läuft auf Port 4000, nur vom eigenen Rechner aus erreichbar.

Installation

1. Paketlisten aktualisieren

Damit apt die aktuelle Version von Jekyll kennt.

sudo apt update

2. Jekyll installieren

Installiert Jekyll mit Ruby, dem Design minima und den Plugins jekyll-feed und jekyll-seo-tag (zusammen etwa 60 Pakete).

sudo apt install jekyll

Prüfen: Die Ausgabe lautet jekyll 4.4.1.

jekyll --version

Eine Website anlegen

3. Neue Website erzeugen

Legt den Ordner ~/meineseite mit einer Beispielseite an: Startseite, Seite „About“, ein Beispielbeitrag und die Einstellungsdatei _config.yml. Jekyll ruft dabei bundle install auf. Bundler prüft, ob alle benötigten Ruby-Pakete vorhanden sind, und findet sie in den apt-Paketen aus Schritt 2.

jekyll new ~/meineseite

Prüfen: Die Ausgabe endet mit New jekyll site installed in …/meineseite. Die Zeile davor lautet Bundle complete!.

4. In den Ordner der Website wechseln

Alle weiteren Befehle werden hier ausgeführt.

cd ~/meineseite

5. Einstellungen anpassen

In _config.yml stehen Titel, Beschreibung, Sprache und Design der Website. Die Beispieldatei enthält englische Platzhalter.

nano _config.yml

Ersetze den gesamten Inhalt: Alt+\ springt an den Anfang, Alt+A beginnt eine Markierung, Alt+/ springt ans Ende, Strg+K löscht alles Markierte. Füge dann diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:

title: Meine Wissensseite
description: Notizen und Anleitungen, gebaut mit Jekyll.
lang: de
baseurl: ""
url: ""
theme: minima
plugins:
  - jekyll-feed
  • title und description erscheinen im Kopf der Seiten und im Feed.
  • lang: de kennzeichnet die Seiten als deutsch. Das hilft Screenreadern und Suchmaschinen.
  • theme: minima ist das Design, jekyll-feed erzeugt die Datei feed.xml für Feed-Reader.

Jekyll liest _config.yml nur beim Start. Nach Änderungen an dieser Datei musst du die Vorschau aus Schritt 7 neu starten.

6. Einen Beitrag schreiben

Beiträge liegen im Ordner _posts. Der Dateiname muss mit dem Datum im Format JJJJ-MM-TT beginnen. Verwende das heutige Datum, denn Beiträge mit einem Datum in der Zukunft lässt Jekyll beim Bauen weg.

nano _posts/2026-09-26-erster-beitrag.md

Füge diesen Inhalt ein (Strg+Umschalt+V), speichere mit Strg+O und Enter und beende nano mit Strg+X:

---
layout: post
title: "Mein erster Beitrag"
---
Diese Seite wurde mit **Jekyll** gebaut.

- Beiträge liegen im Ordner `_posts`.
- Der Dateiname beginnt mit dem Datum.

Der Block zwischen den beiden ----Zeilen heißt Front Matter. Er sagt Jekyll, welche Vorlage (layout) und welchen Titel die Seite bekommt. Darunter folgt normales Markdown.

7. Vorschau starten

Baut die Website und startet einen kleinen Webserver. Jekyll beobachtet den Ordner und baut die Seiten bei jeder gespeicherten Änderung neu.

jekyll serve

Prüfen: Die Ausgabe enthält Server address: http://127.0.0.1:4000/. Öffne http://localhost:4000 im Browser. Oben steht „Meine Wissensseite“, darunter ist „Mein erster Beitrag“ aufgelistet.

Beende die Vorschau mit Strg+C.

8. Website für die Veröffentlichung bauen

Erzeugt die fertige Website im Ordner _site, ohne einen Server zu starten.

jekyll build

Prüfen: Der Ordner _site enthält unter anderem index.html und feed.xml.

ls _site

Den Inhalt von _site kann jeder Webserver ausliefern. Wie das mit nginx geht, zeigt Statische Website mit nginx. Kopiere dafür den Inhalt von _site in den dort verwendeten Ordner /var/www/start.de/html.

Aktualisieren

Jekyll, das Design und die Plugins werden mit den normalen Systemaktualisierungen erneuert:

sudo apt update && sudo apt upgrade

Deinstallieren

1. Jekyll entfernen

purge entfernt das Programm samt seiner Systemdateien.

sudo apt purge jekyll

2. Nicht mehr benötigte Pakete entfernen

Entfernt Ruby, das Design und die Plugins, die mit Jekyll installiert wurden, sofern kein anderes Programm sie braucht. Lies vor dem Bestätigen die Liste.

sudo apt autoremove --purge

3. Beispielseite löschen

Achtung: Damit sind auch deine Beiträge weg. Wer sie behalten will, kopiert vorher den Ordner ~/meineseite/_posts.

rm -r ~/meineseite

Prüfen: Der Befehl jekyll wird nicht mehr gefunden.

jekyll --version

Quellen und Lizenz

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.

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.

Autor: Thorsten · Installationsanleitungen für Ubuntu

Alle Anleitungen ohne Gewähr. Befehle mit sudo verändern das System – vorher lesen, dann ausführen.