# Manuel &app; V&manrevision;

2003
Sun Microsystems
2002
Sun Microsystems
2000
Eric Baudais
Projet de documentation GNOME
&legal; Équipe de documentation Sun GNOME Sun Microsystems Eric Baudais Projet de documentation GNOME

     baudais@okstate.edu

Baris Cicek a fourni des informations concernant les précédentes révisions de l'application gedit. Remerciements Ajit George a fourni des informations concernant les greffons.

&app; Manuel V&manrevision;
&date;

Équipe de documentation Sun GNOME

Projet de documentation GNOME

Manuel gedit V2.5
Mars 2003

Équipe de documentation Sun GNOME

Projet de documentation GNOME

Manuel gedit V2.4
Janvier 2003

Équipe de documentation Sun GNOME

Projet de documentation GNOME

Manuel gedit V2.3
Septembre 2002

Équipe de documentation Sun GNOME

Projet de documentation GNOME

Manuel gedit V2.2
Août 2002

Équipe de documentation Sun GNOME

Projet de documentation GNOME

Manuel gedit V2.1
Juin 2002

Équipe de documentation Sun GNOME

Projet de documentation GNOME

Manuel gedit V2.0
Mars 2002

Équipe de documentation Sun GNOME

Projet de documentation GNOME

gedit V1.0
2000

Eric Baudais baudais@okstate.edu

Projet de documentation GNOME

Le présent manuel décrit la version &appversion; de &app;.

## Vos commentaires

Pour nous signaler un problème ou nous faire part de suggestions concernant l'application &app; ou le présent manuel, procédez comme indiqué à la GNOME Feedback Page.

## Introduction

L'application &app; permet de créer et de modifier des fichiers texte. Vous pouvez utiliser les greffons de &app; pour exécuter, dans la fenêtre &app;, différentes tâches associées à l'édition de texte.

## Démarrage

### Démarrage de &app;

Vous pouvez démarrer &app; par l'intermédiaire des éléments suivants :

Menu

  Pour de plus amples informations sur la procédure de démarrage de &app; à partir d'un menu, reportez-vous à la dernière version de &ug; pour votre plate-forme.

Ligne de commande

  Exécutez la commande suivante : `gedit`

### Lancement de &app;

Lorsque vous lancez &app;, la fenêtre suivante apparaît :

#### Fenêtre &app;

Affiche la fenêtre principale gedit,

qui contient les éléments suivants :

Barre de menus

  Les menus ce cette barre contiennent toutes les commandes nécessaires à l'utilisation des fichiers dans &app;.

Barre d'outils

  Cette barre contient un sous-ensemble des commandes accessibles depuis la barre de menus.

Zone d'affichage

  La zone d'affichage contient le texte du fichier en cours de modification.

Fenêtre de sortie

  La fenêtre de sortie affiche les résultats retournés par le greffon de la commande Shell et le greffon de comparaison de fichiers.

Barre d'état

  Cette barre affiche des informations sur l'activité actuelle de &app; ainsi que des informations contextuelles sur les éléments de menu.

Lorsque vous cliquez avec le bouton droit dans la fenêtre &app;, l'application affiche un menu contextuel. Celui-ci contient les commandes d'édition de texte les plus courantes.

### Ouverture d'un fichier

Pour ouvrir un fichier, sélectionnez Fichier Ouvrir afin d'afficher la boîte de dialogue Ouvrir fichier. Sélectionnez le fichier à ouvrir, puis cliquez sur OK. Le fichier s'affiche dans la fenêtre &app;.

Il est possible d'ouvrir plusieurs fichiers dans &app;, mais la fenêtre de l'application n'affiche qu'un seul fichier à la fois. L'ouverture de chaque nouveau fichier se traduit par l'apparition d'un nouvel onglet dans la fenêtre. Pour visualiser un autre fichier ouvert, cliquez sur l'onglet correspondant. Pour créer une nouvelle fenêtre &app; pour chaque fichier ouvert, faites glisser l'onglet correspondant sur le bureau.

Vous pouvez également utiliser le menu Documents pour passer d'un fichier à l'autre. Vous pouvez sélectionner Documents Déplacer vers une nouvelle fenêtre pour déplacer un document vers une autre fenêtre de &app;.

L'application enregistre les chemins d'accès et les noms des cinq derniers fichiers modifiés et les affiche sous forme d'options du menu Fichier . Vous pouvez aussi cliquer sur l'icône Affiche les derniers fichiers ouverts. de la barre d'outil pour afficher la liste des derniers fichiers ouverts.

### Ouverture de plusieurs fichiers depuis une ligne de commande

Vous pouvez exécuter &app; depuis une ligne de commande et ouvrir un ou plusieurs fichiers. Pour ouvrir plusieurs fichiers depuis une ligne de commande, entrez la commande ci-dessous et appuyez sur Retour :

`gedit file1.txt file2.txt file3.txt`

Lorsque l'application démarre, les fichiers sélectionnés s'affichent dans la fenêtre &app;.

Pour de plus amples informations sur l'exécution de &app; à partir d'une ligne de commande, reportez-vous à &app;1.

