# Outils d'édition avancée

## Commenter / décommenter

Les commandes Commenter et Décommenter, disponibles dans le menu Outils, permettent d'ajouter ou de supprimer des indicateurs de commentaires à la sélection ou à la ligne actuelle, s'il n'y a pas de texte sélectionné et si le format du texte qu'on modifie prend en charge les commentaires.

Les règles qui régissent la façon de créer des commentaires étant établies dans les définitions de syntaxe, l'ajout/la suppression de commentaires n'est pas possible si la coloration syntaxique n'est pas activée.

Certains formats définissent des indicateurs de commentaire sur une seule ligne, d'autres sur plusieurs lignes et d'autres encore, les deux. Si les indicateurs sur plusieurs lignes ne sont pas disponibles, il n'est pas possible de commenter une sélection qui ne contient pas la totalité de sa dernière ligne.

Si un indicateur de commentaire sur une seule ligne est disponible, le commentaire ligne par ligne aura la préférence là où il est applicable, car ce comportement contribue à éviter des problèmes avec les commentaires imbriqués.

Lorsqu'on supprime des indicateurs de commentaire, il ne faut pas sélectionner de texte non commenté. Lorsqu'on supprime des indicateurs de commentaire sur plusieurs lignes d'une sélection, tout espace en dehors des indicateurs de commentaire est ignoré.

Pour placer des indicateurs de commentaire, cliquez sur la ligne de menu Outils Commenter ou le raccourci clavier correspondant, par défaut &Ctrl;#.

Pour supprimer des indicateurs de commentaire, cliquez sur la ligne de menu Outils Décommenter ou le raccourci clavier correspondant, par défaut &Ctrl;&Maj;#.

## La ligne de commande du composant éditeur

Le composant éditeur de &kappname; offre une ligne de commande interne permettant d'effectuer diverses actions à partir d'une interface graphique minimale. La ligne de commande est un élément de texte situé au bas de la zone d'édition. Pour la voir, cliquez sur Affichage Afficher la ligne de commande ou utilisez le raccourci clavier (par défaut, F7). L'éditeur fournit un ensemble de commandes comme décrit ci-dessous. Des commandes additionnelles peuvent être fournies par des modules externes.

Pour exécuter une commande, saisissez cette dernière, puis appuyez sur la touche Entrée. La ligne de commande indique si elle a abouti et affiche éventuellement un message. Si vous avez saisi la ligne de commande en appuyant sur F7, elle disparaît automatiquement au bout de quelques secondes. Pour effacer le message et saisir une nouvelle commande, appuyez sur F7 à nouveau.

La ligne de commande est dotée d'un système d'aide intégré : exécutez la commande `help` pour démarrer. Pour afficher une liste de toutes les commandes disponibles, saisissez `help list`. Pour afficher l'aide concernant une commande donnée, saisissez `help `commande``.

Comme la ligne de commande comporte un historique intégré, vous pouvez réutiliser les commandes déjà saisies. Pour parcourir l'historique, utilisez les touches Haut et Bas. Lorsque vous affichez l'historique des commandes, la partie argument de la commande est sélectionnée, ce qui permet d'écraser aisément les arguments.

### Commandes standard de la ligne de commande

### Types d'arguments

BOOLÉEN

- On emploie cet argument avec les commandes qui servent à (dés)activer tel ou tel élément. Les valeurs admises sont `on`, `off`, `true`, `false`, `1` ou `0`.

ENTIER

- Un nombre entier.

CHAÎNE

- Une chaîne, entourée par des guillemets simples (`'`) ou doubles (`"`) lorsqu'elle contient des espaces.

#### Commandes pour configurer l'éditeur

Ces commandes sont fournies par le composant éditeur et permettent de configurer le document actif et son affichage uniquement. Ce comportement est pratique si vous voulez employer un autre paramètre que ceux par défaut, par exemple pour l'indentation.

    set-tab-widthENTIER largeur

- Associe la largeur de tabulation au nombre `largeur`.

    set-indent-widthENTIER largeur

- Associe la largeur d'indentation au nombre `largeur`. Utilisé seulement si vous indentez avec des espaces.

    set-word-wrap-columnENTIER largeur

- Associe la largeur de ligne pour le retour à la ligne forcé à `largeur`. Utilisé si vous avez choisi le retour à la ligne automatique pour votre texte.

    set-icon-borderBOOLÉEN activer

- Définit la visibilité de la bordure d'icônes.

    set-folding-markersBOOLÉEN activer

- Définit la visibilité de la bordure des indicateurs de pliage.

    set-line-numbersBOOLÉEN activer

