# Le ¢reAide;

## 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 êtes intéressés pour aider à la documentation, rejoignez la liste de discussion et écrivez à l'équipe à l'adresse kde-doc-english@kde.org. 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, vous trouverez plus d'informations, y compris les coordinateurs pour chaque équipe de traduction, sur le site web consacré à la localisation.

#### Installation

Le ¢reAide; 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 paquet kdebase-runtime disponible sur le &kde-ftp;, ou dans le paquet kdebase-runtime de votre système d'exploitation.

### Invoquer l'aide

On peut appeler le ¢reAide; 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 F1 Aide Manuel de `application` pour ouvrir le fichier d'aide de cette application à la page du sommaire.

Depuis le lanceur d'applications de Kickoff

- Cliquez sur le gros K du tableau de bord et choisissez l'onglet Applications puis choisissez Aide pour ouvrir le ¢reAide;, à la page d'accueil.

À partir de la ligne de commande

- Le ¢reAide; 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:/`kwrite``

  Ouvre le fichier d'aide de &kwrite; à 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 ¢reAide;

L'interface du ¢reAide; consiste en deux zones d'information.

La barre d'outils et les menus sont expliqués plus en détail dans la section menu-and-toolbar-ref.

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.

#### Le panneau « Contenu »

Le panneau « Contenu » dans le ¢reAide; 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.

Le panneau du contenu est divisée en deux onglets : l'un contient un vue arborescente affichant les informations d'aide connues du ¢reAide;, et le dernier contient le glossaire de termes de &kde;.

##### L'onglet « Contenu »

L'onglet Contenu contient les éléments de plus haut niveau dans la vue arborescente :

Fondamentaux de &kde;

- Les fondamentaux vous initieront à plusieurs fonctionnalités de la collection d'applications &kde; et décriront plusieurs tâches usuelles que vous pouvez réaliser dans toutes les applications &kde;.

Manuel de Plasma

- Le manuel de &plasma; est la documentation du pilier le plus visible de &kde;, l'interface qui est au cœur du bureau.

Aide en ligne

- Une page avec des liens vers l'aide en ligne et des informations supplémentaires fournies par la communauté &kde;.

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.

Modules du Centre de Configuration

- Fournit une liste de liens vers les divers modules qui se situent dans l'application de &configurationDuSysteme; de &kde;.

Modules du centre d'informations

- Contient une liste de liens vers les documentations des divers modules de KInfocenter.

Modules d'entrées / sorties

- Contient une liste de liens vers les documentations des divers modules KIO.

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.

Scrollkeeper

- Documentations non-&kde; installées sur votre système.

Navigation dans les pages d'information

- La documentation TeXinfo est utilisée par beaucoup d'applications &GNU;, y compris `gcc` (le compilateur C/C++), `emacs`, et beaucoup d'autres.

#### Les sections 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 ¢reAide; 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.

Les pages info sont également disponibles, dont l'objectif est de remplacer les pages man. Le mainteneur de plusieurs applications ne met plus à jour les pages man, donc si les pages man et info sont toutes les deux disponibles, la page info est probablement la plus récente. La plupart des applications en ont une ou plusieurs cependant. Si l'application dont vous consultez l'aide est un utilitaire &GNU;, vous trouverez probablement une page info, pas une page 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 nœud Top niveau, &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 nœud 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 ¢reAide; 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

Table des matières

- Permet d'aller à la page d'accueil principale du ¢reAide;

Précédent

- Permet d'aller à la page précédemment affichée. Cliquez sur l'encoche à droite de l'icône. Ceci affiche une liste des pages précédemment consultées. Choisissez-en une pour revenir directement à cette page.

Suivant

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

Copier

- Copie le texte dans le presse-papiers pour ensuite le coller dans une autre application.

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.

Réduire 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

- &Ctrl;P Fichier Imprimer

- Imprime le contenu de la page actuellement visible. Les manuels au format PDF se trouvent sur le serveur de documentation de &kde;.

&Ctrl;Q Fichier Quitter

- Ferme et sort du ¢reAide;

Modifier

- &Ctrl;C Modifier Copier

- Copie le texte sélectionné dans le presse-papiers.

&Ctrl;A Modifier Tout sélectionner

- Sélectionne tout le texte de la page courante.

&Ctrl;F Modifier Chercher…

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

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

- &Alt;Début Aller Table des matières

- Permet d'aller à la page d'accueil principale du ¢reAide;

&Ctrl;Page préc Aller Page précédente

- Permet d'aller à la page précédente de la documentation actuelle.

&Ctrl;Page suiv Aller Page suivante

- Permet d'aller à la page suivante de la documentation en cours.

&Alt;Gauche Aller Précédent

- Permet d'aller à la page affichée précédemment.

&Alt;Droite 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.

Configuration

- Configuration Configurer les polices...

- Vous permet de configurer les tailles et familles de polices utilisées par le ¢reAide;.

De plus, &khelpcenter; possède des éléments communs de menu KDE Configuration et Aide. Pour plus d'informations, veuillez consulter les sections Menu de configuration et Menu d'aide des fondamentaux de &kde;.

### Remerciements et licence

&khelpcenter;

Originellement développé par &Matthias.Elter; &Matthias.Elter.mail;

Le mainteneur actuel est &Cornelius.Schumacher; &Cornelius.Schumacher.mail;

Traduction française par &EquipeKDE;.

&underFDL; &underGPL;