## Utilisation

### Création d'un fichier

Pour créer un fichier, sélectionnez Fichier Nouveau . L'application affiche un nouveau fichier dans la fenêtre &app;.

### Enregistrement d'un fichier

Vous pouvez enregistrer les fichiers des manières suivantes :

- Pour enregistrer les modifications apportées à un fichier existant, sélectionnez Fichier Enregistrer ou cliquez sur Enregistrerdans la barre d'outils.

- Pour enregistrer un nouveau fichier ou enregistrer un fichier existant sous un nouveau nom, sélectionnez Fichier Enregistrer sous . Nommez le fichier dans la boîte de dialogue Enregistrer sous, puis cliquez sur OK.

- Pour enregistrer tous les fichiers ouverts dans &app;, sélectionnez Documents Tout enregistrer .

### Édition d'un texte

Vous pouvez éditer le texte d'un fichier des manières suivantes :

- Entrez un nouveau texte à l'aide du clavier.

- Pour effacer du texte, utilisez la touche Supprimer.

- Pour modifier du texte, utilisez les éléments Couper, Copier, Coller, et Supprimer du menu Éditer.

Vous pouvez appliquer les actions suivantes au texte sélectionné :

- Pour copier le texte sélectionné vers un tampon, choisissez Éditer Copier .

- Pour supprimer le texte sélectionné du fichier et le déplacer vers un tampon, sélectionnez Éditer Couper.

- Pour supprimer définitivement le texte sélectionné du fichier, sélectionnez Éditer Supprimer.

- Pour insérer le contenu du tampon à l'endroit où est positionné le curseur, sélectionnez Éditer Coller . Vous devez préalablement copier ou couper le texte avant de pouvoir le coller dans le fichier.

- Pour sélectionner tout le texte d'un fichier, sélectionnez Éditer Tout sélectionner .

### Annulation ou restauration des modifications

Pour annuler une modification, sélectionnez Éditer Annuler. Pour restaurer une modification, sélectionnez Éditer Refaire. Le nombre maximum d'opérations pouvant être annulées est déterminé par le paramètre Limiter le nombre d'annulations à de l'onglet de la boîte de dialogue Préférences.

### Recherche de texte

Pour rechercher une chaîne de caractères dans un fichier, procédez comme suit :

1. Sélectionnez Recherche Rechercher pour afficher la boîte de dialogue Rechercher.

2. Entrez la chaîne de caractères à rechercher dans le champ Rechercher.

   Vous pouvez entrer les séquences d'échappement ci-après :

   - `\n`

     Cette séquence d'échappement sert à indiquer une nouvelle ligne

   - `\t`

     Cette séquence d'échappement sert à indiquer une tabulation

   - `\r`

     Cette séquence d'échappement sert à indiquer un retour chariot

3. Sélectionnez l'option Respecter la casse pour ne rechercher que les occurrences respectant la casse du texte entré.

4. Sélectionnez l'option Mots entiers seulement pour ne rechercher que les occurrences correspondant exactement au texte entré.

5. Sélectionnez l'option Dans l'ensemble du fichier pour qu'une fois la fin du fichier atteinte la recherche se poursuive depuis le début du fichier.

6. Cliquez sur Rechercher pour rechercher la première occurrence de la chaîne de caractères entrée. Si &app; la trouve, elle déplace le pointeur jusqu'à celle-ci et la sélectionne.

7. Pour rechercher l'occurrence suivante, cliquez de nouveau sur le bouton Rechercher.

8. Pour terminer la recherche, cliquez sur Fermer.

### Recherche et remplacement de texte

Pour rechercher une chaîne de caractères dans un fichier et la remplacer, procédez comme suit :

1. Sélectionnez Recherche Remplacer pour afficher la boîte de dialogue Remplacer.

2. Entrez la chaîne de caractères à rechercher dans le champ Rechercher.

   Vous pouvez entrer les séquences d'échappement ci-après :

   - `\n`

     Cette séquence d'échappement sert à indiquer une nouvelle ligne

   - `\t`

     Cette séquence d'échappement sert à indiquer une tabulation

   - `\r`

     Cette séquence d'échappement sert à indiquer un retour chariot

3. Indiquez, dans le champ Remplacer par, la chaîne de caractères devant remplacer le texte recherché.

4. Sélectionnez l'option Respecter la casse pour ne rechercher que les occurrences respectant la casse du texte entré.

5. Sélectionnez l'option Mots entiers seulement pour ne rechercher que les occurrences correspondant exactement au texte entré.

6. Sélectionnez l'option Dans l'ensemble du fichier pour qu'une fois la fin du fichier atteinte la recherche se poursuive depuis le début du fichier.

7. Cliquez sur Rechercher pour rechercher la première occurrence de la chaîne de caractères entrée. Si &app; la trouve, elle déplace le pointeur jusqu'à celle-ci et la sélectionne.

8. Cliquez sur le bouton Remplacer pour remplacer l'occurrence par le texte figurant dans le champ Remplacer par. Cliquez sur le bouton Tout remplacer pour remplacer toutes les occurrences de la chaîne.

