21/10/2000 1.94.00 Le système d'aide de KDE est utilisé pour faciliter, d'une part, la lecture des outils standards d'aide du système UNIX (man et info), et d'autre part, pour visionner la documentation propre à KDE (HTML). Toutes les applications de base sont complètement documentées grâce aux efforts de l'équipe de documentation. Si vous voulez aider, veuillez écrire au coordinateur des documentations Mike McBride à mpmcbride7@yahoo.com pour tout renseignement. Il n'y a besoin d'aucune qualification particulière, seulement de patience et d'enthousiasme. Si vous voulez aider à traduire la documentation de KDE dans votre langue natale, le coordinateur des traductions est Éric Bischoff e.bischoff@noos.fr, qui accueillera bien volontiers de l'aide. Vous trouverez plus d'informations, y compris les coordinateurs pour chaque équipe de traduction, sur le site web consacré à l'internationalisation, à la section Contact de ce document. &khelpcenter; fait partie intégrante de l'installation de base de KDE et est installé avec chaque copie de KDE. On peut le trouver dans le paquetage kdebase, disponible sur le site FTP de KDE ou dans le paquetage kdebase de votre distribution Linux. On peut appeler &khelpcenter; de plusieurs manières : À partir du menu Aide Cas le plus fréquent de l'intérieur d'une application. Choisissez Aide Contenu pour ouvrir le fichier d'aide de cette application à la page du contenu. À partir du menu K Cliquez sur le gros K du tableau de bord et choisissez Aide pour ouvrir &khelpcenter;, à la page d'accueil. À partir du tableau de bord Le tableau de bord Kicker contient par défaut une icône pour appeler &khelpcenter;. Une nouvelle fois, c'est la page d'accueil qui est affichée pour commencer. À partir de la ligne de commande &khelpcenter; peut-être activé en utilisant une URL pour afficher un fichier. Il a aussi été ajouté les URL pour les pages Info et man. Vous pouvez les utiliser comme suit : Un fichier d'aide d'une application khelpcenter help:/kedit Ouvre le fichier d'aide de Kedit à la page de début. Une URL locale khelpcenter file:/usr/local/src/qt/html/index.html Une page de man khelpcenter man:/strcpy Une page info khelpcenter info:/"gcc" Saisir khelpcenter sans paramètre ouvre la page d'accueil par défaut. L'interface de &khelpcenter; consiste en deux zones d'information intégrées dans une fenêtre de &konqueror;. Ceci rend la navigation simple et intuitive, en utilisant les barres d'outils de &konqueror; exactement comme sur un site web. De plus, la plupart des documents comportent leurs propres outils de navigation, ce qui vous permet de vous déplacer séquentiellement dans un document en utilisant les liens Suivant et Précédent ou d'une manière moins structurée en suivant les hyperliens. Les liens peuvent vous emmener dans une autre partie du même document ou vers un autre document, et vous pouvez utiliser les icônes de la barre d'outils Précédent (flèche dirigée vers la gauche) et Suivant (flèche dirigée vers la droite) pour circuler parmi les documents que vous avez lus durant la session présente. Les deux zones affichent le contenu du système d'aide et les fichiers d'aide respectivement dans la zone gauche et la zone droite. La zone Contenu dans &khelpcenter; est affichée dans la partie gauche de la fenêtre. Comme vous vous en doutez, vous pouvez déplacer la séparation pour pouvoir lire plus confortablement le contenu d'une zone ou de l'autre. La zone Contenu est divisée en deux onglets : l'un qui contient un menu montrant toutes les informations dont &khelpcenter; dispose, et l'autre qui vous permet de Chercher une information spécifique. L'onglet Contenu contient les items suivants par défaut : Introduction Bienvenue à KDE. Introduction à KDE Le guide de démarrage de KDE. Contient une visite de l'interface KDE et les aides et astuces spécifiques sur la manière de mieux travailler avec KDE. Manuel d'utilisation de KDE Le manuel d'utilisation de KDE explore en profondeur KDE, y compris l'installation la configuration, la personnalisation et l'utilisation. Manuels d'applications Les documentations des applications natives de KDE. Toutes les applications de KDE ont une documentation en HTML. Cette section fait la liste de toutes les applications de KDE avec une brève description et un lien vers la documentation complète de l'application. Les applications sont affichées en une arborescence qui reflète la structure par défaut du menu K, ce qui rend facile la recherche de l'application dont vous avez besoin. Pages de manuel Unix Les pages de man UNIX sont le format traditionnel de documentation pour les systèmes unix. La plupart des programmes sur votre système ont une page man. De plus, les pages man existent pour les fonctions de programmation et les formats de fichiers. Naviguer dans les pages Info La documentation TeXinfo est utilisée par beaucoup d'applications GNU, y compris gcc (le compilateur C/C++), emacs, et beaucoup d'autres. La FAQ de KDE La Foire Aux Questions de KDE...et leurs réponses. KDE sur le web Des liens vers KDE sur le web, aussi bien le site officiel de KDE que d'autes sites utiles. Informations sur les contacts Des information sur la manière de contacter les développeurs de KDE et comment rejoindre les listes de diffusion de KDE. Participer à KDE Comment aider, et comment être impliqué. La recherche suppose que vous ayez l'application ht://Dig installée. Les information concernant l'installation et la configuration sont disponibles dans ce document. La configuration de l'index de recherche est fournie dans le Centre de configuration de KDE, en choisissant le menu AideIndex, et l'aide détaillée est disponible à partir de ce module. Pour la lecture de ce document, nous supposons que vous avez déjà ce système en état de fonctionnement. La recherche de fichiers d'aide est très intuitive : saisissez le(s) mot(s) que vous voulez trouver dans la zone de saisie, choisissez vos options (le cas échéant) et cliquez sur le bouton Chercher. Le résultat s'affiche dans la zone de visualisation à droite. Les options disponibles sont : Méthode Choisissez comment chercher avec plusieurs mots. Si vous choisissez et, les resultats n'apparaîssent que si tous les mots de votre recherche sont présents dans la page. ou renvoie un résultat si n'importe lequel des termes est trouvé, et booléen vous permet de chercher avec des combinaisonsl. La syntaxe Booléenne vous permet d'utiliser les opérateurs AND, OR et NOT pour faire des recherches complexes Exemples : chat et chien Cherche les pages qui contiennent à la fois les mots chat et chien. Les pages avec un seul des deux mots n'apparaîssent pas. chat not chien Cherche les pages qui contiennent cat, mais n'affichent que celles qui ne contiennent pas le mot dog. chat or (chien not nez) Cherche les pages qui contiennent chat, et les pages qui contiennent chien mais sans contenir nez. Les pages qui contiennent à la fois chat et nez seront affichées, mais pas celles qui contiennent les trois mots. Si vos recherches ne renvoient pas le résultat escompté, vérifiez que vous n'avez pas exclu le mauvais terme avec NOT ou une parenthèse mal placée. Nombre maximum de résultats Détermine le nombre maximum de résultats qu'affichera la recherche. Format Décide si vous voulez simplement un court lien vers la page qui contient votre terme recherché ou si vous voulez un sommaire plus long. Trier Trie les résultats de la recherche dans l'ordre Score (correspondance entre ce qui est cherché et ce qui est trouvé), alphabétiquement par Titre ou par Date. En cochant la case Ordre inverse les résultats de la recherche sont inversés. Actualiser l'index Met à jour l'index de recherche, pour incorporer de nouveaux documents ou si vous pensez que la base de données est incomplète ou endommagée. Ceci peut prendre du temps. Les pages man sont les pages de manuel standard d'unix, et sont utilisées depuis des années sur beaucoup de systèmes d'exploitation. Elles sont très détaillées et sont le meilleur endroit pour obtenir de l'information sur la plupart des commandes et applications Linux . Quand on vous dit RTFM, le manuel dont il est question est très souvent la page de man. Cependant, les pages man ne sont pas parfaites. Elles tentent d'être complète, mais également très techniques, souvent écrites par des développeurs et pour des développeurs. Dans certains cas, ceci les rend quelque peu inamicales, voire totalement incompréhensibles pour beaucoup d'utilisateurs. Elles sont malgré tout la meilleure source d'information solide sur la plupart des applications en lignes de commande, et très souvent la seule source. Si vous vous êtes jamais demandé ce que le chiffre veut dire dans man(1), cela signifie dans quelle section du manuel l'item se trouve. Vous verrez que &khelpcenter; utilise les chiffres pour diviser la plupart des pages de man dans leur propres sections, vous rendant plus facile la recherche de l'information que vous recherchez si vous naviguez simplement. Également disponibles, les pages Info, qui tentent de remplacer les pages man. Les responsables de certaines pages man ne les maintiennent plus. Ainsi, s'il existe à la fois une page man et une page info, il est vraisemblable que la page info est plus récente. La plupart des applications ont l'une ou l'autre. Si l'applications que vous cherchez est un utilitaire GNU, vous trouverez vraisemblablement une page info, pas man. Les documents Info sont structurés hiérarchiquement, chaque page s'appelant un noeud. Tous les documents info ont un noeud Top niveau, par exemple la page d'accueil. Vous pouvez retourner à la page Top niveau d'un document info en cliquant sur Top. On utilise Précédent et Suivant pour se déplacer vers les pages précédentes et suivantes par rapport au niveau de la hiérarchie où vous vous situez. Cliquer sur un item de menu à l'intérieur d'un document vous déplace vers un niveau inférieur dans la hiérarchie. Vous pouvez remonter dans la hiérarchie en cliquant sur Dossier parent. Man est traité de la même manière qu'info, avec l'index de section équivalant au noeud top niveau, et chaque page de man au niveau au dessous. Les pages de man s'étalent sur une seule page. &khelpcenter; Originellement développé par Matthias Elter me@kde.org Maintaineur actuel Matthias Hoelzer-Kluepfel mhk@kde.org Traduction française Gérard DELAFOND g.delafond@medsyn.fr &underFDL; &underGPL;