Arch-Wiki-Man und Arch-Wiki-Lite spiegeln das umfangreiche Wiki der Arch-Linux-Community auf die lokale Platte und halten es aktuell.

Wenn Sie als Linux-Anwender gelegentlich auf der Suche nach Tipps zur Fehlerbehebung oder zu Lernzwecken das Internet durchsuchen, stoßen Sie mit Sicherheit immer wieder auf die hilfreichen Inhalte des Arch-Linux-Wikis [1]. Diese von der Arch-Linux-Community gepflegte und primär auf Arch Linux ausgerichtete Dokumentation gibt es, wenn auch mit weniger Umfang, sogar auf Deutsch [2] und ist in ihrer Kompetenz schwer zu toppen. Oft genug lassen sich die Hinweise auf andere Distributionen übertragen, oder sie weisen zumindest in die richtige Richtung.

In Form des Skripts Arch-Wiki-CLI [3] gibt es bereits seit Längerem eine Möglichkeit, das Arch-Wiki im Terminal zu durchsuchen. Das klappt zwar nur über eine bestehende Internet-Verbindung, ist aber je nach Arbeitsumgebung trotzdem gegenüber einem Webbrowser die bessere Wahl. Für geübte Konsoleros stellt sich die Frage kaum, da dieser Weg sie auf alle Fälle schneller zum Ziel führt.

Was aber, wenn Sie nicht (mehr) ins Internet kommen, etwa weil die grafische Desktop-Umgebung streikt oder der Netzzugang nicht funktioniert? Wie kommen Sie offline an Hilfe? Diese Frage haben bereits mehrere Entwickler beantwortet, indem sie das gesamte Arch-Wiki offline und trotzdem ständig aktualisiert im Terminal verfügbar machen. Wir schauen uns die dazu nötigen Werkzeuge Arch-Wiki-Man [4] und Arch-Wiki-Lite [5] etwas genauer an.

Node.js oder Python?

Arch-Wiki-Man basiert auf dem Javascript-Framework Node.js, Arch-Wiki-Lite dagegen auf Python. Eventuell fällt schon auf dieser Basis bei Ihnen eine Entscheidung, welches Tool für Sie infrage kommen könnte. Beide greifen allerdings auf die englischsprachige Version des Arch-Wikis zu, die deutsche Instanz steht über keines der beiden Tools zur Verfügung. Sie läuft auf einem anderem System und lässt sich über die gegebene Struktur nicht integrieren.

Wir wenden uns zunächst Arch-Wiki-Man zu, das zwei verschiedene Installationsmethoden bietet. Verwenden Sie Arch Linux oder eines seiner Derivate, sodass Zugriff auf die Kochrezepte des Arch User Repository AUR besteht, installieren Sie das Skript mithilfe eines AUR-Helper wie Yay über den Eintrag arch-wiki-man.

Die zweite Möglichkeit der Installation lässt sich auch mit anderen Distributionen nutzen. Als Voraussetzung benötigen Sie die Pakete nodejs und npm auf dem System. Danach installieren Sie das Tool mit folgendem Kommando:

# npm install -g arch-wiki-man

Beide Installationsvarianten laden das Arch-Wiki lokal herunter, bei Arch-Wiki-Man hat es rund 75 MByte Umfang. Der Entwickler gibt an, das eingebundene Repository alle zwei Tage zu aktualisieren. Um auf dem Laufenden zu bleiben, setzen Sie einfach den Installationsbefehl erneut ab oder verwenden das integrierte Update-Werkzeug awman-update.

Grundbefehl Awman

Die Anwendung von Arch-Wiki-Man gestaltet sich trivial: Der Grundbefehl lautet immer awman, ergänzt durch eine Reihe von Parametern. So liefert etwa die Eingabe von awman installation alle Artikel aus dem Inhaltsverzeichnis des Wiki, die in irgendeiner Form Installationen betreffen (Abbildung 1).

Abbildung 1: Zur Anzeige der gefundenen Wiki-Artikel dient als Grundlage immer der Befehl Awman, den Sie durch Parameter ergänzen.

Hier wählen Sie über die Pfeiltasten den Artikel aus, den Sie lesen möchten, und bestätigen mit der Eingabetaste (Abbildung 2). Sollte der angezeigte Wiki-Artikel nicht Ihren Wünschen entsprechen und auch bei den related articles nichts entsprechendes dabei sein, kehren Sie mit [Q] zum Prompt zurück und präzisieren die Suche. Entspricht keines der Ergebnisse Ihren Erwartungen, führt [Strg]+[C] Sie direkt zurück.

Abbildung 2: Die Darstellung der gewünschten Fundstelle des Arch-Wiki findet im Format der Linux-Manpages statt.

Verfeinern

Um mehr Artikel zu erhalten, lassen sich zur Verfeinerung neben dem Stichwort auch die Beschreibungen der Wiki-Artikel einbeziehen, indem Sie awman -d installation eingeben. Möchten Sie noch tiefer graben, durchsuchen Sie mit awman -k installation den vollständigen Inhalt der Artikel nach dem angegebenen Begriff.

Standardmäßig zeigt Arch-Wiki-Man bis zu sieben Fundstellen an. Eine Zahl am Anfang jeder Zeile zeigt den Rang der Fundstelle und die Gesamtzahl der Treffer. So liefert die im Beispiel genutzte Suche nach dem Stichwort “Installation” ohne Parameter sechs Einträge. Nach Hinzunahme der Beschreibungen stehen schon 65 Artikel zur Wahl, bei der Volltextsuche finden sich sogar 1269 relevante Stellen. Hier müssen Sie entscheiden, über welchen Weg Sie zu den gesuchten Informationen gelangen möchten.