9. Pour rechercher l'occurrence suivante, cliquez de nouveau sur le bouton Rechercher.

10. Pour terminer la recherche, cliquez sur Fermer.

### Ouverture d'un fichier depuis une URI

Pour ouvrir un fichier depuis une URI (Uniform Resource Identifier), procédez comme suit :

- Sélectionnez Fichier Ouvrir l'emplacement pour afficher la boîte de dialogue Ouvrir l'emplacement. Indiquez l'URI du fichier à ouvrir, puis cliquez sur Ouvrir.

- Entrez `gedit URI` dans une ligne de commande, où URI représente l'URI du fichier à ouvrir, puis appuyez sur Retour. Voici quelques exemples d'URI pouvant être utilisées : `http:`, `ftp:`, `file:` et toutes les méthodes supportées par `gnome-vfs`.

L'application ouvre le fichier situé à l'URI en mode lecture seule.

### Envoi de la sortie d'une commande dans un fichier

Vous pouvez utiliser &app; pour envoyer la sortie d'une commande dans un fichier texte. Par exemple, pour envoyer la sortie d'une commande `ls` dans un fichier texte, entrez `ls | gedit`, puis appuyez sur Retour.

La sortie de la commande `ls` s'affiche dans la fenêtre &app;, dans un nouveau fichier texte.

Vous pouvez également utiliser le greffon de la commande Shell pour envoyer la sortie de la commande dans le fichier actif. Pour de plus amples informations sur l'utilisation du greffon de commande du shell, reportez-vous à .

### Positionnement du curseur sur une ligne spécifique

Pour positionner le curseur sur une ligne spécifique du fichier ouvert, procédez comme suit :

1. Sélectionnez Recherche Aller à la ligne pour afficher la boîte de dialogue Aller à la ligne.

2. Entrez le numéro de la ligne où vous souhaitez placer le curseur dans le champ Numéro de la ligne.

3. Cliquez sur le bouton Aller à la ligne. L'application déplace le pointeur à la ligne spécifiée.

4. Pour fermer la boîte de dialogue Aller à la ligne, cliquez sur Fermer.

### Modification du mode d'entrée

Pour modifier le mode d'entrée, cliquez avec le bouton droit dans la fenêtre de texte, puis sélectionnez Méthodes d'entrée. L'élément de menu Insérer un caractère de contrôle Unicode propose des options de configuration de caractères utiles si vous travaillez avec des jeux de caractères non latins.

### Impression d'un fichier

Vous pouvez utiliser &app; pour exécuter les opérations d'impression suivantes :

- envoyer un fichier à une imprimante ;

- envoyer la sortie de la commande d'impression à un fichier.

Si vous choisissez la seconde option, &app; envoie la sortie à un fichier dans un format de prétraitement. Les formats de prétraitement les plus courants sont PostScript et PDF (Portable Document Format).

Pour afficher un aperçu des pages à imprimer, sélectionnez Fichier Aperçu avant impression .

Pour imprimer le fichier actif sur une imprimante ou dans un fichier, sélectionnez Fichier Imprimer. La boîte de dialogue Imprimer s'affiche.

Elle vous permet de spécifier les options d'impression suivantes :

#### Onglet Imprimante

Panneau Imprimante

  Sélectionnez l'imprimante sur laquelle vous souhaitez imprimer le fichier.

Imprimer

  Sélectionnez l'une des options suivantes pour déterminer le nombre de pages à imprimer :

  - Tout

    Cette option vous permet d'imprimer toutes les pages du fichier.

  - Sélection

    Cette option permet de n'imprimer que le texte sélectionné. Elle n'est accessible que si vous avez sélectionné du texte.

Nombre d'exemplaires

  Cette zone de sélection numérique permet de spécifier le nombre d'exemplaires à imprimer.

Rassembler

  Si vous imprimez plusieurs exemplaires du fichier, cette option vous permet de les rassembler.

Nom du fichier

  Si vous imprimez le document dans un fichier, entrez le nom du fichier de sortie dans cette zone de texte.

#### Onglet Papier

Format

  Cette zone de liste déroulante permet de sélectionner le format de papier sur lequel imprimer le fichier.

Largeur

  Cette zone de sélection numérique vous permet de spécifier la largeur du papier. La liste déroulante adjacente vous offre la possibilité de modifier l'unité de mesure utilisée.

Hauteur

  Cette zone de sélection numérique vous permet de spécifier la hauteur du papier.

Orientation de l'alimentation

  Cette liste déroulante permet de sélectionner l'orientation du papier dans l'imprimante.

Orientation de la page

  Cette zone de liste déroulante vous permet de sélectionner l'orientation du papier.

Disposition

  Cette zone de liste déroulante permet de sélectionner la mise en page. Un aperçu de la mise en page sélectionnée s'affiche dans la zone Aperçu.

### Personnalisation de la barre d'outils et de la barre d'état

Pour afficher ou masquer la barre d'outils, sélectionnez Vue Barre d'outils. Pour personnaliser l'affichage de la barre d'outils, sélectionnez Vue Personnaliser la barre d'outils , puis sélectionnez l'un des éléments de menu suivants :

