# Travailler avec l'éditeur &kappname;

## Vue d'ensemble

L'éditeur &kappname; est la zone d'édition de la fenêtre de &kappname;. Cet éditeur est partagé entre &kate; et &kwrite;, et il peut également l'être dans &konqueror; pour afficher des fichiers texte depuis votre ordinateur local ou depuis le réseau.

L'éditeur est constitué des éléments suivants :

La zone d'édition

- Il s'agit de l'endroit où se trouve le texte de votre document.

Les barres de défilement

- Les barres de défilement indiquent la position de la partie visible du texte du document et peuvent servir pour se déplacer dans le document. Faire glisser les barres de défilement ne provoque pas de déplacement du curseur d'insertion.

  Les barres de défilement sont affichées ou cachées selon les besoins.

La bordure d'icônes

- La bordure d'icônes est une petite zone sur la gauche de l'éditeur, affichant une petite icône à côté des lignes marquées.

  Vous pouvez placer ou supprimer un signet dans une ligne visible en cliquant avec le &BGS; sur la bordure d'icônes à côté de cette ligne.

  L'affichage de la bordure d'icônes peut être (dés)activé à l'aide de l'élément de menu Affichage Afficher la bordure d'icônes.

La zone de numéros de ligne

- La zone de numéros de lignes affiche les numéros de lignes de toutes les lignes visibles dans le document.

  L'affichage de la zone de numéros de ligne peut être (dés)activé à l'aide de l'élément de menu Affichage Afficher les numéros de ligne.

La zone de pliage

- La zone de pliage permet de réduire ou d'étendre des blocs de lignes pliables. Le calcul des régions pliables est réalisé en fonction de règles établies dans la définition de coloration syntaxique du document.

## Également dans ce chapitre :

- Naviguer dans le texte

- Travailler avec la sélection

- Copier et coller du texte

- Chercher et remplacer du texte

- Copier et coller du texte

- Retour à la ligne automatique

- Naviguer dans le texte

## Naviguer dans le texte

Dans &kappname;, on navigue dans le texte comme dans la plupart des éditeurs de texte graphiques. On déplace le curseur à l'aide des touches fléchées et des touches Page précédente, Page suivante, Début et Fin combinées avec les modificateurs &Ctrl; and &Maj;. La touche &Maj; est toujours utilisée pour générer une sélection, alors que la touche &Ctrl; a des effets différents sur différentes touches :

- Pour les touches Haut et Bas, cela signifie faire défiler plutôt que déplacer le curseur.

- Pour les touches Gauche et Droite, cela signifie sauter des mots plutôt que des caractères.

- Pour les touches Page précédente et Page suivante, cela signifie se déplacer vers le bord visible de la vue plutôt que parcourir.

- Pour les touches Début et Fin, cela signifie se déplacer au début ou à la fin du document plutôt qu'au début ou à la fin de la ligne.

&kappname; offre également un moyen d'aller rapidement à une accolade ou une parenthèse correspondante. Placez le curseur à l'intérieur de la parenthèse ou de l'accolade et appuyez sur les touches &Ctrl;6 pour aller directement à l'accolade ou la parenthèse correspondante.

De plus, vous pouvez utiliser un signet pour aller directement aux positions que vous aurez définies vous-même.

## Travailler avec la sélection

Il y a deux façons de sélectionner du texte dans &kappname; : à l'aide de la souris et à l'aide du clavier.

Pour sélectionner à l'aide de la souris, maintenez le &BGS; enfoncé tout en faisant glisser le curseur de la souris à partir de l'endroit où la sélection doit commencer, jusqu'au point final souhaité. Le texte est sélectionné au fur et à mesure que vous faites glisser le pointeur de la souris.

Un double-clic sur un mot sélectionne ce mot.

Un triple-clic sur une ligne sélectionne la ligne entière.

Le texte est sélectionné si la touche &Maj; est maintenue enfoncée tout en cliquant :

- Si rien n'est déjà sélectionné, depuis la position du curseur de texte jusqu'à la position du pointeur de la souris.

- S'il y a une sélection, depuis cette sélection, en l'incluant, jusqu'à la position du pointeur de la souris.

Lorsque vous sélectionnez du texte en faisant glisser la souris, le texte sélectionné est copié dans le presse-papiers. Vous pouvez le coller en cliquant avec le &BCS; dans l'éditeur ou dans n'importe quelle application dans laquelle vous voulez coller le texte.