- Définit la visibilité du panneau des numéros de ligne.

    set-replace-tabsBOOLÉEN activer

- Si cette option est cochée, les tabulations sont remplacées par des espaces au fur et à mesure que vous saisissez au clavier.

    set-remove-trailing-spaceBOOLÉEN activer

- Si cette option est cochée, les espaces de fin sont supprimés chaque fois que le curseur change de ligne.

    set-show-tabsBOOLÉEN activer

- Si cette option est cochée, les caractères de tabulation et l'espace de fin de ligne seront représentés par un petit point.

    set-show-indentBOOLÉEN activer

- Si cette option est cochée, l'indentation sera représentée par une ligne verticale en pointillés.

    set-indent-spacesBOOLÉEN activer

- Si cette option est cochée, l'éditeur indente avec des espaces `indentation-largeur` pour chaque niveau d'indentation plutôt qu'avec un caractère de tabulation.

    set-mixed-indentBOOLÉEN activer

- Si cette option est cochée, &kappname; utilise un mélange de tabulations et d'espaces pour l'indentation. Chaque niveau d'indentation aura une largeur `indentation-largeur` et d'autres niveaux d'indentation seront optimisés pour pouvoir utiliser autant de caractères de tabulation que possible.

  Lorsqu'elle est exécutée, cette commande définit en outre l'indentation avec des espaces activée et, si la largeur d'indentation n'est pas spécifiée, elle est définie à la moitié de la `tab-width` du document au moment de l'exécution.

    set-word-wrapBOOLÉEN largeur

- Active le retour à la ligne dynamique en fonction de `activer`.

    set-replace-tabs-saveBOOLÉEN activer

- Si cette option est cochée, les tabulations sont remplacées par un blanc à chaque fois que le document est enregistré.

    set-remove-trailing-space-saveBOOLÉEN activer

- Lorsque cette option est cochée, l'espace de fin est supprimé de chaque ligne à chaque fois que le document est enregistré.

    set-indent-modenom de CHAÎNE

- Définit le mode d'indentation automatique à `nom`. Si `nom` n'est pas connu, le mode est associé à « none ». Les modes autorisés sont « aucun », « normal », « cstyle », « haskell », « lilypond », « lisp », « python », « ruby » et « xml ».

    set-auto-identBOOLÉEN script

- Active ou désactive l'indentation automatique.

    set-highlightCHAÎNE coloration syntaxique

- Définit le système de coloration syntaxique pour le document. L'argument doit être un nom de coloration syntaxique autorisé, comme on le voit dans le menu Outils Coloration syntaxique. Cette commande fournit une liste de complétement automatique pour son argument.

    reload-scripts

- Recharge tous les scripts JavaScript utilisé par Kate, y compris les indenteurs et les scripts en ligne de commandes.

    set-modeCHAÎNE mode

- Choisit le schéma de types de fichiers pour le document actif.

    nn[oremap]CHAÎNE original CHAÎ mappé

- Mappe la séquence de touches `original` vers `mappé`.

#### Commandes d'édition

Ces commandes modifient le document actuel.

    indent

- Indente les lignes sélectionnées ou la ligne actuelle.

    unindent

- Désindente les lignes sélectionnées ou la ligne actuelle.

    cleanindent

- Nettoie l'indentation des lignes sélectionnées ou de la ligne actuelle en fonction des paramètres d'indentation du document.

    comment

- Insère des indicateurs de commentaire pour créer sur la sélection, les lignes sélectionnées ou la ligne actuelle, un commentaire en fonction du format du texte, comme défini par la coloration syntaxique concernant le document.

    uncomment

- Supprime les indicateurs de commentaires de la sélection, des lignes sélectionnées ou de la ligne actuelle en fonction du format du texte, comme défini par la définition de la coloration syntaxique concernant le document.

    kill-line

- Supprime la ligne actuelle.

    replaceSTRING motifSTRING remplacement

- Remplace le texte correspondant au `motif` par `remplacement`. Si vous voulez ajouter un blanc dans le `motif`, vous devez entourer d'apostrophes ou de guillemets à la fois le `motif` et le `remplacement`. Si les arguments n'ont pas de guillemets, le premier mot sert de `motif` et le reste de `remplacement`. Si `remplacement` est vide, chaque occurrence de `motif` est supprimée.

  Vous pouvez définir des drapeaux pour configurer la recherche, en ajoutant un caractère « : » (deux points), suivi d'une ou plusieurs lettres représentant une configuration, ce qui donne la forme `replace:options motif remplacement`. Les options disponibles sont les suivantes :

  `b`

- Recherche arrière.

`c`

- Recherche à partir de la position du curseur.

`e`