- Valeurs par défaut du bureau :

  Affiche la barre d'outils par défaut.

- Icône

  N'affiche que des icônes.

- Icône et texte :

  Affiche des icônes et du texte.

- Texte prioritaire à côté des icônes

  Affiche les icônes ainsi que du texte à côté certaines d'entre elles.

Pour afficher ou masquer la barre d'état, sélectionnez Vue Barre d'état . Pour personnaliser l'affichage de la barre d'état, sélectionnez Vue Personnaliser la barre d'état , puis choisissez l'un des éléments de menu suivants :

- Afficher la position du curseur:

  Affiche le numéro de la ligne et de la colonne où se trouve le pointeur.

- Afficher le mode d'écrasement:

  Affiche le mode d'édition. Si l'éditeur est en mode d'insertion, la barre d'état contient le mot INS. Si l'éditeur est en mode de superposition, la barre d'état contient le mot SUP.

Pour afficher ou masquer la fenêtre de sortie, sélectionnez Vue Fenêtre de sortie .

## Préférences

Pour configurer &app;, sélectionnez Éditer Préférences . La boîte dialogue Préférences contient les catégories suivantes :

### Éditeur

La catégorie Éditeur se subdivise en sous-catégories :

#### Polices et couleurs

Utiliser la police du thème par défaut

  Cette option permet d'utiliser la police système par défaut pour le texte de la fenêtre &app;.

Police de l'éditeur

  Ce champ indique la police utilisée par &app; pour afficher du texte. Le bouton vous permet de spécifier le type, le style et la taille de police à utiliser pour le texte.

Utiliser les couleurs du thème par défaut

  Cette option vpus permet d'utiliser les couleurs du thème par défaut dans la fenêtre &app;.

Couleur du texte

  Cliquez sur le bouton Couleur du texte pour afficher la boîte de dialogue de sélection des couleurs. Sélectionnez une couleur à utiliser pour afficher du texte dans la fenêtre &app;.

Couleur d'arrière-plan

  Cliquez sur le bouton Couleur d'arrière-plan pour afficher la boîte de dialogue de sélection des couleurs. Sélectionnez une couleur d'arrière-plan pour la fenêtre de texte &app;.

Couleur du texte sélectionné

  Cliquez sur le bouton Couleur du texte sélectionné pour afficher la boîte de dialogue de sélection des couleurs. Sélectionnez une couleur à utiliser pour afficher le texte sélectionné.

Couleur de surbrillance

  Cliquez sur le bouton Couleur de surbrillance pour afficher la boîte de dialogue de sélection des couleurs. Sélectionnez une couleur d'arrière-plan à utiliser pour mettre en surbrillance une sélection de texte.

#### Tabulations

Fixer la largeur des tabulations à

  Cette zone de sélection numérique vous permet de spécifier la largeur de la tabulation insérée lorsque vous appuyez sur la touche Tab.

Insérer des espaces au lieu de tabulations

  Cette option permet d'indiquer à &app; d'insérer des espaces à la place des tabulations lorsque vous appuyez sur la touche Tab.

#### Renvoi automatique à la ligne

Activer le renvoi automatique à la ligne

  Cette option vous permet d'activer le renvoi automatique du texte à la ligne suivante, au niveau du caractère, lorsque vous atteignez la limite de la fenêtre de texte.

Ne pas couper les mots

  Cette option vous permet d'activer le renvoi automatique du texte à la ligne suivante, au niveau du mot, lorsque vous atteignez la limite de la fenêtre de texte.

#### Retrait automatique

Activer le retrait automatique

  Cette option vous permet de spécifier que la prochaine ligne doit commencer au niveau du retrait de la ligne actuelle.

#### Numéros de lignes

Afficher les numéros de lignes

  Sélectionnez cette option pour afficher les numéros de lignes du côté gauche de la fenêtre &app;.

#### Ouverture

Codages supportés

  Le codage de caractères est une méthode de conversion d'octets en caractères. Plusieurs types de codages peuvent convertir la même séquence d'octets en caractères différents ou produire un résultat incorrect. Si vous ouvrez un fichier avec le même codage que celui utilisé pour créer le fichier, tous les caractères s'affichent normalement. Toutefois, si vous ouvrez le fichier avec un autre codage, certains caractères ne s'affichent pas correctement ou une erreur peut être renvoyée.

  Par défaut, &app; utilise un codage UTF-8 lors de l'ouverture d'un fichier. Le codage UTF-8 peut s'utiliser pour des textes dans toutes les langues puisqu'il couvre quasiment tous les alphabets et jeux de caractères connus. Si le fichier n'est pas au format UTF-8, &app; tente de l'ouvrir avec le codage de l'environnement localisé actuel. Si cette action échoue, &app; tente d'utiliser un codage de la liste de codages supportés en commençant au début de la liste.

  Pour modifier le contenu de la liste des codages supportés, utilisez les boutons décrits dans le tableau suivant :

  Bouton | Description
  --- | ---
  Ajouter | Ajoute un codage à la liste.
  Supprimer | Supprime un codage de la liste.
  Flèche haut | Déplace un codage vers le haut de la liste.
  Flèche bas | Déplace un codage vers le bas de la liste.

