# Manuel de pluma

## Introduction

L'application pluma permet de créer et d'éditer des fichiers texte.

Le but de pluma est d'être un éditeur de texte simple et facile à utiliser. Des fonctionnalités plus puissantes peuvent être activées avec différents greffons, offrant des fonctions relatives à l'édition de texte.

## Premiers pas

### Démarrage de pluma

pluma peut être démarré de la façon suivante :

Par le menu Applications

- Choisissez Accessoires Éditeur de texte.

En ligne de commande

- Exécutez la commande : `pluma`

Par défaut, lorsque l'on ouvre un document de type texte dans le gestionnaire de fichiers, pluma se lance et l'affiche.

### Fenêtre de pluma

Au démarrage de pluma, la fenêtre suivante apparaît :

#### Fenêtre de pluma

Shows pluma main window.

Elle contient les éléments suivants :

La barre de menus

- La barre de menu contient toutes les commandes nécessaires pour travailler avec des fichiers dans pluma.

La barre d'outils

- La barre d'outils contient un sous-ensemble des commandes accessibles depuis la barre de menus.

La zone d'affichage

- La zone d'affichage contient le texte du document en cours d'édition.

La barre d'état

- La barre d'état contient des informations sur l'activité en cours dans pluma ainsi que des informations contextuelles sur les éléments de menu. Elle affiche également les informations suivantes :

  - Position de curseur : numéros de ligne et de colonne où se trouve le curseur.

  - Mode d'édition : Si l'éditeur est en mode insertion, la barre d'état contient le mot INS. S'il est en mode écrasement, la barre d'état contient le mot ECR. Appuyez sur la touche Inser pour changer de mode d'édition.

Le panneau latéral

- Le panneau latéral affiche la liste des documents ouverts ainsi que des informations sur les greffons actifs.

  Par défaut, le panneau latéral n'est pas visible. Pour le faire apparaître, choisissez Affichage Panneau latéral.

Le panneau inférieur

- Le panneau inférieur est utilisé par des outils de programmation tels que le greffon Console Python pour leur affichage.

  Par défaut, le panneau inférieur n'est pas visible. Pour le faire apparaître, choisissez Affichage Panneau inférieur.

Lorsque vous cliquez avec le bouton droit dans sa fenêtre, pluma affiche un menu contextuel. Celui-ci contient les commandes d'édition de texte les plus courantes.

Like other MATE applications, actions in pluma can be performed in several ways: with the menu, with the toolbar, or with shortcut keys. Shortcuts keys common to all applications are listed in the User Guide.

### Lancement de pluma depuis la ligne de commande

Il est possible de lancer pluma à partir de la ligne de commande, et d'ouvrir un ou plusieurs documents. Pour cela, saisissez la commande suivante et appuyez sur Entrée :

`pluma `file1.txt file2.txt file3.txt``

Vous pouvez également indiquer un URI au lieu d'un nom de fichier.

Pour de plus amples informations sur l'exécution de pluma à partir de la ligne de commande, reportez-vous à

pluma

1.

## Travailler avec des fichiers

### Création d'un nouveau document

Pour créer un nouveau document, choisissez Fichier Nouveau. Un document vide s'affiche alors dans la fenêtre de pluma.

### Ouverture d'un fichier

Pour ouvrir un fichier, choisissez Fichier Ouvrir afin d'afficher la boîte de dialogue Ouvrir des fichiers. Sélectionnez le fichier à ouvrir, puis cliquez sur Ouvrir. Le fichier est affiché dans la fenêtre de pluma.

The application records the paths and filenames of the five most recent files that you edited and displays the files as menu items on the File menu. You can also click on the Shows Recent Files menu icon. icon on the toolbar to display the list of recent files.

Comme il est possible d'ouvrir plusieurs documents dans pluma, l'application ajoute un onglet dans la fenêtre pour chaque document ouvert. Pour plus d'informations à ce sujet, consultez pluma-tabs.

### Enregistrement d'un document

Vous pouvez enregistrer vos documents de plusieurs façons :

- Pour enregistrer les changement d'un fichier existant, choisissez Fichier Enregistrer.

- To save a new file or to save an existing file under a new filename, choose File Save As . Enter a name for the file in the Save As dialog, then click Save.

- To save all of the files that are currently open in pluma, choose Documents Save All .

To close all of the files that are currently open in pluma, choose Documents Close All .

### Ouverture d'un fichier depuis un emplacement

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

1. Choose File Open Location to display the Open Location dialog.

2. Saisissez l'URI du fichier à ouvrir.

3. Choisissez l'encodage qui convient avec la liste déroulante Codage des caractères.

4. Cliquez sur Ouvrir.

Voici quelques exemples d'`URI` pouvant être utilisés : `http:`, `ftp:`, `file:` ainsi que toutes les méthodes prises en charge par `mate-vfs`.

Les fichiers de certains types d'URI sont ouverts en lecture seule, et toute modification d'un tel fichier doit être enregistrée à un autre emplacement. HTTP ne permet que l'accès en lecture aux fichiers. Les fichiers ouverts par FTP sont en lecture seule car certains serveurs FTP ne gèrent pas correctement l'enregistrement de fichiers distants.

L'enregistrement de fichiers sur les serveurs FTP peut être activé avec l'Éditeur de configuration, en paramétrant la clé `/apps/pluma/preferences/editor/save/writable_vfs_schemes`, mais cela peut provoquer des erreurs.

### Utilisation des onglets

Quand il y a plus d'un document ouvert, pluma affiche un onglet au dessus de la zone d'affichage pour chaque document. Pour passer d'un document à un autre, cliquez sur son onglet.

Pour déplacer un document vers une autre fenêtre de pluma glissez son onglet jusqu'à la fenêtre où vous souhaitez le déplacer.

To move a document to a new pluma window, either drag its tab to the desktop, or choose Documents Move to New Window .

## Travailler avec du texte

### Édition

Vous pouvez éditer le texte d'un document de plusieurs façons :

