<appendix id="app-files"> <!-- LWatts (2005-04-30): A lot of this might be better as variable lists, --> <!-- but it's not that big a deal. Something to be done only when there's --> <!-- a lot of textual changes needed here (e.g., maybe never ) --> <appendixinfo> <authorgroup> <author ><firstname >Bernd</firstname ><surname >Pol</surname ></author> <!-- ROLES_OF_TRANSLATORS --> </authorgroup> </appendixinfo> <title >Fichiers de configuration utilisés par &kdevelop;</title> <para >&kdevelop; utilise une série de fichiers de configuration qui sont répartis parmi plusieurs dossiers. Il faut distinguer deux groupes principaux de fichiers de configuration : </para> <simplelist> <member ><link linkend="app-files-default" >Configuration par défaut de &kdevelop;</link > — fichiers configurés quand &kdevelop; a été installé. </member> <member ><link linkend="app-files-user" >Configuration orientée utilisateur</link > — fichiers qui contiennent des modifications par l'utilisateur des réglages par défaut, ainsi que les réglages effectués par l'application &kdevelop; elle-même et ses modules externes. </member> </simplelist> <sect1 id="app-files-default"> <title >Configuration par défaut de &kdevelop;</title> <para >Lors de l'installation, &kdevelop; écrit quelques fichiers de configuration par défaut à des fins de mise en place et de configuration dans des sous-dossiers du dossier d'installation <filename class="directory" >$<envar >KDEDIR</envar ></filename > (habituellement<filename class="directory" >/opt/kde</filename >, <filename class="directory" >/usr/local/kde</filename > ou n'importe quel autre dossier d'installation défini par l'utilisateur. Reportez-vous au chapitre <link linkend="kdevelop-install" >Installation de &kdevelop;</link >). </para> <sect2 id="app-files-default-config"> <title >Configuration par défaut de &kdevelop;</title> <para >Il n'y a qu'un seul fichier de configuration par défaut propre à &kdevelop; dans le dossier <filename class="directory" >$<envar >KDEDIR</envar >/share/config/</filename > : </para> <variablelist> <varlistentry> <term ><filename >kdeveloprc</filename ></term> <listitem ><para >Ce fichier contient les réglages de base dont &kdevelop; a besoin pour démarrer. Il sera copié dans le dossier <filename class="directory" >$<envar >KDEHOME</envar >/share/config</filename > de l'utilisateur quand &kdevelop;n'y trouve pas de fichier <filename >kdeveloprc</filename > au démarrage. </para ></listitem> </varlistentry> </variablelist> </sect2 > <!-- app-files-default-config --> <sect2 id="app-files-default-apps"> <title >Réglages spécifiques par défaut</title> <para >La plupart des fonctionnalités de &kdevelop; sont fournies par KParts. Ce sont avant tout des applications spécialement conçues pour s'exécuter dans l'environnement &kdevelop; (reportez-vous à la vue d'ensemble dans l'annexe <link linkend="plugin-tools" >Outils modules externes</link >). Chaque application KPart a son propre ensemble de fichiers de configuration dont les réglages par défaut seront stockés dans plusieurs sous-dossiers du dossier d'installation <filename class="directory" >$<envar >KDEDIR</envar >/share/apps/</filename >. </para> <para >On trouve un grand nombre de sous-dossiers de configuration par défaut dans <filename class="directory" >$<envar >KDEDIR</envar >/share/apps/</filename >, dont les noms commencent tous par une séquence <filename >kdev</filename >. La majorité d'entre eux ne sont destinés qu'à l'utilisation en interne de &kdevelop;. Par souci de lisibilité, ils pourront être délibérément groupés comme suit : <simplelist> <member ><link linkend="app-files-default-apps-stdalone" >Applications autonomes</link ></member> <member ><link linkend="app-files-default-apps-task" >Composants propres à une tâche</link ></member> <member ><link linkend="app-files-default-apps-project" >Composants de génération de projet</link ></member> <member ><link linkend="app-files-default-apps-lang" >Composants propres à un langage</link ></member> </simplelist> </para> <itemizedlist> <listitem id="app-files-default-apps-stdalone" ><itemizedlist> <title >Applications autonomes</title> <listitem> <para ><filename class="directory" >kdevelop/</filename > — contient les fichiers permettant de configurer l'EDI &kdevelop; :</para> <itemizedlist> <listitem ><para ><filename class="directory" >licenses/</filename > — contient divers textes de licences.</para ></listitem> <listitem ><para ><filename class="directory" >pics/</filename > — contient les fichiers image utilisés pour &kdevelop;, l'assistant de &kdevelop; et les écrans de bienvenue de &kdevelop; Designer.</para ></listitem> <listitem ><para ><filename class="directory" >profiles/</filename > — contient les réglages par défaut des modules externes. (Actuellement, un seul profil <filename >tiny</filename > est prévu, qui définit un ensemble minimal de modules externes &kdevelop; actifs.)</para ></listitem> <listitem ><para ><filename >eventsrc</filename > — contient une grande quantité de chaînes de localisation « Processus réussi ».</para ></listitem> <listitem ><para ><filename >kdevelopui.rc</filename > — fournit les éléments de menu et de barre d'outils de base que &kdevelop; utilise.</para ></listitem> <listitem ><para ><filename >kdevhtml_partui.rc</filename > — fournit un élément <guimenuitem >Imprimer...</guimenuitem > dans le menu <guimenu >Fichier</guimenu >, un élément <guimenuitem >Copier</guimenuitem > dans le menu <guimenu >Édition</guimenu >, ainsi que des flèches <guilabel >Précédent</guilabel > et <guilabel >Suivant</guilabel > dans la <guilabel >barre d'outils du navigateur</guilabel > dans le cas où l'on parcourt un fichier &HTML; depuis le module externe <guilabel >Documentation</guilabel >.</para ></listitem> </itemizedlist> </listitem> <listitem ><para ><filename class="directory" >kdevassistant/</filename > — fournit les barres de menu et les barres d'outils du navigateur de documentation autonome de l'assistant de &kdevelop;.</para ></listitem> <listitem ><para ><filename class="directory" >kdevdesigner/</filename > et <filename class="directory" >kdevdesignerpart/</filename > — fournissent la barre de menus et les barres d'outil du concepteur d'interface utilisateur autonome de &kdevelop;.</para ></listitem> </itemizedlist ></listitem> <listitem ><itemizedlist id="app-files-default-apps-task"> <title >Composants propres à une tâche</title> <listitem id="app-files-default-abbrev"> <para ><filename class="directory" >kdevabbrev/</filename > — contient les fichiers utilisés par le module externe <guilabel >Complétement automatique</guilabel >.</para> <itemizedlist> <listitem ><para ><filename class="directory" >sources/</filename > — contient les fichiers de définition de mots-clés utilisés par la commande <guilabel >Développer le texte</guilabel >.</para ></listitem> <listitem ><para ><filename class="directory" >templates/</filename > — contient les fichiers de définition de modèles utilisés par la commande <guilabel >Compléter automatiquement</guilabel >.</para ></listitem> <listitem ><para ><filename >kdevabbrev.rc</filename > — fournit les éléments <guimenuitem >Développer le texte</guimenuitem > et <guimenuitem >Compléter automatiquement</guimenuitem > dans le menu <guimenu >Édition</guimenu >.</para ></listitem> </itemizedlist> </listitem> <listitem id="app-files-default-appwizard"> <para ><filename class="directory" >kdevappwizard/</filename > — contient les fichiers utilisés par le composant &appwizard;.</para> <itemizedlist> <listitem ><para ><filename class="directory" >importfiles/</filename > — contient les fichiers du projet <filename >.kdevelop</filename > qui contrôlent l'initialisation d'un nouveau projet.</para ></listitem> <listitem ><para ><filename class="directory" >imports/</filename > — contient les modèles pour configurer les fichiers <filename >.desktop</filename > propres à un projet.</para ></listitem> <listitem ><para ><filename class="directory" >template-common/</filename > — contient divers fichiers communément inclus dans les dossiers des sources d'un projet.</para ></listitem> <listitem ><para ><filename class="directory" >templates/</filename > — contient les fichiers de configuration qui décrivent les informations à inclure dans le dossier des sources d'un projet.</para ></listitem> <listitem ><para ><filename >*.png</filename > — aperçus des images d'un projet utilisées par l'&appwizard;.</para ></listitem> <listitem ><para ><filename >*.tar.gz</filename > — archives tar contenant les fichiers source à inclure dans le dossier d'un projet nouvellement généré.</para ></listitem> </itemizedlist> </listitem> <listitem ><para ><filename class="directory" >kdevastyle/</filename > — fournit l'élément <guimenuitem >Reformater le source</guimenuitem > dans le menu <guimenu >Édition</guimenu >.</para ></listitem> <listitem ><para ><filename class="directory" >kdevautoproject/</filename > — fournit la plupart des éléments dans le menu <guimenu >Construire</guimenu > et la barre d'outils <guilabel >Barre d'outils de construction (&kdevelop;)</guilabel >.</para ></listitem> <listitem> <para ><filename class="directory" >kdevclassview/</filename > — contient les fichiers utilisés par le module externe de projet <guilabel >Afficheur de classes</guilabel >.</para> <itemizedlist> <listitem ><para ><filename class="directory" >pics/</filename > — contient les icônes utilisées dans l'arbre d'affichage des classes de <guilabel >Classes</guilabel >.</para ></listitem> <listitem ><para ><filename >kdevclassview.tc</filename > — fournit l'élément <guimenuitem >Diagramme d'héritage des classes</guimenuitem > dans le menu <guimenu >Projet</guimenu >, ainsi que la zone de liste modifiable de navigation des classes dans la <guilabel >Barre d'outils du navigateur</guilabel >.</para ></listitem> </itemizedlist> </listitem> <listitem ><para ><filename class="directory" >kdevcloser/</filename > — fournit les éléments de fermeture du menu <guimenu >Fenêtre</guimenu >.</para ></listitem> <listitem ><para ><filename class="directory" >kdevctags/</filename > — fournit l'élément<guimenuitem >CTags</guimenuitem > dans le menu <guimenu >Outils</guimenu > pour le module externe de projet <guilabel >Interface pour CTags</guilabel >.</para ></listitem> <listitem ><para ><filename class="directory" >kdevcvsservice/</filename > — fournit l'icône utilisée par l'onglet <guilabel >CvsService</guilabel > et un court script shell servant à ajouter un nouvel élément au référentiel &cvs;, l'un et l'autre étant utilisés par le module externe de projet <guilabel >Intégration de CVS</guilabel >.</para ></listitem> <listitem ><para ><filename class="directory" >kdevdebugger/</filename > — fournit les éléments du menu <guimenu >Déboguer</guimenu > pour le module externe de projet <guilabel >Interface du débogueur</guilabel >.</para ></listitem> <listitem ><para ><filename class="directory" >kdevdiff/</filename > — fournit l'élément <guimenuitem >Afficheur de différences</guimenuitem > dans le menu <guimenu >Outils</guimenu >.</para ></listitem> <listitem ><para ><filename class="directory" >kdevdistpart/</filename > — fournit l'élément <guimenuitem >Distribution et publication</guimenuitem > dans le menu <guimenu >Projet</guimenu > pour le module externe de projet <guilabel >Gestion finale du conditionnement en paquetages</guilabel >.</para ></listitem> <listitem id="app-files-default-kdevdoc"> <para ><filename class="directory" >kdevdocumentation/</filename > — contientles fichiers utilisés par le module externe <guilabel >Documentation</guilabel >.</para> <itemizedlist> <listitem ><para ><filename class="directory" >en/</filename > et <filename class="directory" >pics/</filename > — contiennent les fichiers utilisés par l'outil de recherche <application >htdig</application >.</para ></listitem> <listitem ><para ><filename class="directory" >tocs/</filename > — contient les fichiers de description du contenu de la documentation de &kdevelop; (reportez-vous à la description dans <link linkend="toc-file-structure" >Structure fondamentale des fichiers TOC de &kdevelop;</link >).</para ></listitem> <listitem ><para ><filename >kdevpart_documentation.rc</filename > — fournit les éléments relatifs aux recherches dans le menu <guimenu >Aide</guimenu >.</para ></listitem> </itemizedlist> </listitem> <listitem ><para ><filename class="directory" >kdevdoxygen/</filename > — fournit les éléments de menu pour le module externe <guilabel >Gestion de Doxygen</guilabel >.</para ></listitem> <listitem id="app-files-default-filecreate"> <para ><filename class="directory" >kdevfilecreate/</filename > — contient les fichiers utilisés par le <guilabel >Assistant de création d'un nouveau fichier</guilabel >. <itemizedlist> <listitem ><para ><filename class="directory" >file-templates/</filename > — fournit le contenu initial du texte à placer dans le nouveau fichier source d'un type donné.</para ></listitem> <listitem ><para ><filename >kdevpart_filecreate.rc</filename > — fournit l'élément <guimenuitem >Nouveau</guimenuitem > dans le menu <guimenu >Fichier</guimenu >.</para ></listitem> <listitem ><para ><filename >template-info.xml</filename > — contient les descriptions des types de fichiers disponibles à afficher dans la vue <guilabel >Nouveau fichier</guilabel >.</para ></listitem> </itemizedlist> </para ></listitem> <listitem ><para ><filename class="directory" >kdevfilter/</filename > — fournit les éléments <guimenuitem >Exécuter une commande...</guimenuitem > et <guimenuitem >Choix d'un filtre par une commande...</guimenuitem > dans le menu <guimenu >Outils</guimenu > utilisés par le module externe <guilabel >Filtrage et insertion dans le shell</guilabel >.</para ></listitem> <listitem ><para ><filename class="directory" >kdevfullscreen/</filename > — fournit l'élément <guimenuitem >Mode plein écran</guimenuitem > dans le menu <guimenu >Affichage</guimenu > et l'icône de barre d'outils correspondante.</para ></listitem> <listitem ><para ><filename class="directory" >kdevgrepview/</filename > — fournit l'élément <guimenuitem >Chercher dans les fichiers...</guimenuitem > dans le menu <guimenu >Édition</guimenu > utilisé par le module externe <guilabel >Interface pour Grep</guilabel >.</para ></listitem> <listitem ><para ><filename class="directory" >kdevhistory/</filename > — fournit les éléments <guimenuitem >Précédent</guimenuitem > et <guimenuitem >Suivant</guimenuitem > dans le menu <guimenu >Affichage</guimenu >.</para ></listitem> <listitem ><para ><filename class="directory" >kdevjavadebugger/</filename > — fournit un menu <guimenu >Débogueur JAVA</guimenu > afin de déboguer une application &Java;.</para ></listitem> <listitem ><para ><filename class="directory" >kdevoutputviews/</filename > — fournit les éléments <guimenuitem >Erreur suivante</guimenuitem > et <guimenuitem >Erreur précédente</guimenuitem > dans le menu <guimenu >Affichage</guimenu >.</para ></listitem> <listitem ><para ><filename class="directory" >kdevpartexplorer/</filename > — fournit l'élément <guimenuitem >Afficheur de composants logiciels</guimenuitem > dans le menu <guimenu >Outils</guimenu > utilisé par le module externe <guilabel >Outil d'exploration des composants</guilabel >.</para ></listitem> <listitem ><para ><filename class="directory" >kdevquickopen/</filename > — fournit l'élément <guimenuitem >Quick Open File..</guimenuitem > dans le menu <guimenu >Fichier</guimenu > ainsi que les éléments <guimenuitem >Ouverture rapide de classe...</guimenuitem > et <guimenuitem >Ouverture rapide de méthode...</guimenuitem > dans le menu <guimenu >Outils</guimenu > utilisé par le module externe de projet <guilabel >Ouverture rapide</guilabel >.</para ></listitem> <listitem ><para ><filename class="directory" >kdevregexptest/</filename > — fournit l'élément <guimenuitem >Déboguer l'expression rationnelle...</guimenuitem > dans le menu <guimenu >Outils</guimenu > utilisé par le module externe <guilabel >Débogueur d'expressions rationnelles</guilabel >.</para ></listitem> <listitem ><para ><filename class="directory" >kdevreplace/</filename > — fournit l'élément <guimenuitem >Rechercher / Sélectionner / Remplacer...</guimenuitem > dans le menu <guimenu >Édition</guimenu > utilisé par le module externe <guilabel >Outil de remplacement</guilabel >.</para ></listitem> <listitem id="app-files-default-tips" ><para ><filename class="directory" >kdevtipofday/</filename > — fournit l'élément <guimenuitem >Astuce du jour</guimenuitem > dans le menu <guimenu >Aide</guimenu >, ainsi qu'un fichier HTML contenant les astuces disponibles.</para ></listitem> <listitem ><para ><filename class="directory" >kdevtools/</filename > — contrôle divers éléments de menu créés par les réglages du menu <guimenu >Outils</guimenu > et du menu <guilabel >Outils externes</guilabel > fournis par le module externe <guilabel >Suppléments au menu « Outils »</guilabel >.</para ></listitem> <listitem ><para ><filename class="directory" >kdevvalgrind/</filename > — fournit les éléments <guimenuitem >Vérification des pertes de mémoire avec « Valgrind »</guimenuitem > et <guimenuitem >Profiler avec KCachegrind</guimenuitem > dans le menu <guimenu >Déboguer</guimenu > utilisés par le module externe <guilabel >Interface Valgrind</guilabel >.</para ></listitem> </itemizedlist ></listitem> <listitem ><itemizedlist id="app-files-default-apps-project"> <title >Composants de génération de projet</title> <listitem ><para ><filename class="directory" >kdevadaproject/</filename > — fournit les éléments pour le menu <guimenu >Construire</guimenu > et les icônes de barre d'outils correspondantes pour construire une application en Ada.</para ></listitem> <listitem ><para ><filename class="directory" >kdevantproject/</filename > — fournit les éléments pour le menu <guimenu >Construire</guimenu > lors de l'emploi du générateur de projet Ant.</para ></listitem> <listitem ><para ><filename class="directory" >kdevautoproject/</filename > — fournit les éléments pour le menu <guimenu >Construire</guimenu > et les icônes de barre d'outils correspondantes quand il fonctionne avec les outils &GNU; basés sur le générateur de projet &automake;. Fournit en outre les éléments <guimenuitem >Ajouter une traduction...</guimenuitem > et <guimenuitem >Configuration de compilation</guimenuitem > au menu <guimenu >Projet</guimenu >.</para ></listitem> <listitem ><para ><filename class="directory" >kdevcustomproject/</filename > — fournit les éléments pour le menu <guimenu >Construire</guimenu > et les icônes de barre d'outils correspondantes quand le projet est basé sur des Makefiles personnalisés.</para ></listitem> <listitem ><para ><filename class="directory" >kdevgenericproject/</filename > — contient des définitions de menu pour un générateur de projet générique expérimental. Non utilisé actuellement (version 3.1.0).</para ></listitem> <listitem ><para ><filename class="directory" >kdevhaskellproject/</filename > — fournit les éléments pour le menu <guimenu >Construire</guimenu > et les icônes de barre d'outils correspondantes pour construire une application en Haskell.</para ></listitem> <listitem ><para ><filename class="directory" >kdevpascalproject/</filename > — fournit les éléments pour le menu <guimenu >Construire</guimenu > et les icônes de barre d'outils correspondantes pour construire une application en Pascal.</para ></listitem> <listitem ><para ><filename class="directory" >kdevtrollproject/</filename > — fournit les éléments pour le menu <guimenu >Construire</guimenu > et les icônes de barre d'outils correspondantes pour construire une application utilisant le gestionnaire de projet QMake de &Qt;.</para ></listitem> </itemizedlist ></listitem> <listitem ><itemizedlist id="app-files-default-apps-lang"> <title >Composants propres à un langage</title> <listitem ><para ><filename class="directory" >kdevadasupport/</filename > — fournit les éléments dans le menu <guimenu >Outils</guimenu > et les icônes de barre d'outils correspondantes nécessaires pour développer des applications en Ada.</para ></listitem> <listitem ><para ><filename class="directory" >kdevbashsupport/</filename > — fournit les éléments dans le menu <guimenu >Construire</guimenu > et les icônes de barre d'outils correspondantes nécessaires pour développer des scripts Bash.</para ></listitem> <listitem id="app-files-default-apps-lang-cpp"> <para ><filename class="directory" >kdevcppsupport/</filename > — contient les fichiers utilisés par l'&appwizard; pour construire des applications en C++.</para> <itemizedlist> <listitem ><para ><filename class="directory" >newclass/</filename > — contient les modèles d'en-têtes et de sources à partir desquels l'&appwizard; construit les fichiers sources correspondants.</para ></listitem> <listitem ><para ><filename class="directory" >subclassing/</filename > — contient les modèles que l'&appwizard; utilise pour configurer les déclarations et définitions de classes initiales dans les fichiers sources.</para ></listitem> <listitem ><para ><filename class="directory" >templates</filename > — contient les modèles à partir desquels l'&appwizard; configure les modèles de fichiers d'en-tête et source par défaut que l'&nfwizard; utilise. </para ></listitem> <listitem ><para ><filename >configuration</filename > — modèle factice pour ajouter des macros.</para ></listitem> <listitem ><para ><filename >kdevcppsupport.rc</filename > — fournit les éléments <guimenuitem >Compléter le texte</guimenuitem > et <guimenuitem >Ajouter un membre</guimenuitem > pour le menu <guimenu >Édition</guimenu >, l'élément <guimenuitem >Basculer entre la déclaration / l'implémentation</guimenuitem > pour le menu <guimenu >Affichage</guimenu > et l'élément <guimenuitem >Nouvelle classe</guimenuitem > pour le menu <guimenu >Projet</guimenu >, ainsi qu'une icône <guiicon >Nouvelle classe</guiicon > pour la <guilabel >Barre d'outils du navigateur</guilabel >.</para ></listitem> </itemizedlist> </listitem> <listitem ><para ><filename class="directory" >kdevfortransupport/</filename > — fournit des éléments dans le menu <guimenu >Construire</guimenu > nécessaires pour développer des applications en Fortran.</para ></listitem> <listitem ><para ><filename class="directory" >kdevhaskellsupport/</filename > — fournit les éléments dans le menu <guimenu >Construire</guimenu > et les icônes de barre d'outils correspondantes nécessaires pour développer des applications en Haskell.</para ></listitem> <listitem ><para ><filename class="directory" >kdevjavasupport/</filename > — contient la définition d'interface utilisateur nécessaire pour développer des applications en &Java;.</para ></listitem> <listitem ><para ><filename class="directory" >kdevpascalsupport/</filename > — contient la définition d'interface utilisateur nécessaire pour développer des applications en Pascal.</para ></listitem> <listitem ><para ><filename class="directory" >kdevperlsupport/</filename > — fournit les éléments de menu <guimenu >Projet</guimenu > et <guimenu >Aide</guimenu > nécessaires pour développer des scripts en Perl.</para ></listitem> <listitem ><para ><filename class="directory" >kdevphpsupport/</filename > — contient les fichiers de définition d'interface utilisateur et de fonctions PHP nécessaires pour développer des scripts en PHP.</para ></listitem> <listitem ><para ><filename class="directory" >kdevpythonsupport/</filename > — fournit les éléments de menu <guimenu >Construire</guimenu > et <guimenu >Aide</guimenu > et les icônes de barre d'outils correspondantes nécessaires pour développer des scripts en Python.</para ></listitem> <listitem ><para ><filename class="directory" >kdevrubysupport/</filename > — fournit les éléments de menu <guimenu >Construire</guimenu > et les icônes de barre d'outils correspondantes nécessaires pour développer des scripts en Ruby.</para ></listitem> <listitem ><para ><filename class="directory" >kdevscriptproject/</filename > — fournit les définitions d'interface utilisateur nécessaires pour développer des projets personnalisés. Non utilisé actuellement (version 3.1.0).</para ></listitem> <listitem ><para ><filename class="directory" >kdevsqlsupport/</filename > — fournit les définitions d'interface utilisateur nécessaires pour développer des projets en SQL. Non utilisé actuellement (version 3.1.0).</para ></listitem> </itemizedlist ></listitem> </itemizedlist> </sect2 > <!-- app-files-default-apps --> </sect1 > <!-- app-files-default --> <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> <sect1 id="app-files-user"> <title >Configuration orientée utilisateur</title> <para >Toutes les informations sur les réglages définis par l'utilisateur sont conservées dans deux sous-dossiers de <filename class="directory" >$<envar >KDEHOME</envar ></filename >, à savoir : <simplelist> <member ><link linkend="app-files-user-apps" >Configuration propre à une application</link > dans le dossier <filename class="directory" >$<envar >KDEHOME</envar >/share/apps/</filename > et</member> <member ><link linkend="app-files-user-config" >Fichier de configuration des ressources</link > dans le dossier <filename class="directory" >$<envar >KDEHOME</envar >/share/config/</filename >.</member> </simplelist> </para> <sect2 id="app-files-user-apps"> <title >Configuration propre à une application</title> <para >Tout changement par l'utilisateur apporté aux réglages dans la <link linkend="app-files-default" >configuration par défaut de &kdevelop;</link > aussi bien que les réglages propres à l'utilisateur, qui ne sont conservés dans aucun des <link linkend="app-files-user-config" >fichiers de configuration des ressources</link > se trouvent dans les sous-dossiers <filename >kdev...</filename > du dossier <filename class="directory" >$<envar >KDEHOME</envar >/share/apps/</filename >. </para> <para >La plupart de ces fichiers de configuration est cependant utilisée par divers modules externes de &kdevelop; pour pouvoir fournir certains éléments spécifiques de menu et/ou de barre d'outils. Par conséquent, ils n'ont d'intérêt qu'au cas où il y aurait un gros problème avec l'interface utilisateur. </para> <note ><para >Au cas où le contenu des dossiers reflète celui des réglages de la configuration par défaut, &kdevelop; les aura copiés depuis <filename class="directory" >$<envar >KDEDIR</envar >/apps/</filename > dans le dossier <filename class="directory" >$<envar >KDEHOME</envar >/apps/</filename > lors de son démarrage initial. Tout changement postérieur sera effectué sur ces copies uniquement. Les réglages de la configuration par défaut restent inchangés de toute façons. </para ></note> <itemizedlist> <listitem> <para ><filename class="directory" >kdevabbrev/</filename > — contient les fichiers utilisés par le module externe <guilabel >Complétement automatique</guilabel >.</para> <itemizedlist> <listitem ><para ><filename class="directory" >sources/</filename > — actuellement vide ; &kdevelop; utilise les fichiers de <link linkend="app-files-default-abbrev" >définition par défaut des mots-clés</link > pour la commande <guilabel >Développer le texte</guilabel >.</para ></listitem> <listitem ><para ><filename class="directory" >templates/</filename > — contient les modèles des fichiers de définition utilisés par la commande <guilabel >Compléter automatiquement</guilabel >.</para ></listitem> <listitem ><para ><filename >kdevabbrev.rc</filename > — fournit les éléments <guimenuitem >Développer le texte</guimenuitem > et <guimenuitem >Compléter automatiquement</guimenuitem > dans le menu <guimenu >Édition</guimenu >.</para ></listitem> </itemizedlist > </listitem> <listitem> <para ><filename class="directory" >kdevappwizard/</filename > — ne fournit que les éléments <guimenuitem >Nouveau projet...</guimenuitem > et <guimenuitem >Importer un projet existant...</guimenuitem > dans le menu <guimenu >Projet</guimenu >. L'&appwizard; utilisera les <link linkend="app-files-default-appwizard" >réglages par défaut de la configuration</link > pour son fonctionnement réel.</para> </listitem> <listitem> <para ><filename class="directory" >kdevastyle/</filename > — fournit l'élément <guimenuitem >Reformater le code source</guimenuitem > réel dans le menu <guimenu >Édition</guimenu >.</para> </listitem> <listitem> <para ><filename class="directory" >kdevautoproject/</filename > — fournit les éléments réels dans le menu <guimenu >Construire</guimenu > et la barre d'outils <guilabel >Barre d'outils de construction (KDevelop)</guilabel >.</para> </listitem> <listitem> <para ><filename class="directory" >kdevclassview/</filename > — fournit l'élément <guimenuitem >Diagramme d'héritage des classes</guimenuitem > dans le menu <guimenu >Projet</guimenu > ainsi que la zone de liste modifiable du navigateur de classes dans la <guilabel >Barre d'outils du navigateur</guilabel >par le module externe de projet <guilabel >Afficheur de classes</guilabel >.</para> </listitem> <listitem> <para ><filename class="directory" >kdevcloser/</filename > — fournit l'élément <guimenuitem >Fermer les fenêtres sélectionnées...</guimenuitem > dans le menu <guimenu >Fenêtre</guimenu >.</para> </listitem> <listitem> <para ><filename class="directory" >kdevcppsupport/</filename > — contient la configuration réelle utilisée par l'&appwizard; pour construire des applications en C++. L'&appwizard;, cependant, emploie sa principale masse d'informations de configuration information directement depuis le <link linkend="app-files-default-apps-lang-cpp" >dossier de configuration par défaut</link >. Veuillez vous y reporter pour plus de détail.</para> <itemizedlist> <listitem> <para ><filename class="directory" >newclass/</filename > — contient les modèles d'en-têtes et de sources à partir desquels l'&appwizard; construit les fichiers source correspondants.</para> </listitem> <listitem> <para ><filename class="directory" >pcs/</filename > — contient les fichiers de base de données dont &kdevelop; se sert pour construire le fichier « Persistent Code Store » (<filename >.pcs</filename >) d'un projet &kde; en C++.</para> </listitem> <listitem> <para ><filename >kdevcppsupport.rc</filename > — fournit les éléments <guimenuitem >Compléter le texte</guimenuitem > et <guimenuitem >Ajouter un membre</guimenuitem > pour le menu <guimenu >Édition</guimenu >, l'élément <guimenuitem >Basculer entre la déclaration / l'implémentation</guimenuitem > pour le menu <guimenu >Affichage</guimenu > et l'élément <guimenuitem >Nouvelle classe</guimenuitem > pour le menu <guimenu >Projet</guimenu >, ainsi qu'une icône <guiicon >Nouvelle classe</guiicon > pour la <guilabel >Barre d'outils du navigateur</guilabel >.</para> </listitem> </itemizedlist> </listitem> <listitem> <para ><filename class="directory" >kdevctags/</filename > — fournit l'élément<guimenuitem >CTags</guimenuitem > dans le menu <guimenu >Outils</guimenu > pour le module externe de projet <guilabel >Interface pour CTags</guilabel >.</para> </listitem> <listitem> <para ><filename class="directory" >kdevdebugger/</filename > — fournit les éléments du menu <guimenu >Déboguer</guimenu > pour le module externe de projet <guilabel >Interface du débogueur</guilabel >.</para> </listitem> <listitem> <para ><filename class="directory" >kdevdiff/</filename > — fournit l'élément <guimenuitem >Afficheur de différences</guimenuitem > dans le menu <guimenu >Outils</guimenu >.</para> </listitem> <listitem> <para ><filename class="directory" >kdevdocumentation/</filename > — contient les fichiers réels que le module externe <guilabel >Documentation</guilabel > utilise en plus des <link linkend="app-files-default-kdevdoc" >fichiers de configuration par défaut</link >. Reportez-vous à celui-ci pour plus de détail.</para> <para >Les dossiers de <filename class="directory" >kdevdocumentation/</filename > contiennent surtout des informations comptables à proprement parler. Les fichiers de documentation réellement configurés sont conservés dans les fichiers <link linkend="app-files-user-config-doc" > « <filename >doc...pluginrc</filename > »</link > dans le dossier <filename class="directory" >$<envar >KDEHOME</envar >/share/config/</filename >.</para> <itemizedlist> <listitem> <para ><filename class="directory" >bookmarks/</filename > — maintient les éléments dans l'onglet <guilabel >Signets</guilabel > du module externe <guilabel >Documentation</guilabel > de &kdevelop;.</para> </listitem> <listitem> <para ><filename class="directory" >index/</filename > — contient divers fichiers de cache que &kdevelop; utilise pour accélérer les recherches de documentation indexée dans l'onglet <guilabel >Index</guilabel > du module externe <guilabel >Documentation</guilabel >.</para> </listitem> <listitem> <para ><filename class="directory" >search/</filename > — contient les fichiers utilisés par l'outil de recherche <application >htdig</application > qui prend en charge les appels de recherche depuis l'onglet <guilabel >Recherche</guilabel > du module externe <guilabel >Documentation</guilabel >.</para> </listitem> <listitem> <para ><filename >kdevpart_documentation.rc</filename > — fournit les éléments relatifs aux recherches dans le menu <guimenu >Aide</guimenu >.</para> </listitem> </itemizedlist> </listitem> <listitem> <para ><filename class="directory" >kdevdoxygen/</filename > — fournit les éléments de menu pour le module externe <guilabel >Gestion de Doxygen</guilabel >.</para> </listitem> <listitem> <para ><filename class="directory" >kdevelop/</filename > — contient certains réglages effectifs que &kdevelop; emploie pour sa configuration de base.</para> <itemizedlist> <listitem ><para ><filename class="directory" >profiles/</filename > — fournit un paramétrage réel de profil de module externe. (Initialement, il n'y a qu'un profil <filename >FullIDE</filename > qui définit un ensemble complet de modules externes &kdevelop; actifs.)</para ></listitem> <listitem ><para ><filename >kdevelopui.rc</filename > — fournit les éléments de menu et de barre d'outils de base que &kdevelop; utilise.</para ></listitem> </itemizedlist> </listitem> <listitem> <para ><filename class="directory" >kdevfilecreate/</filename > — contient les fichiers utilisés par le <guilabel >Assistant de création d'un nouveau fichier</guilabel >.</para> <itemizedlist> <listitem ><para ><filename class="directory" >file-templates/</filename > — fournit le contenu du texte réellement utilisé à placer dans le nouveau fichier source d'un type donné. Vous trouverez d''autres modèles de fichiers dans le dossier des <link linkend="app-files-default-filecreate" >fichiers de configuration par défaut</link >.</para ></listitem> <listitem ><para ><filename >kdevpart_filecreate.rc</filename > — fournit l'élément <guimenuitem >Nouveau</guimenuitem > dans le menu <guimenu >Fichier</guimenu >.</para ></listitem> <listitem ><para ><filename >template-info.xml</filename > — contient les descriptions des types de fichiers disponibles à afficher dans la vue <guilabel >Nouveau fichier</guilabel >.</para ></listitem> </itemizedlist> </listitem> <listitem> <para ><filename class="directory" >kdevfilter/</filename > — fournit les éléments <guimenuitem >Exécuter une commande...</guimenuitem > et <guimenuitem >Choix d'un filtre par une commande...</guimenuitem > dans le menu <guimenu >Outils</guimenu > utilisés par le module externe <guilabel >Filtrage et insertion dans le shell</guilabel >.</para> </listitem> <listitem> <para ><filename class="directory" >kdevfullscreen/</filename > — fournit l'élément <guimenuitem >Mode plein écran</guimenuitem > dans le menu <guimenu >Affichage</guimenu > et l'icône de barre d'outils correspondante.</para> </listitem> <listitem> <para ><filename class="directory" >kdevgrepview/</filename > — fournit l'élément <guimenuitem >Chercher dans les fichiers...</guimenuitem > dans le menu <guimenu >Édition</guimenu > utilisé par le module externe <guilabel >Interface pour Grep</guilabel >.</para> </listitem> <listitem> <para ><filename class="directory" >kdevoutputviews/</filename > — fournit les éléments <guimenuitem >Erreur suivante</guimenuitem > et <guimenuitem >Erreur précédente</guimenuitem > dans le menu <guimenu >Affichage</guimenu >.</para> </listitem> <listitem> <para ><filename class="directory" >kdevpartexplorer/</filename > — fournit l'élément <guimenuitem >Afficheur de composants logiciels</guimenuitem > dans le menu <guimenu >Outils</guimenu > utilisé par le module externe <guilabel >Outil d'exploration des composants</guilabel >.</para> </listitem> <listitem> <para ><filename class="directory" >kdevquickopen/</filename > — fournit l'élément <guimenuitem >Quick Open File..</guimenuitem > dans le menu <guimenu >Fichier</guimenu > ainsi que les éléments <guimenuitem >Ouverture rapide de classe...</guimenuitem > et <guimenuitem >Ouverture rapide de méthode...</guimenuitem > dans le menu <guimenu >Outils</guimenu > utilisé par le module externe de projet <guilabel >Ouverture rapide</guilabel >.</para> </listitem> <listitem> <para ><filename class="directory" >kdevregexptest/</filename > — fournit l'élément <guimenuitem >Déboguer l'expression rationnelle...</guimenuitem > dans le menu <guimenu >Outils</guimenu > utilisé par le module externe <guilabel >Débogueur d'expressions rationnelles</guilabel >.</para> </listitem> <listitem> <para ><filename class="directory" >kdevreplace/</filename > — fournit l'élément <guimenuitem >Rechercher / Sélectionner / Remplacer...</guimenuitem > dans le menu <guimenu >Édition</guimenu > utilisé par le module externe <guilabel >Outil de remplacement</guilabel >.</para> </listitem> <listitem> <para ><filename class="directory" >kdevtipofday/</filename > — fournit l'élément <guimenuitem >Astuce du jour</guimenuitem > dans le menu <guimenu >Aide</guimenu >. Le fichier HTML contenant les astuces disponibles est fourni à titre de <link linkend="app-files-default-tips" >fichier de configuration par défaut</link > seulement.</para> </listitem> <listitem> <para ><filename class="directory" >kdevtools/</filename > — contrôle divers éléments de menu créés par les réglages du menu <guimenu >Outils</guimenu > et du menu <guilabel >Outils externes</guilabel > fournis par le module externe <guilabel >Suppléments au menu « Outils »</guilabel >.</para> </listitem> <listitem> <para ><filename class="directory" >kdevvalgrind/</filename > — fournit les éléments <guimenuitem >Vérification des pertes de mémoire avec « Valgrind »</guimenuitem > et <guimenuitem >Profiler avec KCachegrind</guimenuitem > dans le menu <guimenu >Déboguer</guimenu > utilisés par le module externe <guilabel >Interface Valgrind</guilabel >.</para> </listitem> </itemizedlist> </sect2 > <!-- app-files-user-apps --> <sect2 id="app-files-user-config"> <title >Fichier de configuration des ressources</title> <para >Ce sont deux groupes de fichiers de configuration de &kdevelop; dans le dossier <filename class="directory" >$<envar >KDEHOME</envar >/share/config/</filename >, distingués par les séquences de caractères qui les entourent. <simplelist> <member >« <filename >doc...pluginrc</filename > » désigne les fichiers <link linkend="app-files-user-config-doc" >utilisés par le module externe de documentation</link >.</member> <member >« <filename >kdev...rc</filename > » désigne les fichiers de configuration <link linkend="app-files-user-config-kdev" >utilisés par &kdevelop;</link > lui-même et ses modules externes disponibles.</member> </simplelist> </para> <itemizedlist id="app-files-user-config-kdev"> <title >Fichiers de configuration utilisés par &kdevelop;</title> <listitem> <para ><filename >kdevabbrevrc</filename > — contient l'état actuel de la configuration des <guilabel >Abréviations</guilabel > fournie par le module externe <guilabel >Complétement automatique</guilabel >.</para> <note ><para >Celui-ci enregistre si les abréviations seront utilisées ou non. Les définitions réelles des nouvelles abréviations iront dans le fichier <filename >$<envar >KDEHOME</envar >/share/apps/kdevabbrev/templates/templates</filename >.</para ></note> </listitem> <listitem> <para ><filename >kdevassistantrc</filename > — contient quelques états de configuration propres au navigateur autonome de documentation de l'assistant de &kdevelop;.</para> <note ><para >La plupart des réglages de configuration courants sont partagés avec le fichier <filename >kdeveloprc</filename > de l'EDI &kdevelop;.</para ></note> </listitem> <listitem ><para ><filename >kdevassistantuimode4rc</filename > — contient les états de configuration MDI courants (positions d'incrustation, &etc;) du navigateur autonome de documentation de l'assistant de &kdevelop;.</para ></listitem> <listitem> <para ><filename >kdevclassviewrc</filename > — contient le réglage <guilabel >Mode d'affichage</guilabel > de l'onglet du navigateur de classes <guilabel >Classes</guilabel > fourni par le module externe de projet <guilabel >Afficheur de classes</guilabel >.</para> <note ><para >C'est un réglage global, bien que le module externe <guilabel >Afficheur de classes</guilabel > puisse être désactivé projet par projet. Tout changement dans ce réglage sera mis à jour de façon globale chaque fois que le projet actuel est fermé et affectera ainsi tous les projets chargés ultérieurement.</para ></note> </listitem> <listitem ><para ><filename >kdevcppsupportrc</filename > — contient quelques réglages utilisés pour configurer les fichiers source CPP. En particulier, vous y trouverez les réglages effectués sur la boîte de dialogue de configuration du <guilabel >Générateur de classes C++</guilabel >.</para ></listitem> <listitem ><para ><filename >kdevdocumentationrc</filename > — contient les réglages réels que le module externe <guilabel >Documentation</guilabel > utilise.</para ></listitem> <listitem ><para ><filename >kdeveloprc</filename > — contient les réglages globaux que le l'EDI &kdevelop; et le navigateur autonome de documentation de l'assistant de &kdevelop; utiliseront.</para ></listitem> <listitem ><para ><filename >kdevelopuimode4rc</filename > — contient les états de configuration MDI actuels (positions d'ancrage, &etc;) de l'EDI &kdevelop;.</para ></listitem> <listitem ><para ><filename >kdevfileselectorrc</filename > — contient les réglages réels que le module externe <guilabel >Sélecteur de fichiers</guilabel > utilise.</para ></listitem> <listitem ><para ><filename >kdevfileviewrc</filename > — contient les réglages de couleur des noms de fichiers que le module externe de projet <guilabel >Intégration de CVS (Cervisia)</guilabel > utilise pour l'affichage.</para ></listitem> <listitem ><para ><filename >kdevfilterrc</filename > — contient les réglages réels que le module externe <guilabel >Filtrage et insertion dans le shell</guilabel > utilise.</para ></listitem> <listitem ><para ><filename >kdevgrepviewrc</filename > — contient les réglages réels que le module externe <guilabel >Interface pour Grep</guilabel > utilise.</para ></listitem> <listitem ><para ><filename >kdevsnippetrc</filename > — contient les réglages réels que le module externe <guilabel >Fragments de code</guilabel > utilise.</para ></listitem> <listitem ><para ><filename >kdevtoolsrc</filename > — contient les réglages réels que le module externe <guilabel >Suppléments au menu « Outils »</guilabel > utilise.</para ></listitem> </itemizedlist> <itemizedlist id="app-files-user-config-doc"> <title >Fichiers de configuration utilisés par le module externe Documentation</title> <listitem ><para ><filename >docchmpluginrc</filename > — contient des informations sur les fichiers d'aide CHM de &Microsoft;, comme défini sur la page de configuration <guilabel >Collection de documentation CHM</guilabel >.</para ></listitem> <listitem ><para ><filename >doccustompluginrc</filename > — contient des informations sur tout fichier de documentation personnalisé défini sur la page de configuration <guilabel >Collection de documentation personnalisée</guilabel >.</para ></listitem> <listitem ><para ><filename >docdevhelppluginrc</filename > — contient des informations sur les fichiers de documentation réels DevHelp de GNOME 2, comme défini sur la page de configuration <guilabel >Collection de documentation DevHelp</guilabel >.</para ></listitem> <listitem ><para ><filename >docdoxygenpluginrc</filename > — contient des informations sur les fichiers de documentation de l'API générée par Doxygen, comme défini sur la page de configuration <guilabel >Collection de documentation Doxygen</guilabel >.</para ></listitem> <listitem ><para ><filename >dockdevtocpluginrc</filename > — contient des informations sur les fichiers réels de documentation structurée KDevelopTOC, comme défini sur la page de configuration <guilabel >Collection de documentation KDevelopTOC</guilabel >.</para ></listitem> <listitem ><para ><filename >docqtpluginrc</filename > — contient des informations sur les fichiers de documentation QT inclus réellement sur la page de configuration <guilabel >Collection de documentation QT</guilabel >.</para ></listitem> </itemizedlist> </sect2 > <!-- app-files-user-config --> </sect1 > <!-- app-files-user --> <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - --> <sect1 id="app-files-project"> <title >Configuration dépendante d'un projet</title> <para >La plus grande partie de la configuration dépendante d'un projet est conservée dans les fichiers de configuration de projet de &kdevelop; <filename ><nom-projet>.kdevelop</filename > et <filename ><nom-projet>.kdevses</filename >, plutôt que dans des fichiers séparés comme les autres réglages de configuration, plus globaux. En bref, ces fichiers sont prévus pour : </para> <simplelist> <member ><filename ><nom-projet>.kdevelop</filename > — informations de configuration globales du projet.</member> <member ><filename ><nom-projet>.kdevses</filename > — informations de configuration nécessaires pour rétablir les comportements spécifiques de la session en cours.</member> </simplelist> <para >Ces deux fichiers sont codés en &XML;. Vous pouvez les afficher et les modifier (avec précaution) à l'aide de n'importe quel éditeur de texte. </para> <sect2> <title >Fichiers « Persistent Code Store »</title> <para >Il y a un troisième fichier de configuration dépendant d'un projet, le <filename ><project-name>.kdevelop.pcs</filename > Persistant Code Store. C'est un fichier binaire codé contenant un cache d'analyse interne pour la plus grande partie, afin d'accélérer la séquence de chargement du projet. De plus, ce « Persistant Code Store » conserve les informations utilisées par la fonction <guilabel >Complétement du code</guilabel > de &kdevelop;. </para> <note ><para >Des fichiers « Persistant Code Store » additionnels peuvent être configurés sur l'onglet <guilabel >Complétement du code</guilabel > de la page de configuration de projet <guilabel >Spécifique au C++</guilabel >. Des informations sur ces <filename >.pcs</filename > additionnels sont conservées globalement dans le dossier <filename class="directory" >$<envar >KDEHOME</envar >/share/apps/kdevcppsupport/pcs/</filename >. </para ></note> </sect2> </sect1 > <!-- app-files-project --> </appendix > <!-- app-files -->