#### Enregistrement

Créer une copie de sauvegarde des fichiers avant l'enregistrement

  Cette option permet de créer une copie de sauvegarde du fichier à chaque fois que vous l'enregistrez. Le nom d'un fichier de copie de sauvegarde se termine par le signe ˜.

Enregistrer automatiquement le fichier actuel toutes les

  Cette option permet d'enregistrer automatiquement le fichier courant à intervalle régulier. La zone de sélection numérique permet de spécifier l'intervalle entre les enregistrements.

Lors de l'enregistrement d'un fichier existant

  Sélectionnez l'une des options d'enregistrement suivantes :

  - Toujours utiliser l'encodage UTF-8 (plus rapide)

    Cette option permet d'enregistrer les fichiers avec le codage UTF-8.

  - Utiliser si possible le codage de l'environnement localisé actuel

    Cette option permet d'enregistrer les fichiers à l'aide de la langue courante. Vous pouvez configurer différents modes d'entrée dans les versions localisées.

  - Utiliser si possible le codage du fichier original

    Cette option permet d'enregistrer un fichier à l'aide de la langue courante si le fichier a déjà été enregistré avec celle-ci.

Lors de l'enregistrement d'un nouveau fichier

  Sélectionnez l'une des options de sauvegarde suivantes :

  - Toujours utiliser l'encodage UTF-8 (plus rapide)

    Sélectionnez cette option pour enregistrer des nouveaux fichiers avec un codage UTF-8.

  - Utiliser si possible le codage de l'environnement localisé actuel

    Cette option permet d'enregistrer les fichiers à l'aide de la langue courante. Vous pouvez configurer différents modes d'entrée dans les versions localisées.

#### Annulation

Limiter le nombre d'annulations à

  Cette option permet de définir la limite du nombre de modifications pouvant être annulées. La zone de sélection numérique permet de spécifier le nombre maximum d'actions qu'il est possible d'annuler.

### Impression

La catégorie Impression se subdivise en sous-catégories :

#### Page

Imprimer les en-têtes des pages

  Cette option permet d'insérer un en-tête sur chaque page imprimée. Les en-têtes ne peuvent être configurés.

Activer le renvoi automatique à la ligne

  Cette option vous permet d'activer le renvoi automatique à la ligne, au niveau du mot, lors de l'impression. L'application considère les lignes issues du renvoi automatique comme de nouvelles lignes à des fins de numérotation.

Imprimer les numéros de lignes toutes les

  Cette option permet d'inclure des numéros de lignes sur le fichier imprimé. La zone de sélection numérique vous permet de spécifier l'espacement des numéros de ligne, par exemple toutes les 5 lignes, les 10 lignes, etc.

#### Polices

Corps du texte

  Ce bouton permet de sélectionner la police à utiliser pour l'impression du corps du texte d'un fichier.

En-têtes de pages

  Ce bouton permet de sélectionner la police à utiliser pour l'impression des en-têtes.

Numéros de lignes

  Ce bouton permet de sélectionner une police à utiliser pour imprimer les numéros de ligne.

Pour réinitialiser les polices par défaut pour l'impression d'un fichier depuis &app;, cliquez sur le bouton Restaurer les polices par défaut.

### Greffons

Pour de plus amples informations sur l'utilisation de la catégorie Greffons de la boîte de dialogue Préférences, reportez-vous à.

## Utilisation des greffons

Un greffon est un programme complémentaire qui optimise les fonctionnalités d'une application. Les greffons &app; vous permettent d'exécuter différentes fonctions associées à l'édition de texte depuis la fenêtre &app;. Vous trouverez, dans le tableau ci-dessous, une liste des greffons de &app;.

Nom du greffon | Objet
--- | ---
Table ASCII | Affiche une boîte de dialogue contenant une table ASCII. La table ASCII vous permet d'insérer des caractères dans un fichier.
Journal de changements CVS | Ouvre les journaux associés aux commandes de validation CVS.
Comparaison de fichiers | Compare deux fichiers et affiche les différences détectées dans une fenêtre de résultat. Ce greffon utilise la commande `diff` pour effectuer cette comparaison.
Statistiques du document | Compte le nombre de lignes, mots, caractères et octets du fichier actif. Le greffon affiche les résultats dans la boîte de dialogue Statistiques du document.
Lignes de retrait | Mets les lignes sélectionnées en retrait ou supprime le retrait des lignes sélectionnées.
Insertion de la la date et de l'heure | Insère la date et l'heure actuelles dans un fichier.
Commande Shell | Affiche la sortie texte d'une commande shell dans une fenêtre de sortie.
Tri | Tri le texte sélectionné.
Liste d'étiquettes | Affiche une fenêtre contenant une liste des étiquettes courantes. Cette fenêtre vous permet d'insérer une étiquette dans un fichier.
Nom d'utilisateur | Insère le nom de l'utilisateur courant dans le fichier.

### Chargement des greffons &app;

Pour charger les greffons &app;, sélectionnez Éditer Préférences . Cliquez sur la sous-catégorie Gestionnaire de la catégorie Greffons. La sous-catégorieGestionnaire affiche les informations ci-après :