- Entrez le texte à partir du clavier. Le curseur d'insertion clignotant indique l'endroit où le texte frappé est inséré. Pour modifier la position de ce curseur, utilisez les touches fléchées ou cliquez avec la souris.

- To copy the selected text to the clipboard, choose Edit Copy .

- To delete the selected text from the file and move the selected text to the clipboard, choose Edit Cut .

- To permanently delete the selected text from the file, choose Edit Delete .

- To insert the contents of the clipboard at the cursor position, choose Edit Paste . You must cut or copy text before you can paste text into the file, either from pluma or another application.

- To select all of the text in a file, choose Edit Select All .

### Annulation et rétablissement des modifications

To undo a change you have made, choose Edit Undo . To reverse this action, choose Edit Redo .

## Recherche et remplacement de texte

Pluma fournit deux moyens pour faire des recherches dans le texte. Utilisez Rechercher pour trouver un morceau de texte particulier ou Recherche incrémentale pour mettre en surbrillance le texte au fur et à mesure que vous le saisissez.

### Recherche de texte

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

1. Choose Search Find to display the Find dialog.

2. Saisissez la chaîne de caractères à rechercher dans le champ Rechercher. Des caractères spéciaux comme le retour chariot ou la tabulation peuvent être introduits. Voir : pluma-find-escapes.

3. Cliquez sur Rechercher pour trouver la première occurrence du texte après la position du curseur. Si pluma trouve le texte, l'application sélectionne la première occurrence. Les autres occurrences sont mises en évidence.

4. To find the next occurrence of the string, click Find or choose Search Find Next . To find the previous occurrence of the text, choose Search Find Previous .

After you have closed the Find dialog, you can still move the selection to other occurrences of the text by choosing Search Find Next and Search Find Previous .

To remove the highlighting from the text, choose Search Clear Highlight .

### Recherche incrémentale

La recherche incrémentale place le texte recherché en surbrillance au fur et à mesure qu'il est saisi. (Ce fonctionnement est similaire à celui utilisé dans certains navigateurs web)

To start an incremental search, choose Search Incremental Search . The search box appears at the top of the display area.

Commencez la saisie pour que le texte correspondant se mette en surbrillance dans le document. De plus, la première occurrence trouvée après la position du curseur est sélectionnée.

Pour sélectionner la prochaine occurrence tout en gardant la boîte de recherche incrémentale ouverte, appuyez sur Ctrl G. Appuyez sur Ctrl Majuscule G pour revenir à l'occurrence précédente.

Vous pouvez également utiliser les touches fléchées haut et bas ou la molette de la souris pour vous déplacer parmi les occurrences trouvées.

### Remplacement de texte

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

1. Choose Search Replace to display the Replace dialog.

2. Saisissez la chaîne de caractères à rechercher dans le champ Rechercher. Il est possible d'y inclure des caractères spéciaux tels que le retour chariot ou la tabulation. Voir : pluma-find-escapes.

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

Pour examiner chaque occurrence du texte cherché avant de le remplacer, cliquez sur Rechercher. Lorsqu'il est trouvé pluma le sélectionne. Cliquez sur Remplacer pour effectuer le remplacement. Cliquez à nouveau sur Rechercher pour passer à l'occurrence suivante.

Pour remplacer toutes les occurrences de la chaîne de caractères dans l'ensemble du document, cliquez sur le bouton Remplacer tout.

### Options de recherche et de remplacement.

Les fenêtres de dialogue Rechercher et Remplacer offrent les options suivantes :

- Cochez Respecter la casse pour ne rechercher que les occurrences respectant la casse du texte saisi. Dans ce cas, par exemple, les mots "TEXTE" et "texte" ne sont pas équivalents.

- Cochez Mots entiers seulement pour ne rechercher que les occurrences correspondant exactement au texte entré. Par exemple, avec cette option, les mots "texte" et "contexte" ne correspondent pas.

- Cochez Rechercher en arrière pour que la recherche se fasse de la position du curseur vers le début du document.

- Cochez Recherche circulaire pour que lorsqu'une recherche atteint une extrémité du document, elle se poursuive en reprenant à partir de l'autre extrémité.

### Caractères spéciaux

Dans le texte à chercher ou à remplacer, il est possible d'inclure les séquences d'échappement suivantes :

`\n`

- Indique une nouvelle ligne.

`\t`

- Indique une tabulation.

`\r`

- Indique un retour chariot.

`\\`

- La barre oblique inverse elle-même doit être échappée si elle est recherchée. Par exemple, si vous recherchez le terme « `\n` », vous devrez saisir « \\n » dans le champ Rechercher. Ou si vous recherchez une suite de barres obliques inverses, vous devrez en doubler le nombre.

### Positionnement du curseur sur une ligne particulière

To position the cursor on a specific line in the current file, choose Search Go to Line . The line number box appears at the top of the display area.

Saisissez le numéro de la ligne où vous souhaitez placer le curseur, et le contenu du document défile jusqu'à la ligne indiquée.

Pour faire disparaître la boîte et placer le curseur à la ligne indiquée, appuyez sur Entrée.

## Impression

### Mise en page

To set the page options, choose File Page Setup to display the Page Setup dialog.

Cette boîte de dialogue permet d'indiquer les options d'impression suivantes :

#### Onglet Général

Print syntax highlighting

- Cochez cette option pour imprimer le texte avec la coloration syntaxique. Pour plus d'informations à ce sujet, consultez pluma-set-highlightmode.

Print page headers

- Cochez cette option pour ajouter un en-tête sur chaque page imprimée. Les en-têtes ne sont pas modifiables.

Line Numbers

- Cochez l'option Imprimer les numéros de ligne pour ajouter les numéros de ligne dans le texte imprimé.

  Utilisez la zone de sélection numérique Numéro toutes les ... lignes pour spécifier l'espacement des numéros de ligne, par exemple toutes les 5 lignes, les 10 lignes, etc.

Text Wrapping

