# Manuel de pluma

2015-2020
MATE Documentation Project
2007
GNOME Documentation Project
2002
2003
2004
Sun Microsystems
2000
Eric Baudais
Le projet de documentation MATE
GNOME Documentation Project
Le projet de documentation MATE
Bureau MATE
Joachim
Noreiko
GNOME Documentation Project
GNOME
Hal
Canary
Added the Shortcut Keys Table
Sun Java Desktop System Documentation Team
Sun Microsystems
gdocteam@sun.com
Eric
Baudais
GNOME Documentation Project
baudais@okstate.edu
Baris
Cicek
Provided information from earlier revisions of the pluma application.
George
Ajit
Provided information about plugins.
1.0
2000

Eric Baudais baudais@okstate.edu

GNOME Documentation Project

2.0
March 2002

Équipe de documentation Sun GNOME

GNOME Documentation Project

2.1
June 2002

Équipe de documentation Sun GNOME

GNOME Documentation Project

2.2
August 2002

Équipe de documentation Sun GNOME

GNOME Documentation Project

2.3
September 2002

Équipe de documentation Sun GNOME

GNOME Documentation Project

2.4
January 2003

Équipe de documentation Sun GNOME

GNOME Documentation Project

2.5
March 2003

Équipe de documentation Sun GNOME

GNOME Documentation Project

2.6
September 2003

Équipe de documentation Sun GNOME

GNOME Documentation Project

2.7
March 2004

Équipe de documentation Sun GNOME

GNOME Documentation Project

2.8
July 2015

Sun Java Desktop System Documentation Team

GNOME Documentation Project

2.9
July 2006

Équipe de Documentation GNOME

GNOME Documentation Project

3.0
July 2015

Équipe de documentation MATE

Le projet de documentation MATE

This manual describes version 1.10 of pluma.
Vincent Renardias
vincent@ldsol.com
1998-2000.
Vincent Renardias
Joaquim Fellmann
joaquim@hrnet.fr
2000.
Joaquim Fellmann
Christophe Merlet
redfox@redfoxcenter.org
2000-2006.
Christophe Merlet
Christophe Fergeau
teuf@users.sourceforge.net
2002-2003.
Christophe Fergeau
Sun G11n
gnome_int_l10n@ireland.sun.com
2002.
Sun G11n
Robert-André Mauchin
zebob.m@pengzone.org
2006-2008.
Robert-André Mauchin
Stéphane Raimbault
stephane.raimbault@gmail.com
2007.
Stéphane Raimbault
Yannick Tailliez
ytdispatch-libre@yahoo.com
2008.
Yannick Tailliez
Claude Paroz
claude@2xlibre.net
2008-2010.
Claude Paroz
Gérard Baylard
gerard dot b at bbox dot fr
2010
Gérard Baylard

## 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

  Choose Accessories Pluma Text Editor .

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 :

Barre de menus

  The menus on the menubar contain all the commands you need to work with files in pluma.

Barre d'outils

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

Zone d'affichage

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

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.

Panneau latéral

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

  By default, the side pane is not shown. To show it, choose View Side Pane .

Panneau inférieur

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

  By default, the bottom pane is not shown. To show it, choose View Bottom Pane .

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 emplacement au lieu d'un nom de fichier.

Refer to the pluma 1 man page for more information on how to run pluma from a command line.

## Travailler avec des fichiers

### Création d'un nouveau document

To create a new document, choose File New . The application displays a new blank document in the pluma window.

### Ouverture d'un fichier

To open a file, choose File Open to display the Open File dialog. Select the file that you want to open, then click Open. The file is displayed in the pluma window.

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 .

### Enregistrement d'un fichier

Vous pouvez enregistrer vos documents de plusieurs façons :

- To save changes to an existing file, choose File Save .

- 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 the files that are currently open in pluma, choose Documents Save All .

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

### Travailler avec 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 de texte

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

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.