- Recherche dans la sélection uniquement.

`r`

- Recherche sur des expressions rationnelles. Si défini, vous pouvez utiliser `\N`, où N est un nombre représentant des captures dans la chaîne de remplacement.

`s`

- Recherche sensible à la casse.

`p`

- Invite de permission pour remplacer la prochaine occurrence.

`w`

- Correspondance de mots entiers uniquement.

    dateCHAÎNE format

- Insère une chaîne date/heure comme défini par le format spécifié `format` ou le format « aaaa-MM-jj hh:mm:ss », si aucun n'est indiqué. Les traductions suivantes sont effectuées lors de l'interprétation de `format` :

  `d` | Le jour sous la forme d'un nombre sans zéro de début (1-31).
  `dd` | Le jour sous la forme d'un nombre avec un zéro de début (01-31).
  `ddd` | Le nom abrégé du jour localisé (par exemple « Lun », « Dim »).
  `dddd` | Le nom entier du jour localisé (par exemple « Lundi », « Dimanche »).
  `M` | Le mois sous la forme d'un nombre sans zéro de début (1-12).
  `MM` | Le mois sous la forme d'un nombre avec un zéro de début (01-12).
  `MMMM` | Le nom long du mois localisé (par exemple « Janvier »... « Décembre »).
  `MMM` | Le nom abrégé du mois localisé (par exemple « Jan »… « Déc »).
  `aa` | L'année sous la forme d'un nombre à deux chiffres (00-99).
  `aaaa` | L'année sous la forme d'un nombre à quatre chiffres (1752-8000).
  `h` | L'heure sans zéro de début (0..23 ou 1..12 en cas d'affichage AM/PM).
  `hh` | L'heure avec un zéro de début (00..23 ou 01..12 en cas d'affichage AM/PM).
  `m` | La minute sans zéro de début (0..59).
  `mm` | La minute avec un zéro de début (00..59).
  `s` | La seconde sans zéro de début (0..59).
  `ss` | La seconde avec un zéro de début (00..59).
  `z` | Les millisecondes sans zéro de début (0..999).
  `zzz` | Les millisecondes avec des zéros de début (000..999).
  `AP` | Utiliser l'affichage AM/PM. AP sera remplacé soit par « AM », soit par « PM ».
  `ap` | Utiliser l'affichage. ap sera remplacé soit par « am », soit par « pm ».

    charCHAÎNE identifiant

- Cette commande permet d'insérer des caractères spéciaux par leur identifiant numérique, sous forme décimale, octale ou hexadécimale. Pour l'utiliser, ouvrez la boîte de dialogue Commandes d'édition, et saisissez `char: [numéro]` dans la zone de saisie, puis cliquez sur Ok.

  ##### Exemples avec `char`

  Entrée : `char:234`

  Sortie : `ê`

  Entrée : `char:0x1234`

  Sortie : `ሴ`

`s///[ig]` `%s///[ig]`