- Cochez l'option Activer le retour à la ligne pour renvoyer automatiquement à la ligne, au niveau du caractère, lors de l'impression. À des fins de numérotation, l'application considère alors les lignes issues du renvoi automatique comme de nouvelles lignes.

  Cochez l'option Ne pas couper les mots sur deux lignes pour que le renvoi automatique à la ligne se fasse au niveau du mot, lors de l'impression.

#### Polices

Body

- Cliquez sur ce bouton pour choisir la police à utiliser pour l'impression du corps du texte.

Line numbers

- Cliquez sur ce bouton pour choisir la police à utiliser pour imprimer les numéros de ligne.

Headers and footers

- Cliquez sur ce bouton pour choisir la police à utiliser pour l'impression des en-têtes et des pieds de page.

Pour restaurer les polices proposées par défaut pour l'impression, cliquez sur le bouton Restaurer les polices par défaut.

### Impression d'un document

Pluma permet d'exécuter les opérations d'impression suivantes :

- Imprimer un document avec une imprimante.

- Envoyer la sortie de la commande d'impression dans un fichier.

Si vous imprimez vers un fichier, pluma envoie le document dans un fichier dans un format pré-traité. Les plus courants de ces formats sont PostScript et PDF (Portable Document Format).

To preview the pages that you want to print, choose File Print Preview .

To print the current file to a printer or a file, choose File Print to display the Print dialog.

Les options d'impression suivantes sont disponibles :

#### Onglet Travail

Print range

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

  - All

    Imprime toutes les pages du document.

  - Lines

    Imprime les lignes spécifiées. Indiquez l'intervalle souhaité avec les zones de sélection numérique De et À.

  - Selection

    Imprime le texte sélectionné. Cette option n'est disponible que si vous avez sélectionné du texte.

Copies

- Utilisez la zone de sélection numérique Nombre de copies pour indiquer le nombre d'exemplaires à imprimer.

  Si vous imprimez plusieurs exemplaires du document, l'option Rassembler permet de rassembler chaque copie.

#### Onglet Imprimante

Printer

- Utilisez la liste pour choisir l'imprimante avec laquelle vous souhaitez imprimer le document.

Settings

- Utilisez cette liste déroulante pour paramétrer l'impression.

  Pour régler l'imprimante, cliquez sur Configurer. Par exemple, il est possible de choisir une impression recto-verso ou de planifier l'impression dans le temps, si cette option est prise en charge par l'imprimante.

Location

- Utilisez cette liste déroulante pour sélectionner l'une des destinations d'impression suivantes :

  CUPS

- Impression du document avec une imprimante CUPS.

  Si l'imprimante choisie est connue par CUPS, CUPS est le seul choix dans la liste déroulante.

lpr

- Impression du document à une imprimante.

File

- Envoie le document dans un fichier PostScript.

  Cliquez sur Enregistrer sous pour obtenir une boîte de dialogue permettant de spécifier le nom et l'emplacement du fichier postscript.

Custom

- Commande à utiliser pour imprimer le document.

  Saisissez la commande ainsi que tous ses arguments dans la fenêtre de texte.

State

- Cette fonctionnalité n'est pas prise en charge dans cette version de pluma.

Type

- Cette fonctionnalité n'est pas prise en charge dans cette version de pluma.

Comment

- Cette fonctionnalité n'est pas prise en charge dans cette version de pluma.

#### Onglet Papier

Paper size

- Sélectionnez le format du papier sur lequel imprimer le document dans la liste déroulante.

Width

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

Height

- La zone de sélection numérique permet de spécifier la hauteur du papier.

Feed orientation

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

Page orientation

- La liste déroulante permet de sélectionner l'orientation de la page.

Layout

- La liste déroulante permet de sélectionner l'agencement des pages. Un aperçu de l'agencement choisi s'affiche dans la zone Aperçu.

Paper tray

- La liste déroulante permet de sélectionner le bac de papier de l'imprimante.

## Aides à la programmation

Plusieurs aides à la programmation sont fournies par des greffons de pluma. Par exemple, le greffon Liste de Balises fournit les balises les plus communément utilisées par les différents langages à balise : Voyez pluma-tag-list-plugin.

### Coloration syntaxique

La coloration syntaxique rend les codes source plus faciles à lire en colorant de manière différente certaines parties du texte.

pluma chooses an appropriate syntax highlighting mode based on a document's type. To override the syntax highlighting mode, choose View Highlight Mode , then choose one of the following menu items:

Normal

- N'utilise pas la coloration syntaxique.

Sources

- Active la coloration syntaxique. Sélectionnez le type de code source avec le sous-menu Sources.

Markup

- Active la coloration syntaxique pour un code à balises. Sélectionnez le type de balise avec le sous-menu Balisage.

Scripts

- Active la coloration syntaxique pour un code script. Sélectionnez le sous-menu Scripts.

Others

- Active la coloration syntaxique pour d'autres types de code. Sélectionnez le sous-menu Autres.

### Redirection de la sortie d'une commande shell dans un fichier

On peut rediriger la sortie d'une commande shell dans un document au travers de pluma. Par exemple, pour rediriger la sortie de la commande `ls`, entrez `ls | pluma`, puis appuyez sur Entrée.

La sortie de la commande s'affiche dans la zone d'affichage de pluma, dans un nouveau document.

Vous pouvez encore utiliser le greffon Outils externes pour rediriger la sortie de la commande dans le document courant.

## Raccourcis clavier

Les raccourcis clavier permettent d'effectuer des tâches courantes plus rapidement qu'avec la souris et les menus. Les tableaux suivants énumèrent tous les raccourcis clavier de pluma.

For more on shortcut keys, see the Desktop User Guide.

Tabulations

Raccourcis pour les onglets :

Raccourci clavier | Commande
Ctrl + Alt + Page haut | Bascule sur l'onglet suivant vers la gauche.
Ctrl + Alt + Page bas | Bascule sur l'onglet suivant vers la droite.
Ctrl + W | Ferme l'onglet.
Ctrl + Maj + L | Enregistre tous les onglets.
Ctrl + Maj + W | Ferme tous les onglets.
Alt + n | Active le nième onglet.