Wollen Sie die Fundstellen statt im Terminal lieber im Webbrowser lesen, tippen Sie awman -w installation (Abbildung 3). Das öffnet die entsprechende Seite im Standard-Browser des Systems, egal, ob dieser textbasiert oder grafisch ist. Hierzu benötigen Sie allerdings eine Anbindung ans Internet. Awman unterstützt neben Englisch rudimentär rund 30 andere Sprachen, die Sie über das Kommando awman --list-languages einsehen.

Abbildung 3: Wollen Sie mit Awman lediglich suchen, die Darstellung aber einem Webbrowser überlassen, erreichen Sie das mit dem Parameter -w.

Arch-Wiki-Lite

Arch-Wiki-Lite lässt sich nicht ganz so vielseitig einsetzen wie Arch-Wiki-Man. Das Programm finden Sie nur unter Arch Linux und seinen Derivaten in den Paketquellen. Die Installation erfolgt über den mit administrativen Rechten ausgeführten Befehl pacman -S arch-wiki-lite. Der Befehl installiert nur 17 MByte Daten – ein Zehntel des Umfangs des Originals, ein Viertel von Arch-Wiki-Man. Um die Darstellung zu verbessern, sollten Sie zusätzlich das Paket dialog einspielen.

Auch Arch-Wiki-Lite sieht seinen Haupteinsatzzweck in der Hilfestellung in Fällen jenseits von Webbrowser und Internet-Zugang. Die Syntax zum Aufruf der einzelnen Seiten ist einfach gehalten. Suchen Sie beispielsweise nach einer Anleitung, um durch Einrichten des Netzwerks mit Systemd den Internet-Zugang wiederherzustellen, geben Sie wiki-search systemd ein. Neben direkten Suchbegriffen unterstützt das Werkzeug auch reguläre Ausdrücke (Regex).

Die Suchergebnisse präsentiert Arch-Wiki-Lite in einer Ncurses-Oberfläche, wobei es die Treffer nach der Häufigkeit des Vorkommens des Suchbegriffs im Artikel sortiert. Im Beispiel aus Abbildung 4 findet sich an dritter Stelle der gesuchte Eintrag Systemd-networkd, den Sie in diesem Fall am sinnvollsten über die Pfeiltasten auswählen. Alternativ wählen Sie den Artikel über den rot markierten Anfangsbuchstaben aus – im Beispiel beginnen allerdings zu viele Einträge mit einem S.

Abbildung 4: Arch-Wiki-Lite geht flott zu Werk und zeigt die Fundstellen per Ncurses an.

Anzeige mit Pager

Ein Klick auf die Eingabetaste führt zur Darstellung der gewünschten Seite mit dem Pager Less. Am unteren Rand lässt sich erkennen, welche Zeilen des Wiki-Artikels gerade sichtbar sind und – je nach Konfiguration der Shell – wie viele Zeilen der Artikel insgesamt umfasst (Abbildung 5).

Abbildung 5: Die gewünschte Fundstelle zeigt Arch-Wiki-Lite über den Pager Less an, sodass Sie auch durch längere Artikel bequem per Tastatur navigieren.

In einem umfangreichen Artikel wie dem aus unserem Beispiel – er umfasst 782 Zeilen – ist es praktisch, wenn man nach Begriffen suchen kann. Das gelingt durch Eingabe des Suchbegriffs, dem Sie einen Schrägstrich voranstellen. So markiert beispielsweise /resolved sämtliche Fundstellen des Begriffs. Mit [N] springen Sie zum nächsten Treffer, mit [Umschalt]+[N] zum Vorherigen.

Aus denselben Gründen wie Arch-Wiki-Man bietet auch Arch-Wiki-Lite das deutschsprachige Wiki nicht an. Arch-Wiki-Lite bindet allerdings weitere Sprachen ein. Der Befehl wiki-search --lang zeigt die verfügbaren Sprachen. Der Grad der Vollständigkeit der Übersetzungen lässt sich an den hier angegebenen Zahlen ablesen. So existieren für Chinesisch 632 Artikel, während Finnisch lediglich 7 Artikel aufzuweisen hat. Um beispielsweise auf italienische Artikel zuzugreifen, setzen Sie vorbereitend den Befehl export wiki_lang="it" ab.

Auch bei Arch-Wiki-Lite ist eine Darstellung im Browser möglich. Dazu nutzen Sie folgendes Kommando:

$ wiki-search-html Suchbegriff

Alle Optionen und Parameter von Arch-Wiki-Lite zeigt der Befehl wiki-search --help an; eine Liste aller verfügbaren Artikel erhalten Sie mit wiki-search --all.

Fazit

Arch-Wiki-Man und Arch-Wiki-Lite weisen einige Gemeinsamkeiten auf. Beide Werkzeuge halten das gesamte Arch-Wiki in allen verfügbaren Sprachen (außer Deutsch) lokal vor und helfen speziell dann weiter, wenn eine Netzanbindung fehlt. Dabei beschränkt sich Arch-Wiki-Lite auf das Arch-Universum, während Arch-Wiki-Man auch auf anderen Distributionen funktioniert.

Mit einem gravierenden Nachteil müssen Sie allerdings bei beiden Tools leben: Wikis zeichnet üblicherweise aus, dass die Artikel miteinander verknüpft sind. Benötigen Sie beispielsweise während der Installation von Arch Hinweise zur Konfiguration von NetworkManager, finden Sie direkt an Ort und Stelle den Link zum entsprechenden Artikel. Diese Verknüpfungen kennen beide Anwendungen nicht: Sie zeigen lediglich den reinen Text an.