Kiwix eigene Webprojekte in eine ZIM-Datei umwandeln

Digitale Autarkie

Technische Souveränität → Digitale Autarkie
└─ KiCad – Einstieg für Autarke
   ├─ Schaltungen simulieren mit KiCad und weiteren Tools
      └─ Logik-Simulatoren
      └─ USB-Messgeräte für PC und Laptop
   └─ Freie Software als Grundlage für eine kleine Industrie
      └─ Freie Software für produktives Arbeiten
  
Kiwix - Das Offline-Internet  
└─ Kiwix installieren und einrichten
   └─ Kiwix eigene Webprojekte in eine ZIM-Datei umwandeln

Siehe auch:
Sicherheitskamera, Wie funktioniert Meshtastic, Digitale Kommunikation mit Meshtastic, Volla Phone und Tablet, Alte Smartphones sinnvoll weiter verwenden, Starlink für Autarkie, Digitale Autarkie, Autarkie  
└─ ASCII/Block-Arts, Terminal-Games ─┘

Der bequemste Weg

Wer keinen eigenen Linux-Server hat und keine Befehle im Terminal tippen möchte, kann den kostenlosen Webdienst You.Zimit nutzen.

1. Rufe die Webseite you.zimit.kiwix.org auf.
2. Gib die Adresse (URL) deines Webprojekts ein.
3. Trage deine E-Mail-Adresse ein.
4. Starte den Vorgang.

Sobald der Kiwix-Server deine Webseite vollständig verarbeitet hat, erhältst du eine E-Mail mit einem direkten Download-Link zu deiner fertigen `.zim`-Datei.

Hinweis: Dieser Dienst eignet sich hervorragend für kleine bis mittelgroße Webseiten und Blogs!

Anleitung: Eigene Webprojekte in eine ZIM-Datei umwandeln

Wer ein eigenes Wiki, einen Blog oder eine Dokumentationsseite betreibt, kann diese mit wenigen Befehlen in eine eigene `.zim`-Datei umwandeln. So lässt sich das eigene Webprojekt komplett offline sichern oder auf Mobilgeräten verteilen.

Methode 2: Jede beliebige HTML-Webseite / Wiki umwandeln (mit Zimit / Docker)

Das offizielle und einfachste Werkzeug für moderne Webseiten ist Zimit. Es nutzt im Hintergrund einen echten Browser (Playwright), lädt die Webseite vollständig herunter und packt sie direkt in das ZIM-Format.

Voraussetzungen

• Ein Linux-System (Ubuntu, Debian etc.) oder macOS
• Installiertes Docker

Schritt-für-Schritt

1. Docker-Befehl ausführen:

  Öffne das Terminal und starte den Container. Ersetze `https://dein-webprojekt.de` durch die URL deiner Webseite und wähle einen Namen für die Ausgabedatei:

  docker run -v $(pwd):/output ghcr.io/openzim/zimit zimit --url https://dein-webprojekt.de --output mein-projekt.zim

2. Was passiert im Hintergrund?

  * Das Tool crawlt deine Webseite automatisiert Link für Link.
  * Bilder, CSS-Styling und JavaScript werden lokal gespeichert.
  * Am Ende liegt die fertige Datei mein-projekt.zim in deinem aktuellen Ordner.

Methode 2: Für MediaWiki-Enzyklopädien (mwoffliner)

Wenn du ein echtes MediaWiki betreibst (wie Wikipedia oder deine eigene Wissensdatenbank), gibt es das spezialisierte Tool mwoffliner. Es nutzt direkt die API des Wikis, was zu extrem komprimierten und sauberen Ergebnissen führt.

Befehl via Docker

docker run -v $(pwd):/output ghcr.io/openzim/mwoffliner mwoffliner --mwUrl=https://dein-wiki.de/ --adminEmail=deine-email@domain.de --output=/output

Vorteile von mwoffliner:

• Erstellt automatisch Suchindizes für die Kiwix-Volltextsuche.
• Erzeugt auf Wunsch getrennte Versionen (z. B. mit Bildern oder als speicherschonende Nur-Text-Version).

Methode 3: Für statische Ordner mit HTML-Dateien (zimwriterfs)

Falls du eine reine statische HTML-Webseite lokal auf der Festplatte liegen hast (z. B. mit Hugo, Jekyll oder per Hand geschrieben), nutzt du das Tool zimwriterfs.

Befehl

zimwriterfs --welcome=index.html --favicon=favicon.png --language=deu --title="Mein Projekt" --description="Offline-Archiv" /pfad/zum/html-ordner mein-projekt.zim

Praxis-Tipps für eigene ZIM-Dateien

> Wichtiger Hinweis: Achte darauf, dass deine Webseite vor dem Crawlen keine kaputten relativen Links enthält. Externe Links (zu fremden Webseiten) funktionieren offline natürlich nicht mehr!

• Favicon festlegen: Vergiss nicht, ein deutliches Favicon für deine Webseite zu setzen, da Kiwix dieses als Icon in der Offline-Bibliothek anzeigt.
• Testen: Öffne die erstellte `.zim`-Datei nach der Erstellung direkt in deiner Kiwix-App am PC oder Tablet und prüfe, ob die Suchfunktion und alle Bilder wie gewünscht funktionieren.
• Automatisierung: Du kannst den Docker-Befehl in einen monatlichen Cronjob auf deinem Server einbinden, um immer automatisch ein frisches Offline-Backup deiner Webseite generieren zu lassen.

Weblinks

• Offizielles OpenZIM GitHub Repository
• Zimit-Webdienst (ZIM-Erstellung direkt im Browser testen)