- une liste des greffons à utiliser avec &app;.

- un bouton Configurer le greffon ; Ce bouton vous permet d'ouvrir une boîte de dialogue de configuration pour les greffons personnalisables. Pour de plus amples informations, reportez-vous à et .

- une brève description de tous les greffons. Pour afficher une description, sélectionnez le greffon dans la liste.

- des détails concernant l'auteur du greffon et le nom du module.

Pour charger un greffon, cochez la case située en regard de son nom. L'application &app; ajoute le greffon au menu de &app; approprié, comme indiqué dans le tableau suivant.

Nom du greffon | Ajouté au menu
--- | ---
Table ASCII | Vue Table ASCII
Journal de changements CVS | Fichier Ouvrir les journaux de changements
Comparaison de fichiers | Outils Comparer des fichiers
Statistiques du document | Outils Statistiques du document
Lignes de retrait | Éditer Retrait Éditer Suppression du retrait
Insertion de la la date et de l'heure | Éditer Insertion de la date et heure
Commande Shell | Outils Exécuter la commande
Tri | Éditer Trier
Liste d'étiquettes | Affichage Liste d'étiquettes
Nom d'utilisateur | Éditer Insérer le nom d'utilisateur

Pour fermer la boîte de dialogue Préférences, cliquez sur Fermer.

### Suppression des greffons de &app;

Un greffon reste actif lorsque vous fermez &app;.

Pour supprimer les greffons &app;, sélectionnez Éditer Préférences . Cliquez sur la sous-catégorie Gestionnaire de la catégorie Greffons. Pour supprimer un greffon, désélectionnez la case à cocher située en regard de son nom.

Pour fermer la boîte de dialogue Préférences, cliquez sur Fermer.

### Greffon de la table ASCII

Le greffon de la table ASCII affiche une boîte de dialogue contenant une table ASCII. La table ASCII vous permet d'insérer des caractères dans un fichier. Pour utiliser le greffon de la table ASCII suivez les étapes indiquées ci-dessous :

1. Chargez le greffon de la table ASCII.

2. Sélectionnez Vue Table ASCII pour afficher la boîte de dialogue Table ASCII.

3. Parcourez la liste jusqu'au caractère requis puis sélectionnez-le d'un seul clic.

4. Cliquez sur le bouton Insérer car pour insérer le caractère à l'emplacement du curseur dans le fichier actif.

5. Lorsque vous avez fini d'insérer des caractères ASCII, cliquez sur Fermer pour fermer la boîte de dialogue Table ASCII.

### Greffon du journal de modifications CVS

Le greffon du journal de modifications CVS ouvre les messages de journal associés aux commandes de validation CVS. Le greffon vous permet de coller facilement le texte dans le message de validation depuis le fichier journal de modifications. Pour utiliser le greffon du journal de modifications CVS, suivez les étapes indiquées ci-dessous :

1. Définissez la variable d'environnement CVSEDITOR sur &app;. Exemple : si vous utilisez le shell`bash`, exécutez la commande suivante à l'invite du système d'exploitation :

        export CVSEDITOR=&app;

2. Validez un fichier vers le CVS de la manière habituelle. Une fenêtre &app; vous permettant d'entrer le message de validation s'ouvre.

3. Chargez le greffon du journal de modifications CVS.

4. Sélectionnez Fichier Ouvrir journal de modifications CVS pour ouvrir tous les fichiers journaux de modifications référencés dans le message de validation. &app; ouvre chaque fichier journal de modifications dans un nouvel onglet.

5. Copiez les entrées des journaux de modifications (que vous souhaitez ajouter au message de validation) depuis les fichiers journaux de modifications &app;.

6. Insérez les entrées des journaux de modifications dans l'onglet du message de validation &app;.

7. Enregistrez vos modifications dans le message de validation, puis fermez tous les fichiers.

8. Quittez &app;.

### Greffon de comparaison de fichiers

Le greffon de comparaison de fichiers permet de comparer deux fichiers et d'afficher les différences entre les fichiers dans la fenêtre de sortie. Ce greffon utilise la commande `diff` pour comparer les fichiers. Pour utiliser le greffon de comparaison de fichiers, procédez comme suit :

1. Chargez le greffon de comparaison de fichiers.

2. Sélectionnez Outils Comparer fichiers . Lorsque vous sélectionnez cette option pour la première fois, vous êtes invité à confirmer l'emplacement de la commande `diff`. Cela ne vous sera plus demandé par la suite. Reportez-vous à pour obtenir plus d' informations concernant la modification ultérieure de cet emplacement.

   Cliquez sur OK pour afficher la boîte de dialogue Comparer fichiers.

3. Sélectionnez les fichiers que vous souhaitez comparer. Pour spécifier un fichier ouvert, sélectionnez-le dans la liste déroulante. Dans le cas d'un fichier fermé, saisissez l'emplacement du fichier dans la zone de texte.

4. Pour ignorer les modifications du nombres d'espaces vides, sélectionnez l'option Ignorer zones vides.

