Bernd
Pol

# Configurer &kdevelop;

&kdevelop; est un EDI très puissant et très souple, qui offre de nombreuses façons de l'adapter à vos besoins. Pour démarrer la configuration, cliquez sur Configuration Configurer KDevelop.... S'ouvre alors la boîte de dialogue de configuration composée d'une fenêtre de sélection dans la partie gauche et de la boîte de dialogue de configuration dans la partie droite, dont le contenu varie en fonction de l'élément de configuration que vous avez choisi.

Sélectionnez un élément de configuration

Sélectionnez un élément de configuration

Nous aborderons ces configurations dans un ordre différent, en les divisant en thèmes principaux : Configuration générale, Configuration de la documentation et Configuration avancée, ce qui contribue à une lecture plus intuitive.

Si vous souhaitez consulter un certain élément de configuration directement, utilisez l'un des liens suivants.

- Général
- Interface utilisateur
- Modèles de fichier
- Éditeur
- Abréviations
- Scriptage
- Menu des outils
- Outils externes
- Documentation
- Fragments de code
- Liste des fichiers
- Sélecteur de fichiers
- Générateur de classes C++
- Formatage
- Analyse de la syntaxe C++

## Configuration générale

La configuration générale concerne les tâches les plus courantes pour ajuster &kdevelop;, puisqu'il s'agit des aspects suivants :

- Configuration générale

- Sélectionner l'interface utilisateur

- ### Tâches d'édition des sources

  - Sélectionner un éditeur

  - Sélectionner un style de format source

  - Configurer l'outil « Fragments de code »

- Configurer le sélecteur de fichiers

### Configuration générale

La boîte de dialogue de configuration Général permet de définir un comportement de base de &kdevelop;, qui changera rarement dans le travail quotidien. Celle-ci porte sur :

Les options générales du projet comme

  - définir un dossier parent par défaut que &kdevelop; devra utiliser pour les nouveaux projets.

  - décider si vous souhaitez que &kdevelop; charge automatiquement le projet sur lequel vous avez travaillé en dernier lieu.

La sélection d'une police pour les fenêtres de sortie les plus couramment utilisées, à savoir :

  - l'affichage des messages de sortie que &kdevelop; utilise pour communiquer &pex; l'avancement de la compilation, et

  - la fenêtre de sortie de l'application qui indiquera des informations d'erreur et d'état concernant une application en cours d'exécution.

Un comportement courant portant sur les lignes affichées dans la fenêtre Affichage des messages de sortie, à savoir :

  - si les longues lignes seront coupées automatiquement et

  - si les messages d'entrée et de sortie du dossier émis par `make` seront affichés.

  Le niveau de détail des messages concernant le processus de compilation affiché dans la fenêtre des messages de sortie.

La boîte de dialogue de configuration générale

Ouvrir le dernier projet au démarrage

  Cochez cette case si vous souhaitez continuer à travailler avec le dernier projet sur lequel vous avez travaillé. Cette action amènera &kdevelop; à charger automatiquement ce projet au démarrage. Il sera habituellement affiché dans l'état où vous l'avez laissé, de sorte que vous pouvez continuer sans problème.

Dossier par défaut des projets

  Par défaut, &kdevelop; utilise un dossier parent commun pour tous les nouveaux projets. Saisissez le chemin absolu de ce dossier commun dans le champ prévu ou sélectionnez-le dans votre structure de dossier. &kdevelop; y placera tout nouveau projet en tant que sous-dossier.

  Vous pouvez bien sûr changer le chemin du dossier d'un nouveau projet au moment où vous le configurez dans l'&appwizard;.