- Cette commande effectue une opération de recherche / remplacement comme sed dans la ligne actuelle, ou dans tout le fichier (`%s///`).

  En bref, on recherche dans le texte une expression qui correspond au texte recherché, l'expression rationnelle entre la première et la deuxième barre oblique. Lorsqu'une correspondance est trouvée, la partie de texte correspondant est remplacée par l'expression située entre le slash du milieu et le dernier slash. Les parenthèses dans le motif de recherche créent des références arrière, c'est-à-dire que la commande se souvient quelle partie de la chaîne correspondait dans les parenthèses ; ces chaînes peuvent être réutilisées dans le motif de remplacement, référencées par `\1` pour la première paire de parenthèses, `\2` pour la deuxième, etc.

  Pour rechercher une `(` ou une `)`, vous devez la faire précéder d'une barre oblique inverse, qui joue le rôle de caractère d'échappement : `\(\)`

  Si vous placez un `i` à la fin de l'expression, l'expression correspondante sera insensible à la casse. Si vous placez un `g` à la fin, toutes les occurrences du motif seront remplacées, sinon seule la première occurrence est remplacée.

  ##### Remplacer du texte dans la ligne actuelle

  Votre compilateur préféré vient de s'arrêter en vous indiquant que la classe `maClasse` mentionnée à la ligne 3902 de votre fichier source n'est pas définie.

  Il s'agit évidemment de `MaClasse` ! Allez à la ligne 3902 et, au lieu d'essayer de trouver le mot dans le texte, ouvrez la boîte de dialogue Commande d'édition, saisissez `s/maClasse/MaClasse/i`, cliquez sur le bouton Ok, enregistrez le fichier et compilez – avec succès, sans l'erreur.

  ##### Remplacer du texte dans le fichier entier

  Imaginez que vous avez un fichier dans lequel vous mentionnez plusieurs fois « Mlle Dupont » lorsque quelqu'un vient vous informer qu'elle vient de se marier avec « M. Martin ». Vous voulez, bien évidemment, remplacer chaque occurrence de « Mlle Dupont » par « Mme Martin ».

  Sur la ligne de commande, saisissez `%s/Melle Dupont/Mme Martin/` et appuyez sur Entrée. Vous avez terminé.

  ##### Un exemple plus avancé

  Cet exemple utilise les références arrière ainsi qu'une classe de caractères (si vous ne savez pas de quoi il s'agit, consultez la documentation relative à ce sujet mentionnée ci-dessous).

  Supposons que vous ayez la ligne suivante :

      void MyClass::DoStringOps( String      &foo, String &bar, String *p, int  &a, int &b )

  Maintenant, vous vous rendez compte que ces lignes ne donnent pas du code élégant et que vous voulez utiliser le mot clé `const` pour tous les arguments « adresse de », ceux caractérisés par l'opérateur & avant le nom d'argument. Vous voulez aussi simplifier les espaces,pour qu'il n'y ait qu'un caractère d'espacement entre les mots.

  Ouvrez la boîte de dialogue « Commande d'édition » et saisissez : `s/\s+(\w+)\s+(&)/ const \1 \2/g`, puis cliquez sur le bouton Ok. Le `g` à la fin de l'expression fait recompiler l'expression rationnelle pour chaque occurrence, pour enregistrer les références arrière.

  Sortie : `void MyClass::DoStringOps( const String &foo, const String &bar, String *p, const int &a, const int &b )`

  Mission réussie ! Mais que s'est-il passé ? Nous avons recherché des blancs (`\s+`), suivis d'un ou plusieurs caractères alphabétiques (`\w+`), eux-mêmes suivis d'un autre blanc (`\s+`) suivi d'une esperluette. Le processus a enregistré le fragment alphanumérique et l'esperluette pour le réutiliser lors de l'opération de remplacement. Puis, nous avons remplacé la partie correspondante de la ligne par un blanc suivi de « const », suivi d'un blanc, suivi de notre fragment alphanumérique enregistré (`\1`), lui-même suivi d'un blanc et de notre esperluette enregistrée (`\2`)

  Maintenant, comme dans certains cas, le fragment alphanumérique était « String » et dans d'autres « int », l'utilisation de la classe de caractères `//w` et du quantificateur `+` a été un grand avantage.

    sort

- Trie le texte sélectionné ou le document entier.

    natsort

- Trie naturellement les lignes sélectionnées ou le document entier.

  ##### `sort` contre `natsort`

  ``sort`(a10, a1, a2)` donne `a1, a10, a2`

  ``natsort`(a10, a1, a2)` donne `a1, a2, a10`

    moveLinesDown

- Déplace les lignes sélectionnées vers le bas.

    moveLinesUp

- Déplace les lignes sélectionnées vers le haut.

    uniq

- Enlève les lignes en doubles dans le texte sélectionné ou le document entier.

    rtrim

- Enlève les espaces en fin de ligne dans le texte sélectionné ou le document entier.

    ltrim

- Enlève les espaces en début de ligne dans le texte sélectionné ou dans le document entier.

    joinSTRING séparateur

- Assemble les lignes sélectionnées ou le document entier. Prend éventuellement un paramètre définissant un séparateur, par exemple : ``join` ', '`

    rmblank

- Supprime tous les espaces dans le texte sélectionné ou dans le document entier.

    unwrap

- Déplie le texte sélectionné ou le document entier.

    eachSTRING script

- Si l'argument est une fonction JavaScript, appelle ceci pour la liste des lignes sélectionnées et les remplace avec la valeur retournée de ce callback.

  ##### Assembler les lignes sélectionnées

  ``each` 'function(lines){return lines.join(", ")}'`

  ou, plus court :

  ``each` 'lines.join(", ")'`

    filterSTRING script

- Si l'argument est une fonction JavaScript, appelle ceci pour la liste des lignes sélectionnées et enlève celles pour lesquelles le callback renvoie faux.

  ##### Enlever les lignes vides

  ``filter` 'function(1){return 1.length > 0;}'`

  ou, plus court :

  ``filter` 'line.length > 0'`

    mapSTRING script

- Si l'argument est une fonction JavaScript, appelle ceci pour la liste des lignes sélectionnées et remplace la ligne avec la valeur du callback.

  ##### Enlever les lignes vides

  ``map` 'function(line){return line.replace(/^s+/,"");}'`

  ou, plus court :

  ``map` 'line.replace(/^s+/,"")'`

    duplicateLinesUp