5. Pour utiliser le format de sortie unifiée, affichant trois lignes de contexte, sélectionnez l'option Utiliser le format de sortie unifiée.

6. Cliquez sur le bouton Comparer pour comparer le contenu des fichiers spécifiés. La sortie de commande est affichée dans la fenêtre de sortie.

Pour obtenir plus d'informations, reportez-vous à diff 1.

#### Configuration du greffon de comparaison de fichiers

Pour modifier l'emplacement de la commande utilisée par le greffon de comparaison de fichiers, procédez comme suit :

1. Sélectionnez Éditer → Préférences.

2. Cliquez sur la sous-catégorie Gestionnaire de la catégorie Greffons.

3. Sélectionnez le greffon Comparaison de fichiers.

4. Cliquez sur le bouton Configurer greffon pour afficher la boîte de dialogue Définir l'emplacement du programme.

5. Spécifiez l'emplacement de la commande `diff` dans la zone de texte Emplacement à chercher.

6. Cliquez sur OK pour fermer la boîte de dialogue Définir l'emplacement du programme.

7. Pour fermer la boîte de dialogue Préférences, cliquez sur Fermer.

### Greffon statistiques du document

Le greffon statistiques du document compte le nombre de lignes, de mots, de caractères et d'octets du fichier actif. Le greffon affiche les résultats dans la boîte de dialogue Statistiques du document. Pour utiliser le greffon de statistiques du document, procédez comme suit :

1. Chargez le greffon de statistiques du document.

2. Sélectionnez Outils Statistiques du document pour afficher la boîte de dialogue Statistiques du document. La boîte de dialogue Statistiques du document affiche les informations suivantes concernant le fichier :

   - nombre de lignes du document,

   - nombre de mots du document,

   - nombre de caractères (espaces compris) du document,

   - nombre de caractères (espaces non compris) du document,

   - nombre d'octets du document.

3. Vous pouvez continuer à mettre le fichier &app; à jour tandis que la boîte de dialogue Statistiques du document est ouverte. Pour actualiser le contenu de la boîte de dialogue Statistiques du document, cliquez sur le boutonMettre à jour.

4. Pour fermer la boîte de dialogue Statistiques du document, cliquez sur Fermer.

### Greffon de lignes de retrait

Le greffon des lignes de retrait met les lignes sélectionnées en retrait ou supprime le retrait des lignes sélectionnées. Pour utiliser le greffon de lignes de retrait, procédez comme suit :

1. Chargez le greffon de lignes de retrait.

2. Sélectionnez les lignes à mettre en retrait. Pour mettre en retrait ou supprimer le retrait d'une seule ligne, placez le curseur n'importe où sur cette ligne.

3. Sélectionnez Éditer Retrait .

4. Pour supprimer le retrait, sélectionnez les lignes et choisissez Éditer Supprimer le retrait .

### Greffon d'insertion date/heure

Le greffon d'insertion de date/heure vous permet d'insérer la date et l'heure actuelle dans un fichier. Pour utiliser le greffon d'insertion date/heure, procédez comme suit :

1. Chargez le greffon d'insertion date/heure.

2. Sélectionnez Éditer Insertion de la date et heure .

   Si le greffon d'insertion de la date et de l'heure n'est pas configuré pour insérer automatiquement la date et l'heure sans demander le format, &app; affiche la boîte de dialogue Insertion de la date et heure. Sélectionnez le format approprié dans la liste. Cliquez sur le bouton Insérer pour fermer la boîte de dialogue Insertion de la date et heure ;&app; insère la date et l'heure dans le fichier, à l'emplacement du curseur.

   Si vous avez configuré &app; pour un format de date/heure particulier, la boîte de dialogue Insertion de la date et heure ne s'affiche pas ; la date et l'heure sont automatiquement insérées dans le fichier, à l'emplacement du curseur.

   Reportez-vous à pour obtenir plus d'informations concernant la configuration du greffon d'insertion date/heure.

#### Configuration du greffon d'insertion date/heure

Pour utiliser le greffon d'insertion de date/heure, suivez les étapes indiquées ci-dessous :

1. Sélectionnez Éditer → Préférences.

2. Cliquez sur la sous-catégorie Gestionnaire de la catégorie Greffons.

3. Chargez le greffon d'insertion date/heure.

4. Cliquez sur le bouton Configurer greffon pour afficher la boîte de dialogue Configurer greffon d'insertion date/heure.

5. Sélectionnez une des options comme indiqué ci-après :

   - Pour définir le format date/heure à chaque insertion de la date et heure, sélectionnez l'option Demander un format.

   - Pour utiliser le format proposé par &app;, sélectionnez l'option Utilisez le format sélectionné, puis sélectionnez-le dans la liste. Si cette option est activée, &app; ne vous demande pas le format lorsque vous sélectionnez Éditer Insertion de la date et heure .

   - Pour utiliser le même format personnalisé à chaque insertion de la date et heure, sélectionnez l'option Utilisez le format personnalisé, puis entrez le format adéquat dans la zone de texte. Pour de plus amples informations sur la définition d'un format personnalisé, reportez-vous à strftime 3. Si cette option est activée, &app; ne vous demande pas le format lorsque vous sélectionnez Éditer Insertion de la date et heure .