To advance the selection to the next match while keeping the incremental search box open, press Ctrl G . Press Ctrl Shift G to go back to the previous match.

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

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, vous pouvez inclure les séquences d'échappement suivantes :

`\n`

  Indique une nouvelle ligne.

`\t`

  Indique un caractère de 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

### Options de 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 .

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.

La boîte de dialogue vous permet de préciser les options d'impression suivantes :

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

  Fichier

    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.

## Programming Features

Several of pluma's features for programming are provided with plugins. For example, the Tag List plugin provides a list of commonly-used tags for different markup languages: see .

### 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

Vous pouvez 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.

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

## Raccourcis clavier

Vous pouvez utiliser les raccourcis clavier pour vous perrmettre 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.

Onglets

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 sur le disque.
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ée pour la placer dans le presse-papiers.
Ctrl + C | Copie le texte ou la zone sélectionnée 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 une chaîne de caractères.
Ctrl + G | Recherche la prochaine occurrence d'une chaîne de caractères.
Ctrl + Maj + G | Recherche la précédente occurrence d'une chaîne de caractères.
Ctrl + K | Recherche interactive.
Ctrl + H | Recherche et remplace
Ctrl + Maj + K | Annule la surbrillance.
Ctrl + I | Sauter à 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:

### Affichage

Text Wrapping

  Cochez l'option « Activer le retour à la ligne » pour changer de longues lignes de texte en paragraphes au lieu de poursuivre après la limite de la fenêtre de texte. Ceci évite d'avoir à faire défiler le texte horizontalement.

  Cochez l'option « Ne pas couper les mots » pour conserver l'intégralité d'un mot sur la même ligne lorsque le renvoi de ligne est activé. Cette option rend texte plus facile à lire.

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 la parenthèse correspondante à celle sur laquelle le curseur est positionné.

### Éditeur

Tabs

  La zone de sélection numérique « Largeur des tabulations » permet de spécifier le nombre d'espace que pluma insère lorsque vous appuyez sur la touche Tabulation.

  Cochez l'option Insérer des espaces au lieu des tabulations pour indiquer à pluma de remplacer les tabulations par des espaces lorsque vous appuyez sur la touche Tabulation.

Auto Indentation

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

File Saving

  Cochez l'option « 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 l'option « Enregistrer automatiquement toutes les ... minutes » pour enregistrer automatiquement le document actif à intervalles réguliers. Indiquer dans la zone de sélection numérique la fréquence à laquelle vous souhaitez enregistrer le fichier.

### Police et couleurs

Font

  Cochez l'option « 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. Cliquez sur le bouton pour spécifier le type, le style et la taille de la police à utiliser pour le texte.

Color Scheme

  Vous pouvez choisir un jeu de couleurs parmi la 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 le bleu.

  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 »

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

#### 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 à cocher en face 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 désactiver un greffon dans pluma, suivez les étapes ci-dessous :

1. Choose Edit Preferences .

2. Sélectionnez l'onglet « Greffons » >.

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

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

## Greffons

### Travailler avec des greffons

Vous pouvez ajouter des fonctions supplémentaires à pluma en activant des greffons. Un greffon est un programme connexe qui améliore les fonctionnalités d'une application. Les greffons ajoutent de nouvelles entrées aux menus de pluma.pour les fonctionnalités qu'ils apportent.

Several plugins come built-in with pluma.

To enable and disable plugins, or see which plugins are currently enabled, use the .

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

- allows you to change the case of the selected text.

- shows the number of lines, words, and characters in the document.

- allows you to execute external commands from pluma.

- allows you to browse your files and folders in the side pane.

- adds or removes indentation from the selected lines.

- adds the current date and time into a document.

- allows you to set editing preferences for individual documents, and supports Emacs, Kate and Vim-style modelines.

- allows you to run commands in the python programming language.

- allows you to strip trailing whitespaces in your document after saving.

- allows you to store frequently-used pieces of text and insert them quickly into a document.