Fichiers

Raccourcis pour la manipulation des fichiers :

Raccourci clavier | Commande
Ctrl + N | Crée un nouveau document.
Ctrl + O | Ouvre un document.
Ctrl + L | Ouvre un emplacement.
Ctrl + S | Enregistre le document actuel.
Ctrl + Maj + S | Enregistre le document actuel sous un nouveau nom.
Ctrl + P | Imprime le document actuel.
Ctrl + Maj + P | Aperçu avant impression.
Ctrl + W | Ferme le document actuel.
Ctrl + Q | Quitte Pluma.

Édition

Raccourcis pour l'édition de documents :

Raccourci clavier | Commande
Ctrl + Z | Annule la dernière action.
Ctrl + Maj + Z | Rétablit la dernière action annulée.
Ctrl + X | Coupe le texte ou la zone sélectionné et le place dans le presse-papiers.
Ctrl + C | Copie le texte ou la zone sélectionné dans le presse-papiers.
Ctrl + V | Colle le contenu du presse-papiers.
Ctrl + A | Sélectionne tout.
Ctrl + D | Supprime la ligne actuelle.
Alt + flèche haut | Déplace la ligne sélectionnée d'une ligne vers le haut.
Alt + flèche bas | Déplace la ligne sélectionnée d'une ligne vers le bas.

Panneaux

Raccourcis pour l'affichage et le masquage des panneaux :

Raccourci clavier | Commande
F9 | Affiche ou masque le panneau latéral.
Ctrl + F9 | Affiche ou masque le panneau inférieur.

Recherche

Raccourcis pour la recherche :

Raccourci clavier | Commande
Ctrl + F | Recherche un texte.
Ctrl + G | Recherche la prochaine occurrence du texte.
Ctrl + Maj + G | Recherche l'occurrence précédente du texte.
Ctrl + K | Recherche interactive.
Ctrl + H | Recherche et remplace.
Ctrl + Maj + K | Annule la surbrillance.
Ctrl + I | Se rendre à une ligne.

Outils

Raccourcis pour les outils :

Raccourci clavier | Commande
Maj + F7 | Vérifie l'orthographe (avec le greffon).
Alt + F12 | Enlève les espaces finales (avec le greffon).
Ctrl + T | Indente les lignes (avec le greffon).
Ctrl + Maj + T | Supprime l'indentation (avec le greffon).
F8 | Exécute « make » dans le répertoire actuel (avec le greffon).
Ctrl + Maj + D | Affiche le contenu du répertoire (avec le greffon).

Aide

Raccourcis pour l'aide :

Raccourci clavier | Commande
F1 | Ouvre le manuel d'utilisation de pluma.

## Préférences

To configure pluma, choose Edit Preferences . The Preferences dialog contains the following categories:

- pluma-prefs-view

- pluma-prefs-editor

- pluma-prefs-fontsandcolors

- pluma-prefs-plugins

### Affichage

Text Wrapping

- L'option Activer le retour à la ligne permet d'activer le renvoi automatique du texte à la ligne suivante lorsque un caractère atteint la limite de la fenêtre de texte. Ceci évite d'avoir à faire défiler le texte horizontalement.

  Pour une lecture plus aisée, cochez l'option Ne pas couper les mots. Elle permet de conserver l'intégralité d'un mot sur la même ligne lorsque le renvoi de ligne est activé.

Line Numbers

- Cochez l'option Afficher les numéros de lignes pour afficher les numéros de lignes du côté gauche de la fenêtre de pluma.

Current Line

- Cochez l'option Surligner la ligne actuelle pour mettre en évidence la ligne où se trouve le curseur.

Right Margin

- Cochez l'option Afficher la marge de droite pour afficher une ligne verticale représentant cette marge.

  Utilisez la zone de sélection numérique Marge de droite à la colonne pour indiquer la position de la ligne verticale.

Bracket Matching

- Cochez l'option Surligner les parenthèses correspondantes pour mettre en évidence les parenthèses correspondantes lorsque le curseur se trouve sur une parenthèse.

### Éditeur

Tabs

- La zone de sélection numérique Largeur des tabulations permet de spécifier la largeur de la tabulation insérée lors de l'utilisation de la touche Tabulation.

  L'option Insérer des espaces au lieu des tabulations permet d'indiquer à pluma de remplacer les tabulations par des espaces lors de l'utilisation de la touche Tabulation.

Auto Indentation

- Cochez l'option Activer l'indentation automatique pour indiquer que chaque prochaine prochaine ligne doit commencer au niveau d'indentation de la ligne actuelle.

File Saving

- Cochez Créer une copie de sauvegarde des fichiers avant l'enregistrement pour créer une copie de sauvegarde du document à chaque fois que le document est enregistré. Le nom du fichier de sauvegarde se termine par le signe ~.

  Cochez Enregistrer automatiquement toutes les ... minutes pour enregistrer automatiquement le document actif à intervalles réguliers. Indiquer dans la zone de sélection numérique l'intervalle de temps entre ces enregistrements.

### Police et couleurs

Font

- Cochez Utiliser la police du thème par défaut pour utiliser la police par défaut du système pour le texte de la fenêtre de pluma.

  Le champ Police de l'éditeur indique la police utilisée par pluma pour afficher le texte. Le bouton permet de spécifier son type, son style et sa taille.

Color Scheme

- Vous pouvez choisir un jeu de couleurs dans ls liste des jeux de couleurs. Par défaut, les jeux de couleurs suivants sont installés :

  Classic

- Un jeu de couleurs classique basé sur les couleurs gvim.

Cobalt

- Jeu de couleurs basé sur des tons bleus.

Kate

- Jeu de couleurs utilisé dans l'éditeur de texte Kate.

Oblivion

- Jeu de couleurs foncées utilisant la palette Tango.

Tango

- Jeu de couleurs utilisant la palette Tango.

Vous pouvez ajouter un nouveau jeu de couleurs en cliquant sur Ajouter et en sélectionnant un fichier de jeu de couleurs

