Le système d'aide de KDE
Le système d'aide de KDE a été conçu pour permettre d'accéder
simplement aux systèmes d'aide d'Unix (man et info), ainsi que pour permettre
d'accéder à l'aide de KDE proprement dite (au format HTML).
Lancer l'aide de KDE
Le système d'aide de KDE peut être démarré en utilisant une URL pour
désigner un fichier à afficher, par exemple :
kdehelp file:/usr/local/src/qt/html/index.html
De nouveaux types d'URLs ont été ajoutés pour les systèmes info et
man, par exemple :
kdehelp info:"(gcc)G++ and GCC"
kdehelp man:strcpy
Si aucun paramètre n'est fourni sur la ligne de commande, un index est affiché
(pour le moment il comprend uniquement des liens vers les répertoires des systèmes
info et man, mais il pourrait afficher des liens vers l'aide des applications de KDE
dans le futur).
Par ailleurs, un fichier ou une URL peuvent être ouvertes en utilisant les menus
ou par glisser-déposer depuis le gestionnaire de fichiers de KDE, kfm.
Naviguer dans l'aide
On peut naviguer dans le système d'aide grâce aux liens à l'intérieur des
documents, en utilisant les options du menu Aller à, ainsi que grâce aux boutons
de la barre d'outils.
Contenu
Si le système d'aide est démarrer sans spécifier d'emplacement de
départ sur la ligne de commande, le sommaire est affiché. Sa première
section comprend des informations générales sur le projet KDE. La deuxième
section traite de la documentation d'applications et de commandes spécifiques.
La section concernant la documentation d'applications et de commandes système comprend
trois parties :
- Liste des applications de KDE
- La documentation des applications KDE proprement dites. Toutes les applications
KDE ont une aide au format HTML. Cette section liste toutes les applications KDE avec
une breève description et un lien vers la documentation de l'application proprement dite.
- Manuel du système Unix
- Les pages de manuel Unix (man pages) forment le système de documentation en ligne
traditionnel des systèmes Unix. La plupart des programmes sur votre système
ont une page de manuel. De plus, des pages de manuel existent pour les fonctions
de programmation et les formats de fichier.
- Pages d'information du projet GNU
- Beaucoup d'applications GNU ont une documentation au format TeXinfo, y compris gcc
(le compilateur C/C++), emacs, et bien d'autres.
À tout moment vous pouvez revenir au Sommaire en en choisissant Contenu dans le
menu Aller à ou en utilisant la barre d'outils.
Document précédent et Document suivant
Ce sont les commandes liées à l'historique des pages visitées.
Document précédent vous amène sur la page visitée en
dernier, alors que Document suivant vous amène à la page suivante à
avoir été visitée. L'historique permet pour le moment de retenir 50 pages,
mais cela devrait pouvoir être modifié par réglage dans les prochaines
versions.
Noeud précédent, Noeud suivant, Remonter d'un noeud, Premier noeud
Vous reconnaîtrez ces commandes si vous avez déjà utilisé le
système info auparavant.
Les documents info sont arrangés hiérarchiquement, chaque page étant
appelée un "noeud". Tous les documents info ont un Premier noeud, la page de
démarrage. Vous pouvez revenir au premier noeud d'un document info en appuyant sur
"Premier noeud".
Noeud précédent et Noeud suivant sont utilisés pour se
déplacer vers les pages précédente et suivante au niveau courant de la
hiérarchie.
En cliquant sur un élément de menu au sein d'un document, vous descendez d'un
niveau dans la hiérarchie. Vous pouvez remonter d'un niveau dans la hiérarchie en
cliquant sur Remonter d'un noeud.
Le système man est traité de manière similaire au système info,
l'index de section correspondant au premier noeud, et chaque page de manuel étant au
niveau en-dessous.
Recherche
Vous pouvez chercher une chaîne de caractères dans la documentation en
sélectionnant Rechercher dans le menu Fichier.
La page de recherche apparaît alors et vous demande le texte à rechercher.
Vous pouvez alors choisir de chercher dans l'un des trois systèmes d'aide :
KDE, man, ou info.
En cliquant sur Lancer la recherche on affiche la liste des termes trouvés dans chaque
catégorie sélectionnée.
Les occurences KDE sont listées de la meilleure correspondance à la plus mauvaise.
Les pages de manuel sont listées comme la commande apropos
les renvoie.
La recherche dans les documents info n'a pas encore été implémentée.