2002-02-03
0.08.00

# Manuel du système d'aide de &kde;

## Le système d'aide de &kde;

Le système d'aide de &kde; est utilisé pour faciliter la lecture des outils standards d'aide du système &UNIX; (man et info), et pour afficher la documentation propre à &kde; (&XML;).

Toutes les applications de base de &kde; sont totalement documentées, grâce aux efforts de l'équipe de documentation. Si vous souhaitez apporter votre aide, veuillez écrire à la coordinatrice de la documentation, Lauri Watts, à l'adresse lauri@kde.org pour vous renseigner. Aucune expérience préalable n'est requise, seulement de l'enthousiasme et de la patience.

Si vous voulez aider à traduire la documentation de &kde; dans votre langue natale, le coordinateur des traductions est Thomas Diehl, thd@kde.org, 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, et à la section Contact de ce document.

### Installation

Le &centreAide; 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 &kde-ftp;, ou dans le paquetage kdebase de votre système d'exploitation.

## Invoquer l'aide de KDE

On peut appeler le &centreAide; de plusieurs manières :

À partir du menu Aide

  Le cas le plus fréquent est sans doute de l'appeler de l'intérieur d'une application. Choisissez Aide Contenu pour ouvrir le fichier d'aide de cette application à la page du sommaire.

À partir du menu K

  Cliquez sur le gros K du tableau de bord et choisissez Aide pour ouvrir le &centreAide;, à la page d'accueil.

À partir du tableau de bord

  Par défaut, le tableau de bord &kicker; contient une icône pour appeler le &centreAide;. Encore une fois, c'est la page d'accueil par défaut qui est affichée.

À partir de la ligne de commande

  Le &centreAide; 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 du sommaire.

  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 du &centreAide;

L'interface du &centreAide; consiste en deux zones d'information.

La barre d'outils et les menus sont expliqués plus en détail dans la section .

Les documents contiennent leurs propres outils de navigation, qui vous permettent soit de feuilleter séquentiellement le document en utilisant les liens Suivant, Précédent et Sommaire, soit de manière moins structurée en utilisant les liens hypertexte.

Les liens peuvent vous emmener dans d'autres parties du même document, ou dans un document différent, et vous pouvez utiliser les icônes de barre d'outils Précédent (flèche vers la gauche) ou Suivant (flèche pointant vers la droite) pour parcourir les documents que vous avez affichés lors de cette session.

Les deux zones affichent le sommaire du système d'aide et les fichiers d'aide eux-mêmes, respectivement dans la zone gauche et la zone droite.

### La zone Contenu

La zone Contenu dans le &centreAide; 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 contient un menu affichant les informations d'aide connues du &centreAide;, et le dernier contient le glossairede termes de &kde;.

#### L'onglet Contenu

L'onglet Contenu contient les éléments suivants par défaut :

Introduction

  Bienvenue à &kde; - une introduction à l'environnement de bureau K.

Introduction à &kde;

  Le guide de démarrage de KDE. Contient une visite guidé de l'interface de &kde; ainsi que des aides et astuces particulières sur la manière de mieux travailler avec &kde;.

Manuel d'utilisation de &kde;

  Le manuel d'utilisation de &kde; explore en profondeur &kde;, et en particulier 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 au format &XML;, qui sont converties en HTML au moment de l'affichage. 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 manuel &UNIX; sont le format traditionnel de documentation pour les 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 fichiers.

Affichages des 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.

Tutoriels

  De courts manuels d'apprentissage centrés sur une tâche donnée ou purement informatifs.

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'autres 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 section Man et Info

Les pages de manuel 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 &UNIX;. Quand on vous dit RTFM, le manuel dont il est question est très souvent la page de manuel.

Cependant, les pages de manuel ne sont pas parfaites. Elles tentent d'être complètes, mais sont é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 ligne 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'élément se trouve. Vous verrez que le &centreAide; 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 de manuel. 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 application sont l'une ou l'autre. Si l'application que vous cherchez est un utilitaire &GNU;, vous trouverez vraisemblablement une page info, pas man.

#### Navigation dans les pages Info

Les documents Info sont structurés hiérarchiquement, chaque page s'appelant un noeud. Tous les documents info ont un noeud Topniveau, &pex; la page d'accueil. Vous pouvez retourner à la page Top niveau d'un document info en cliquant surTop.

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 élément 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 équivalent au noeud top niveau, et chaque page de man au niveau au-dessous. Les pages de man s'étalent sur une seule page.

### Le glossaire de &kde;

Le glossaire fournit une fiche de référence rapide où vous pouvez chercher les définitions de mots qui peuvent vous sembler non familières. Sont couverts aussi bien des applications et technologies spécifiques à &kde; que des termes d'informatique sous &UNIX; génériques.

Une vue arborescente se trouve dans la zone de gauche, avec deux options : Alphabétiquement ou Par sujet. Elles contiennent toutes les deux les mêmes termes, classés différemment, pour vous permettre de trouver rapidement le terme qui vous intéresse.

Parcourez la vue arborescente sur la gauche, et les termes que vous sélectionnez seront affichés sur la droite.

### Les menus et la barre d'outils

le &centreAide; a une interface minimaliste vous permettant de vous concentrer sur l'aide plutôt que sur l'apprentissage de l'usage du navigateur d'aide.

Les icônes disponibles dans la barre d'outils sont :

#### Icônes de barre d'outils

Précédent

  Va à la page affichée précédemment.

Suivant

  Va à la page suivante. Cette icône n'est active que si vous avez déjà utilisé l'icône Précédente.

Imprimer

  Imprime le contenu de la page en cours d'affichage.

Chercher

  Cherche un mot ou des mots à l'intérieur de la page en cours d'affichage.

Augmenter la taille des polices

  Augmente la taille du texte dans la zone d'affichage.

Diminuer la taille des polices

  Diminue la taille du texte dans la zone d'affichage. Cette icône ne s'affiche que si vous avez précédemment agrandi le texte.

Les menus contiennent les éléments suivants :

Fichier
  Fichier Imprimer

    Imprime le contenu de la page en cours d'affichage.

  &Ctrl;Q Fichier Quitter

    Ferme et sort du &centreAide;

Édition
  &Ctrl;A Édition Sélectionner tout

    Sélectionne tout le texte de la page courante.

  &Ctrl;F Édition Chercher

    Cherche un mot ou des mots dans la page en cours d'affichage.

Affichage
  Affichage Afficher le code HTML du document

    Affiche la source HTML de la page en cours d'affichage.

  Affichage Définir l'encodage

    Change l'encodage de la page courante. Normalement, le réglage par défaut sur Auto devrait être suffisant, mais si vous avez des problèmes à afficher des pages écrites dans un autre langage que l'anglais, il se peut que vous ayez besoin de choisir un encodage spécifique dans ce menu.

Aller Précédent

  Va à la page affichée précédemment.

Aller Suivant

  Si vous êtes déjà allé à la page précédente en utilisant le bouton Précédent ou l'entrée de menu, vous pouvez retourner à la page suivante avec cette entrée de menu.

Aller ...

  En bas du menu Aller, vous trouverez un historique des quelques dernière pages que vous avez vues. Sélectionnez-en une pour y être directement emmené.

## Remerciements et licence

le &centreAide;

Originellement développé par Matthias Elterme@kde.org

Mainteneur actuel Matthias Hoelzer-Kluepfelmhk@kde.org

&underFDL; &underGPL;