Vous pouvez supprimer le jeu de couleurs sélectionné en cliquant sur Enlever

### Préférences des greffons

Les greffons offrent des possibilités supplémentaires à pluma. Pour plus d'informations sur les greffons et comment utiliser les greffons intégrés, voir pluma-plugins-overview.

#### Activation d'un greffon

Pour activer un greffon de pluma exécutez les opérations suivantes :

1. Choose Edit Preferences .

2. Sélectionnez l'onglet Greffons.

3. Cochez la case en regard du nom du greffon à activer.

4. Cliquez sur Fermer pour fermer la boîte de dialogue Préférences.

#### Désactivation d'un greffon

Un greffon reste actif lorsque vous fermez pluma.

Pour activer un greffon dans pluma, suivez les étapes ci-dessous :

1. Choose Edit Preferences .

2. Sélectionnez l'onglet Greffons.

3. Décochez la case en regard du nom du greffon à désactiver.

4. Cliquez sur Fermer pour fermer la boîte de dialogue Préférences.

## Greffons

### Travail sur des documents

Il est possible d'ajouter des fonctions supplémentaires à pluma en validant les greffons. Un greffon est un programme annexe qui améliore les fonctionnalités d'une application. Un greffon ajoute de nouvelles entrées aux menus de pluma.suivant les fonctionnalités apportées.

Certains greffons sont intégrés directement dans pluma mais on peut en installer d'autres. Le site de pluma recense les greffons tierce partie.

Pour valider ou non l'utilisation d'un greffon ou pour voir la liste de ceux qui le sont utilisez Préférences des greffons.

Les greffons suivants sont intégrés à pluma :

- Modifier la casse permet de modifier la casse du texte sélectionné.

- Statistiques du document affiche le nombre de lignes, de mots et de caractères dans le document.

- Outils externes permet d'exécuter des commandes externes depuis pluma.

- Navigateur de fichiers permet de parcourir vos fichiers et vos dossier dans le panneau latéral.

- Indenter les lignes augmente ou réduit l'indentation des lignes sélectionnées.

- Insérer la date et l'heure ajoute la date et l'heure actuelle dans un document.

- Modificateurs permet de définir des préférences d'édition pour chaque document, et prend en charge les modificateurs d'Emacs, de Kate et de Vim.

- Console Python permet de lancer des commandes dans le langage de programmation Python.

- Extraits de code permet de stocker des parties de code fréquemment utilisées et de les insérer rapidement dans un document.

- Trier trie les lignes sélectionnées dans l'ordre alphabétique.

- Vérificateur orthographique corrige l'orthographe du texte sélectionné, ou marque automatiquement les erreurs du document.

- Liste des balises permet d'insérer des balises fréquemment utilisées pour HTML et d'autres langages à partir du panneau latéral.

Pour plus d'informations sur la création de greffons, consultez le site Web de pluma.

### Greffon Modifier la casse

Le greffon Modifier la casse change la casse du texte sélectionné.

Quand le greffon Modifier la casse est activé, les entrées de menu suivantes sont ajoutées au menu Édition :

Entrée de menu | Action | Exemple
Edit Change Case All Upper Case | Passe chaque caractère en majuscule. | `Ce texte` devient `CE TEXTE`
Edit Change Case All Lower Case | Passe chaque caractère en minuscule. | `Ce Texte` devient `ce texte`
Edit Change Case Invert Case | Inverse majuscules et minuscules pour chaque lettre. | `Ce Texte` devient `cE tEXTE`
Edit Change Case Title Case | Passe chaque initiale de mot en majuscule. | `ce texte` devient `Ce Texte`

### Greffon Statistiques du document

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

1. Choose Tools Document Statistics to display the Document Statistics dialog. The Document Statistics dialog displays the following information about the file:

   - nombre de lignes du document courant.

   - nombre de mots du document.

   - nombre de caractères (espaces comprises) du document.

   - nombre de caractères (espaces non comprises) du document.

   - nombre d'octets du document.

2. Vous pouvez continuer à mettre le document pluma à jour tandis que la boîte de dialogue Statistiques du document est ouverte. Pour en actualiser le contenu, cliquez sur le bouton Mettre à jour.

### Greffon Outils externes

Le greffon Outils externes permet d'exécuter des commandes externes depuis pluma. Vous pouvez transmettre des données à une commande pour exploiter sa sortie (par exemple avec sed), ou lancer une commande prédéfinie (par exemple make).

Utilisez le Gestionnaire d'outils externes pour créer et éditer les commandes. Pour lancer une commande externe, choisissez la depuis le menu Outils.

#### Commandes prédéfinies

Le greffon Outils externes fournit les commandes prédéfinies suivantes :

Build (Construire)

- Lance make dans le répertoire du document actif.

Directory Listing (Contenu du répertoire)

- Affiche le contenu du répertoire du document actif dans un nouveau document.