Pour sélectionner à l'aide du clavier, maintenez la touche &Maj; enfoncée tout en utilisant les touches de navigation (les touches fléchées, Page précédente, Page suivante, Début et Fin, éventuellement combinées avec la touche &Ctrl; pour étendre le déplacement du curseur de texte).

Consultez également la section Naviguer dans le texte dans ce chapitre.

Pour copier la sélection actuelle, utilisez l'élément de menu Édition Copier ou le raccourci clavier (par défaut, &Ctrl;C).

Pour désélectionner la sélection actuelle, utilisez l'élément de menu Édition Désélectionner ou le raccourci clavier (par défaut, &Ctrl;&Maj;A) ou bien cliquez avec le &BGS; dans l'éditeur.

### Utiliser la sélection par bloc

Lorsque la sélection en bloc est activée, vous pouvez faire des « sélections verticales » dans le texte, &cad; sélectionner des colonnes limitées sur plusieurs lignes. Cette fonction est pratique pour travailler avec des lignes séparées par des tabulations, par exemple.

On peut (dés)activer la sélection par bloc à l'aide de l'élément de menu Édition Mode « sélection par bloc ». Le raccourci clavier par défaut est &Ctrl;&Maj;B .

### Utiliser l'écrasement de la sélection

Si l'option « Écraser les sélections » est cochée, la fonction « Saisir ou coller du texte » dans la sélection remplace le texte sélectionné. Si elle n'est pas cochée, le nouveau texte est ajouté à la position du curseur de texte.

L'écrasement de la sélection est activé par défaut.

Pour changer le paramétrage de cette option, utilisez la page Curseur et sélection de la boîte de dialogue de configuration.

### Utiliser la sélection persistante

Lorsque la sélection persistante est cochée, la saisie des caractères ou le déplacement du curseur ne désélectionne pas la sélection. Cela signifie que vous pouvez déplacer le curseur hors de la sélection et saisir du texte.

La sélection persistante est désactivée par défaut.

On peut activer la sélection persistante dans la page Curseur et sélection de la boîte de dialogue de configuration.

Si les options « Sélection persistante » et « Écraser la sélection » sont toutes deux cochées, la fonction « Saisir ou coller du texte », lorsque le curseur est à l'intérieur d'une sélection, remplace et désélectionne le texte.

## Copier et coller du texte

Pour copier du texte, sélectionnez-le et cliquez sur l'élément de menu Édition Copier. De plus, la fonction « Sélectionner du texte à la souris » copie le texte dans le presse-papiers.

Pour coller le texte se trouvant actuellement dans le presse-papiers, cliquez sur l'élément de menu Édition Coller.

De plus, le texte sélectionné à la souris peut être collé à la position souhaitée en cliquant avec le bouton central de la souris.

Lorsqu'on utilise l'environnement de bureau &kde;, il est possible d'extraire du texte copié précédemment depuis n'importe quelle application à l'aide de l'icône de &klipper; située dans la boîte à miniatures.

## Chercher et remplacer du texte

### Les barres « Recherche et remplacement »

&kappname; est doté d'une barre de recherche incrémentale et d'une puissante barre de recherche et remplacement, qui offre le moyen de saisir une chaîne de caractères de remplacement, ainsi que quelques options supplémentaires.

Les barres offrent les options communes suivantes :

Chercher

- Il s'agit de l'endroit où il faut saisir la chaîne de caractères à rechercher. L'interprétation de la chaîne dépend de quelques options décrites ci-dessous.

Respecter la casse

- Si cette option est cochée, la recherche sera limitée aux éléments qui respectent la casse (majuscules ou minuscules) de chacun des caractères dans le motif de recherche.

La barre de recherche et remplacement offre quelques options supplémentaires :

Texte en clair

- Fait correspondre littéralement toute occurrence de la chaîne de recherche.

Mots entiers

- Si cette option est cochée, la recherche ne correspond que s'il y a un séparateur de mots aux deux extrémités de la chaîne recherchée, &cad; un caractère autre qu'un caractère alphanumérique - soit un autre caractère visible, soit un saut de ligne.

Séquences d'échappement

- Si cette option est cochée, l'élément de menu Ajouter, en bas du menu contextuel de la boîte de texte, est activé et permet d'ajouter des séquences d'échappement au motif de recherche à partir d'une liste prédéfinie.

Expression rationnelle

- Si cette option est cochée, la chaîne de recherche est interprétée comme une expression rationnelle. L'élément de menu Ajouter, en bas du menu contextuel de la boîte de texte, est activé et permet d'ajouter des éléments d'expressions rationnelles au motif de recherche à partir d'une liste prédéfinie.

  Consultez la section Expressions rationnelles pour plus de détails à ce propos.

