<para>&kwrite; est plus qu'un éditeur pour le Bureau &kde;. Destiné à être un éditeur pour le développeur, il peut être considéré comme au moins une alternative partielle à des éditeurs plus puissants. Il est très performant en association avec &konqueror; pour parcourir des fichiers source pour différents langages. &kwrite; est également performant comme simple éditeur de texte. Une des fonctionnalités principales de &kwrite; est la coloration syntaxique, personnalisée pour de nombreux langages de programmation différents tels que: C/C++, &Java;, Python, Perl, Bash, Modula2, <acronym>HTML</acronym> et Ada. </para>
<para>&kwrite; utilise le protocole de glisser-déposer de &kde;. On peut faire un glisser-déposer des fichiers dans &kwrite; depuis le bureau, &konqueror; ou n'importe quel site &FTP; distant ouvert dans une des fenêtres de &konqueror;. </para>
<para>Même si &kwrite; peut être le plus souvent lancé depuis le menu des programmes de &kde; ou d'une icône placée sur le bureau, il est également possible de l'ouvrir à l'invite de la ligne de commande d'une fenêtre de terminal. Il existe quelques options utiles qui sont disponibles dans ce cas. </para>
<para>En spécifiant le chemin et le nom d'un fichier particulier, l'utilisateur peut ouvrir (ou créer) ce fichier immédiatement au démarrage. Voici un exemple:</para>
<title>Spécifier un fichier sur l'Internet</title>
<para>La méthode décrite ci-dessus peut même être utilisée pour ouvrir des fichiers sur l'Internet (si l'utilisateur a une connexion active à ce moment). Voici un exemple:</para>
<listitem><para>Liste les informations de version pour &Qt;, &kde; et &kwrite;. Cette option est également disponible avec <userinput><command>kwrite</command><option>-V</option></userinput>. </para></listitem>
<listitem><para>Veille à ce que &kwrite; lise le contenu du document à partir de l'entrée standard (STDIN). Cette option est similaire à l'option commune <option>-</option> utilisée dans de nombreux programmes en ligne de commande et permet de redirigier la sortie de la commande dans &kwrite;.</para></listitem>
<para>Beaucoup des raccourcis clavier sont configurables par le biais du menu <link linkend="settings">Configuration</link>. Par défaut, &kwrite; gère les raccourcis clavier suivants:</para>
<entry><para>Basculer entre le mode insertion et écrasement. En mode insertion, l'éditeur ajoute au texte tout caractère saisi et pousse à droite du curseur tout caractère saisi précédemment. Le mode écrasement veille à ce que la saisie de chaque caractère élimine le caractère actuel.</para></entry>
<para>Démarre un nouveau document dans l'éditeur. S'il y a un document en cours comportant des changements non enregistrés, l'utilisateur aura alors la possibilité de les enregistrer. </para>
<para>Affiche une boîte de dialogue <guilabel>Ouvrir un document</guilabel> &kde; standard. Utilisez l'affichage des fichiers pour choisir le fichier à ouvrir et cliquez sur <guibutton>Ouvrir</guibutton>. Vous trouverez plus d'informations sur la boîte de dialogue <guilabel>Ouvrir un document</guilabel> de &kde; dans le Guide utilisateur de &kde;.</para>
<para>Raccourci pour ouvrir les documents récemment enregistrés. En cliquant sur cet élément, on fait apparaître sur le côté du menu une liste contenant les fichiers enregistrés le plus récemment. Un clic sur un fichier donné l'ouvrira dans &kwrite; — si le fichier réside toujours au même endroit. </para>
<para>Enregistre le document actuel. S'il y a déjà eu un enregistrement du document, cette commande écrasera le fichier précédemment enregistré sans demander le consentement de l'utilisateur. S'il s'agit du premier enregistrement d'un nouveau document, la boîte de dialogue «Enregistrer sous» (décrite ci-après) sera invoquée. </para>
<para>Permet d'enregistrer un document sous un nouveau nom. Cette opération est effectuée au moyen de la boîte de dialogue décrite ci-dessus dans la section <link linkend="open">Ouvrir</link> de ce fichier d'aide. </para>
<para>Recharge le fichier actif depuis le disque. Cette commande est utile si un autre programme ou processus a modifié le fichier pendant qu'il est ouvert dans &kwrite;. </para>
<para>Ouvre une boîte de dialogue d'impression simple permettant à l'utilisateur de spécifier ce qu'il souhaite imprimer, où et comment le faire. </para>
<para>Fermez le fichier actif avec cette commande. Si vous avez effectué des changements non enregistrés, vous serez invité à enregistrer le fichier avant que &kwrite; ne le ferme. </para>
<para>Ferme la fenêtre de l'éditeur. Si vous avez plus d'une instance de &kwrite; en cours d'exécution, avec les éléments de menu <guimenuitem>Nouvelle vue</guimenuitem> ou <guimenuitem>Nouvelle fenêtre</guimenuitem>, ces instances ne seront pas fermées. </para>
<para>Supprime la sélection actuelle et la place dans le presse-papiers. Le presse-papiers est une fonctionnalité de &kde; qui opère de manière invisible pour fournir un moyen de transférer des données entre applications.</para>
<para>Copie le texte actuellement sélectionné dans le presse-papiers de façon à ce qu'il puisse être collé ailleurs. Le presse-papiers est une fonctionnalité de &kde; qui opère de manière invisible pour offrir un moyen de transférer des données entre applications.</para>
<para>Insère le contenu du presse-papiers à la position du curseur. Le presse-papiers est une fonctionnalité de &kde; qui opère de manière invisible pour offrir un moyen de transférer des données entre applications.</para>
<term><anchor id="block-selection-mode"/><menuchoice><shortcut> <keycombo action="simul">&Ctrl;&Maj;<keycap>B</keycap></keycombo> </shortcut> <guimenu>Édition</guimenu><guimenuitem>Mode de sélection par bloc</guimenuitem></menuchoice></term>
<para>(Dés)Active le mode de sélection. Lorsque le mode de sélection est «BLOC», vous pouvez effectuer des sélections verticales c'est-à-dire sélectionner les colonnes5 à 10 des lignes9 à 15. La barre d'état montre l'état actuel du mode de sélection, soit «NORM» soit «BLOC».</para>
<para>Bascule entre les modes d'insertion/d'écrasement. Lorsque le mode est «INS», on insère les caractères là où se trouve le curseur. Lorsque le mode est «ÉCR», la frappe de caractères remplacera les caractères actuels si votre curseur est positionné avant un caractère quelconque. La barre d'état montre l'état actuel du mode d'écrasement, soit «INS» soit «ÉCR».</para>
<para>Ouvre une boîte de dialogue utilisée pour spécifier le <guilabel>texte à chercher</guilabel> dans le document. Elle comporte une petite zone de texte afin de saisir le motif de recherche, qui fait également fonction de liste déroulante. En cliquant sur la flèche de la liste déroulante, sur le côté de la zone de saisie, on fait apparaître d'autres motifs de recherche récents. D'autres paramètres sont inclus pour rendre la recherche plus efficace. En sélectionnant « <guilabel>Tenir compte de la casse</guilabel> », on limitera la recherche aux éléments qui respectent la casse (minuscules ou majuscules) de chacun des caractères dans le motif de recherche. « <guilabel>Chercher en arrière</guilabel> » permet de poursuivre la recherche dans l'autre sens. L'option « <guilabel>Texte sélectionné</guilabel> » limite la recherche au texte actuellement sélectionné. L'option « <guilabel>Mots entiers seulement</guilabel> » empêche la recherche de s'arrêter sur les mots qui contiennent le motif recherché. L'option « <guilabel>Depuis le curseur</guilabel> » commence la recherche à partir de la position actuelle du curseur dans le document plutôt que depuis le début.</para>
<para>Répète la dernière opération de recherche, le cas échéant, sans appeler la boîte de dialogue «Chercher», et en cherchant dans le document vers l'arrière plutôt que vers l'avant. </para>
<para>Ouvre la boîte de dialogue «Remplacer». Celle-ci est pratiquement identique à la boîte de dialogue «Chercher» indiquée ci-dessus. En plus des fonctionnalités de la boîte de dialogue «Chercher», elle contient une zone de texte/une zone de liste déroulante « <guilabel>Remplacer par</guilabel> ». Grâce à cette boîte de dialogue, l'utilisateur peut spécifier à la fois le texte à trouver et celui qui le remplacera. L'option additionnelle « <guilabel>Invite lors d'un remplacement</guilabel> » permet à l'utilisateur de faire confirmer à &kwrite; avant chaque remplacement. </para>
<menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>G</keycap></keycombo> </shortcut> <guimenu>Édition</guimenu> <guimenuitem>Aller à la ligne</guimenuitem></menuchoice></term>
<para>Ouvre une boîte de dialogue «Aller à la ligne» utilisée pour faire déplacer le curseur sur une ligne particulière (spécifiée par un nombre) dans le document. Le numéro de ligne peut être saisi directement dans la zone de texte ou graphiquement en cliquant sur les boutons fléchés rotatifs haut et bas situés sur le côté de la zone de texte. La petite flèche vers le haut incrémente le numéro de ligne tandis que la petite flèche vers le bas le décrémente. Il y a également un curseur de réglage à droite de la zone de texte qui permet à l'utilisateur de déplacer le point «Aller à » dans le document d'une manière analogue. </para>
<menuchoice><shortcut><keycombo action="simul"><keycap>F7</keycap></keycombo></shortcut> <guimenu>Affichage</guimenu> <guimenuitem>Basculer dans la ligne de commande</guimenuitem> </menuchoice>
<para>Affiche la ligne de commande Katepart au bas de la fenêtre. Dans la ligne de commande, saisissez «help» pour obtenir de l'aide et «help list» pour obtenir une liste des commandes.</para>
<menuchoice><shortcut><keycombo action="simul"><keycap>F10</keycap></keycombo></shortcut> <guimenu>Affichage</guimenu> <guimenuitem>Retour à la ligne dynamique</guimenuitem> </menuchoice>
<menuchoice><shortcut><keycombo action="simul"><keycap>F10</keycap></keycombo></shortcut> <guimenu>Affichage</guimenu> <guimenuitem>Indicateurs de retour à la ligne dynamique </guimenuitem> </menuchoice>
<para>Choisissez quand et comment les indicateurs de retour à la ligne dynamique devront être affichés. Cette commande n'est disponible que si l'option <guilabel>Retour à la ligne dynamique</guilabel> est cochée.</para>
<para>Si cette option est cochée, une ligne verticale sera tracée au niveau de la colonne de retour à la ligne comme défini dans <menuchoice> <guimenu>Configuration</guimenu> <guimenuitem>Configurer l'éditeur...</guimenuitem></menuchoice>, dans l'onglet «Édition». Notez que l'indicateur de retour à la ligne n'est tracé que si vous utilisez une police à chasser fixe.</para>
<menuchoice><shortcut><keycombo action="simul"><keycap>F11</keycap></keycombo></shortcut> <guimenu>Affichage</guimenu> <guimenuitem>Afficher les numéros de ligne</guimenuitem> </menuchoice>
<para>Élément d'activation/de désactivation. En le cochant, on rend actif l'affichage de la zone des numéros de ligne du document visible sur la bordure gauche de l'éditeur, et vice versa.</para>
<menuchoice><shortcut><keycombo action="simul"><keycap>F9</keycap></keycombo></shortcut> <guimenuitem>Cacher les indicateurs de pliage</guimenuitem> </menuchoice>
<term><menuchoice><shortcut><keycombo action="simul"><keycap>Ctrl</keycap> <keycap>Maj</keycap><keycap>-</keycap></keycombo></shortcut> <guimenuitem>Replier le plus haut niveau</guimenuitem></menuchoice>
<listitem><para>Replie toutes les régions de plus haut niveau dans le document.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul"><keycap>Ctrl</keycap> <keycap>Maj</keycap><keycap>+</keycap></keycombo></shortcut> <guimenuitem>Déplier le plus haut niveau</guimenuitem></menuchoice>
<listitem><para>Déplie toutes les régions de plus haut niveau dans le document.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul"><keycap>Ctrl</keycap> <keycap>-</keycap></keycombo></shortcut> <guimenuitem>Replier d'un niveau local</guimenuitem></menuchoice>
<listitem><para>Replie la région la plus proche du curseur.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut><keycombo action="simul"><keycap>Ctrl</keycap> <keycap>+</keycap></keycombo></shortcut> <guimenuitem>Déplier d'un niveau local</guimenuitem></menuchoice>
<para>Définit ou supprime un signet dans la ligne actuelle du document actif. (Si un signet est présent, il est supprimé, sinon un autre est défini.). </para>
<listitem><para>Déplace le curseur au début de la première ligne précédente comportant un signet. Le texte de l'élément de menu comprendra le numéro de ligne et le premier bloc de texte dans la ligne. Cet élément n'est disponible que lorsqu'il y a un signet dans une ligne au-dessus du curseur.</para></listitem>
<listitem><para>Ce raccourci déplace le curseur au début de la ligne suivante comportant un signet. Le texte de l'élément de menu comprendra le numéro de ligne et le premier bloc de texte dans la ligne. Cet élément n'est disponible que lorsqu'il y a un signet dans une ligne au-dessous du curseur.</para></listitem>
<para>Place le document actuel en mode lecture seule. Cette fonction empêche tout ajout de texte et tout changement dans le formatage du document.</para>
<para>Choisissez le schéma de type de fichier que vous préférez pour le document actif. Cette fonction écrase le mode de type de fichier global défini dans <menuchoice> <guimenu>Configuration</guimenu> <guimenuitem>Configurer l'éditeur...</guimenuitem></menuchoice> dans l'onglet «Types de fichiers» pour votre document actuel uniquement.</para>
<para>Choisissez le schéma de coloration syntaxique que vous préférez pour le document actif. Cette fonction écrase le mode de coloration syntaxique globale défini dans <menuchoice> <guimenu>Configuration</guimenu> <guimenuitem>Configurer l'éditeur...</guimenuitem> </menuchoice> pour votre document actuel uniquement.</para>
<para>Choisissez le style d'indentation que vous souhaitez pour votre document actif. Cette fonction écrase le mode d'indentation global défini dans <menuchoice> <guimenu>Configuration</guimenu> <guimenuitem>Configurer l'éditeur...</guimenuitem> </menuchoice> pour votre document actuel uniquement.</para>
<para>Vous pouvez écraser l'encodage par défaut défini dans <menuchoice> <guimenu>Configuration</guimenu> <guimenuitem>Configurer l'éditeur...</guimenuitem></menuchoice> dans l'onglet « <guilabel>Ouvrir/Enregistrer</guilabel> » pour définir un encodage différent pour votre document actuel. L'encodage que vous définissez ici sera valable pour votre document actuel uniquement.</para>
<para>Choisissez votre mode de fin de ligne préféré pour votre document actif. Cette fonction écrase le mode de fin de ligne global défini dans <menuchoice> <guimenu>Configuration</guimenu> <guimenuitem>Configurer l'éditeur...</guimenuitem> </menuchoice> pour votre document actuel uniquement.</para>
<listitem><para><action>Cette fonction lance le programme de vérification orthographique — un programme conçu pour aider l'utilisateur à repérer et corriger toute faute d'orthographe.</action> Un clic sur cet élément démarre le vérificateur et fait apparaître la boîte de dialogue «Orthographe» grâce à laquelle l'utilisateur peut contrôler le processus. Il y a quatre paramètres alignés verticalement au centre de la boîte de dialogue, avec les étiquettes correspondantes juste à gauche. En partant du haut, ce sont:</para>
<listitem><para>Ici, le vérificateur orthographique indique le mot actuellement examiné. Ceci se produit lorsque le vérificateur rencontre un mot qui ne figure pas dans son dictionnaire — un fichier contenant une liste de mots correctement orthographiés par rapport auquel il compare chaque mot dans l'éditeur.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Remplacer par:</guilabel></term>
<listitem><para>Si le vérificateur trouve des mots similaires dans son dictionnaire, le premier apparaîtra ici. L'utilisateur peut accepter la suggestion, saisir sa propre correction ou choisir une autre suggestion figurant dans la zone suivante.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Mot suggéré:</guilabel></term>
<listitem><para>Le vérificateur peut lister ici un certain nombre de remplacements possibles pour le mot actuellement examiné. Un clic sur l'une quelconque des suggestions entraînera la saisie de ce mot dans la zone <guilabel>Remplacer par:</guilabel>, au-dessus.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Langue:</guilabel></term>
<listitem><para>Si vous avez installé plusieurs dictionnaires, vous pouvez choisir ici quel devra être la langue/le dictionnaire utilisé.</para></listitem>
<para>Du côté droit de la boîte de dialogue, se trouvent cinq boutons qui permettent à l'utilisateur de contrôler le processus de vérification orthographique. Ce sont:</para>
<term><guibutton>Ajouter au dictionnaire</guibutton></term>
<listitem><para>En cliquant sur ce bouton, on ajoute le mot dans la zone <guilabel>Mot mal orthographié:</guilabel> au dictionnaire du vérificateur. Cela signifie qu'à l'avenir, le vérificateur considérera toujours que ce mot est correctement orthographié.</para></listitem>
</varlistentry>
<varlistentry>
<term><guibutton>Remplacer</guibutton></term>
<listitem><para>Permet au vérificateur de remplacer le mot actuellement examiné dans le document par le mot figurant dans la zone <guilabel>Remplacer par:</guilabel>.</para></listitem>
<listitem><para>Permet au vérificateur de remplacer non seulement le <guilabel>Mot inconnu:</guilabel> mais encore à effectuer automatiquement la même substitution pour toute autre occurrence de ce « <guilabel>mt mal orthographié:</guilabel> » dans le document.</para></listitem>
</varlistentry>
<varlistentry>
<term><guibutton>Ignorer</guibutton></term>
<listitem><para>Un clic sur ce bouton fera se déplacer le vérificateur sans effectuer aucun changement.</para></listitem>
<listitem><para>Indique au vérificateur de ne rien faire en ce qui concerne le « <guilabel>mot inconnu:</guilabel> » actuel et d'ignorer toute autre occurrence du même mot.</para> <note><para>Cette fonction ne s'applique qu'à la vérification orthographique en cours. Si le vérificateur est relancé ultérieurement, il s'arrête sur ce même mot.</para></note></listitem>
<listitem><para>Annule le processus de vérification orthographique: toutes les modifications sont annulées, et vous revenez à votre document.</para></listitem>
<term><anchor id="tools-spelling-from-cursor"/><menuchoice><guimenu>Outils</guimenu> <guimenuitem>Vérification de l'orthographe (depuis le curseur)...</guimenuitem></menuchoice></term>
<para>Lance le programme de vérification orthographique, mais elle démarre là où se trouve votre curseur au lieu de le faire au début du document.</para>
<term><anchor id="tools-spellcheck-selection"/><menuchoice><guimenu>Outils</guimenu> <guimenuitem>Vérification de l'orthographe de la sélection...</guimenuitem></menuchoice></term>
<para>Réduit l'indentation du paragraphe d'une tabulation. La valeur de la tabulation dépend des <link linkend="pref-indent">paramètres d'indentation</link>.</para>
<para>Supprime l'indentation pour la sélection en cours ou pour la ligne sur laquelle se trouve le curseur actuellement. La suppression de l'indentation garantit que tout votre texte sélectionné suit le mode d'indentation que vous choisissez.</para>
<para>Provoque un réalignement de la ligne actuelle ou des lignes sélectionnées à l'aide du mode d'indentation et des paramètres d'indentation dans le document.</para>
<listitem><para>Supprime un espace (s'il en existe) au début de la ligne dans laquelle se trouve le curseur ou au début de toute ligne sélectionnée.</para></listitem>
<listitem><para>Met en minuscules le texte sélectionné ou la lettre placée après le curseur.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Alt;&Ctrl;<keycap>U</keycap></keycombo> </shortcut> <guimenu>Outils</guimenu> <guimenuitem>Mettre une majuscule à chaque mot</guimenuitem> </menuchoice></term>
<listitem><para>Met en majuscules le texte sélectionné ou le mot actuel.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><shortcut> <keycombo action="simul">&Ctrl;<keycap>J</keycap></keycombo> </shortcut> <guimenu>Outils</guimenu> <guimenuitem>Fusionner les lignes</guimenuitem> </menuchoice></term>
<listitem><para>Fusionne les lignes sélectionnées ou la ligne actuelle et la ligne au-dessous avec un caractère d'espacement sous la forme d'un séparateur. L'espacement placé au début/ à la fin des lignes fusionnées est supprimé dans les extrémités affectées.</para></listitem>
</varlistentry>
<varlistentry>
<term><menuchoice><guimenu>Outils</guimenu> <guimenuitem>Effectuer les retours à la ligne dans le document</guimenuitem> </menuchoice></term>
<listitem><para>Applique le retour à la ligne statique sur tout le document. Cela signifie qu'une nouvelle ligne de texte commencera automatiquement dès que la ligne dépasse la longueur spécifiée par l'option «Couper à la colonne» de l'élément «Édition» dans <menuchoice> <guimenu>Configuration</guimenu><guimenuitem>Configurer l'éditeur...</guimenuitem></menuchoice></para></listitem>
<para>Lorsqu'elle est cochée, cette option affiche une barre d'outils déplaçable contenant des boutons utilisés pour lancer les commandes fréquemment utilisées. Si elle est décochée, la barre d'outils est cachée. </para>
<para>Lorsqu'elle est cochée, cette option affiche une petite barre au bas de l'éditeur, contenant des informations sur l'état du document actuel. Si elle est décochée, la barre d'état est cachée.</para>
<para>Lorsque cette option est cochée, le chemin du document actuel (son emplacement dans le système de fichiers) est affiché dans la barre de titre. Si elle est décochée, le chemin est caché.</para>
<para>Cette commande ouvre une boîte de dialogue dans lequel les différents <link linkend="pref-dialog">paramètres</link> peuvent être ajustés. </para>
<para>Sélectionnez le composant d'édition de texte par défaut que vous souhaitez utiliser dans &kwrite;. Vous pouvez choisir <guilabel>Valeur par défaut du système</guilabel>, <guilabel>Éditeur de texte avancé intégré</guilabel> ou <guilabel>Éditeur de texte basé sur &Qt;Designer</guilabel> (notez que l'éditeur de texte basé sur &Qt;Designer n'est disponible que si vous avez installé KDevelop sur votre système). Si vous choisissez <guilabel>Valeur par défaut du système</guilabel>, &kwrite; appliquera vos changements dans le &kcontrolcenter;. Tous les autres choix annuleront ce réglage. </para>
<term><anchor id="configure-keybindings"/><menuchoice><guimenu>Configuration</guimenu><guimenuitem>Configurer les raccourcis clavier...</guimenuitem></menuchoice></term>
<para>Cette commande ouvre une boîte de dialogue permettant de modifier les <link linkend="keybindings">raccourcis clavier</link>. Une fenêtre en haut de la boîte de dialogue affiche la liste des commandes (actions) qui peuvent avoir des raccourcis clavier. Sous l'affichage, se trouvent trois boutons radio. L'utilisateur peut choisir entre «Aucun», «Par défaut» et «Personnalisé». (Notez qu'un ensemble de boutons radio ne permet que la sélection d'un seul des éléments offerts — de la même façon que les boutons d'un autoradio ne permettent de sélectionner qu'une seule station préréglée. De plus, la sélection du raccourci «Par défaut» est disponible uniquement pour les commandes réellement dotées d'un raccourci clavier «Par défaut». La sélection du raccourci «Personnalisé» active les trois cases à cocher ainsi que le bouton de touche au bas de la boîte de dialogue. L'utilisateur peut alors choisir une combinaison de touches pour la commande en question au moyen des cases à cocher et du bouton de touche. Par exemple, d'un clic sur la commande « À propos de &kde; » dans la fenêtre d'affichage, l'utilisateur peut sélectionner &Ctrl; et <keycap>Alt</keycap>, cliquer sur le bouton de touche, puis appuyer sur la touche <keycap>K</keycap> du clavier. Cela signifie que la boîte de dialogue « À propos de &kde; » s'affiche chaque fois que l'utilisateur maintient enfoncées les touches &Ctrl; et <keycap>Alt</keycap> et appuie sur <keycap>K</keycap> (lorsqu'il utilise &kwrite;). </para>
<term><anchor id="configure-toolbars"/><menuchoice><guimenu>Configuration</guimenu><guimenuitem>Configurer les barres d'outils...</guimenuitem></menuchoice></term>
<listitem><para>Cette commande ouvre une boîte de dialogue permettant de modifier la configuration des barres d'outils. L'utilisateur peut choisir quels seront les boutons de raccourci à faire apparaître dans la barre d'outils. Une fenêtre située sur la gauche affiche la liste des commandes qu'il est possible de placer dans la barre d'outils. Les commandes déjà présentes dans la barre d'outils sont affichées à droite. Un ensemble de quatre boutons fléchés entre les deux listes permet de manipuler les sélections. La flèche pointant vers la droite place toute commande sélectionnée depuis la liste de gauche vers la liste de droite, c'est-à-dire qu'elle est ajoutée à la barre d'outils. La flèche pointant vers la gauche fait juste l'inverse, en supprimant de la barre d'outils toute action sélectionnée dans la fenêtre de droite. Les flèches pointant vers le haut et vers le bas changent la position d'une action sélectionnée dans la fenêtre de droite, laquelle change la position dans la barre d'outils.</para> </listitem>
<para>En sélectionnant <menuchoice><guimenu>Configuration</guimenu><guimenuitem>Configurer l'éditeur...</guimenuitem></menuchoice> depuis le menu, on fait apparaître la boîte de dialogue <guilabel>Configuration</guilabel>. Cette dernière peut être utilisée pour modifier un certain nombre de paramètres différents. Les paramètres que l'on peut changer varient selon la catégorie que choisit l'utilisateur dans une liste verticale située du côté gauche de la boîte de dialogue. Trois boutons au bas de la boîte permettent à l'utilisateur de contrôler le processus. </para>
<para>Il peut invoquer le système d'<guilabel>aide</guilabel>, accepter les réglages actuels et fermer la boîte de dialogue en cliquant sur le bouton <guibutton>OK</guibutton> ou sur <guibutton>Annuler</guibutton> pour annuler le processus. Les catégories <guilabel>Couleurs</guilabel>, <guilabel>Polices</guilabel>, <guilabel>Indentation</guilabel>, <guilabel>Sélection</guilabel>, <guilabel>Édition</guilabel>, <guilabel>Orthographe</guilabel> et <guilabel>Coloration syntaxique</guilabel> sont décrites en détail ci-après. </para>
<term><guilabel>Retour à la ligne dynamique</guilabel></term>
<listitem><para>Si cette option est cochée, les lignes de texte seront coupées le long de la bordure d'affichage sur l'écran.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Indicateurs dynamiques de retour à la ligne</guilabel></term>
<listitem><para>Choisissez à quel moment les indicateurs dynamiques de retour à la ligne devront être affichés. </para></listitem></varlistentry>
<varlistentry>
<term><guilabel>Aligner verticalement les lignes coupées dynamiquement à la profondeur de l'indentation: </guilabel></term>
<listitem><para>Permet d'aligner le début des lignes coupées dynamiquement au niveau d'indentation de la première ligne. Cette fonction peut être utile pour rendre le code et le balisage plus lisibles.</para><para>De plus, cette fonction permet de définir une largeur maximale pour l'écran, en pourcentage, au-delà de laquelle les lignes coupées dynamiquement ne seront plus alignées verticalement. Par exemple, à 50%, pour les lignes dont les niveaux d'indentation ont une profondeur supérieure à 50% de la largeur de l'écran, il ne sera pas possible d'appliquer un alignement vertical aux lignes coupées ensuite.</para></listitem>
<term><guilabel>Afficher les indicateurs de pliage </guilabel></term>
<listitem><para>Si cette option est cochée, la vue actuelle affiche les indicateurs de pliage du code, si le pliage du code est disponible.</para></listitem>
<term><guilabel>Afficher la bordure d'icônes </guilabel></term>
<listitem><para>Si cette option est cochée, vous voyez une bordure d'icônes sur le côté gauche. La bordure d'icônes affiche des repères de signet par exemple.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Afficher les numéros de ligne </guilabel></term>
<listitem><para>Si cette option est cochée, vous voyez les numéros de ligne sur le côté gauche.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Afficher les repères sur les barres de défilement </guilabel></term>
<listitem><para>Si cette option est cochée, la vue actuelle affiche les repères sur la barre de défilement verticale. Ces repères afficheront par exemple des signets.</para></listitem>
<term><guilabel>Afficher les lignes d'indentation </guilabel></term>
<listitem><para>Si cette option est cochée, l'éditeur affiche des lignes verticales pour aider à identifier les lignes d'indentation.</para></listitem>
<para>Cette section de la boîte de dialogue permet de configurer toutes les polices et couleurs dans n'importe quel schéma de couleurs dont vous disposez, de supprimer des schémas existants, voire d'en créer de nouveaux. Chaque schéma offre des réglages pour les couleurs, les polices, les styles de texte normal et de coloration syntaxique. </para>
<para>&kwrite; présélectionne pour vous le schéma actuellement en vigueur. Si vous souhaitez travailler sur un autre schéma, commencez par le sélectionner depuis la zone de liste modifiable <guilabel>Schéma</guilabel>.</para>
<listitem><para>Fond pour le texte sélectionné. Le réglage par défaut est la couleur de sélection globale, comme défini dans vos préférences de couleurs de &kde;. </para></listitem>
<listitem><para>Définit la couleur de la ligne actuelle. Régler ce paramètre un peu différemment du fond du texte normal permet de garder le focus sur la ligne actuelle. </para></listitem>
<listitem><para>Cette zone de ligne modifiable permet de définir des couleurs de recouvrement pour divers types de marques. La couleur est mélangée à la couleur de fond d'une ligne marquée, de sorte qu'une ligne ayant plus de marques ou une ligne marquée active a un fond qui est un mélange de plusieurs couleurs. Les couleurs des marques sont également utilisées si vous activez l'affichage des marques des barres de défilement.</para></listitem>
<term><guilabel>Fond de la bordure gauche</guilabel></term>
<listitem><para>Cette couleur est utilisée pour les marques, les numéros de ligne et les bordures de pliage du code du côté gauche de la fenêtre de l'éditeur lorsqu'ils sont affichés. </para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Numéros de ligne</guilabel></term>
<listitem><para>Cette couleur est utilisée pour tracer les numéros de ligne sur le côté gauche de la fenêtre lorsque affichés.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Coloration des accolades</guilabel></term>
<listitem><para>Cette couleur est utilisée pour tracer le fond des couples d'accolades. </para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Marqueurs de retour à la ligne</guilabel></term>
<listitem><para>Cette couleur est utilisée pour tracer un motif à gauche des lignes coupées dynamiquement lorsque celles-ci sont alignées verticalement, ainsi que pour le marqueur de retour à la ligne statique.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Marqueurs de tabulations</guilabel></term>
<listitem><para>Cette couleur est utilisée pour tracer des indicateurs d'espacement lorsqu'ils sont activés. </para></listitem>
<para>Ici vous pouvez choisir la police pour le schéma. Vous pouvez choisir à partir de n'importe quelle police disponible sur votre système et définir une taille par défaut. Comme un échantillon de texte s'affiche au bas de la boîte de dialogue, vous pouvez voir l'effet de vos choix. </para>
<para>Les styles pour le texte normal sont hérités des styles du texte en surbrillance, en permettant à l'éditeur de présenter du texte d'une manière très cohérente. Par exemple, le texte des commentaires utilise le même style dans pratiquement tous les formats de texte que Kwrite peut mettre en surbrillance.</para>
<para>Le nom figurant dans la liste des styles utilise le style configuré pour l'élément, ce qui vous offre un aperçu immédiat lorsque vous configurez un style. </para>
<para>Chaque style permet de sélectionner des attributs communs ainsi que des couleurs d'avant-plan et de fond. Pour désélectionner une couleur de fond, cliquez avec le bouton droit pour employer le menu contextuel.</para>
<para>Ici vous pouvez modifier les styles de texte utilisés par une définition de coloration syntaxique donnée. L'éditeur présélectionne la coloration syntaxique employée par votre document actuel. Pour travailler sur une coloration syntaxique différente, choisissez-en une dans la zone de liste modifiable « <guilabel>Coloration syntaxique</guilabel> » au-dessus de la liste des styles. </para>
<para>Le nom figurant dans la liste des styles utilise le style configuré pour l'élément, ce qui vous offre un aperçu immédiat lorsque vous configurez un style. </para>
<para>Chaque style permet de sélectionner des attributs communs ainsi que des couleurs d'avant-plan et de fond. Pour désélectionner une couleur de fond, cliquez avec le bouton droit pour utiliser le menu contextuel. De plus, vous pouvez voir si un style équivaut au style par défaut employé pour l'élément et le définir dans le cas contraire.</para>
<para>On remarque que beaucoup de surbrillances en contiennent d'autres, représentées par des groupes dans la liste des styles. Par exemple, la plupart des surbrillances importent la surbrillance «Alerte», et beaucoup de formats de code source importent la surbrillance «Doxygen». Modifier les couleurs dans ces groupes n'affecte que les styles lorsque utilisés dans le format de surbrillance en cours d'édition. </para>
<para>Lorsque cette option est cochée, si l'on appuie sur la touche «Début», le curseur ignorera tout caractère d'espacement et ira au du début du texte d'une ligne.</para>
<para>Lorsque cette option est cochée, si l'on déplace le curseur d'insertion à l'aide des touches <emphasis role="bold">gauche</emphasis> et <emphasis role="bold">droite</emphasis>, il ira sur la ligne précédent ou suivante au début ou à la fin de la ligne, de la même manière que la plupart des éditeurs.</para><para>Lorsqu'elle n'est pas cochée, le curseur d'insertion ne peut pas être déplacé à gauche du début de la ligne mais peut l'être depuis la fin de la ligne. Cette fonction peut s'avérer très pratique pour le développeur. Lorsque cette option est cochée, si le curseur est déplacé de la fin d'une ligne (vers la droite) avec les touches fléchées, il passe au début de la ligne suivante. De même, lorsque le curseur est déplacé après le début d'une ligne (vers la gauche), il passe à la fin de la ligne précédente. Lorsque cette option n'est pas cochée, si l'on déplace le curseur à droite après la fin d'une ligne, il se contente de continuer horizontalement dans la même ligne, et si'l'on essaie de le déplacer à gauche après le début, on n'a aucun effet.</para>
<para>Cette option change le comportement du curseur lorsque l'utilisateur appuie sur les touches <keycap>Page précédente</keycap> et <keycap>Page suivante</keycap>. Si elle n'est pas cochée, le curseur se maintiendra à sa position relative au sein du texte affiché dans &kwrite; lorsque le nouveau texte devient visible suite à l'opération. Ainsi, si le curseur est au milieu du texte visible lorsque l'opération se produit, il y restera (sauf si l'on atteint le début ou la fin du document). Si cette option est cochée, la première fois où l'on appuie sur la touche, le curseur se déplace soit au début, soit à la fin du texte visible lorsqu'une nouvelle page de texte est affichée.</para>
<para>Lorsque cette option est cochée, l'éditeur insère un nombre calculé d'espaces selon la position dans le texte et le paramètre <option>tab-width</option> lorsque vous appuyez sur la touche <keycap>Tab</keycap>.</para>
<para>Lorsque cette option est cochée, &kwrite; affiche un petit point comme représentation visuelle des caractères de tabulation.</para>
<note><para>Cette fonction a pour rôle de tracer des points pour indiquer le caractère d'espacement de fin. Ce sera corrigé dans une version future de &kwrite;.</para></note>
<term id="pref-tab-width">Taille des tabulations</term> <listitem><para>Si l'option <link linkend="pref-word-wrap"><guilabel>Remplacer les tabulations par des espaces</guilabel></link> est cochée, cet élément détermine le nombre d'espaces par lesquels l'éditeur remplacera automatiquement les tabulations.</para></listitem>
<term id="pref-word-wrap"><guilabel>Retour à la ligne statique</guilabel></term>
<listitem><para>Le retour à la ligne est une fonctionnalité qui amène l'éditeur à démarrer automatiquement une nouvelle ligne de texte et à déplacer (encapsuler) le curseur au début de cette nouvelle ligne. &kwrite; démarrera automatiquement une nouvelle ligne de texte lorsque la ligne actuelle atteindra la longueur spécifiée par l'option <link linkend="pref-wrap-words-at">Couper à la colonne</link>.</para>
<para>Si cette option est cochée, une ligne verticale sera tracée au niveau de la colonne de retour à la ligne comme défini dans <menuchoice> <guimenu>Configuration</guimenu> <guimenuitem>Configurer l'éditeur...</guimenuitem></menuchoice>, dans l'onglet «Édition». Notez que l'indicateur de retour à la ligne n'est tracé que si vous utilisez une police à chasser fixe.</para>
<para>Si l'option <link linkend="pref-word-wrap">Retour à la ligne</link> est cochée, cette fonction détermine la longueur (en caractères) à laquelle l'éditeur démarrera automatiquement une nouvelle ligne.</para>
<term><guilabel>Supprimer les espaces de fin de ligne</guilabel></term>
<listitem><para>&kwrite; éliminera automatiquement les espaces supplémentaires à la fin des lignes de texte.</para></listitem> </varlistentry>
<varlistentry>
<term><guilabel>Accolades automatiques</guilabel></term> <listitem><para>Lorsque l'utilisateur saisit une accolade gauche ([, ( ou {), &kwrite; saisit automatiquement l'accolade droite (}, ) ou ]) à droite du curseur.</para></listitem>
<listitem><para>Ici l'utilisateur peut spécifier le nombre d'étapes que &kwrite; retiendra en mémoire aux fins d'annuler des saisies et des actions. Cela signifie que plus le nombre d'étapes défini est élevé, plus &kwrite; utilisera de mémoire pour cette fonction. Fixer ce nombre à 10 signifierait que l'utilisateur pourrait revenir sur les dix dernières opérations, &cad; cliquer 10fois sur le bouton <guibutton>Annuler</guibutton> et obtenir des résultats.</para></listitem> </varlistentry>
<varlistentry> <term>Recherche de texte intelligente à partir de:</term>
<listitem><para>Cette fonction détermine à partir d'où &kwrite; cherchera le texte (celui-ci sera automatiquement saisi dans la boîte de dialogue «Texte à chercher»): <itemizedlist> <listitem><para><emphasis role="bold">Nulle part</emphasis>: ne pas deviner le texte de la recherche.</para></listitem> <listitem><para><emphasis role="bold">La sélection seulement</emphasis>: utiliser la sélection de texte actuelle si disponible. </para></listitem> <listitem><para><emphasis role="bold">La sélection, puis le mot actuel</emphasis>: utiliser la sélection actuelle, si disponible, sinon utiliser le mot actuel.</para></listitem> <listitem><para><emphasis role="bold">Le mot actuel seulement</emphasis>: utiliser le mot sur lequel le curseur est actuellement positionné. </para></listitem> <listitem><para><emphasis role="bold">Le mot actuel, puis la sélection</emphasis>: utiliser le mot actuel, si disponible, sinon utiliser la sélection actuelle. </para></listitem> </itemizedlist> Notez que, dans les modes ci-dessus, si une chaîne de recherche n'a pas été ou ne peut pas être déterminée, alors la boîte de dialogue «Texte à chercher» reviendra au dernier texte de recherche. </para></listitem>
<para>Choisissez le mode d'indentation automatique que vous souhaitez employer comme mode par défaut. Il est vivement recommandé d'employer <userinput>Aucun</userinput> ou <userinput>Normal</userinput> ici, et d'utiliser les configurations de types de fichiers pour définir d'autres modes d'indentation pour des formats de texte comme le code C/C++ ou le &XML;.</para>
<para>Insère automatiquement un « * » lors de la frappe à l'intérieur d'un commentaire de style Doxygen. Ce réglage n'est activé que lorsqu'il est applicable.</para>
<para>Définit le nombre d'espaces que vous souhaitez utiliser pour l'indentation lorsque vous cochez l'option « <guilabel>Utiliser des espaces au lieu de tabulations pour indenter</guilabel> ».</para>
<term><guilabel>Conserver le profil d'indentation</guilabel></term>
<listitem><para>Lorsque cette option est cochée, l'éditeur n'indente pas les lignes dans une autre sélection si la ligne comportant la dernière indentation devient non indentée. Cette fonction peut être utile si vous désindentez parfois des blocs de code indenté. </para></listitem>
<para>Cochez cette option si vous voulez que l'éditeur détecte automatiquement le type de fin de ligne. Le premier type de fin de ligne trouvé sera utilisé pour le fichier entier.</para>
<para>L'éditeur chargera le nombre donné de blocs (d'environ 2048lignes) de texte en mémoire; si la taille de fichier est supérieure, les autres blocs sont transférés sur le disque et chargés de façon transparente selon les besoins.</para>
<para>Ce comportement peut entraîner un peu de retard lorsqu'on navigue dans le document; un compte de blocs supérieur augmente la vitesse d'édition au prix de la mémoire. </para><para>Pour une utilisation normale, choisissez simplement le compte de blocs possible. Ne le limitez que si vous avez des problèmes avec l'utilisation de la mémoire.</para>
<para>L'éditeur effectuera la recherche en remontant selon le nombre de niveaux de dossiers indiqué dans le fichier de configuration de &kwrite; et chargera la ligne des paramètres à partir de celui-ci.</para>
<term><guilabel>Sauvegarde à l'enregistrement</guilabel></term>
<listitem><para>Faire une sauvegarde à l'enregistrement veillera à ce que &kwrite; copie le fichier sur disque dans « <préfixe><nomdefichier><suffixe> » avant d'enregistrer les changements. Le suffixe prend par défaut un « <emphasis role="bold">~</emphasis> » et le préfixe est vide par défaut. </para>
<para>Ce groupe d'options est utilisé pour personnaliser les styles de coloration syntaxique pour chaque type de langage de programmation. Tout changement que vous avez effectué dans d'autres zones de cette boîte de dialogue ne s'appliquera qu'à ce type.</para>
<term><guilabel>Extensions de noms de fichiers:</guilabel></term>
<listitem><para>C'est la liste des extensions de fichiers utilisées pour déterminer quels sont les fichiers à mettre en surbrillance à l'aide du mode de coloration syntaxique actuel.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Types MIME:</guilabel></term>
<listitem><para>En cliquant sur le bouton d'assistant, on affiche une boîte de dialogue comportant une liste de tous les types MIME disponibles parmi lesquel choisir.</para><para>L'élément <emphasis role="bold">Extensions de fichiers</emphasis> sera automatiquement modifié également.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Priorité:</guilabel></term>
<listitem><para>Définit la priorité de la règle de coloration syntaxique.</para></listitem>
<para>Cette page permet de passer outre la configuration par défaut pour les documents de types MIME spécifiés. Lorsque l'éditeur charge un document, il essaie de vérifier s'il correspond aux masques ou aux types MIME de fichiers pour un des types de fichiers définis et, si tel est le cas, d'appliquer les variables définies. Si d'autres types de fichiers correspondent, celui qui a la priorité la plus élevée sera utilisé. </para>
<term><guilabel>Type de fichier:</guilabel></term>
<listitem><para>Le type de fichier ayant la priorité la plus élevée est celui affiché dans la première zone de liste déroulante. Si d'autres types de fichier ont été trouvés, ils sont également listés.</para>
<listitem><para>Cette option est utilisée pour créer un nouveau type de fichier. Une fois que vous avez cliqué sur ce bouton, les champs ci-dessous se retrouvent vides et vous pouvez y saisir les propriétés que vous souhaitez pour le nouveau type de fichier.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Supprimer</guilabel></term>
<listitem><para>Pour supprimer un type de fichier existant, sélectionnez-le dans la zone de liste déroulante et cliquez sur le bouton «Supprimer».</para></listitem>
<term><guilabel>Propriétés du type de fichier actuel</guilabel></term>
<listitem><para>Le type de fichier ayant la priorité la plus élevée est celui affiché dans la première zone de liste déroulante. Si d'autres types de fichier ont été trouvés, ils sont également listés.</para>
<listitem><para>Le nom du type de fichier sera le texte de l'élément de menu correspondant. Ce nom est affiché dans <menuchoice><guisubmenu>Outils</guisubmenu><guisubmenu>Types de fichiers</guisubmenu></menuchoice>.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Section:</guilabel></term>
<listitem><para>Le nom de la section est utilisé pour organiser les types de fichiers dans les menus. Cette option sert également dans <menuchoice><guisubmenu>Outils</guisubmenu><guisubmenu>Types de fichiers</guisubmenu></menuchoice>.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Variables:</guilabel></term>
<listitem><para>Cette chaîne permet de configurer les réglages de &kwrite; pour les fichiers sélectionnés par ce type MIME à l'aide des variables de &kwrite;. Vous pouvez définir pratiquement n'importe quelle option de configuration, telle que la coloration syntaxique, le mode d'indentation, l'encodage, etc.</para><para>Pour obtenir une liste complète des variables connues, reportez-vous au manuel.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Extensions de noms de fichiers:</guilabel></term>
<listitem><para>Le masque de jokers permet de sélectionner des fichiers par nom de fichier. Un masque typique utilise un astérisque et l'extension de fichier, par exemple <filename>*.txt; *.text</filename>. La chaîne est une liste de masques séparés par un point-virgule.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Types MIME:</guilabel></term>
<listitem><para>Affiche un assistant qui vous aide à sélectionner facilement des types MIME.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Priorité:</guilabel></term>
<listitem><para>Définit une priorité pour ce type de fichier. Si plus d'un type de fichier choisit le même fichier, celui qui a la priorité la plus élevée sera utilisé.</para></listitem>
<para>Vous pouvez changer ici la configuration des touches de raccourcis clavier. Choisissez une action et cliquez sur « <guilabel>Personnalisé</guilabel> » si vous voulez un autre raccourci pour cette action.</para>
<para>La recherche permet de chercher une action spécifique et de voir le raccourci clavier associé.</para>
<para>Cette page répertorie tous les modules externes disponibles, et vous pouvez y cocher ceux que vous souhaitez employer. Dès lors qu'un module externe est coché, le bouton « <guibutton>Configurer</guibutton> » est activé et vous pouvez cliquer dessus afin de le module externe mis en évidence.</para>