- arranges selected lines of text into alphabetical order.

- corrects the spelling in the selected text, or marks errors automatically in the document.

- lets you insert commonly-used tags for HTML and other languages from a list in the side pane.

For more information on creating plugins, see .

### 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 l'initiale de chaque 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 :

Construire

  Lance make dans le répertoire du document actif.

Contenu du répertoire

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

Variables d'environnement

  Affiche la liste des 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.

Enlever les espaces finales

  Enlève toutes les espaces de la fin des ligne du document.

#### Définition d'une commande

To add an external command, choose Tools External Tools .

In the External Tools Manager window, click New. You can specify the following details for the new command:

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.

Commandes

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

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

  Que faire des sorties 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. Vous ne pouvez pas retirer un outil intégré, uniquement ceux que vous avez créés.

#### Variables

Vous pouvez utiliser les variables suivantes dans le champ Commandes de la définition de la commande :

- 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

### File Browser Pane Plugin

The File Browser Pane Plugin shows your files and folders in the side pane, allowing you to quickly open files.

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 initialement vos signets du gestionnaire de fichiers. Pour parcourir l'un d'entre eux, double-cliquez dessus.

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

Pour afficher le dossier contenant le document sur lequel vous travaillez actuellement, 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 fichiers et de dossiers

Pour créer un nouveau fichier 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 si des caractères de tabulation ou d'espace sont utilisés dépendent des paramètres Tabulations dans les préférences de l'éditeur : consultez .

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

Le greffon Insérer la date et l'heure insére la date et l'heure actuelles dans le document. Pour l'utiliser, suivez les étapes indiquées ci-dessous :

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 vous 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 à l'emplacement du curseur dans le fichier courant.

   Si vous avez configuré pluma pour utiliser un format de date et d'heure particulier, la boîte de dialogue Insertion de la date et de l'heure n'est pas affichée La date et l'heure sont automatiquement insérées à l'emplacement du curseur dans le fichier courant.

#### 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 Insérer la date et l'heure.

4. Cliquez sur le bouton Configurer le greffon pour afficher la boîte de dialogue Configurer le greffon d'insertion de la date et de l'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. Refer to the strftime 3 for more information on how to specify a custom format. 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 la date et de l'heure.

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

### Greffon Modificateurs

The Modelines plugin allows you to set preferences for individual documents. A modeline is a line of text at the start or end of the document with settings that pluma recognizes.

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.

Vous pouvez définir les préférences suivantes avec les modificateurs, :

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

The Emacs options for tab-width, indent-offset, indent-tabs-mode and autowrap are supported. For more information, see the GNU Emacs Manual.

#### Modificateurs de Kate

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

The Kate options for tab-width, indent-width, space-indent, word-wrap and word-wrap-column are supported. For more information, see the Kate website.

#### Modificateurs de Vim

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

The Vim options for et, expandtab, ts, tabstop, sw, shiftwidth, wrap, and textwidth are supported. For more information, see the Vim website.

### Greffon Console Python

Le greffon Console Python vous permet d'exécuter des commandes de ce langage à partir de pluma. L'activation du greffon ajoute un onglet au panneau inférieur. Il montre la sortie récente et un champ d'invite de commande.

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

### Save Without Trailing Spaces Plugin

The Save Without Trailing Spaces Plugin removes whitespace characters such as space (`˽`), tab (`\t`), carriage returns (`\r`) etc. from the end of a line. To use the Save Without Trailing Spaces plugin, perform the following steps:

1. Enable the plugin as described in .

2. When your document is ready, save it.

3. You will see that any trailing whitespaces has been stripped after the document has been saved.

### Greffon Extraits

Le greffon Extraits vous 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, lorsque vous travaillez avec un document HTML, vous pouvez choisir une liste d'extraits utiles pour le HTML. En plus, certains d'entre eux sont globaux et sont disponibles pour tous les documents.

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

#### Insertiion d'extraits

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

