&Anders.Lund; &Anders.Lund.mail;
&traducteurEquipeKDE;

# 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 commentaire à la sélection ou à la ligne actuelle, s'il n'y a pas de texte sélectionné et si le format du texte que vous modifiez 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, on ne pas dé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 sélectionner aucun 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, utilisez la ligne de menu Outils Commenter ou le raccourci clavier correspondant, par défaut &Ctrl;#.

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

## La ligne de commande du composant d'édition

Le composant d'édition de Kate 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, 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 vous permet d'écraser aisément les arguments.

### Commandes standard de la ligne de commande

#### Commandes pour configurer l'éditeur

Ces commandes sont fournies par le composant d'édition 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.

##### 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 de caractères

    set-tab-widthENTIER largeur

  Définit la largeur de tabulation au nombre `largeur`

    set-indent-widthENTIER largeur

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

    set-word-wrap-columnENTIER largeur

  Définit 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-borderactiver

  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 activé, les tabulations sont remplacées par des espaces au fur et à mesure que vous saisissez au clavier.

    set-remove-trailing-spaceBOOLÉEN activer

  Si activé, les espaces de fin sont suppimés chaque fois que le curseur change de ligne.

    set-show-tabsBOOLÉEN activer

  Si activé, les caractères de tabulation et l'espace de fin de ligne seront représentés par un petit point.

    set-indent-spacesBOOLÉEN activer

  Si activé, 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 activé, Kate 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.

  Si 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 activé, les tabulations sont remplacées par un blanc chaque fois que le document est enregistré.

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

  Si activé, l'espace de fin est supprimé de chaque ligne chaque fois que le document est enregistré.

    set-indent-modenom

  Définit le mode d'indentation automatique à `nom`. Si `nom` n'est pas connu, le mode est défini à 'none'. Les modes autorisés sont 'cstyle', 'csands', 'xml', 'python', 'varindent' et 'none'.

    set-highlightcoloration syntaxique

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

#### 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 l'a établi la définition de la coloration syntaxique du document.

    uncomment

  Supprime les indicateurs de commentaire de la sélection, des lignes sélectionées ou de la ligne actuelle en fonction du format du texte, comme l'a établi la définition de la coloration syntaxique du document.

    kill-line

  Supprime la ligne actuelle.

    replacemotifremplacement

  Remplace le texte correspondant à `motif` par `remplacement`. Si vous voulez ajouter un blanc dans le `motif`, vous devez entourer d'aspotrophes 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 répré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.

    dateformat

  Insère une chaîne date/time 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).
  `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 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 ».

    charidentifiant

  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 de `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 part de texte correspondant est remplacée par l'expression entre la partie du milieu et la dernière partie de la chaîne. Les parenthèses dans le motif de recherche créent des références arrières, c'est-à-dire que la commande se souvient quelle part du motif 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'un antislash, 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.

  C'est évidemment `MaClasse` ! Vous allez à la ligne 3902 et, au lieu d'essayer de trouver le mot dans le texte, vous 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 entre et vous dit 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ères ainsi qu'une classe de caractères (si vous ne savez pas de quoi il s'agit, reportez-vous à 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 ce n'est pas du code élégant et décidez 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, de sorte qu'il n'y a qu'un caractère d'espace 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 que l'expression rationnelle est recompilée pour chaque occurrence, pour enregistrer les références arrières

  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.

#### Commandes de navigation

    gotoENTIER ligne

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

    findmotif

  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 réprésentant des captures dans la chaîne de remplacement.

  `s`

    Recherche sensible à la casse.

  `w`

    Correspondance de mots entiers uniquement.

    ifindmotif

  Cette commande fournit une recherche au fur et à mesure de la saisie (« as-you-type »). Vous pouvez 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 les suivantes :

  `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.