Suche online - offline
Online-Suche
Die Online-Suche von aptosid verwendet die mächtige Indizierung von xapian-omega. Diese steht nur online zur Verfügung unter Nutzung des internetbasierten aptosid-Handbuchs.
Option 1
Nach Eingabe eines oder mehrerer Begriffe klickt man auf Suche oder drückt die Eingabetaste "Enter".
Suchoptionen
Nach ALLEN Wörtern suchen ist die Standardoption. Man erhält eine Liste von Handbuchdateien, welche alle gesuchten Begriffe enthalten. Nach IRGENDEINEM Wort suchen gibt eine Liste von Handbuchdateien aus, die zumindest einen der Suchbegriffe enthalten.
Komplexe Suche:
Ein Pluszeichen (+) direkt vor einem oder mehreren Begriffen sucht nach Handbuchdateien, welche alle diese Wörter enthalten. Ein Minuszeichen (-) direkt vor einem oder mehreren Begriffen sucht nach Handbuchdateien, welche alle diese Wörter nicht enthalten.
Die Resultate sind nach Relevanz sortiert (höchste Relevanz zuerst). Relevanzkriterien sind Anzahl und Positionierung der Suchbegriffe in der Handbuchdatei.
Option 2
Für die Online-Suche im deutschen Handbuch gibt man in die Suchleise des Browsers folgenden Suchbefehl ein (xxxx ist Platzhalter für den Suchbegriff):
xxxxx site:manual.aptosid.com/de
Offline-Suche
In Zusammenarbeit mit dem Entwickler von Recoll ist für das aptosid-Handbuch eine spezielle Konfiguration als Teil des Standard-Pakets entwickelt worden. Diese basiert auf dem Xapian-Backend, um ein umfangreiches wie auch benutzerfreundliches Frontend mit einer auf QT aufgesetzten grafischen Benutzerführung bieten zu können. Ein ganz besonderer Dank geht an Recoll.
Recoll findet man als "Recoll - Local Text Search" im Unterpunkt "Dienstprogramme" des KDE-Menüs.
Schritt 1
Das Handbuch ist derzeit via apt für folgende Sprachen installierbar:
Deutsch (German, -de)
Englisch (English, -en)
*Čeština (Tschechisch, -cz)
*Dansk (Dänisch, -da)
*Español (Spanisch, -es)
*Français (Französisch, -fr)
*Italiano (Italienisch, -it)
*Nihongo (Japanisch, -ja)
*Nederlands (Holländisch, -nl)
*Polski (Polnisch, -pl)
*Português (Portugiesisch, pt-br)
*Română (Rumänisch, -ro)
*Русский (Russisch, -ru)
*Українська (Ukrainisch, -uk)
apt-get update apt-get install aptosid-manual-xx (-xx ist Platzhalter für die gewünschte Sprache. For example: aptosid-manual-en, aptosid-manual-de, aptosid-manual-es, ....)
Schritt 2
apt-get install recoll
Schritt 3
- Recoll fragt beim ersten Start, ob eine Datenbank eingerichtet werden soll, was man ablehnt, indem man auf cancel klickt, worauf ein Dialogfenster zur Index-Erstellung geöffnet wird.
- Im Reiter "Globale Parameter" klickt man unterhalb von "Start-Verzeichnisse" auf das Plus-Zeichen + und geht nach /usr/share/aptosid-manual. Dort wählt man die bevorzugte Sprache und klickt auf "ok". Als nächstes markiert man alle anderen Verzeichnisse inklusive die Tilde ~ und klickt auf das Minuszeichen -, um sie zu löschen.
Als "Wortstammerweiterungssprache" fügt man "German" hinzu.
Man schließt das Unterfenster mit einem Klick auf "OK" rechts unten. - Abschließend erstellt man den Index, indem man im Hauptfenster von Recoll Datei>Indizieren wählt. Nun können Begriffe im aptosid-Handbuch gesucht werden.
Das Neuindizieren von Recoll nach einem Update des Handbuchs via apt erfolgt als user $ in der Konsole
recollindex -z
und nach einem Neustart von Recoll durch den GUI-Befehl Datei>Indizieren.
Der Link 'Preview' öffnet ein neues Fenster, in dem alle Fundstellen des Suchbegriffs innerhalb einer Datei markiert sind.
Der Link 'Open' hingegen öffnet Konqueror. In Konqueror verwendet man den Suchen-Dialog, um gewünschte Begriffe zu finden.