La sélection seulement

- Si cette option est cochée, la recherche et le remplacement seront effectués dans le texte sélectionné uniquement.

Tout chercher

- En cliquant sur ce bouton, toutes les correspondances dans le document sont surlignées et leur nombre s'affiche dans une petite fenêtre surgissante.

### Chercher du texte

Pour chercher du texte, lancez la barre de recherche incrémentale avec &Ctrl;F ou depuis l'élément de menu Édition Chercher...

Ceci ouvre la barre de recherche incrémentale en bas de la fenêtre de l'éditeur. Un bouton avec une icône permettant de fermer la barre se trouve sur la gauche. Il est suivi par une petite zone texte pour saisir la recherche.

La recherche démarre immédiatement quand vous commencez à saisir les caractères de votre motif de recherche. S'il existe une correspondance dans le texte, elle est mise en surbrillance et la couleur de fond devient vert pâle. Si le motif de recherche ne correspond à aucune chaîne dans le texte, ce résultat sera indiqué par une couleur de fond rouge clair du champ de saisie et le message Non trouvé est affiché sur le côté droit de la barre.

Utilisez le bouton Suivant ou Précédent pour aller directement vers la correspondance suivante ou précédente dans le document.

Les correspondances sont surlignées même lorsque vous fermez la barre de recherche. Pour enlever le surlignage, appuyez sur la touche &Echap;.

Vous pouvez choisir si la recherche est sensible à la casse. En cochant Respecter la casse, la recherche se limitera aux éléments qui correspondent à la casse (majuscule ou minuscule) pour chaque caractère du motif recherché.

Cliquez sur le bouton avec une flèche verte à droite de la barre de recherche incrémentale pour basculer vers la barre de recherche et remplacement étendue.

Pour répéter la dernière opération de recherche, s'il y a lieu, sans appeler la barre de recherche incrémentale, utilisez F3 Édition Poursuivre la recherche ou &Maj;F3 Édition Chercher en arrière.

### Remplacer du texte

Pour remplacer du texte, lancez la barre de recherche et remplacement à l'aide de la commande Édition Remplacer ou du raccourci clavier &Ctrl;R.

Sur le côté supérieur gauche de la barre, se trouve un bouton avec une icône pour fermer la barre, suivie d'un petite zone de texte permettant de saisir le motif de recherche.

On peut contrôler le mode de recherche en sélectionnant les paramètres Texte en clair, Mots entiers, Séquences d'échappement ou Expression rationnelle décrites ci-dessus.

Utilisez le bouton Suivant ou Précédent pour aller directement vers la correspondance suivante ou précédente dans le document.

Saisissez le texte de remplacement dans la zone de texte intitulée Remplacer et cliquez sur le bouton Remplacer pour remplacer uniquement le texte en surbrillance ou le bouton Tout remplacer pour remplacer le texte de la recherche dans le document entier.

Vous pouvez modifier la manière dont opère les fonctions recherche et remplacement en sélectionnant les différentes options en bas de la barre. Sélectionner Respecter la casse limitera les résultats aux termes ayant une casse identique (majuscule ou minuscule) aux caractères utilisés pour la recherche.La sélection seulement cherchera et remplacera seulement à l'intérieur de la sélection actuelle. Le bouton Tout chercher mettra en surbrillance toutes les occurrences dans le document et affichera le nombre de correspondances dans une petite fenêtre.

Cliquez sur le bouton avec une flèche verte à droite de la barre de recherche et remplacement étendue pour basculer vers la barre de recherche.

Si vous employez une expression rationnelle pour trouver le texte à remplacer, vous pouvez faire appel à des références arrière pour réutiliser le texte capturé dans des sous-motifs entre parenthèses de l'expression.

Consultez la section Expressions rationnelles pour plus de détails à ce propos.

Vous pouvez `chercher`, `remplacer` et effectuer une `recherche incrémentale` depuis la ligne de commande.

## Utiliser les signets

La fonctionnalité « Signets » permet de marquer certaines lignes, pour pouvoir les retrouver facilement plus tard.

On peut définir ou supprimer un signet dans une ligne de deux façons :

- En déplaçant le curseur d'insertion jusqu'à la ligne et en cliquant sur la commande Signets Définir un signet (&Ctrl;B).

- En cliquant sur la bordure d'icônes à côté de la ligne.