Police de caractères

  La fenêtre Vue de la sortie de l'application est utilisée pour afficher des informations d'erreur et d'état provenant des applications exécutées depuis &kdevelop;. Ce sont des informations que les applications envoient habituellement à la console lorsque exécutée en mode autonome. Vous n'avez donc pas à quitter l'EDI lorsque vous testez l'application sur laquelle vous travaillez actuellement.

  Pour sélectionner une police appropriée pour la fenêtre Affichage des messages de sortie, cliquez sur le bouton Police de caractères affichant la police actuellement sélectionnée (« Luxi Sans » dans l'illustration ci-dessus). La boîte de dialogue standard de &kde;Choisir une police apparaît, dans laquelle vous pouvez sélectionner la police à utiliser.

  Au premier lancement, &kdevelop; initialise ce paramètre de police à la police standard pour laquelle votre utilisateur &kde; a été configuré. Comme ce réglage est fixe, si vous modifiez Préférences Apparence et thèmes Polices dans le Centre de configuration, il n'affecte pas cette sélection de police de &kdevelop;. Vous devrez sélectionner à nouveau explicitement la police de la fenêtre Vue des messages de sortie.

Sortie du compilateur

  &kdevelop; prétraite les messages que reçoit la fenêtre Affichage des messages de sortie pendant les processus de construction, afin de filtrer les informations superflues. Vous pouvez contrôler le niveau de détail que &kdevelop; affichera à l'aide des boutons radio dans ce champ.

  Très courte

    N'affiche que les avertissements, erreurs et noms de fichiers qui sont compilés.

  Courte

    Supprime tous les drapeaux du compilateur et formate la sortie pour une meilleure lisibilité.

  Complète

    Affiche tous les messages de sortie sans modification.

  Il y a une autre manière de changer le niveau de détail de la sortie du compilateur. Cliquez simplement avec le &BDS; dans la fenêtre Affichage des messages de sortie et sélectionnez le niveau de détail souhaité dans le menu qui apparaît.

Coupure des lignes

  Par défaut, &kdevelop; coupe les longues lignes dans la fenêtre Vue des messages de sortie pour que des informations utiles ne passent pas facilement inaperçues. Dans certains cas, ce réglage ne fera qu'encombrer de longues listes de messages. Décochez la case si vous ne souhaitez pas de coupures de lignes.

  Il y a une autre manière d'activer la coupure des lignes. Cliquez simplement avec le &BDS; dans la fenêtre Affichage des messages de sortie, cochez ou décochez l'élément Coupure des lignes dans le menu qui apparaît.

Messages de navigation dans les dossiers

  L'outil `Make` affiche habituellement des messages comme « Ouverture du dossier » ou « Fermeture du dossier » lorsqu'il navigue dans les dossiers dans lesquels il s'exécute actuellement. Comme ces lignes encombrent la liste de messages dans la fenêtre Affichage des messages de sortie, &kdevelop; supprime ces messages par défaut. Cochez la case si vous souhaitez consigner les dossiers dans lesquels `make` s'est exécuté.

  Les changements de ce réglage affectent uniquement le traitement des nouveaux messages. Les messages correspondant à la navigation dans les anciens dossiers restent visibles lorsque vous désactivez cette fonctionnalité.

Intégration du concepteur d'interfaces graphiques

  Cette fonction vous permet de choisir la manière dont vous souhaitez que les fichiers `.ui` soient affichés dans &kdevelop;. &kdevelop; est livré avec son propre concepteur d'interfaces utilisateur appelé KDeveDesigner, qui peut soit être imbriqué soit lancé en tant que programme séparé. Qt Designer peut également être utilisé pour modifier des fichiers `.ui`.

  - Utiliser le concepteur imbriqué de &kdevelop;

    This uses &kdevelop; own designer embedded within &kdevelop;

  - Exécuter le concepteur de &kdevelop; en tant qu'application séparée

    L'application KDevDesigner sera exécutée séparément dans sa propre fenêtre.

    KDevDesigner dans sa propre fenêtre

  - Lancer Qt Designer

    Qt Designer depuis votre installation Qt sera démarré de façon externe à chaque fois que vous cliquez sur un fichier `.ui` dans &kdevelop;.

Émulation de terminal

  Choisissez ici le terminal que vous voulez voir intégré dans KDevelop.

  - Utiliser le réglage de &kde;

    Ce comportement utilise le réglage de &kde; comme défini dans &kcontrol; dans l'onglet Composants de &kde; Sélecteur de composants qui définit l'émulateur par défaut utilisé par toutes les applications &kde; qui nécessitent un terminal.

  - Autre

    Choisissez un autre terminal différent de celui configuré par défaut.

### Sélectionner l'interface utilisateur

Comme déjà indiqué dans le chapitre Modes d'interface utilisateur disponibles, il y a quatre manières différentes de configurer la zone de travail de &kdevelop;, à savoir :

- Mode fenêtre IDEAl simplifié

  IDEAl

- Mode fenêtre IDEAl

  Il s'agit d'un clone de l'interface utilisateur IDEA, similaire au mode fenêtre d'onglets, et c'est le mode par défaut.

- Mode fenêtre enfant

  Toutes les vues des outils sont initialement intégrées à la fenêtre principale. Les vues de l'éditeur et du navigateur résideront comme les fenêtres de premier niveau dans une zone d'affichage de la fenêtre principale. Un exemple typique de ce mode d'interface utilisateur est MS Visual Studio 6.0.

- Mode fenêtre d'onglets

  Toutes les vues des outils sont initialement intégrées à la fenêtre principale. Les vues de l'éditeur et du navigateur seront superposées dans une fenêtre à onglets. Un exemple typique de ce mode d'interface utilisateur est KDEStudio, notre EDI C++-ami dans le monde de KDE.

- Mode fenêtre au premier niveau

  Toutes les vues des outils, de l'éditeur et du navigateur seront des fenêtres de premier niveau (directement sur le bureau). L'élément graphique (widget) principal contient le menu, les barres d'outils et la barre d'état uniquement. Un exemple typique de ce mode d'interface utilisateur est Borland Delphi 6.0.

Pour changer de mode d'interface utilisateur, sélectionnez Configuration Configurer &kdevelop;... dans les menus. La boîte de dialogue Configurer KDevelop apparaît, dans laquelle vous devrez sélectionner Interface utilisateur dans l'arborescence de la partie gauche. S'affichera alors la boîte de dialogue des réglages suivants dans la partie droite.

Sélectionner un mode d'interface utilisateur

Sélectionner un mode d'interface utilisateur

Clquez sur le bouton radio du mode d'interface utilisateur vers lequel vous souhaitez basculer, puis sur OK.

N'oubliez pas de redémarrer &kdevelop; afin que l'un quelconque de ces choix prenne effet.

Lorsque vous avez sélectionné soit le mode fenêtre IDEAl simplifié soit le mode fenêtre IDEAl, deux ou plusieurs sections de configuration deviennent disponibles : Utiliser des onglets et Utiliser la fermeture sur l'onglet au survol. Celles-ci permettent de décider dans quelles circonstances les onglets seront affichés en haut des fenêtres du document et si vous pouvez fermer le document par un clic sur l'icône de l'onglet.

En mode fenêtre IDEAl simplifié et en mode fenêtre IDEAl, une seule autre section de configuration sera disponible, Disposition de l'onglet de la vue des outils, qui permet effectivement de choisir entre différentes tailles des onglets de la vue des outils qui entourent la zone de travail principale dans ce mode.

Configuration de l'affichage de la barre d'onglets des documents

  Comme dans les modes IDEAl et fenêtre d'onglets, il y aura des onglets nommés au début des fenêtres du document par défaut, vous pouvez facilement sélectionner différents documents d'un clic avec le &BGS;. Si vous préférez prévoir plus d'espace pour les fenêtres de document dans la zone de travail principale de &kdevelop;, vous pouvez changer ce comportement dans la section de configuration Utiliser des onglets.

  Toujours

    C'est le comportement par défaut — affiche un onglet comprenant une icône et le nom du document en haut de toute fenêtre de document dans l'affichage de la fenêtre principale de &kdevelop;.

  Lorsque plus d'un onglet

    Ne fait pas apparaître d'onglet quand un seul document est affiché. S'il y a plus d'un document, cependant, &kdevelop; affichera une barre d'onglets en conséquence dans comme dans la sélection Toujours ci-dessus. Vous pouvez être amené à sélectionner ce mode si vous travaillez sur un seul document la plupart du temps car il offre plus d'espace vertical.

  Jamais

    N'affiche jamais d'onglet de sélection de document. Il se peut que vous préfériez ce mode si vous employez rarement la souris pour passer d'un document à l'autre. Il offre plus d'espace vertical pour toutes les fenêtres de document. Pour sélectionner une autre fenêtre de document ou en fermer une quelconque, faites appel au menu Fenêtre de &kdevelop;.

Configuration de la fermeture d'un document par un clic sur son onglet

  Lorsque vous avez configuré &kdevelop; pour afficher la barre d'onglets des documents, soit toujours, soit quand plus d'un document est affiché dans la zone de travail principale, vous pouvez ajouter plus de fonctionnalité aux onglets en plus de leur capacité de sélection de document. Faites appel à la section de configuration Utiliser la fermeture sur l'onglet au survol pour ce faire.

  Non

    C'est le comportement par défaut. Aucune fonctionnalité supplémentaire n'est ajoutée aux onglets. Ils ne peuvent être employés que pour sélectionner des fenêtres de document lors de clics avec le &BGS;.

  Oui

    Quand vous avez cliqué sur ce bouton radio, &kdevelop; permet de fermer une fenêtre de document d'un clic avec le &BGS;. Utilisez la souris pour pointer sur la petite icône située sur le bord gauche de l'onglet. Elle se transforme en un symbole de fermeture. Cliquez maintenant avec le &BGS; sur ce symbole modifié. &kdevelop; ferme la fenêtre de document correspondante.

  Oui, mais non immédiat

    Après avoir cliqué sur ce bouton radio, &kdevelop; permet de fermer une fenêtre de document comme décrit dans le cas Oui ci-dessus. L'icône ne changera pas instantanément, cependant, mais il y aura un bref délai avant que l'icône de fermeture n'apparaisse.

Configuration de la disposition de la barre d'onglets

  La section de configuration Disposition de la barre d'onglets n'est disponible qu'en mode IDEAl. Utilisez ces boutons radio pour configurer l'aspect des barres d'onglets qui entourent la zone de travail principale dans ce mode.

  Icônes

    Chaque onglet présente une icône uniquement. Si la vue des outils associée est affichée, l'onglet s'ouvre et un texte descriptif de cette vue des outils apparaît. Vous pouvez être amené à utiliser ce mode si vous travaillez sur un moniteur doté d'une définition limitée.

    Les icônes ne sont pas très descriptives néanmoins. Si vous souhaitez découvrir quelle vue des outils est affectée à un onglet donné, pointez dessus avec la souris et attendez une seconde. Une petite bulle d'aide apparaît avec le nom de la vue des outils.

  Texte

    C'est le mode d'affichage par défaut de la barre d'onglets. Chaque onglet affiche le nom de sa vue d'outils associée.

  Texte et icônes

    Si l'affichage des barres d'onglets standard « Texte » vous semble trop plat et que vous travaillez sur un moniteur à haute définition, vous pouvez être amené à cliquer sur ce bouton radio. Vous obtiendrez alors l'affichage du nom de la vue des outils associée, plus une icône sur la gauche de cette dernière qui permet de distinguer plus facilement les onglets. L'illustration Onglets pliés de la vue des outils ci-dessous en montre un exemple.

Onglets pliés de la vue des outils

  Si vous avez choisi que les onglets des vues des outils du mode IDEAl affichent du texte (avec ou sans icônes d'accompagnement), ne vous préoccupez pas du fait qu'ils soient cachés derrière une fenêtre de vue des outils. Si une des fenêtres inférieures des vues des outils occupe plus d'espace que disponible pour afficher tous les onglets (verticaux), ceux-ci se replient comme le montre cette illustration :

  Les onglets des vues des outils se plient pour ne pas être cachés derrière une autre fenêtre de vue

  Les onglets des vues des outils se plient pour ne pas être cachés derrière une autre fenêtre de vue

  La fenêtre des vues des outils active doit être affichée de façon fixe (non en mode superposé), partageant la zone de travail avec les autres fenêtres, pour imposer ce type de pliage d'onglets. Cliquez sur le petit carré situé sur le bord de la fenêtre pour l'obtenir, comme illustré dans l'exemple.

### Modèles de fichiers

Configurer les modèles de fichiers

Configurer les modèles de fichiers

### Sélectionner un éditeur

&kdevelop; vous permet de choisir votre outil d'édition de texte favori. Cochez l'élément Éditeur dans l'arborescence de sélection, sur la partie gauche de la fenêtre Configurer KDevelop. La boîte de dialogue suivante s'affichera sur la partie droite.

Sélectionner un éditeur

Sélectionner un éditeur

Pour sélectionner un nouvel éditeur, cliquez sur la flèche située dans le champ de la liste déroulante. En fonction des interfaces de composants d'édition que votre version de &kde; a compilées, vous voyez apparaître une liste d'éditeurs dans laquelle vous pouvez faire votre choix (voir la note Important ci-dessous à ce sujet). Cliquez sur l'éditeur qui vous convient et confirmez par OK. Il y a actuellement trois possibilités :

Éditeur de texte avancé intégré

  C'est le composant d'édition Kate standard de &kde;.

Éditeur de texte basé sur Qt Designer

  C'est l'éditeur que fournit &Qt; dans son composant Designer.

Ces interfaces d'éditeur sont entièrement intégrées dans le concept d'EDI &kdevelop;. En particulier, la possibilité de sauter à la ligne de code source incriminée en cliquant simplement sur un message d'erreur dans la fenêtre Affichage des messages de sortie a été prévue.

Changer d'éditeur n'aura aucun effet sur les fichiers déjà ouverts. Il y a deux possibilités pour continuer : soit fermer toutes les fenêtres de texte ouvertes et les rouvrir une par une, soit simplement fermer le projet entier et le rouvrir. Les fenêtres s'ouvriront alors automatiquement sous la nouvelle interface d'éditeur de texte.

KDevelop vous permet d'employer les interfaces d'éditeur qui ont été déclarées avec &kde; et qui fournissent une interface KatePart. S'il vous manque une des sélections mentionnées ci-dessus, vérifiez dans votre installation &kde; si le composant KPart correspondant a été correctement installé.

Que faire si le fichier a été modifié par un programme externe :

Ne rien faire

  Le fichier sera marqué comme modifié par un programme externe et l'utilisateur sera invité à vérifier toute tentative d'écrasement de ce fichier.

Alerter l'utilisateur

  Une boîte de dialogue avertira l'utilisateur qu'un fichier a été modifié et invitera l'utilisateur à recharger le fichier.

Recharger automatiquement le fichier s'il n'y a aucun danger, et alerter l'utilisateur sinon

  Tout fichier qui n'a pas été modifié en mémoire est rechargé et une alerte affichée pour tout conflit.

### Abréviations pour le complétement des mots

(... à écrire ...)

### Scriptage

(... à écrire ...)

### Ajout d'applicatons &kde; standard au menu Outils

(... à écrire ...)

### Ajout d'applications externes aux menus

(... à écrire ...)

#### Ajout aux menu Outils

(... à écrire ...)

#### Ajout au menu contextuel Fichier

(... à écrire ...)

#### Ajout au menu contextuel Dossier

(... à écrire ...)

### Sélection d'un style de format source

&kdevelop; formate automatiquement un texte source dans un style prédéfini. Ce style est extrêmement configurable.

La fonctionnalité de reformatage du code source est actuellement disponible pour C, C++ et &Java; uniquement. En particulier, vous ne pouvez pas l'utiliser pour les langages de scriptage comme PHP &pex;. C'est parce que &kdevelop; emploie l'application astyle pour implémenter cette fonctionnalité.

Pour configurer un style de format donné, sélectionnez Configuration Configurer &kdevelop;... dans la barre de menus. La boîte de dialogue Configurer KDevelop apparaît, dans laquelle vous sélectionnerez Formatage dans l'arborescence de la partie gauche. S'affiche alors une série de trois onglets de boîtes de dialogue à droite, à savoir Général, Indentation et Autre.

Tout changement de style s'applique au texte qui vient d'être saisi uniquement. Si vous voulez changer le style de formatage d'un texte source déjà existant, vous devrez utiliser explicitement la commande Édition Reformater le code source.

Le résultat exact de ces définitions de formatage de style dépend de l'éditeur dont vous vous servez. Actuellement, la plupart des réglages sont adaptés au composant d'édition Kate (l'éditeur « de texte avancé intégré »). Quelques autres éditeurs (&pex;, l'éditeur de Qt) peuvent se fonder sur leurs propres réglages de configuration. Essayez dans ce cas de découvrir les effets exacts des paramètres de style prévus ici.

Il se peut qu'il y ait des incompatibilités entre les paramètres de configuration de style fournis ici et l'éditeur que vous utilisez, au point même de risquer, dans des cas extrêmes, de détruire vos fichiers. Veillez à avoir une sauvegarde de vos fichiers sources avant d'essayer ces réglages avec un éditeur standard non KDE.

#### Configuration générale du formatage

L'onglet Généralde la boîte de dialogue Formatage des fichiers sources vous permet de choisir un des cinq styles prédéfinis de format des fichiers sources.

Configuration générale du style de formatage des sources

Configuration générale du style de formatage des sources

Un exemple de fichier source formaté sera affiché dans le champ situé à droite. Si aucun des styles prédéfinis n'est à votre goût, cliquez sur le bouton radio Défini par l'utilisateur du haut et définissez vos propres préférences de style de formatage des sources sur les deux autres onglets qui deviendront alors disponibles.

Actuellement, seuls les styles prédéfinis de formatage des sources seront présentés par un exemple de texte. Si vous décidez de définir votre propre style, aucun exemple d'affichage ne sera disponible. Vous devez l'expérimenter sur un texte source réel ou adapter les réglages à votre goût.

#### Configuration du style d'indentation

Une indentation appropriée est le principal moyen d'améliorer la lisibilité d'un texte source. Si vous avez sélectionné l'onglet Indentation de la boîte de dialogue Formatage des fichiers sources, vous voyez s'afficher une série de choix de formatage d'indentation groupée en trois cases comme suit.

Configuration du style d'indentation du formatage des sources

Configuration du style d'indentation du formatage des sources

Réglages par défaut

  Les choix des formats prédéfinis feront ressembler le texte source au style de formatage ANSI :

      namespace foospace
      {
        int Foo()
        {
          if (isBar)
          {
            bar();
            return 1;
          }
          else
            return 0;
        }
      }

Définition de la largeur et des caractères d'indentation

  Les boutons radio réunis dans le groupe Remplissage définissent la manière dont les indentations dans le texte source seront dessinées.

  Utiliser des tabulations

    Cette option fera insérer à l'éditeur un caractère de tabulation pour chaque niveau d'indentation. La largeur de la tabulation est prédéfinie dans les réglages de l'éditeur (8 ou 4 colonnes de caractères habituellement). Utilisez Configuration Configurer l'éditeur... pour le redéfinir.

    La procédure consistant à définir la largeur réelle de la tabulation dépend de l'éditeur que vous avez choisi dans l'étape de configuration Sélectionner l'éditeur. Vous devrez consulter l'aide de l'éditeur correspondant pour la découvrir.

  Utiliser des espaces

    Si vous cliquez sur ce bouton radio, l'éditeur saisit un nombre d'espaces pour chaque niveau d'indentation. Changez ce nombre, par défaut 2, pour la largeur d'indentation que vous préférez.

Entités indentées

  Ce réglage définit laquelle des entités (C/C++) sera formatée avec une indentation supplémentaire au-delà du niveau d'indentation actuel.

  Par défaut, seuls les espaces de noms et les intitulés seront indentés en sus. Vous pouvez être amené à expérimenter divers réglages pour adapter ces indentations supplémentaires à votre goût.

Lignes suivantes

  Les réglages groupés ici s'appliquent à ces cas où le formatage des fichierssources coupe automatiquement les longues lignes du source. Il prend en considération deux cas spéciaux, à savoir que dans les indentations profondément imbriquées, il devra rester assez de place pour le source, et que les conditions devront obtenir des niveaux d'indentation supplémentaires sur les lignes suivantes pour qu'elles puissent ressortir correctement.

  Ce réglage s'applique aux cas de coupures de lignes statiques uniquement, où une largeur de ligne maximale fixe est utilisée dans le texte source. Si vous configurez votre éditeur pour couper dynamiquement les longues lignes dans l'affichage uniquement (ce qui est possible dans le composant d'édition de &kate;), les effets de ces réglages n'apparaîtront généralement pas.

  Maximum dans une déclaration

    Ce réglage limite l'indentation maximale possible pour les lignes de continuation, de façon à ce qu'il reste assez d'espace pour conserver la lisibilité du texte. Aucune ligne de continuation sera jamais indentée au-delà du nombre de colonnes que vous avez choisies dans ce champ.

    La valeur par défaut est fixée à des colonnes de 40 caractères (la moitié d'une page standard de 80 colonnes). Il se peut que vous deviez augmenter cette valeur pour justifier un papier plus large (&pex;, si vous imprimez vos sources au format paysage). Ou bien diminuez la valeur en conséquence pour prendre en compte les réglages de marges supérieurs de vos sorties imprimante.

  Minimum dans une condition

    Les conditions ou les sources qui suivent &pex; un opérateur d'affectation devront généralement obtenir une indentation supplémentaire sur les lignes suivantes pour conserver la lisibilité du texte. La quantité de cette indentation supplémentaire est définie ici.

    La valeur par défaut est fixée au « double de l'actuel », ce qui signifie que les conditions continues obtiendront un niveau d'indentation supplémentaire par rapport à la taille standard d'indentation que vous avez choisie dans le groupe Remplissage. Vous pouvez modifier cette indentation supplémentaire pour une autre largeur fixe (y compris zéro) à l'aide des flèches ou en saisissant la valeur directement.

#### Autre configuration du formatage

Autres réglages de styles du format des fichiers source

Autres réglages de styles du format des fichiers source

Contrôler la position des accolades

  Les boutons radio (quelque peu mal nommés) du groupe Accolades contrôlent la position des accolades de délimitation des blocs dans un texte source (C/C++). Il y a trois possibilités vous permettant de choisir.

  Cassées

    Ce réglage insère un saut de ligne avant chaque accolade. Les deux accolades de délimitation de tous les blocs seront placées au même niveau d'indentation que la déclaration de début du bloc.

        namespace foospace
        {
          int Foo()
          {
            if (isBar)
            {
              bar();
              return 1;
            }
            else
              return 0;
          }
        }

  Attachées

    Ce réglage garde l'accolade ouvrante d'un bloc en alignement avec la déclaration de début du bloc. Les accolades fermantes seront au même niveau d'indentation que la déclaration de début du bloc. Le else d'une déclaration if sera maintenu en alignement avec l'accolade fermante du bloc précédent.

        namespace foospace {
          int Foo() {
            if (isBar) {
              bar();
              return 1;
            } else
              return 0;
          }
        }

  Style Linux

    Il s'agit d'un compromis des styles énumérés ci-dessus. Les accolades délimitant les blocs fonctionnels sont placées sur des lignes supplémentaires. Les accolades ouvrant un bloc dans une condition ou une déclaration de boucle seront maintenues en alignement.

        namespace foospace
        {
          int Foo()
          {
            if (isBar) {
              bar();
              return 1;
            } else
              return 0;
          }
        }

Contrôle des espaces supplémentaires

  Par défaut, &kdevelop; minimise l'utilisation des espaces dans les textes des fichiers sources.

      if (isBar(fooArg)==barValue)

  Vous pouvez améliorer la lisibilité si vous forcez le formatage de fichiers sources à insérer des espaces supplémentaires dans des positions spéciales.

  Ajouter des espaces autour des parenthèses

    L'idée est en fait d'ajouter des espaces autour du texte placé entre parenthèses. Ce réglage améliore la lisibilité des arguments des fonctions et des conditions.

        if ( isBar( fooArg )==barValue )

  Ajouter des espaces autour des opérateurs

    Ce réglage place des espaces autour des opérateurs d'affectation et de comparaison pour améliorer la lisibilité.

        if (isBar(fooArg) == barValue)

Contrôler le formatage des structures d'une ligne

  Il y a quelques cas dans lesquels vous ne souhaiterez pas que le formatage des fichiers sources divise une longue ligne séparément. Pour le code C/C++, on peut contrôler ce comportement ici.

  Garder une ligne lors d'une déclaration

    Ce réglage maintient réunies des déclarations d'une ligne dans certaines situations, même si elles dépassent une longueur de ligne maximale fixe.

  Garder une ligne lors de la constitution de blocs

    Ce réglage maintient réunis des blocs d'une ligne dans certaines situations, même s'ils dépassent une longueur de ligne maximale fixe.

### Configuration de l'outil « Fragments de code »

Lorsque vous éditez dans &kdevelop; vous pouvez mémoriser des parties de code souvent utilisés sous forme de fragments de code. Pour configurer les fonctionnalités du composant « Fragments de code », sélectionnez Configuration Configurer &kdevelop;... dans la barre de menus. La boîte de dialogue Configurer KDevelop apparaît; dans laquelle vous devez sélectionner Fragments de code dans l'arborescence de la partie gauche. Vous voyez alors la boîte de dialogue suivante s'afficher dans la partie droite.

Configuration de l'outil « Fragments de code »

Configuration de l'outil « Fragments de code »

Activer l'aperçu d'un fragment

  Cochez la case Afficher le texte du fragment dans une bulle d'aide si vous souhaitez visualiser le texte mémorisé dans une fenêtre de bulle d'aide chaque fois que vous maintenez le curseur de la souris sur le titre de ce fragment.

Travailler avec des variables de fragments

  L'outil Fragments de code prévoit 'un texte de variable dans des emplacements prédéfinis chaque fois que vous insérez un fragment dans un fichier. Pour ce faire, l'outil Fragments de code fournit son propre mécanisme de variables. Vous pouvez configurer son comportement dans le groupe Variables.

  Délimiteur

    L'outil Fragments de code distingue les variables dans le texte en entourant le nom de la variable par des symboles de délimiteurs spéciaux. Pour utiliser votre propre symbole de délimiteur, changez le caractère $ prédéfini dans le champ Délimiteur.

  Méthode d'entrée des variables

    - Une seule boîte de dialogue pour chaque variable d'un fragment de code — fait apparaître une boîte de dialogue séparée pour chaque variable que l'outil trouve en insérant le fragment de code sélectionné.

    - Une boîte de dialogue pour toutes les variables d'un fragment de code — fait apparaître une boîte de dialogue commune où l'utilisateur doit remplir les valeurs de toutes les variables avant l'insertion du fragment de code.

### Liste des fichiers

(... à écrire ...)

### Configurer le sélecteur de fichiers

&kdevelop; fournit un module externe Sélecteur de fichiers qui, lorsque chargé au démarrage, permet de naviguer dans n'importe quel fichier ou dossier ans le système.

Le sélecteur de fichiers (mode IDEAl)

Le sélecteur de fichiers (mode IDEAl)

Le comportement du Sélecteur de fichiers est extrêmement configurable. Sélectionnez Configuration Configurer &kdevelop;... dans la barre de menus. La boîte de dialogue Configurer KDevelop apparaît, dans laquelle vous devrez cliquer sur Sélecteur de fichiers dans l'arborescence à gauche. La boîte de dialogue suivante apparaît dans la partie droite.

Configurer le sélecteur de fichiers

Configurer le sélecteur de fichiers

Configurer la barre d'outils

  Il y a une barre d'outils en haut du Sélecteur de fichiers que l'on peut configurer comme d'habitude dans le groupe Barre d'outils.

  #### Ajouter une action à la barre d'outils

  1. Choisissez un élément dans la partie droite de la liste Actions sélectionnées, après quoi la nouvelle action devra être insérée.

  2. Sélectionnez l'action à insérer dans la partie gauche de la liste Actions disponibles.

  3. Cliquez sur la flèche droite (en haut) entre les deux listes.

     L'action sera supprimée de la liste Actions disponibles et insérée dans la liste Actions sélectionnées sous l'élément sélectionné.

  #### Supprimer une action de la barre d'outils

  1. Sélectionnez l'élément à supprimer dans la partie droite de la liste Actions sélectionnées.

  2. Cliquez sur la flèche gauche (en bas) entre les deux listes.

     L'élément sélectionné sera supprimé de la liste Actions sélectionnées et placé à nouveau dans la liste Actions disponibles.

  #### Réordonner les actions sur la barre d'outils

  1. Sélectionnez l'action à déplacer dans la partie droite de la liste Actions sélectionnées.

  2. Cliquez sur la flèche haut ou bas à droite de cette liste.

     L'élément sélectionné sera déplacé vers le haut ou vers le bas de la liste Actions sélectionnées.

Définir le moment où le contenu devra changer

  La mise à jour du contenu dans la fenêtre Sélecteur de fichiers prend du temps et des ressources, en particulier lorsqu'on change de dossier. Par conséquent, le Sélecteur de fichiers est configuré par défaut de telle sorte que son contenu ne change que sur demande, &cad; lorsque vous choisissez un autre dossier ou lorsque vous souhaitez explicitement rafraîchir son contenu.

  Cliquez sur le bouton Recharger dans la barre d'outils pour mettre à jour le contenu du Sélecteur de fichiers. Ce bouton de barre d'outils n'est pas disponible par défaut, cependant. Vous devez l'insérer ici d'abord.

  Vous pouvez configurer le Sélecteur de fichiers pour répercuter immédiatement certains changements dans votre travail. Les réglages dans le groupe Synchronisation automatique de la boîte de dialogue de configuration sont responsables de ce comportement.

  Lorsqu'un document devient actif

    Si vous cochez cette case, le contenu de la fenêtre Sélecteur de fichiers est mis à jour chaque fois que vous êtes sur le point d'ouvrir un autre document déjà ouvert, &pex; lorsque vous cliquez sur l'onglet de la fenêtre d'édition correspondante en mode IDEAl. Si nécessaire, le Sélecteur de fichiers passe dans le dossier auquel ce fichier appartient et actualise l'affichage pour en montrer le contenu réel.

  Lorsqu'un document est ouvert

    Si vous cochez cette case, le contenu de la fenêtre Sélecteur de fichiers est mis à jour chaque fois qu'un document est ouvert, &pex; par le menu Fichier Ouvrir. Si nécessaire, le Sélecteur de fichiers passe dans le dossier auquel ce fichier appartient et actualise l'affichage pour en montrer le contenu réel.

  Lorsque le sélecteur de fichiers devient visible

    Si vous cochez cette case, le contenu de la fenêtre Sélecteur de fichiers est mis à jour chaque fois qu'il redevient visible. Si nécessaire, il passe dans le dossier auquel ce fichier appartient et actualise l'affichage pour en montrer le contenu réel.

  Vous pouvez combiner librement ces réglages pour adapter le comportement d'actualisation du Sélecteur de fichiers à votre goût.

Contrôler l'historique dans les zones de listes modifiables

  Il y a deux zones de listes modifiables en haut et au bas de la fenêtre de contenu du Sélecteur de fichiers, qui contrôlent le dossier à afficher (zone de liste modifiable du haut) et les filtres à appliquer à l'affichage des fichiers (zone de liste modifiable du bas). Un historique des réglages les plus récents est conservé dans le champ de sélection de chaque zone de liste modifiable. Vous pouvez configurer le nombre des éléments d'historique comme suit.

  Mémoriser les emplacements

    Saisissez ici le nombre maximal de sélections de dossiers que la zone de liste modifiable du haut devra mémoriser.

  Mémoriser les filtres

    Saisissez ici le nombre maximal de sélections de dossiers que la zone de liste modifiable du bas devra mémoriser.

  Contrôler ce qui devra être mémorisé entre les sessions

    Par défaut, le Sélecteur de fichiers est configuré pour réafficher la session la plus récente au prochain démarrage de &kdevelop;. Vous pouvez changer ce comportement dans le groupe de configurationSession.

    Si &kdevelop; a été redémarré automatiquement par le gestionnaire de sessions de &kde;, les changements apportés dans ces réglages n'auront aucun effet. Dans ce cas, les réglages d'emplacement et de filtre de la session la plus récente de &kde; seront toujours restaurés.

  Restaurer l'emplacement

    Décochez cette case si vous ne souhaitez pas que l'emplacement affiché soit mémorisé entre les sessions.

    Si vous avez sélectionné un des réglages de mise à jour automatique, l'emplacement affiché pourra changer automatiquement, indépendamment de ce qui a été mémorisé depuis la précédente session.

  Restaurer les filtres

    Décochez cette case si vous ne souhaitez pas que les filtres appliqués à l'affichage soient mémorisés entre les sessions.

### Générateur de classes C++

(... à écrire ...)

### Formatage

(... à écrire ...)

### Analyse de la syntaxe C++

(... à écrire ...)

## Configurer la documentation

&kdevelop; contient une fonction documentation très puissante qui fournit un accès à plusieurs sortes de documentations exhaustives. En mode IDEAl &pex;, vous trouverez un onglet Documentation sur le bord droit de la zone de travail.

La fenêtre de documentation de &kdevelop; en mode IDEAl

La fenêtre de documentation de &kdevelop; en mode IDEAl

&kdevelop; doit avoir chargé le module externe Documentation pour pouvoir visualiser l'arborescence de la documentation. Consultez la section Outils modules externes » pour plus d'informations.

Vous pouvez configurer le contenu et le comportement des diverses parties de cette fenêtre de documentation en sélectionnant Configuration Configurer &kdevelop;... dans la barre de menus. La boîte de dialogue Configurer KDevelop apparaît, dans laquelle vous devez sélectionner Documentation dans la fenêtre de gauche.

La page de configuration ainsi affichée montre trois pages de boîtes de dialogue de configuration à onglets, à savoir :

- Collections de documentation
- Recherche plein texte
- Autre

### Configuration des collections de documentation

Les paramètres de configuration de la documentation ont été divisés en une série de collections de documentation, dont chacune offre l'accès à des fichiers de documentation d'un format et d'un type de contenu uniques. Ces configurations vérifient quels seront les éléments de documentation répertoriés sur la page Contenu de la fonction Documentation de &kdevelop; et comment l'utilisateur peut accéder aux éléments de documentation via des recherches indexées et plein texte.

L'onglet Documentation fournit une série de pages de configuration qui sont ordonnées verticalement comme une pile de fiches. Une page à la fois s'ouvre après avoir cliqué sur le titre de sa fiche :

- Collection de documentation &Qt;
- Collection de documentation CHM
- Collection de documentation Doxygen
- Collection de documentation &kdevelop;TOC
- Collection de documentation Devhelp
- Collection de documentation personnalisée

Configuration des collections de documentation

Configuration des collections de documentation

#### Structure commune de configuration de la documentation

Toutes les pages de configurations dans l'onglet Documentation utilisent une disposition commune. Vous trouverez les éléments de documentation actuellement disponibles de ce type répertoriées sur la page d'ouverture ainsi qu'un ensemble de boutons sur la partie droite.

Boutons pour maintenir le contenu de la liste de documentation

  Il y a trois boutons disponibles pour maintenir le contenu des pages de configuration de la documentation :

  Ajouter

    Ouvre une boîte de dialogue Propriétés du catalogue de la documentation comme illustré ci-dessous, où vous pouvez sélectionner l'emplacement source de l'élément de documentation à ajouter et le nommer.

  Modifier

    Ouvre une boîte de dialogue Propriétés du catalogue de la documentation comme illustré ci-dessous, où vous pouvez changer l'emplacement source de l'élément de documentation précédemment sélectionné dans la liste et le renommer.

  Supprimer

    Supprime de la liste l'entrée de documentation sélectionnée.

    L'entrée sera supprimée de la liste uniquement. Les sources proprement dites de la documentation restent intactes. Vous devrez les supprimer explicitement par un autre moyen.

  Ajouter ou changee une entrée de documentation

  Le bouton situé à droite du champ Emplacement ouvre une boîte de dialogue de dossier dont les éléments seront habituellement filtrés selon le type de fichier de la page de configuration sélectionnée.

  Le champ Titre risque de ne pas être accessible, en fonction du type de documentation à maintenir.

Structure de liste de la documentation

  Chaque page de configuration de la documentation affiche les éléments de documentation répertoriés dans un tableau de colonnes :

  TOC

    Si cette case est cochée, cet élément de documentation sera affiché sur la page Contenu de la fonction Documentation de &kdevelop;.

    Décocher la case TOC désactivera les cases à cocher Index et Recherche (voir ci-dessous). Ainsi, vous pouvez avoir les éléments les collections de documentation indexés mais non affichés dans le contenu.

  Index

    Si cette case est cochée, un index interne sera construit à partir de cet élément de documentation. Ce comportement permet un accès rapide à la documentation via l'utilisation des pages Index et (optionnellement) Localisateur de la fonction Documentation de &kdevelop;..

    L'index interne sera construit la première fois où l'utilisateur sélectionne la page Index. Cette action retardera le premier accès de façon significative car l'index sera lu à partir du disque puis placé dans le cache.

    Toutes les recherches indexées ultérieures utiliseront cependant ce cache et iront ainsi beaucoup plus vite.

  Recherche

    Si cette case est cochée, le contenu de cet élément de documentation sera inclus dans le chemin de recherche plein texte de la page Recherche de la fonction Documentation de &kdevelop;.

    &kdevelop; se sert de la collection de l'application « htdig » pour effectuer les recherches plein texte. Cette recherche sera faite sur un index interne, la machinerie « htdig » ayant été construite avant de pouvoir être utilisée.

    Tout changement de la case à cocher Recherche n'affectera ainsi les actions de recherche qu'après avoir reconstruit l'index sur la page Recherche de la fonction Documentation de &kdevelop;.

  Titre

    C'est le nom de l'élément de documentation tel qu'il sera affiché sur la page Contenu de la fonction Documentation de &kdevelop;.

  Les précédentes versions de &kdevelop; permettaient de sélectionner les éléments de documentation à afficher par projet. Ce comportement n'est plus disponible.

#### Collections de documentation &Qt;

Sur cette page de configuration, toute la documentation &Qt; est configurée.

Configuration de la collection de documentation &Qt;

Configuration de la collection de documentation &Qt;

Normalement,&kdevelop; la remplit lors de son premier démarrage. Il cherche les fichiers de documentation standard `*.xml` ou `*.dcf` dans le dossier d'installation de &Qt;. Le tableau de la partie gauche répertorie par titres standard les fichiers que &kdevelop; a trouvés.

Si vous avez une installation non standard, soit il n'y aura absolument aucune information répertoriée, soit les entrées pointeront peut-être sur des emplacements incorrects (&pex; sur une autre installation &Qt; disponible dans votre système). Vous pouvez ajuster les entrées à l'aide des boutons situés dans la partie droite du champ de liste.

&kdevelop; utilisera les titres déjà fournis par la documentation &Qt; installées. Donc, le champ Titre dans la boîte de dialogue Propriétés du catalogue de la documentation ests inaccessible.

Par défaut, toute la documentation &Qt; n'est pas affichée sur la page Contenu de la fonction Documentation de &kdevelop;. Utilisez la case à cocher TOC dans la table de configuration pour sélectionner la documentation à afficher.

Si vous souhaitez que de la documentation propre à &Qt; soit incluse dans les index de recherche ou dans la recherche plein texte, utilisez les cases à cocher Index et Recherche dans la table de configuration.

#### Configuration de la collection de documentation CHM

Dans cette page de configuration, vous pouvez collecter de la documentation selon le standard des fichiers d'aide CHM &Microsoft;.

Configuration des fichiers de documentation standard CHM &Microsoft;

Configuration des fichiers de documentation standard CHM &Microsoft;

Par défaut, cette page de configuration sera vide (comme illustré ci-dessus). Vous pouvez ajouter de nouvelles entrées à l'aide des boutons situés à droite du champ de liste. &kdevelop; filtrera les fichiers `*.chm` dans la boîte de dialogue associée aux boutons Ajouter et Modifier.

Pour plus d'informations sur le format des fichiers `*.chm` &Microsoft;, reportez-vous &pex; au document « PHP: Documentation - Extended CHM Format » sur le site http://de2.php.net/docs-echm.php.

#### Documentation générée par Doxygen

Dans cette page de configuration, toutes les documentations de l'&API; que génère &doxygen; sont configurées.

Configuration de la documentation de l'&API; générée par Doxygen

Configuration de la documentation de l'&API; générée par Doxygen

En bref, une telle &API; documente l'interface à certaines fonctions de bibliothèques. La documentaion de l'&API;. présente sur cette page devra être produite par l'outil &doxygen; fourni en externe.

La documentation de l'&API; générée par &doxygen; se compose d'une série de fichiers `html` commençant par `index.html`. De plus, il peut exister des fichiers `tag` qui contiennent des informations à lier aux documentations de l'&API; existantes. Ainsi, &kdevelop; cherchera les fichiers `index.html` et `*.tag` lorsqu'il effectue des recherches dans la documentation de l'&API; générée par &doxygen;.

Il y a certaines contraites structurelles supposées lors d'une recherche dans la documentation de l'&API; générée par &doxygen;. Le dossier dans lequel le fichier `index.html` réside devra contenir des sous-dossiers ayant des collections de documentation séparées. Chacun de ces sous-dossiers est censé contenir un fichier `.tag` et un sous-dossier `html/`.

Vous pouvez jeter un coup d'œil à `$`KDEDIR`/share/doc/HTML/en/kdelibs-apidocs` pour voir un exemple d'une telle disposition de documentation de l'&API; générée par &doxygen;.

L'ancien format de l'&API; générée par le KDoc de &kde; n'est plus pris en charge directement. Si vous souhaitez toujours utiliser ce type de documentation, vous pouvez l'ajouter dans la page Collection de documentation personnalisée.

&kdevelop; aura rempli un lien vers l'&API; des bibliothèques &kde; actuelles, à condition qu'il en ait trouvé une. Il y a plusieurs moyens pour &kdevelop; de le découvrir

- Soit vous avez fourni la commande `configure` avec l'option `--with-kdelibsdoxy-dir` lorsque vous avez compilé &kdevelop; (reportez-vous au chapitre Comment obtenir une documentation de l'&API; &kdevelop;).

- Soit la commande `configure` a automatiquement trouvé une &API; des bibliothèques &kde; générée par &doxygen; dans l'un des quelques emplacements standard qu'elle connaît.

- Soit en dernier recours, &kdevelop; a toruvé le `$`KDEDIR`/share/doc/HTML/en/kdelibs-apidocs/` lors de son premier démarrage.

Si &kdevelop; n'a pas trouvé d'&API; des bibliothèques &kde; générée par &doxygen; lors de son premier démarrage, la liste Collection de documentation Doxygen sera vide.

Vous pouvez ajouter vos propres entrées de documentation de l'&API; (&pex; à partir de vos projets en cours) via les boutons situés à droite. Si vous souhaitez qu'elles soient incluses dans la recherche indexée/plein texte, cochez les cases Index ou Recherche dans la table de configuration.

&kdevelop; utilise les informations de titre provenant du `index.html`. Donc; le champ Titre dans la boîte de dialogue Propriétés du catalogue de la documentation est inaccessible.

Le système &kde; fournit davantage de documentation de l'&API; que l'&API; des bibliothèques &kde; seule. Vous aurez besoin d'informations complémentaires sur les interfaces si vous souhaitez &pex; inclure le composant &kate; dans vos programmes. Pour cette &API; du composant &kate; &pex;, vous devrez compiler et installer l'&API; des bibliothèques de base &kde; à partir des sources (à l'aide des commandes `make apidox` et `make install` sur les sources `kdebase`) puis ajouter une entrée à la liste Collection de documentation Doxygen comme suit :

Ajout d'une &API; de base &kde; à la liste

Ajout d'une &API; de base &kde; à la liste

(Naturellement, vous devrez remplacer le dossier `/home/dev/mykde-system/` dans l'exemple de champ Emplacement par le chemin vers votre installation &kde;.)

Vous devez placer l'&API; de votre projet actuel dans cette Collection de documentation Doxygen également. Les versions antérieures de &kdevelop; la plaçaient dans l'arborescence de la documentation par projet. Ce n'est plus le cas.

#### Gestion de la documentation structurée (fichiers KDevelopTOC)

La partie principale de la fonction de documentation de &kdevelop; offre un accès immédiat à de la documentation structurée, locale aussi bien que distante. Vous pouvez la configurer dans l'onglet Collection de documentation KDevelopTOC.

Mise en place de l'accès à la documentation structurée KDevelopTOC

&kdevelop; est livré avec un ensemble de fichiers KDevelopTOC prédéfinis qui sont automatiquement placés dans le tableau au moment de l'installation. Pour que l'affichage reste gérable; seuls ceux qui sont le plus souvent utilisés seront initialement cochés pour affichage. Si vous souhaitez voir une autre documentation, cochez la case TOC dans la table de conifguration.

Les fichiers KDevelopTOC ne peuvent pas être indexés pour effectuer une recherche plein texte parce qu'ils pointent habituellement sur un emplacement distant. Par ailleurs, un tel fichier `.toc` peut avoir un index défini manuellement à l'aide de la balise `<index>`. Ainsi, la cse à cocher Index ne sera activée que lorsque &kdevelop; trouvera une balise `<index>` dans le fichier `.toc`. (Pour plus de détails, reportez-vous à la description ci- dessous dans la section Fichiers TOC &kdevelop;.)

La case à cocher Recherche dans la table de configuration sera toujours désactivée.

Vous pouvez ajouter de nouvelles entrées à l'aide des boutons situés dans la partie droite du champ de liste. &kdevelop; filtrera les fichiers `*.toc` dans la boîte de dialogue des dossiers associée aux boutons Ajouter et Modifier.

Comme les versions autres que les précédentes de &kdevelop; auront le bouton Supprimer mais ne changent pas les fichiers `*.toc` sur disque, supprimer l'opération est avisé à présent.

#### Fichiers &kdevelop;TOC

Il y a une fonctionnalité spéciale associée à ce comportement. Pour illustrer, suivez ces étapes : dans l'arborescence de la documentation, cherchez une entrée immédiatement au-dessous de la documentation &Qt;/&kde; (&pex; « KDE2 Development Book (kde.org) »). Cliquez sur le signe + à côté de ce dernier. Une arborescence s'ouvre, dans laquelle vous pouvez rapidement naviguer vers les chapitres ultérieurs imbriqués à plusieurs niveaux de profondeur, entièrement hors ligne. Mais si vous choisissez en dernier lieu un des chapitres, &kdevelop; essaiera dans de nombreux cas d'accéder à un fichier de documentation distant.

La raison qui justifie tout cela n'est pas seulement naviguer localement dans la documentation distante sans gaspiller des ressources d'accès Internet, mais d'offrir au développeur un accès aisé, structuré à la documentation dont il a besoin. Grâce à ces outils, on peut accéder à presque toute documentation locale ou distante d'une manière structurée même si l'original disposé à plat ou structuré d'une autre façon. Il suffit d'avoir un accès aux fichiers et/ou aux parties des fichiers que Konqueror peut afficher.

Un accès ainsi structuré est rendu possible par l'utilisation de fichiers de « table des matières » (ou fichiers TOC) spéciaux, qui sont désignés par des extensions de fichiers `.toc`. Tout fichier TOC &kdevelop; de ce type contient une description &XML; structurée du document auquel accéder.

Dossier standard des fichiers TOC &kdevelop;

  Lorsque &kdevelop; est installé, une série de fichiers `.toc` prédéfinis est habituellement placée dans le dossier `$KDEDIR/share/apps/kdevdoctreeview/tocs`. Ce sont des fichiers texte assez simples et structurés. Vous pouvez les examiner à l'aide d'un éditeur de texte ou de tout autre fonction d'affichage de exte.

##### Structure de base des fichiers TOC &kdevelop;

en-tête
  - `<!DOCTYPE kdeveloptoc>`
  - `<kdeveloptoc>`
  - (titre)
  - (adresse de base)
  - (structure du contenu)
  - (structure de l'index)
  - `</kdeveloptoc>`

  La structure &XML; sera analysée par le module externe Documentation de &kdevelop; pour configurer le contenu de l'arborescence de la documentation et pour guider l'utilisateur dans sa navigation dans la documentation. Elle contient toutes les informations nécessaires pour afficher les titres et pour accéder au contenu des fichiers de documentation.

titre
  - `<title>` (n'importe quelle chaîne de titre) `</titre>`

  Il s'agit du titre que &kdevelop; affichera aux niveaux de base dans l'arborescence de la documentation.

  L'utilisateur ne peut pas changer ce titre affiché. Si vous souhaitez qu'un autre texte soit affiché, vous devez changer manuellement l'entrée `<titre>` dans le fichier `.toc`.

adresse de base
  - `<base href="` (&URL; du document de base) `"/>`

  Cette &URL; pointe sur l'emplacement où se trouvent tous les fichiers de cette documentation. Elle sera ajoutée au début de l'&URL; de chaque section dans la liste de structure de contenu suivante. Donc, si &pex; vous avez téléchargé une documentation sur un serveur distant, il vous suffit de changer son &URL; de `<base>` pour afficher les fichiers à partir de ce nouvel emplacement.

structure du contenu
  - `<tocsect1 name="` (titre de la section) `" url="` (&URL; de la section) `">`
  - ...
  - `<tocsectn name="` (titre de la section) `" url="` (&URL; de la section) `"/>`
  - ...
  - `</tocsect1>`

  Toutes les informations de navigation et d'accès restantes sont enregistrées dans une série de paires `<tocsecti>` ... `</tocsecti>` imbriquées. Chaque i désigne un niveau d'imbrication consécutif jusqu'au nombre n qui correspond à la section de la documentation finalement affichée.

  Toute entrée `<tocsecti>` doit avoir un attribut « `name="xxx"` » qui lui est associé (le « "xxx" » désigne la chaîne de titre réelle). Ce nom sera affiché en tant que titre de niveau dans l'arborescence de la documentation et devra correspondre à une section réelle de la documentation.

  Il peut y avoir un attribut « `url=""` » associé à n'importe quel niveau d'imbrication i. Lorsque l'utilisateur clique sur un titre de section dans l'arborescence de la documentation, &kdevelop; essaie d'accéder au fichier à l'emplacement sur lequel pointe l'&URL; combinée de base et de section.

  L'entrée `<tocsectn/>` doit avoir un attribut « `url=""` » dans tous les cas. Cette `<tocsectn/>` imbriquée finale n'est pas sous la forme de paires mais sera immédiatement fermée par un `/` avant l'accolade `>`.

  Toute adresse combinée d'une &URL; de base et de section doit pointer sur un fichier texte affichable. Habituellement, ce sera un fichier structuré en HTML. Il est possible de le lier à des marques d'ancrage dans un tel fichier HTML à l'aide d'une notation # standard du format : `/url-basel/url-section#marque-ancrage`.

structure de l'index
  - `<index>`
  - `<nom entrée="` (titre de l'entrée d'index) `" url="` (&URL; de la section d'index) `"/>`
  - `</index>`

  L'index est une liste simple d'entrées - paires de titre et d'&URL;. L'index n'est pas obligatoire.

#### Documentation DevHelp

La documentation DevHelp est un autre moyen d'accès à la documentation structurée. Elle emploie des fichiers de tables des matières structurés désignés par une extension `.devhelp` similaire aux fichiers TOC &kdevelop; pour accéder à la documentation pour le bureau GNOME 2.

Vous pouvez vérifier quels devront être les fichiers DevHelp accessibles sur la page de configuration Collection de documentation DevHelp.

Mise en place de la documentation DevHelp

Les fichiers DevHelp étaient à l'origine accessibles sur le site web LiDN, mais il semble qu'ils ne sont pas maintenus depuis quelque temps. De la documentation DevHelp récente est disponible sur la page web DevHelp Books Download.

Lorsque &kdevelop; est installé, il tente de trouver tous les fichiers `.devhelp` dans certains emplacements standard du système, &pex; dans les sous-dossiers de `/opt/gnome/share/`. Initialement, ces fichiers ne seront pas marqués pour être affichés. Si vous souhaitez voir une autre documentation, cochez la case TOC dans la table de configuration.

Vous pouvez ajouter de nouvelles entrées à l'aide des boutons situés dans la partie droite du champ de liste. &kdevelop; filtrera les fichiers `*.toc` dans la boîte de dialogue des dossiers associée aux boutons Ajouter et Modifier.

#### Configuration des collections de documentation personnalisée

Elle est laissée à votre propre gré. Vous pouvez ajouter pratiquement n'importe quel fichier de documentation ici, pourvu que les modules externes de &konqueror; puissent les afficher.

Mise en place de la documentation personnalisée

Habituellement, cette collection sera vide au premier démarrage de &kdevelop;. Nous avons rempli un élément délibéré pour montrer la structure des entrées.

La manipulation est très facile ici. Utilisez les boutons à droite du champ de liste pour ajouter, modifier ou supprimer les éléments de documents. &kdevelop; ne filtrera rien dans la boîte de dialogue associée aux boutons Ajouter et Modifier.

Vous devrez explicitement sélectionner les éléments à afficher dans la fonction de documentation de &kdevelop;. Cochez la case TOC de l'entrée dans la table de configuration.

On ne peut ni indexer ni faire de recherche dans la documentation personnalisée. Ainsi, les cases à cocher Index et Recherche n'ont aucun effet ici comme illustré ci-dessus.

### Configuration des index de recherche de texte

(... à écrire ...)

Configuration des index de recherche de texte

### Autres réglages de configuration de la documentation

(... à écrire ...)

## Configuration avancée

(... à écrire ...)

### Outils Modules externes

(... à écrire ...)