# Travailler avec l'éditeur &kate;

## Vue d'ensemble

L'éditeur de &kate; est la zone d'édition de la fenêtre de &kate;. &kwrite; fait également appel à cet éditeur et &konqueror; peut l'utiliser pour afficher des fichiers texte à partir de votre ordinateur local ou du réseau.

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

La zone d'édition

- C'est ici que 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ée à l'aide de l'élément de menu Affichage Afficher la bordure d'icônes.

La zone de numéros de lignes

- La zone de numéros de lignes affiche les numéros des lignes de toutes les lignes visibles du document.

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

L'arborescence

- L'arborescence vous permet de replier ou de déplier des blocs de lignes. Le calcul des localisations des lignes est réalisé par les règles 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

- Utiliser les signets

- Retour à la ligne automatique

- Utiliser l'indentation automatique

## Naviguer dans le texte

Se déplacer dans le texte dans &kate;se fait comme dans la plupart des éditeurs de texte graphiques. Vous déplacez le curseur en utilisant les touches fléchées et les touches de défilement vers le haut et vers le bas, les touchesDébut et Fin en combinaison avec les modificateurs Ctrl et Maj. La touche Maj est toujours utilisée pour effectuer une sélection alors que la touche Ctrl a différents effets sur des touches différentes.

- Les touches de défilement vers le haut et vers le bas permettent de défiler plutôt que de déplacer le curseur

- Avec les touches fléchées GaucheetDroite vous pouvez sauter des mots plutôt que des caractères.

- Avec les touches Page précédenteet Page suivante vous pouvez vous déplacer avec la barre visible plutôt que parcourir.

- Avec les touchesDébutet Finvous pouvez vous déplacer au début ou à la fin du document plutôt qu'au début ou à la fin de ligne.

&kate;vous fournit également un moyen d'aller rapidement à une accolade ou une parenthèse recherchée. Placez le curseur à l'intérieur de la parenthèse ou de l'accolade et appuyer surla touche Ctrl et 6pour aller à l'accolade ou la parenthèse recherchée.

De plus, vous pouvez utiliser un signet pour aller rapidement sur des emplacements que vous aurez défini vous-même.

## Travailler avec la sélection

Il y a deux façons de sélectionner du texte dans &kate; : à 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 curseur 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 appuyée tout en cliquant :

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

- S'il y a une sélection, depuis cette sélection, en l'incluant, jusqu'à la position du curseur 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 aussi 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. C'est pratique pour travailler avec des lignes séparées par des tabulations, par exemple.

Vous pouvez (dés)activer la sélection par bloc à l'aide de l'élément de menu Édition Activer / désactiver la sélection par bloc. Le raccourci clavier par défaut est F4.

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

Si l'option Écraser les sélections est cochée, 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 des sélection est activé par défaut.

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

### Utiliser la sélection persistante

Lorsque la sélection persistante est activé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 sortir le curseur de la sélection et saisir du texte.

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

La sélection continue peut être activée dans la page Sélection de la boîte de dialogue de configuration.

Si es options Sélection persistante et Écraser les sélections sont toutes les deux activées, 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 utilisez l'élément de menu Édition Copier. De plus, sélectionner du texte à la souris copie le texte dans le presse-papiers.

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

De plus, le texte sélectionné à la souris peut être collé en cliquant avec le bouton du milieu de la souris à l'emplacement souhaité.

Si vous utilisez l'environnement de bureau &kde;, vous pouvez récupérer un texte copié plus tôt depuis n'importe quelle application à l'aide de l'icône de &klipper; dans la boîte à miniatures du tableau de bord.

## Chercher et remplacer du texte

### Les boîtes de dialogue Chercher du texte et Remplacer du texte

Les boîtes de dialogue Chercher et Remplacer du texte de &kate; sont très semblables, excepté que la boîte de dialogue Remplacer du texte offre le moyen de saisir une chaîne de caractères de remplacement, ainsi que quelques options supplémentaires.

Les boîtes de dialogue comportent les options suivantes :

Texte à chercher