Alternatively, press Ctrl Space to see a list of snippets you can insert.

#### Ajout d'extraits

Pour créer un nouvel extrait procédez comme indiqué ci-après :

1. Choose Tools Manage Snippets . The Snippets Manager window opens.

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

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

4. Entrez les informations suivantes pour le nouvel extrait :

   Nom

     Entrez un nom pour l'extrait dans le champ texte de la liste des extraits. Ce nom sert seulement à se souvenir de son utilité. Vous pouvez changer le nom de l'extrait que vous créez en cliquant dessus dans la liste.

   Texte de l'extrait

     Entrez le texte de l'extrait dans la zone de texte Modification de l'extrait. Pour l'utilisation de codes spéciaux, voyez .

     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 sera surligné en rouge si un déclencheur 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. Vous ne pouvez pas retirer un extrait intégré, seulement ceux que vous avez créés.

#### Substitutions dans un extrait

En plus de l'insertion d'un texte précédemment stocké, un extrait peut inclure du texte paramétrable ou des repères que vous pouvez ajouter une fois l'extrait inséré dans votre document.

Vous pouvez utiliser les codes 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ù vous pourrez ajouter du texte supplémentaire après l'insertion de l'extrait.

  Pour utiliser une é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 de chaque emplacement dans le texte.

  Press Shift Tab to return to the previous tab placeholder. Pressing Tab when there are no more tab placeholders moves the cursor to the end of the snippet text, or to the end placeholder if it exists.

Répétition des paramètres de substitution

  Répéter une étiquette de paramètre de substitution déjà définie, vous permet de ne saisir qu'une seule fois un texte que vous voulez voir apparaître plusieurs fois dans l'extrait

End placeholder

  `$0` définit la fin d'un paramètre de substitution. Ceci vous 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 de fichier complet du document, avec son chemin, ou une chaîne vide si le document n'a pas encore été enregistré.

  $PLUMA_BASENAME

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

  $PLUMA_CURRENT_WORD

    Le 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)` vous permet de référencer 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 de 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 vous 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 pour 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. Select the lines of text you want to sort.

2. Choose Edit Sort . The Sort dialog opens.

3. Choisissez les options de tri :

   - Pour trier le texte dans l'ordre inverse, cochez l'option Inverser l'ordre.

   - Pour supprimer les lignes dupliquées, cochez l'option Enlever les doublons.

   - Pour ignorer la sensibilité à 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 exécuter l'opération de tri, cliquez sur le bouton Trier.

### Greffon Vérificateur orthographique

Le greffon Vérificateur orthographique vérifie l'orthographe dans le texte sélectionné. Vous pouvez configurer pluma pour vérifier l'orthographe automatiquement ou manuellement, 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 orthographique, 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.

   Unknown spellings are displayed in a different color, and underlined. Right-click on an unknown spelling, then select Spelling Suggestions from the popup menu:

   - 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 d'orthographe, une boîte de dialogue Information s'affiche pour indiquer que le document ne contient pas de mot mal orthographié. Cliquez sur Fermer pour refermer cette boîte de dialogue.

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

   - Le mot mal orthographié est affiché en haut de la boite de dialogue.

   - Une suggestion de mot connu est affichée dans la zone de texte Remplacer par. Vous pouvez choisir un autre mot connu depuis la liste des Suggestions ou vous pouvez le saisir directement dans la zone de texte Remplacer par.

   - Pour vérifier l'orthographe du mot de la zone 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 ignorer toutes les occurrences du mot inconnu cliquez sur Toujours ignorer. Le mot inconnu est ignoré seulement pendant 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 dictionnaire personnel, 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 vous 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 l'onglet de la liste des balises.

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 la balise souhaitée.

5. Pour insérer la balise à la position du curseur dans le fichier courant, cliquez deux fois sur son nom dans la liste. Vous pouvez également le faire comme suit :

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

   - To insert a tag in the current file and maintain the focus on the Tag list plugin window, press Shift Return .