Installation¶

Das Programm ist nicht in den offiziellen Paketquellen enthalten. Es muss daher manuell installiert werden. Da bei diesem Weg eine statische Programmversion zum Einsatz kommt, werden Updates nicht automatisch durchgeführt.

sudo tar -xvjf kiwix-VERSION-linux-ARCHITEKTUR.tar.bz2 -C /opt/
sudo ln -s /opt/kiwix/kiwix /usr/local/bin/kiwix  

kiwix 

1
2
3
4
5
6
7
8

[Desktop Entry]
Name=Kiwix
Comment=Wikipedia offline betrachten
Exec=kiwix
Icon=/PFAD/ZU/kiwix_logo.png
Terminal=false
Type=Application
Categories=Application;Office;

ZIM-Dateien¶

Die Entwickler von Kiwix stellen regelmäßig aktuelle ZIM-Dateien der Wikipedia in verschiedensten Sprachen zur Verfügung. Zunächst lädt man sich die gewünschte Version von der Homepage 🇩🇪 herunter; es werden zwei Downloads angeboten. Wird neue Hardware verwendet, kann man ohne Weiteres den kleineren ersten Download wählen. Steht einem jedoch nur alte Hardware zur Verfügung, sollte man zunächst den Abschnitt Indexierung lesen und erwägen, den Index aus dem zweiten Download zu importieren. In diesem Fall verfährt man wie unter Index importieren beschrieben. Im Zweifelsfall sollte man sich eher für den zweiten Download entscheiden, die Installation ist dann zwar ein wenig umständlicher, dafür aber schneller, auch wenn etwas mehr Daten heruntergeladen werden müssen.

Einlesen¶

Man startet Kiwix und wählt unter "Datei → Datei öffnen" die ZIM-Datei aus. Anschließend erhält man eine Meldung

"Diese Datei enthält keinen Suchindex. Diesen zu erstellen kann mehrere Minuten dauern. Möchten Sie die ZIM-Datei jetzt indexieren?"

Um die Indexierung zu starten, bestätigt man mit "OK", andernfalls wählt man "Cancel" (s. Indexierung).

Indexierung¶

Nach der Installation funktioniert die Volltextsuche noch nicht, das heißt, man findet über die Suchmaske zwar jeden Artikel, wenn man jedoch nach einem Wort sucht, das keinen eigenen Artikel hat, erhält man obige Meldung. Wer diese Volltextsuche (s. Navigation) nicht braucht, kann Kiwix im Prinzip auch ohne einen solchen Index verwenden, allerdings wird die Meldung dann jedes Mal auftauchen, wenn man einen Begriff sendet, der kein Artikel ist. Deshalb sollte ein solcher Index erstellt werden.

Auf neuer Hardware ist dies auch kein Problem, selbst wenn es ein paar Stunden dauert. Man bestätigt dazu einfach die o.g. Meldung mit "OK" und wartet, bis der Vorgang abgeschlossen ist (der Prozessor wird dabei ausgelastet sein). Auf alter Hardware hingegen kann der Vorgang durchaus etliche Stunden dauern oder überhaupt nicht abschließen. Es besteht jedoch die Möglichkeit, einen Index zu importieren.

Da die Indexdateien selbst schnell ein paar GiB Speicherplatz beanspruchen, kann man diese nach Abschluss der Indexierung noch komprimieren. Hierzu findet man im Archiv kiwix-Version-linux-Architektur.tar.bz2 (siehe oben) ein Bash-Skript names kiwix-compact, das sich im entpackten Ordner mit ^[2]

./kiwix-compact 

ausführen lässt.

Index importieren¶

Wenn die Indexierung auf dem Zielrechner nicht funktioniert oder zu lange dauert, kann man den Index entweder auf einem leistungsfähigerem Rechner erstellen oder aus dem Download Pre-indexed ZIM + Kiwix for Windows beziehen.

Im Folgenden wird Letzteres beschrieben, das Vorgehen ist aber im anderen Fall analog. Ferner wird bei diesem Beispiel die Datei kiwix-0.9-rc1+wikipedia_de_all_05_2012.zip benutzt und es ist darauf zu achten, dass im Pfad www.kiwix.org/kiwix/5rxrb4i1.default der String "5rxrb4i1" angepasst wird, da er im Allgemeinen nicht übereinstimmen wird.

Sofern noch nicht geschehen, öffnet man Kiwix zunächst kurz und beendet es dann wieder (dies ist notwendig, damit der Ordner ~/.www.kiwix.org/kiwix erstellt wird). Dann entpackt ^[1] man die Datei kiwix-0.9-rc1+wikipedia_de_all_05_2012.zip, aus dem Unterverzeichnis ./kiwix/data/ verschiebt man die Ordner content und index nach ~/.www.kiwix.org/kiwix/ (der Pfad ist im Prinzip beliebig, die Anleitung ist bei abweichendem Speicherort anzupassen.). Dann startet man Kiwix und verfährt wie unter Einlesen beschrieben: auswählen der Datei ~/.www.kiwix.org/kiwix/content/wikipedia_de_all_05_2012.zimaa, Abbruch bei der Meldung mit "Cancel" und beenden von Kiwix.

Als nächstes öffnet man die Datei ~/.www.kiwix.org/kiwix/5rxrb4i1.default/library.xml in einem Editor ^[5] und fügt unterhalb von:

 path="/home/user/.www.kiwix.org/kiwix/content/wikipedia_de_all_05_2012.zim"

den Eintrag

 indexPath="../index/wikipedia_de_all_05_2012.zim.idx/" indexType="xapian"

ein. In der Datei gibt es zwei Möglichkeiten, Pfade anzugeben. Absolute Pfade (wie hier path) dürfen kein "~" statt "/home/BENUTZERNAME" verwenden. Relative Pfade (wie hier indexPath) beziehen sich auf den Ort von library.xml. Wenn man die Datei speichert und Kiwix erneut startet, sollte die Volltextsuche funktionieren.

Bedienung¶

sudo ln -s /opt/kiwix/bin/kiwix-serve /usr/local/bin/kiwix-serve 

kiwix-serve --library --port=8000 --verbose ~/.www.kiwix.org/kiwix/5rxrb4i1.default/library.xml 

kiwix-serve --library --port=8000 --daemon ~/.www.kiwix.org/kiwix/5rxrb4i1.default/library.xml 

pkill kiwix-serve 

Problembehebung¶

pkill xulrunner-bin 

Links¶

• Projektseite 🇩🇪 - Download der ZIM-Dateien

  • Kiwix 🇬🇧 - Entwicklerseite, Download der Software

• Kiwix 🇬🇧

• Kiwix

• ubuntuusers.de Offline-Wiki