6. Cliquez sur OK pour fermer la boîte de dialogue Configurer greffon d'insertion date/heure.

7. Pour fermer la boîte de dialogue Préférences, cliquez sur Fermer.

### Greffon de la commande Shell

Le greffon de la commande Shell permet de saisir le résultat d'une commande Shell dans &app;, en affichant le texte de ce résultat dans la fenêtre de sortie de la commande Shell. Pour utiliser le greffon de la commande Shell, procédez comme suit :

1. Chargez le greffon de la commande Shell.

2. Sélectionnez Outils Exécuter la commande pour afficher la boîte de dialogue exécuter la commande.

3. Entrez la commande Shell à exécuter dans le champ Commande.

   Vous pouvez entrer les caractères spéciaux ci-après :

   - `%f`

     Ces caractères spéciaux permettent de spécifier le nom de fichier du document actif, avec le chemin d'accès.

   - `%n`

     Ces caractères spéciaux permettent de spécifier le nom de fichier du document actif, sans le chemin d'accès. Dans ce cas, &app; recherche le fichier dans le répertoire de travail.

4. Modifiez le champ Répertoire de travail, le cas échéant. Par défaut, le greffon de la commande Shell exécute la commande spécifiée dans le répertoire actif.

5. Sélectionnez l'option Afficher les résultats dans la fenêtre de sortie pour afficher les résultats de la commande dans la fenêtre de sortie. Si vous ne sélectionnez pas cette option, &app; ne retient pas les résultats de la commande.

6. Cliquez sur Exécuter. Le greffon de la commande Shell exécute la commande et insère le texte de résultat dans la fenêtre de sortie.

7. Utilisez la touche Maj pour sélectionner le texte de la fenêtre.

8. Cliquez sur le bouton Copier lignes sélectionnées pour copier le texte dans le tampon.

9. Sélectionnez Éditer Coller pour coller le texte dans le fichier.

10. Cliquez sur le bouton Fermer la fenêtre de sortie pour fermer la fenêtre de sortie.

### Greffon de tri

Le greffon de tri permet de trier le texte sélectionné.

Une opération de tri ne peut pas être annulée, il est donc recommandé de sauvegarder le fichier avec d'effectuer un tri. Pour revenir à la version sauvegardée après l'opération de tri, sélectionnez Fichier Retour .

Pour utiliser le greffon de tri, procédez comme suit :

1. Chargez le greffon de tri.

2. Sélectionnez Éditer Tri pour afficher la boîte de dialogue Tri.

3. Pour organiser un texte dans le sens inverse de l'ordre de tri, sélectionnez l'option Ordre inverse.

4. Pour supprimer les doublons, sélectionnez l'option Supprimer les doublons.

5. Pour ignorer la casse, sélectionnez l'option Ignorer la casse.

6. Pour spécifier l'emplacement de départ du tri, sélectionnez la colonne adéquate dans la zone de texte Commencer à la colonne.

7. Pour faire le tri, cliquez sur le bouton Tri.

### Greffon de la liste d'étiquettes

Le greffon de la liste d'étiquettes affiche une fenêtre contenant une liste d'étiquettes communes. Vous pouvez utiliser la fenêtre pour insérer une étiquette dans un fichier. Pour utiliser le greffon de la liste d'étiquettes, procédez comme suit :

1. Chargez le greffon de la liste d'étiquettes.

2. Sélectionnez Vue Liste d'étiquettes pour afficher la fenêtre Greffon de la liste d'étiquettes.

3. Sélectionnez la catégorie d'étiquettes appropriée dans la liste déroulante ;par exemple, `HTML - Tags`.

4. Faites défiler la liste d'étiquettes pour trouver celle qui vous convient.

5. Pour insérer une étiquette dans le fichier actif à la position du curseur, cliquez deux fois sur l'étiquette dans la liste d'étiquettes. Vous pouvez également insérer une étiquette comme suit :

   - Pour insérer une étiquette dans un fichier actuel et passer de la fenêtre Greffon de la liste d'étiquettes à la fenêtre de l'éditeur, appuyez sur Entrée.

   - Pour insérer une étiquette dans le fichier actuel et rester sur la fenêtre Greffon de la liste d'étiquettes, appuyez sur Maj Entrée.

6. Pour fermer la fenêtre Greffon de la liste d'étiquettes, cliquez sur le bouton Fermer fenêtre dans le cadre de la fenêtre. Vous pouvez aussi appuyer sur Ctrl W lorsque vous êtes dans la fenêtre Greffon de la liste d'étiquettes.

### Greffon du nom d'utilisateur

Le greffon du nom d'utilisateur vous permet d'insérer dans le fichier le nom de l'utilisateur actuel. Pour utiliser le greffon du nom d'utilisateur, suivez les étapes indiquées ci-dessous :

1. Charger le greffon du nom d'utilisateur.

2. Sélectionnez Éditer Insérer nom utilisateur pour insérer votre nom d'utilisateur dans le fichier actif à l'emplacement du curseur.