Les signets sont disponibles dans le menu Signets. Les signets individuels sont accessibles en tant qu'éléments de menu, le numéro de ligne de la ligne étant étiqueté avec le signet, ainsi que les premiers caractères du texte de la ligne. Pour déplacer le curseur d'insertion au début d'une ligne comportant un signet, ouvrez le menu et sélectionnez le signet.

Pour vous déplacer rapidement entre les signets ou vers le signet suivant/précédent, utilisez les commandes Signets Suivant (&Alt; Page suivante) ou Signets Précédent (&Alt;Page précédente ).

## Retour à la ligne automatique

Cette fonctionnalité permet de formater le texte d'une façon très simple : le texte va à la ligne, de manière à ce qu'aucune ligne ne dépasse un nombre maximal de caractères par ligne, à moins qu'il ne s'agisse d'une très longue chaîne de caractères accolés sans blancs.

Pour (dés)activer cette fonctionnalité, (dé)cochez la case Retour à la ligne statique dans la page Édition de la boîte de dialogue de configuration.

Pour définir la largeur de ligne maximale (le nombre maximal de caractères par ligne), cochez l'option Couper à la colonne dans la page Édition de la boîte de dialogue de configuration.

Si cette option est cochée, elle a les effets suivants :

- Lorsqu'on effectue une saisie, l'éditeur insère automatiquement un saut de ligne forcé après le dernier blanc à une position donnée avant d'atteindre la largeur de ligne maximale.

- Lorsqu'un document est chargé, l'éditeur génère des retours à la ligne d'une manière similaire, de sorte qu'aucune ligne ne dépasse la largeur de ligne maximale, si elle contient des blancs qui le permettent.

Il n'existe actuellement aucun moyen de régler le retour à la ligne en fonction du type de document, ni même d'activer ou de désactiver cette fonctionnalité au niveau de chaque document. Ce paramètre sera ajouté dans une version future de &kappname;.

## Utiliser l'indentation automatique

Le composant éditeur de &kappname; prend en charge différents modes d'indentation automatique, conçus pour différents formats de texte. Vous pouvez choisir parmi les modes disponibles à l'aide du menu Outils Indentation. Les modules d'indentation fournissent également une fonction par le biais du menu Outils Alignement, qui recalcule l'indentation de la ligne sélectionnée ou de la ligne actuelle. Ainsi, vous pouvez réindenter entièrement votre document en sélectionnant tout le texte et en activant cette action.

Tous les modes d'indentation utilisent les paramètres d'indentation associés au document actif.

On peut définir toutes sortes de variables de configuration, y compris celles relatives à l'indentation, à l'aide du menu Variables de document et Types de fichiers.

## Modes d'indentation automatique disponibles

Aucun

- Sélectionner ce mode désactive l'indentation automatique entièrement.

Normal

- Cet indenteur conserve simplement la même indentation que celle de la ligne précédente ayant un contenu autre qu'un caractère d'espacement. Vous pouvez combiner celle-ci à l'aide des actions d'indentation et de désindentation pour indenter selon votre gré.

Style C

- Il existe un indenteur pour le C et les langages similaires, tels que C++, C#, Java, JavaScript, etc. Celui-ci ne fonctionne pas avec des langages de scriptage tels que Perl ou PHP.

Haskell

- Un indenteur pour le langage de programmation fonctionnel Haskell.

Lilypond

- Un indenteur pour le langage de notation Lilypond pour la musique.

Lisp

- Un indenteur spécifique pour le langage de scriptage Lisp et les dialectes Lisp.

Python

- Un indenteur spécifique au langage de scriptage Python.

Style XML

- Un indenteur spécifique aux langages comme XML.

## Indicateurs de modification de ligne

Les indicateurs de modifications de ligne de &kappname; vous permette de voir facilement ce que vous avez modifié récemment dans un fichier. Par défaut, les changements enregistrés sont indiqués par une barre verte à gauche du document, tandis que les changements non enregistrés sont indiqués par une barre orange.

Les indicateurs de modification de ligne en action.

Vous pouvez modifier les couleurs utilisées dans le panneau de configuration Polices et couleurs, ou vous pouvez complètement désactiver cette fonctionnalité dans l'onglet Bordures du panneau de configuration Apparence.

## Mini-carte de défilement

La mini-carte de défilement de &kappname; affiche un aperçu des documents à la place de l'ascenceur. La partie du document actuellement visible est surlignée.

La mini-carte de défilement montre un aperçu du code source de &kate;.

Vous pouvez (dés)activer temporairement la mini-carte en choisissant Affichage Afficher une mini-carte de défilement ou de manière permanente dans la section Apparence de la configuration de &kappname;.