Environment Variables (Variables d'environnement)

- Affiche les variables d'environnement dans le panneau inférieur.

Grep

- Recherche un terme dans tous les fichiers du répertoire du document actif, en utilisant une correspondance de motif. Les résultats sont affichés dans le panneau inférieur.

Remove Trailing Spaces (Enlever les espaces finales)

- Enlève toutes les espaces des fins de ligne du document.

#### Définition d'une commande

Pour ajouter une commande externe, choisissez Outils Outils externes.

Dans la fenêtre Gestionnaire d'outils externes, cliquez sur Nouveau. Renseignez les données suivantes de la nouvelle commande :

Description

- Cette description est affichée dans la barre d'état quand l'entrée de menu est sélectionnée.

Raccourci

- Saisissez un raccourci clavier pour la commande.

Commande(s)

- Les commandes à lancer. De nombreuses variables d'environnement de pluma peuvent être utilisées pour passer des données à ces commandes : consultez pluma-external-tools-plugin-variables.

Entrée

- Les données à fournir aux commandes (comme un `flux d'entrée standard`) : l'ensemble du texte du document actif, la sélection active, la ligne active ou le mot actif.

Sortie

- L'exploitation des données de sortie des commandes : les afficher dans le panneau inférieur, les insérer dans un nouveau document, ou les ajouter au document actif, à la fin, à la position du curseur, ou replacer la sélection ou le document entier.

Applicabilité

- Détermine quels documents peuvent être affectés par la commande, par exemple si le document est enregistré ou non, et s'il est local ou distant.

#### Édition et suppression d'outils

Pour éditer un outil, sélectionnez-le dans la liste et effectuez les modifications à ses propriétés.

Pour renommer un outil, cliquez à nouveau dessus dans la liste.

Pour restaurer un outil intégré que vous avez modifié, appuyez sur Restaurer.

Pour enlever un outil, sélectionnez-le dans la liste et appuyez sur Enlever. Il n'est pas possible de retirer un outil intégré, uniquement ceux que vous avez créés.

#### Variables

Dans le champ Commande(s) définissant la commande à exécuter, vous pouvez utiliser les variables suivantes :

- PLUMA_CURRENT_DOCUMENT_URI

- PLUMA_CURRENT_DOCUMENT_NAME

- PLUMA_CURRENT_DOCUMENT_SCHEME

- PLUMA_CURRENT_DOCUMENT_PATH

- PLUMA_CURRENT_DOCUMENT_DIR

- PLUMA_DOCUMENTS_URI

- PLUMA_DOCUMENTS_PATH

### Greffon Navigateur de fichiers

Le greffon Navigateur de fichiers affiche vos fichiers et vos dossiers dans le panneau latéral, permettant de les ouvrir rapidement.

To view the File Browser, choose View Side Pane and then click on the tab showing the File Browser icon at the bottom of the side pane.

#### Parcours de vos fichiers

L'onglet Navigateur de fichiers montre en premier lieu les signets de votre gestionnaire de fichiers. Pour parcourir l'un d'entre eux, double-cliquez dessus.

Pour afficher le dossier parent, sélectionnez-le depuis le menu déroulant ou appuyez sur le bouton flèche vers le haut de la barre d'outils du navigateur de fichiers.

Pour afficher le dossier qui contient le document sur lequel vous travaillez, cliquez avec le bouton droit dans la liste des fichiers et choisissez Définir la racine au document actif.

#### Ouverture d'un fichier

Pour ouvrir un fichier dans pluma, double-cliquez dessus dans la liste des fichiers.

#### Création de documents et de dossiers

Pour créer un nouveau document texte vide dans le dossier courant affiché dans le navigateur, cliquez avec le bouton droit dans la liste des fichiers et choisissez Nouveau fichier.

Pour créer un nouveau dossier dans le dossier actuellement affiché dans le navigateur, cliquez avec le bouton droit dans la liste des fichiers et choisissez Nouveau dossier.

### Greffon Indenter les lignes

Le greffon Indenter les lignes augmente ou réduit l'espace au début des lignes de texte.

Pour augmenter ou réduire l'indentation du texte, effectuez les opérations suivantes :

1. Sélectionnez les lignes à indenter. Pour n'agir que sur une seule ligne, placez le curseur n'importe où sur celle-ci.

2. - To indent the text, choose Edit Indent .

   - To remove the indentation, choose Edit Unindent .

La largeur des indentations et l'utilisation de tabulations ou d'espaces dépendent des paramètres Tabulations dans les préférences de l'éditeur : consultez pluma-prefs-editor.

### Greffon Insérer la date et l'heure

Le greffon Insérer la date et l'heure permet d'insérer la date et l'heure actuelles dans le document. Pour l'utiliser, procédez comme suit :

1. Choose Edit Insert Date and Time .

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

   Si pluma est configuré pour utiliser un format date/heure particulier, la boîte de dialogue Insertion de la date et de l'heure ne s'affiche pas et l'insertion se fait automatiquement dans le document, à l'emplacement du curseur.

#### Configuration du greffon Insérer la date et l'heure

Pour configurer le greffon Insérer la date et l'heure, suivez les étapes indiquées ci-dessous :

1. Choose Edit Preferences .

2. Sélectionnez l'onglet Greffons.

3. Sélectionnez le greffon Insertion de la date et de l'heure.

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

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

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

   - To use the same pluma-provided date/time format each time you insert the date/time, select the Use the selected format option, then select the appropriate format from the list. When you select this option, pluma does not prompt you for the date/time format when you choose Edit Insert Date and Time .

   - To use the same customized date/time format each time you insert the date/time, select the Use custom format option, then enter the appropriate format in the text box. For more information about how to specify a custom format, see

     strftime

     3. When you select this option, pluma does not prompt you for the date/time format when you choose Edit Insert Date and Time .

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

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

### Greffon Modificateurs

Le greffon Modificateurs permet de définir des préférences pour chaque document. Un modificateur est une ligne de texte au début ou à la fin du document contenant des paramètres reconnus par pluma.

Les préférences définies avec les modificateurs ont la priorité sur celles définies dans la boîte de dialogue des préférences.

Avec les modificateurs, vous pouvez définir les préférences suivantes :

- Largeur des tabulations

- Largeur d'indentation

- Insérer des espaces au lieu des tabulations

- Renvoi automatique à la ligne

- Marge de droite à la colonne

Le greffon Modificateurs prend en charge certaines des options utilisées par d'autres éditeurs de texte comme Emacs, Kate et Vim.

#### Modificateurs d'Emacs

Les deux premières lignes d'un document sont analysées pour trouver les modificateurs Emacs.

Les options d'Emacs, largeur de tabulation, distance d'indentation, mode d'indentation des tabulations et repli de ligne, sont prises en charge. Pour plus d'informations consultez le manuel d'Emacs GNU.

#### Modificateurs de Kate

Les modificateurs de Kate sont recherchés dans la première et les dix dernières lignes du document.

Les options de Kate, largeur de tabulation, espaces d'indentation et coupure des mots, sont prises en charge. Pour plus d'informations consultez Le site Web de Kate.

#### Modificateurs de Vim

Les modificateurs de Vim sont recherchés dans la première et les trois dernières lignes du document.

Les options de Vim et, expandtab, ts, tabstop, sw, shiftwidth, wrap et textwidth sont prises en charge. Pour plus d'informations, consultez le site Web de Vim.

### Greffon Console Python

Le greffon Console Python permet d'exécuter des commandes de ce langage à partir de pluma. Lorsque le greffon est activé, un onglet est ajouté au panneau inférieur. Il montre les dernières sorties de commandes ainsi qu'un champ avec une invite de saisie de commande.

Les commandes entrées à la console python ne sont pas vérifiées avant d'être exécutées, aussi, il est possible de bloquer pluma en entrant, par exemple, une boucle infinie.

### Greffon Extraits

Le greffon Extraits permet de stocker différentes parties de texte fréquemment utilisées, appelées extraits et de les insérer rapidement dans un document.

Les extraits sont spécifiques à la syntaxe du langage du document courant. Par exemple, avec un document HTML, on choisit une liste d'extraits adaptée au HTML. Certains d'entre eux sont globaux et sont donc disponibles pour tous les documents.

Un certain nombre d'extraits intégrés sont installés avec pluma et peuvent être modifiés.

#### Insertion d'extraits

Pour insérer un extrait dans un document tapez son déclencheur puis appuyez sur la touche Tabulation. Ce déclencheur est en général constitué des premières lettres de l'extrait ou de quelque chose de court et de facilement mémorisable.

Sinon, appuyez Ctrl Espace pour afficher la liste des extraits qu'il est possible d'utiliser.

#### Ajout d'extraits

Création d'un nouvel extrait :

1. Choisissez Outils Gérer les extraits de code. La fenêtre Gestionnaire des extraits de code s'ouvre.

2. La liste des extraits est groupée par langages. Sélectionnez le langage dans lequel doit être ajouté l'extrait ou un extrait de ce langage. Pour l'ajouter à tous les langages, sélectionnez Global en haut de la liste. La syntaxe du document actif est affichée par défaut.

3. Cliquez sur Nouveau. Un nouvel extrait apparaît dans la liste.

4. Fournissez les informations suivantes pour le nouvel extrait :

   Nom

5. Saisissez un nom dans le champ texte de la liste. Ce nom sert à se souvenir de son utilité. Pour le modifier, cliquez dessus dans la liste.

Texte de l'extrait

- Saisissez le texte de l'extrait dans la zone de texte Modification de l'extrait de code. Pour l'utilisation de codes spéciaux, voyez pluma-snippets-plugin-syntax.

  Vous pouvez retourner dans la fenêtre du document pour copier du texte sans fermer celle du Gestionnaire d'extraits.

Déclencheur.

- Entrez le déclencheur de l'extrait. C'est le texte que vous tapez avant d'appuyer sur la touche Tabulation pour l'insérer.

  Le déclencheur doit être un mot simple, constitué de quelques lettres, ou d'un caractère unique. Le déclencheur deviendra rouge si un commutateur invalide a été saisi.

Raccourci clavier

- Entrez le raccourci clavier à utiliser pour insérer l'extrait.

#### Édition et suppression des extraits

Pour éditer un extrait, sélectionnez-le dans la liste et effectuez les modifications dans son texte ou ses propriétés d'activation.

Pour renommer un extrait, cliquez à nouveau dessus dans la liste.

Pour restaurer un extrait intégré que vous avez modifié, appuyez sur Restaurer.

Pour enlever un extrait, sélectionnez le dans la liste et appuyez sur Enlever. Il n'est pas possible de retirer un extrait intégré, mais seulement ceux que vous avez crées.

#### Substitutions dans un extrait

En plus de l'insertion d'un texte précédemment stocké, un extrait peut inclure un texte paramétrable avec des repères où il sera possible d'ajouter du texte un fois l'extrait inséré dans le document.

Vous pouvez utiliser les codes de paramètres de substitution suivants dans le texte d'un extrait :

Étiquettes des paramètres de substitution

- `$`n`` définit l'étiquette d'un paramètre de substitution où `n` est tout nombre supérieur ou égal à 1.

  `${`n`:`default`}` définit l'étiquette d'un paramètre de substitution avec une valeur par défaut.

  Une étiquette de paramètre marque un endroit dans le texte d'un extrait où il sera possible, après son insertion, d'y ajouter du texte.

  Lors de l'utilisation d'étiquettes de paramètres de substitution, insérez l'extrait normalement. Le curseur se place sur la première étiquette. Tapez votre texte et appuyez sur Tabulation pour avancer à l'étiquette suivante. Le numéro dans le code de l'étiquette définit l'ordre dans lequel chacune d'elle sera accédée.

  Appuyez sur Majuscule Tabulation pour revenir à l'étiquette précédente. Appuyer sur Tabulation quand il n'y a plus d'étiquette déplace le curseur à la fin du texte de l'extrait ou sur la dernière étiquette si elle existe.

Miroir des paramètres de substitution

- Répéter une étiquette de paramètre de substitution déjà définie, permet de ne saisir un texte qu'une seule fois et de le reproduire en plusieurs endroits.

Paramètre de substitution terminal

- `$0` définit le paramètre de substitution terminal. Il permet de terminer le travail sur l'extrait avec le curseur à un endroit différent de celui de la fin du texte de l'extrait.

Variables d'environnement

- Les variables d'environnement, telles que `$PATH` et `$HOME`, sont substituées dans le texte de l'extrait. Les variables suivantes, spécifiques à pluma peuvent également être utilisées :

  $PLUMA_SELECTED_TEXT

- La sélection de texte actuelle.

$PLUMA_FILENAME

- Le nom du document, avec son chemin, ou une chaîne vide si le document n'a pas encore été enregistré.

$PLUMA_BASENAME

- Le nom du document sans son chemin ou une chaîne vide si le document n'a pas encore été enregistré.

$PLUMA_CURRENT_WORD

- Mot qui se trouve à l'emplacement du curseur dans le document. Quand cette variable est utilisée, le mot actuel est remplacé par le texte de l'extrait.

Paramètres de substitution pour le shell

- `$(`cmd`)` est remplacé par le résultat de l'exécution de la commande shell `cmd`.

  `$(`n`:`cmd`)` référence ce paramètre de substitution où `n` est supérieur ou égal à 1. Utilisez `$`n`` pour utiliser la sortie de la commande shell comme entrée d'une autre variable.

Paramètres de substitution pour Python

- `$<`cmd`>` est remplacé par le résultat de l'évaluation de la commande `cmd` par l'interpréteur python.

  `$<`a`:`cmd`>` définit un autre paramètre de substitution python comme dépendance, où `a` donne l'ordre dans l'extrait. Ceci permet d'utiliser des fonctions python définies dans un autre extrait. Pour spécifier plusieurs dépendances, séparez les nombres avec des virgules. Par exemple : `$<`a`,`b`:`cmd`>`

  Pour utiliser une variable dans d'autres extraits python, déclarez-la comme `global`.

### Greffon Trier

Le greffon Trier trie les lignes sélectionnées dans l'ordre alphabétique.

You cannot undo the Sort operation, so you should save the file before performing the sort. To revert to the saved version of the file after the sort operation, choose File Revert .

Pour utiliser le greffon Trier, procédez comme suit :

1. Sélectionnez les lignes à trier.

2. Choose Edit Sort . The Sort dialog opens.

3. Choisissez les options de tri :

   - Pour réaliser un tri inverse, cochez l'option Inverser l'ordre.

   - Pour supprimer les lignes identiques, cochez l'option Enlever les doublons.

   - Pour ignorer la casse, cochez l'option Ignorer la casse.

   - Pour que le tri ignore des caractères au début des lignes, indiquez dans la zone de sélection numérique Commencer à la colonne les premiers caractères devant être utilisés dans le tri.

4. Pour faire le tri, cliquez sur le bouton Trier.

### Greffon Vérificateur orthographique

Le greffon Vérificateur orthographique agit dans le texte sélectionné. pluma peut le faire automatiquement ou manuellement et dans une langue donnée. Le paramétrage de la langue et les propriétés du correcteur orthographique s'appliquent à l'ensemble du document. Pour utiliser le correcteur, suivez les étapes suivantes :

1. Choose Tools Set Language to display the Set language dialog. Select the appropriate language from the list. Click OK to close the Set language dialog.

2. To check the spelling automatically, choose Tools Autocheck Spelling . To unset the automatic spell check, choose Tools Autocheck Spelling again. When automatic spell checking is set, an icon is displayed beside the Autocheck Spelling menu item. Automatic spell checking is unset by default, each time pluma starts.

   Les mots dont l'orthographe est inconnue sont soulignés et affichés dans une couleur différente. Cliquez avec le bouton droit sur l'un de ces mots, puis choisissez Suggestions d'orthographe :

   - Pour remplacer un mot inconnu par un de ceux de la liste, utilisez Remplacer dans le menu Suggestion d'orthographe.

   - To add the unknown spelling to your personal dictionary, select Spelling Suggestions Add .

   - To ignore all occurrences of the unknown spelling, so that they are no longer flagged as unknown but are not added to your personal dictionary, select Spelling Suggestions Ignore All . The unknown word is ignored in the current pluma session only.

3. To check the spelling manually, choose Tools Check Spelling .

   S'il n'y a aucune faute, une fenêtre Information s'affiche pour indiquer que le document ne contient pas de mot mal orthographié. Cliquez sur Fermer pour refermer cette fenêtre.

   S'il y a des fautes, la boîte de dialogue Vérification d'orthographe s'ouvre :

   - Le Mot mal orthographié est affiché en haut de la fenêtre.

   - Une suggestion de mot est affichée dans la zone de texte Remplacer par. Il est possible de choisir un autre mot dans la liste des Suggestions ou encore de le saisir directement.

   - Pour vérifier l'orthographe du mot de la fenêtre de texte Remplacer par, cliquez sur Vérifier le mot. S'il est reconnu, la liste de Suggestions est remplacée par le texte `(orthographe correcte)`, sinon de nouvelles propositions apparaissent.

   - Pour ignorer l'occurrence courante du mot non reconnu, cliquez sur Ignorer. Pour l'ignorer partout dans le texte cliquez sur Toujours ignorer. Cela ne reste vrai que pour la session actuelle de pluma.

   - Pour corriger l'occurrence courante d'un mot non reconnu par celui de la zone de texte Remplacer par, cliquez sur Remplacer. Pour corriger toutes les occurrences de ce mot dans le texte, cliquez sur Tout remplacer.

   - Pour ajouter un mot inconnu à votre propre dictionnaire, cliquez sur le bouton Ajouter le mot.

   - Pour fermer la boîte de dialogue Vérification orthographique, cliquez sur Fermer.

### Greffon Liste des balises.

Le greffon Liste des balises permet d'insérer les balises courantes à partir d'une liste située dans le panneau latéral.

Pour utiliser le greffon Liste des balises, procédez comme suit :

1. Choose View Side Pane .

2. Par défaut, le panneau latéral montre un onglet contenant la liste des documents ouverts. Cliquez sur l'onglet montrant une icône + au bas du panneau pour afficher la liste des étiquettes.

3. Sélectionnez la catégorie de balises appropriée dans la liste déroulante. Par exemple, HTML - Balises.

4. Faites défiler la liste des balises pour trouver celle qui vous convient.

5. Insérez la balise dans le document actif, à la position du curseur, en cliquant deux fois sur son nom dans la liste. Vous pouvez également le faire comme suit :

   - Pour insérer une balise dans le document courant et passer de la fenêtre Greffon de liste des balises à la fenêtre de l'éditeur, appuyez sur Entrée.

   - Pour insérer une balise dans le document courant et rester sur la fenêtre Greffon de liste des balises, appuyez sur Majuscule Entrée.