- Duplique les lignes sélectionnées au dessus de la sélection actuelle.

    duplicateLinesDown

- Duplique les lignes sélectionnées en-dessous de la sélection actuelle.

#### Commandes de navigation

    gotoINT ligne

- Cette commande permet d'aller jusqu'à la ligne spécifiée.

    grep STRING motif

- Cherche l'expression rationnelle `motif` dans le document. Pour davantage d'informations, consultez regular-expressions.

    findSTRING motif

- Cette commande permet d'aller à la première occurrence de `motif`, en fonction de la configuration. Vous pouvez trouver les occurrences suivantes à l'aide de Édition Poursuivre la recherche (le raccourci par défaut est F3).

  Il est possible de configurer la commande Chercher en ajoutant à la fin un caractère « : », suivi d'une ou plusieurs options. La forme est `find:options motif`. Les options suivantes sont prises en charge :

  `b`

- Recherche arrière.

`c`

- Recherche à partir de la position du curseur.

`e`

- Recherche dans la sélection uniquement.

`r`

- Recherche sur des expressions rationnelles. Si défini, vous pouvez utiliser `\N`, où N est un nombre représentant des captures dans la chaîne de remplacement.

`s`

- Recherche sensible à la casse.

`w`

- Correspondance de mots entiers uniquement.

    ifindSTRING motif

- Cette commande fournit une recherche au fur et à mesure de la saisie (« as-you-type »). On peut configurer le comportement ou la recherche en ajoutant à la fin un caractère « : », suivi d'une ou plusieurs options, comme suit : `ifind:options motif`. Les options autorisées sont

  `b`

- Recherche arrière.

`r`

- Effectue une recherche sur des expressions rationnelles.

`s`

- Recherche sensible à la casse.

`c`

- Recherche à partir de la position du curseur.

#### Commandes pour les fonctions simples de l'éditeur (celles-ci dépendent de l'application dans laquelle le composant éditeur est utilisé).

    w

- Enregistrer le document actuel.

    wa

- Enregistrer tous les documents ouverts actuellement.

    q

- Ferme le document actuel.

    qa

- Ferme tous les documents ouverts.

    wq

- Enregistre et ferme le document actuel.

    wqa

- Enregistre et ferme tous les documents ouverts actuellement.

    x

- Enregistre et ferme le document actuel uniquement s'ii a changé.

    x

- Enregistre et ferme tous les documents ouverts actuellement uniquement s'ils ont changé.

    bp

- Se déplace au document précédent dans la liste des documents

    bn

- Se déplace au document suivant dans la liste des documents

    new

- Ouvre un nouveau document en vue scindée horizontalement.

    vnew

- Ouvre un nouveau document en vue scindée verticalement.

    e

- Recharger le document actuel s'il a changé sur le disque.

    enew

- Édite un nouveau document.

    print

- Ouvre la boîte de dialogue d'impression pour imprimer le document actuel.

## Utiliser le pliage du code

Le pliage du code permet de cacher des parties d'un document dans l'éditeur, ce qui facilite l'affichage de la vue d'ensemble de documents volumineux. Dans &kappname;, les régions pliables sont calculées à l'aide de règles définies dans les définitions de coloration syntaxique, et le pliage du code n'est donc disponible que dans certains formats - en général le code source du programme, le marquage XML et similaires. La plupart des définitions de coloration syntaxique prenant en charge le pliage du code permet également de définir manuellement des régions pliables, en général à l'aide des mots clés `DÉBUT` et `FIN`.

Pour utiliser la fonctionnalité de pliage du code, activez les marqueurs suivants à l'aide de l'élément de menu Affichage Afficher les indicateurs de pliage s'ils ne sont pas déjà visibles. Le panneau des indicateurs de pliage du côté gauche de l'écran affiche une vue graphique des régions pliables, avec des signes +/- pour indiquer l'opération possible sur une région donnée : un - signifie que la région est dépliée. Un clic sur - replie la région et sur + sera affiché à la place.

Trois commandes sont prévues pour manipuler l'état des régions de pliage. Consultez la documentation du menu.

L'état de repliement des lignes est conservé lorsqu'un fichier est fermé, de sorte que lorsque vous l'ouvrez de nouveau, les nœuds qui étaient repliés le seront toujours. Ceci s'applique également au opérations de rechargement.

Si vous ne voulez pas employer la fonctionnalité de pliage du code, vous pouvez désactiver l'option Afficher les indicateurs de pliage (si disponible) dans la page Apparence de la configuration de l'éditeur.