- C'est ici que vous devez saisir la chaîne de caractères à rechercher. L'interprétation de la chaîne dépend de quelques options décrites ci-dessous.

Expression rationnelle

- Si cette case est cochée, la chaîne de caractères est interprétée comme une expression rationnelle. Un bouton pour utiliser un outil graphique permettant de créer ou modifier l'expression sera activé.

  Reportez-vous aux Expressions rationnelles pour plus de détails les concernant.

Ne pas tenir compte de la casse

- Si cette option est cochée, la recherche ne tient pas compte de la casse.

Mots entiers seulement

- Si cette case 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; autre chose qu'un caractère alphanumérique - soit un autre caractère visible, soit un saut de ligne.

Depuis le curseur

- Si elle est sélectionnée, la recherche débutera à la position du curseur sinon elle commencera à la première ligne du document.

Chercher en arrière

- Si cette case est cochée, la recherche trouvera la première correspondance avant le point de départ, soit la position du curseur, soit le début du document, si l'option Depuis le début est cochée.

La boîte de dialogue Remplacer du texte comporte des options supplémentaires :

Remplacer par

- Saisissez ici la chaîne de remplacement.

Texte sélectionné

- Cette option est décochée si aucun texte n'est sélectionné ou si l'option Demander lors du remplacement est cochée. Si cette case est cochée, toutes les occurrences de la chaîne de recherche dans le texte sélectionné sont remplacées par la chaîne de remplacement.

Demander lors du remplacement

- Si cette option est cochée, une petite boîte de dialogue vous demande ce qu'il faut faire chaque fois qu'une occurrence est trouvée. Elle offre les options suivantes :

  Oui

- Cochez cette option pour remplacer l'occurrence actuelle (qui est sélectionnée dans l'éditeur).

Non

- Cochez cette option pour sauter l'occurrence actuelle et essayer d'en trouver une autre.

Tous

- Cochez cette option pour ne plus demander et remplacer simplement toutes les occurrences.

Fermer

- Cochez cette option pour sauter l'occurrence actuelle et arrêter la recherche.

Il n'y a actuellement aucun moyen d'utiliser une correspondance minimale lorsqu'on recherche une expression rationnelle. Cette option sera ajoutée dans les versions futures de &kate;.

### Chercher du texte

Pour chercher du texte, lancez l'interface de recherche avec &Ctrl;F ou via le menu Édition Chercher..., saisissez une chaîne de caractères à rechercher, paramétrez les options à votre convenance et cliquez sur OK. Si aucune occurrence n'est trouvée entre le point de départ de la recherche (soit la position du curseur dans le texte, soit le début du document) et la fin du document, le programme vous demande si vous souhaitez relancer la recherche depuis le début du document (ou depuis la fin, si vous faites une recherche arrière).

Si une occurrence est trouvée, elle est sélectionnée et la boîte de dialogue Chercher du texte est cachée, mais n'abandonnez pas, il est très facile de trouver les autres occurrences :

Pour trouver la prochaine occurrence dans la direction de la recherche, utilisez la commande Édition Poursuivre la recherche ou appuyez sur F3.

Pour trouver la prochaine occurrence dans la direction opposée, utilisez la commande Édition Trouver l'occurrence précédente ou appuyez sur &Maj;F3.

Si aucune occurrence n'est trouvée avant d'atteindre la fin du document (ou le début du document si vous effectuez une recherche en arrière), le programme vous demande si vous souhaitez relancer une recherche.

### Remplacer du texte

Pour remplacer du texte, lancez la boîte de dialogue "Remplacer du texte" via le menu Édition Remplacer ou le raccourci clavier &Ctrl;R, saisissez une chaîne de caractères à rechercher et optionnellement une chaîne de remplacement (si aucune chaîne de remplacement n'est saisie, chaque occurrence est remplacée par ""), parametrez les options à votre convenance et cliquez sur OK.

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

Reportez-vous aux regular-expressions pour plus de détails les concernant.

Vous pouvez `chercher`, `remplacer` et effectuer une `recherche incrémentale` enligne de commande

## Utiliser les signets

La fonction signets vous permet de marquer certaines lignes, pour pouvoir les retrouver facilement plus tard.

Vous pouvez ajouter ou supprimer un signet dans une ligne de deux façons :

- En déplaçant le curseur d'insertion sur cette ligne, activez le menu Signets(Dés)Activer les signets (&Ctrl;B).

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

Les signets sont disponibles dans le menu Signets. Les signets sont disponibles individuellement sous forme d'éléments de menu, étiquetés avec le numéro de la ligne et 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 se déplacer rapidement entre les signets ou entre le signet suivant et/ou précédent utilisez le menu Signet Suivant Ctrl keycap >ivanteou Signets Précédent Ctrl Page précédente

## Retour à la ligne automatique

Cette fonctionnalité vous permet de formater le texte d'une façon très simple : le texte va à la ligne, de manière à ce qu'aucune ligne n'excède 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é, cochez ou décochez la case Retour à la ligne automatique dans la page Édition de la boîte de dialogue de configuration.

Pour définir la longueur maximale d'une ligne (le nombre maximal de caractères par ligne), utilisez l'option Couper à la colonne option dansl'édition de la page 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 avant d'atteindre la largeur maximale de ligne.

- Lorsqu'un document est chargé, l'éditeur génère des retours à la ligne de la même manière, de sorte qu'aucune ligne ne dépasse la longueur maximale, si du moins elles contiennent des blancs qui le permettent.

Il n'y a actuellement aucun moyen de régler le retour à la ligne en fonction du type de document. Ce paramètre sera ajouté dans les versions futures de &kate;.

## Utiliser l'indentation automatique

Le composant d'édition de Kate prend en charge différents modes d'autoindentation, 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 via le menuOutils 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 opération.

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

Vous pouvez réaliser toute sorte de configuration de variables, incluant l'indentation associée en utilisant le menu Variables du document etTypes de fichiers

## Modes d'autoindentation disponibles

Aucun

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

Normal

- Cet indenteur se contente de garder 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 scripting tels que Perl ou PHP.

Style C SS

- Un indenteur alternatif pour le C et les langages similaires, avec les mêmes contraintes.

Style Python

- Il existe un indenteur spécifique au langage de scripting python.

XML

- Un indenteur automatique XML très convivial. À tester toutefois, n'essayez pas de l'utiliser avec du HTML autre que le XHTML, car il ne fonctionne pas avec les balises HTML de l'ancien style (ouvre des balises comme <br> par exemple).

Indenteur de variables

- L'indenteur de variables est expérimental et risque de changer le comportement ou de disparaître dans les versions futures.

  L'indenteur variable est spécial en ce qu'il peut être configuré à l'aide de variables dans le document (ou dans la configuration d'un type de fichier). Les variables suivantes sont lues :

  var-indent-indent-after

- Une expression rationnelle qui amène la désindentation d'une ligne d'une unité, si le premier non-espace-une ligne au-dessus correspond. var-indent-indent : une expression rationnelle qui provoque l'indentation d'une ligne correspondante d'une unité.

var-indent-unindent

- Une expression rationnelle qui amène la désindentation de la ligne d'une unité en cas de correspondance.

var-indent-triggerchars

- Une liste de caractères qui devrait provoquer le recalcul de l'indentation immédiatement à la saisie.

var-indent-handle-couples

- Une liste d'ensembles de parenthèses à gérer. Toute combinaison de 'parenthèses', 'accolades' et 'crochets'. Chaque type d'ensemble est géré de la manière suivante : s'il y a des instances d'ouverture non concordantes sur la ligne au-dessus, une unité d'indentation est ajoutée. S'il y a des instances de fermetures non concordantes sur la ligne au-dessus, une unité d'indentation est supprimée.

`var-indent-couple-attribute`

- Lorsqu'on cherche des paires ouvertures / fermetures non concordantes, seuls les caractères ayant cet attribut sont pris en compte. La valeur doit être le nom de l'attribut du fichier de syntaxe xml, par exemple "Symbole". Si elle n'est pas spécifiée, l'attribut 0 est utilisé(habituellement 'Texte normal').