# Manuale di pluma

## Introduzione

L'applicazione pluma consente di creare e modificare file di testo.

Lo scopo di pluma è quello di essere un semplice editor di testo. Caratteristiche più avanzate possono essere abilitate attraverso l'uso di diversi plugin, che consentono lo svolgimento di diverse attività correlate alla modifica di file di testo.

## Per iniziare

### Avviare pluma

È possibile avviare pluma nei seguenti modi:

Menù Applicazioni

- Scegliere Accessori Editor di testo.

Riga di comando

- Eseguire il seguente comando: `pluma`

In modo predefinito, aprendo un documento di testo dal file manager, pluma viene avviato mostrando il contenuto del documento.

### La finestra di pluma

All'avvio di pluma viene visualizzata la seguente finestra:

#### Finestra di pluma

Shows pluma main window.

La finestra di pluma contiene i seguenti elementi:

Barra dei menù

- I menù della barra dei menù contengono tutti i comandi necessari per le operazioni sui file in pluma.

Barra degli strumenti

- La barra degli strumenti contiene un sottoinsieme dei comandi a cui è possibile accedere nella barra dei menù.

Area di visualizzazione

- L'area di visualizzazione contiene il testo del file che si sta modificando.

Barra di stato

- La barra di stato visualizza informazioni sulle attività di pluma attualmente in corso e altre indicazioni contestuali relative alle voci di menù.

  - Posizione del cursore: il numero di riga e di colonna in cui è posizionato il cursore.

  - Modalità di modifica: se l'editor è in modalità di inserimento, la barra di stato contiene l'indicazione INS. Se l'editor è in modalità di sovrascrittura, la barra di stato contiene l'indicazione SSC. Premere Ins per cambiare la modalità di modifica.

Riquadro laterale

- Il riquadro laterale visualizza l'elenco dei documenti aperti e altre informazioni in base ai plugin abilitati.

  Il riquadro laterale, in modo predefinito, non è mostrato. Per visualizzarlo, scegliere Visualizza Riquadro laterale.

Riquadro inferiore

- Il riquadro inferiore è utilizzato dagli strumenti di programmazione come il plugin Console Python per la visualizzazione dell'output.

  Il riquadro inferiore, in modo predefinito, non è mostrato. Per visualizzarlo, scegliere Visualizza Riquadro inferiore.

Facendo clic con il pulsante destro del mouse nella finestra di pluma, l'applicazione visualizza un menù pop-up. Questo menù contiene i comandi di uso più frequente per la modifica del testo.

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.

### Eseguire pluma dalla riga di comando

È possibile eseguire pluma dalla riga di comando e aprire automaticamente uno o più file. Per aprire più file dalla riga di comando, digitare il comando seguente e premere Invio:

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

In alternativa, è possibile specificare un URI invece del nome di un file.

Per maggiori informazioni sull'esecuzione di pluma dalla riga di comando, consultare la pagina di manuale Unix di pluma,

pluma

1.

## Lavorare con i file

### Creare un nuovo documento

Per creare un nuovo documento, scegliere File Nuovo. L'applicazione visualizza un nuovo file nella finestra di pluma.

### Aprire un file

Per aprire un file, scegliere File Apri per visualizzare il dialogo Apri file. Selezionare il file da aprire e fare clic su Apri. Il file viene visualizzato nella finestra di 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.

Con pluma è possibile aprire anche file multipli. L'applicazione aggiunge, nella finestra, una scheda per ogni file aperto. Per maggiori informazioni, consultare pluma-tabs.

### Salvare un file

È possibile salvare un file nei seguenti modi:

- Per salvare le modifiche a un file esistente, scegliere File Salva.

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

### Aprire un file da un URI

Per aprire un file usando un URI (Uniform Resource Identifier), procedere come segue:

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

2. Inserire l'URI del file da aprire.

3. Usare l'elenco a discesa Codifiche dei caratteri per selezionare la codifica appropriata.

4. Fare clic su Apri.

`URI` validi sono: `http:`, `ftp:`, `file:` e tutti i metodi supportati da `mate-vfs`.

I file da alcuni tipi di URI sono aperti in sola lettura e qualsiasi modifica apportata deve essere salvata in una posizione diversa. HTTP consente di leggere solamente i file, anche i file aperti attraverso FTP sono a sola lettura in quanto non tutti i server FTP sono in grado di gestire il salvataggio remoto di file.

Il salvataggio di file su server FTP può essere abilitato attraverso l'Editor della configurazione, impostando la chiave `/apps/pluma/preferences/editor/save/writable_vfs_schemes`. Questo però, potrebbe causare degli errori.

### Lavorare con le schede

Quando sono aperti più file, pluma mostra una scheda per ogni documento sopra l'area di visualizzazione. Per passare a un altro documento, fare clic sulla sua scheda.

Per spostare un documento in un'altra finestra di pluma, trascinare la scheda corrispondente nella finestra in cui si vuole spostarlo.

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

## Lavorare con il testo

### Modificare il testo

È possibile modificare il testo di un file nei seguenti modi:

- Inserire del nuovo testo attraverso l'uso della tastiera. Il cursore di inserimento lampeggiante indica il punto dove appare il testo. Per modificarlo, utilizzare le frecce direzionali o fare clic col mouse.

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

### Annullare e ripetere le modifiche

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

## Trovare e sostituire del testo

In pluma ci sono due modi per cercare del testo. È possibile utilizzare il dialogo Trova per cercare un testo specifico, oppure la Ricerca incrementale per evidenziare le corrispondenze mentre viene digitato il testo.

### Trovare del testo

Per cercare una stringa all'interno di un file, procedere come segue:

1. Choose Search Find to display the Find dialog.

2. Digitare la stringa da trovare nel campo Cerca. È possibile utilizzare dei caratteri speciali come le tabulazioni o gli a capo: consultare pluma-find-escapes.

3. Fare clic su Trova per cercare la prima occorrenza della stringa nel file dopo la posizione del cursore. Se pluma trova la stringa, l'applicazione ne seleziona la prima occorrenza, le altre vengono solo evidenziate.

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 .

### Ricerca incrementale

La ricerca incrementale evidenzia le corrispondenze del testo nel documento durante la digitazione, lettera per lettera (simile alla ricerca in diversi browser web).

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

Iniziando a digitare una parola, il testo corrispondente viene evidenziato nel documento e viene selezionata la prima istanza successiva alla posizione del cursore.

Per spostare la selezione alla corrispondenza successiva mantenendo la casella di ricerca aperta, premere Ctrl G. Premere Ctrl Maiusc G per spostare la selezione indietro.

È anche possibile utilizzare le frecce direzionali su e giù o la rotellina di scorrimento del mouse per spostare la selezione tra le varie corrispondenze.

### Sostituire il testo

Per cercare una stringa all'interno di un file e sostituirla con un'altra, procedere come segue:

1. Choose Search Replace to display the Replace dialog.

2. Digitare la stringa da trovare nel campo Cerca. È possibile utilizzare dei caratteri speciali come le tabulazioni o gli a capo: consultare pluma-find-escapes.

3. Digitare la stringa con cui sostituire quella che si sta ricercando nel campo Sostituisci con.

Per controllare le occorrenze della stringa prima di sostituirla, fare clic su Trova. Se pluma trova la stringa, questa viene selezionata. Fare clic su Sostituisci per sostituire l'occorrenza selezionata della stringa. Per trovare l'occorrenza successiva, fare clic nuovamente su Trova.

Per sostituire tutte le occorrenze della stringa all'interno del documento, fare clic su Sostituisci tutti.

### Opzioni di trova e sostituisci

Le finestre di dialogo Trova e Sostituisci presentano entrambe le seguenti opzioni:

- Selezionare l'opzione Maiuscole/minuscole per individuare solo le occorrenze della stringa che corrispondono esattamente al testo digitato. Per esempio, con l'opzione Maiuscole/minuscole selezionata, «TESTO» non corrisponde a «testo».

- Selezionare l'opzione Solo parole intere per individuare solo le occorrenze della stringa che corrispondono a parole intere del testo digitato. Per esempio, con l'opzione Solo parole intere selezionata, «testa» non corrisponde a «testamento».

- Selezionare l'opzione Cercare all'indietro per eseguire la ricerca dalla fine del file al suo inizio.

- Selezionare l'opzione Ricominciare dall'inizio per eseguire la ricerca fino alla fine del file e continuare dall'inizio del file.

### Caratteri speciali

È possibile includere i seguenti caratteri speciali per eseguire ricerche o sostituzioni:

`\n`

- Specifica un "new line".

`\t`

- Specifica un carattere di tabulazione.

`\r`

- Specifica un "carriage return".

`\\`

- Affinché il carattere backslash possa essere cercato, è necessario usare una sequenza di escape. Per esempio, per cercare "`\n`", è necessario digitare "\\n" nel campo Cerca. Oppure, per cercare una sequenza di backslash, è necessario raddoppiare il numero di backslash da cercare.

### Posizionare il cursore su una riga specifica

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.

Digitare il numero della riga in cui si intende spostare il cursore e il documento scorrerà fino alla riga specificata.

Per rimuovere la casella di testo e spostare il cursore alla riga specificata, premere Invio.

## Stampa

### Impostare le opzioni della pagina

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

La finestra di dialogo Impostazioni pagina consente di specificare le seguenti opzioni di stampa:

#### Scheda Generale

Print syntax highlighting

- Selezionare questa opzione per stampare l'evidenziazione di sintassi. Per maggiori informazioni al riguardo, consultare pluma-set-highlightmode.

Print page headers

- Selezionare questa opzione per includere un'intestazione in ogni pagina stampata. Non è possibile configurare l'intestazione.

Line Numbers

- Selezionare l'opzione Stampare numeri di riga per includere i numeri delle righe nella stampa di un file.

  Usare il controllo di selezione Numeri ogni ... righe per specificare la frequenza con cui stampare i numeri, per esempio ogni 5 righe, ogni 10 righe e così via.

Text Wrapping

- Selezionare l'opzione Attivare a capo automatico per mandare a capo il testo automaticamente a livello di parola durante la stampa di un file. L'applicazione conteggia le righe mandate a capo come una singola riga ai fini della numerazione.

  Selezionare l'opzione Non dividere le parole su due righe per impostare il ritorno a capo del testo a livello di parola durante la stampa di un file.

#### Caratteri

Body

- Fare clic su questo pulsante per selezionare il tipo di carattere da usare per stampare il testo di un file.

Line numbers

- Fare clic su questo pulsante per selezionare il tipo di carattere da usare per stampare i numeri di riga di un file.

Headers and footers

- Fare clic su questo pulsante per selezionare il tipo di carattere da usare per stampare le intestazioni e i piè di pagina di un file.

Per ripristinare i caratteri predefiniti per la stampa dei file da pluma, fare clic sul pulsante Ripristina caratteri predefiniti.

### Stampare un documento

pluma consente di eseguire le seguenti operazioni di stampa:

- Stampare un documento su una stampante.

- Inviare l'output di un comando di stampa in un file.

Quando si stampa su un file, pluma invia l'output al file in un formato di prestampa. I formati di prestampa più diffusi sono PostScript e 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 finestra di dialogo Stampa consente di specificare le seguenti opzioni di stampa:

#### Scheda Lavoro

Print range

- Selezionare una delle opzioni seguenti per determinare quali pagine stampare:

  - All

    Selezionare questa opzione per stampare tutte le pagine del file.

  - Lines

    Selezionare questa opzione per stampare solamente le righe specificate. Usare i controlli di selezione Da: e A: per specificare un intervallo di righe.

  - Selection

    Selezionare questa opzione per stampare solo il testo selezionato. L'opzione è abilitata solo quando è stata effettuata una selezione.

Copies

- Usare il controllo di selezione Numero di copie per specificare il numero di copie da stampare.

  Se si intendono stampare più copie del file, selezionare l'opzione Fascicola per fascicolare le copie stampate.

#### Scheda Stampante

Printer

- Usare questo elenco a discesa per selezionare la stampante con cui stampare il file.

Settings

- Usare questa elenco a discesa per selezionare le impostazioni della pagina.

  Per configurare la stampante, fare clic su Configura. Per esempio, è possibile abilitare la stampa fronte retro o impostare una stampa ritardata, sempre che queste funzionalità siano supportate dalla stampante.

Location

- Usare questo elenco a discesa per selezionare una delle seguenti opzioni:

  CUPS

- Stampa il file su una stampante CUPS.

  Se la stampante selezionata è una stampante CUPS, CUPS è l'unica voce di questo elenco a discesa.

lpr

- Stampa il file su una stampante.

File

- Stampa su un file PostScript.

  Fare clic su Salva come per visualizzare la finestra di dialogo in cui specificare il nome e la posizione del file PostScript.

Custom

- Usa il comando specificato per stampare il file.

  Digitare il nome del comando nella casella di testo. Includere anche tutti gli argomenti a riga di comando.

State

- Questa funzionalità non è supportata da questa versione di pluma.

Type

- Questa funzionalità non è supportata da questa versione di pluma.

Comment

- Questa funzionalità non è supportata da questa versione di pluma.

#### Scheda Carta

Paper size

- Usare questo elenco a discesa per selezionare la dimensione della carta su cui stampare il file.

Width

- Usare questo controllo di selezione per specificare la larghezza della carta. Usare l'elenco a discesa adiacente per modificare l'unità di misura per la dimensione della carta.

Height

- Usare questo controllo di selezione per specificare l'altezza della carta.

Feed orientation

- Usare questo elenco a discesa per selezionare l'orientamento della carta nella stampante.

Page orientation

- Usare questo elenco a discesa per selezionare l'orientamento della pagina.

Layout

- Usare questo elenco a discesa per selezionare la disposizione della pagina. La disposizione prescelta viene visualizzata in anteprima nell'area Anteprima.

Paper tray

- Usare questo elenco a discesa per selezionare l'orientamento della pagina.

## Caratteristiche di programmazione

Molte delle caratteristiche di programmazione di pluma vengono fornite attraverso plugin. Il plugin «Elenco dei tag», per esempio, fornisce un elenco dei tag più usati per i maggiori linguaggi di marcatura del testo: consultare pluma-tag-list-plugin.

### Evidenziazione sintassi

L'evidenziazione della sintassi rende la lettura del codice sorgente più semplice visualizzando diverse parti del testo con colori differenti.

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

- Non visualizza alcuna evidenziazione.

Sources

- Visualizza l'evidenziazione della sintassi per il codice sorgente. Usare il sotto-menù Sorgenti per selezionare il tipo di codice sorgente.

Markup

- Visualizza l'evidenziazione della sintassi per il codice di marcatura. Usare il sotto-menù Markup per selezionare il tipo di marcatura.

Scripts

- Visualizza l'evidenziazione della sintassi per gli script. Usare il sotto-menù Script per selezionare il tipo di script.

Others

- Visualizza l'evidenziazione di sintassi per altri tipi di codice. Usare il sotto-menù Altri per selezionare il tipo.

### Inviare l'output di un comando in pipe a un file

È possibile usare pluma per inviare con una pipe l'output di un comando a un file di testo. Per esempio, per inviare in pipe l'output del comando `ls` a un file di testo, digitare `ls | pluma`, quindi premere Invio.

L'output del comando `ls` viene visualizzato in un nuovo file di testo nella finestra di pluma.

In alternativa, è possibile usare il plugin Strumenti esterni per inviare in pipe l'output del comando al file aperto.

## Scorciatoie da tastiera

È possibile usare le scorciatoie da tastiera per eseguire delle azioni comuni più velocemente rispetto all'utilizzo del mouse o dei menù. La seguente tabella elenca tutte le scorciatoie di pluma.

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

Tabulazioni

Scorciatoie per le tabulazioni:

Scorciatoia | Comando
Ctrl + Alt + PagSu | Passa alla successiva scheda sulla sinistra.
Ctrl + Alt + PagGiù | Passa alla successiva scheda sulla destra.
Ctrl + W | Chiude la scheda.
Ctrl + Maiusc + L | Salva tutte le schede.
Ctrl + Maiusc + W | Chiude tutte le schede.
Alt + n | Passa all'n-esima scheda.

File

Scorciatoie per lavorare con i file:

Scorciatoia | Comando
Ctrl + N | Creare un nuovo file.
Ctrl + O | Apre un file.
Ctrl + L | Apre una posizione.
Ctrl + S | Salva il file aperto sul disco.
Ctrl + Maiusc + S | Salva il file aperto con un nuovo nome.
Ctrl + P | Stampa il file corrente.
Ctrl + Maiusc + P | Anteprima di stampa.
Ctrl + W | Chiude il file corrente.
Ctrl + Q | Esce da Pluma

Modifica

Scorciatoie per modificare i file:

Scorciatoia | Comando
Ctrl + Z | Annulla l'ultima azione.
Ctrl + Maiusc + Z | Ripete l'ultima azione annullata.
Ctrl + X | Taglia il testo o la regione selezionata e la mette negli appunti.
Ctrl + C | Copia il testo o la regione selezionata negli appunti.
Ctrl + V | Incolla il contenuto degli appunti.
Ctrl + A | Seleziona tutto.
Ctrl + D | Elimina la riga attuale.
Alt + Up | Move the selected line up one line.
Alt + Down | Move the selected line down one line.

Riquadri

Scorciatoie per mostrare e nascondere i riquadri:

Scorciatoia | Comando
F9 | Mostra/Nasconde il riquadro laterale.
Ctrl + F9 | Mostra/Nasconde il riquadro inferiore.

Cerca

Scorciatoie per eseguire ricerche:

Scorciatoia | Comando
Ctrl + F | Trova una stringa.
Ctrl + G | Trova l'istanza successiva della stringa.
Ctrl + Maiusc + G | Trova l'istanza precedente della stringa.
Ctrl + K | Ricerca incrementale.
Ctrl + H | Cerca e sostituisce.
Ctrl + Maiusc + K | Azzera evidenziazione.
Ctrl + I | Va alla riga.

Strumenti

Scorciatoie per gli strumenti:

Scorciatoia | Comando
Maiusc + F7 | Controllo ortografico (con plugin).
Alt + F12 | Rimuove gli spazi di fine riga (con plugin).
Ctrl + T | Rientro (con plugin).
Ctrl + Maiusc + T | Rimuove rientro (con plugin).
F8 | Esegue "make" nella directory attuale (con plugin).
Ctrl + Maiusc + D | Elenco directory (con plugin).

Aiuto

Scorciatoie per l'aiuto:

Scorciatoia | Comando
F1 | Apre il manuale utente di pluma.

## Preferenze

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

### Preferenze di visualizzazione

Text Wrapping

- Selezionare l'opzione Attivare a capo automatico in modo che le righe di testo più lunghe non vadano oltre il bordo della finestra. In questo modo si evita lo scorrimento orizzontale.

  Selezionare l'opzione Non dividere le parole su due righe in modo che l'opzione di a capo automatico preservi le parole a fine riga intere. Consente una lettura più facile del testo.

Line Numbers

- Selezionare l'opzione Mostrare i numeri di riga per visualizzare i numeri di riga nella parte sinistra della finestra di pluma.

Current Line

- Selezionare l'opzione Evidenziare la riga corrente per evidenziare la riga a cui il cursore è posizionato.

Right Margin

- Selezionare l'opzione Mostrare il margine destro per visualizzare una riga verticale indicante il margine destro.

  Usare il controllo di selezione Margine destro alla colonna per specificare la posizione della riga verticale.

Bracket Matching

- Selezionare l'opzione Evidenziare la parentesi corrispondente per evidenziare la parentesi corrispondente quando il cursore è posizionato su una parentesi.

### Preferenze dell'editor

Tabs

- Usare il controllo di selezione Ampiezza tabulazione per specificare la larghezza dello spazio che pluma deve inserire quando si preme il tasto Tab.

  Selezionare l'opzione Inserire spazi invece di tabulazioni per specificare che pluma deve inserire una sequenza di spazi anziché un carattere di tabulazione quando si preme il tasto Tab.

Auto Indentation

- Selezionare l'opzione Attivare rientro automatico per specificare che la riga successiva deve iniziare al livello di rientro di quella attuale.

File Saving

- Selezionare l'opzione Creare una copia di backup dei file prima di salvare per creare una copia di backup di un file ogni volta che viene salvato. La copia di backup del file presenta una tilde (~) alla fine del nome.

  Selezionare l'opzione Salvataggio automatico ogni ... minuti per impostare il salvataggio automatico del file a intervalli regolari. Usare il controllo di selezione per specificare l'intervallo per il salvataggio automatico del file.

### Caratteri & colori

Font

- Selezionare l'opzione Usare il carattere predefinito del tema per usare il tipo di carattere predefinito del sistema nella finestra di testo di pluma.

  Il campo Carattere dell'editor visualizza il tipo di carattere utilizzato da pluma per la visualizzazione del testo. Fare clic sul pulsante per specificare il tipo di carattere, lo stile e la dimensione da usare per il testo.

Color Scheme

- È possibile scegliere uno schema di colori dall'elenco di quelli installati. Quelli che seguono sono gli schemi di colori installati in modo predefinito:

  Classic

- Schema colore classico basato su quello di gvim.

Cobalt

- Schema colore basato sul blu.

Kate

- Schema colore usato nell'editor di testo Kate.

Oblivion

- Schema colore scuro che fa uso dei colori del progetto Tango.

Tango

- Schema colore che fa uso dei colori del progetto Tango.

È possibile aggiungere un nuovo schema di colori facendo clic su Aggiungi... e selezionando un file contenente lo schema di colori

È possibile rimuovere lo schema colore selezionato facendo clic su Rimuovi

### Plugin

I plugin aggiungono funzionalità a pluma. Per maggiori informazioni sull'utilizzo dei plugin integrati, consultare pluma-plugins-overview.

#### Abilitare un plugin

Per abilitare un plugin di pluma, procedere come segue:

1. Choose Edit Preferences .

2. Selezionare la scheda Plugin.

3. Selezionare la casella di spunta a fianco il nome del plugin da abilitare.

4. Fare clic su Chiudi per chiudere la finestra di dialogo Preferenze.

#### Disabilitare un plugin

Quando si esce da pluma, i plugin rimangono abilitati.

Per disabilitare un plugin di pluma, procedere come segue:

1. Choose Edit Preferences .

2. Selezionare la scheda Plugin.

3. Deselezionare la casella di spunta a fianco del nome del plugin da disabilitare.

4. Fare clic su Chiudi per chiudere la finestra di dialogo Preferenze.

## I plugin

### Lavorare con i plugin

È possibile aggiungere ulteriori caratteristiche a pluma attraverso l'uso dei plugin. Un plugin è un programma ausiliario che aumenta le funzionalità di un'applicazione. I plugin aggiungono nuovi oggetti ai menù di pluma in base alle funzionalità che forniscono.

Diversi plugin sono integrati in pluma ed è possibile installarne altri. Il sito wed di pluma elenca ulteriori plugin.

Per abilitare o disabilitare un plugin o per vedere quali plugin sono attualmente abilitati, consultare la sezione Plugin.

I seguenti plugin sono integrati in pluma:

- Cambia maiuscole/minuscole consente di cambiare il testo selezionato tra maiuscolo e minuscolo.

- Statistiche sul documento mostra il numero di righe, parole e caratteri del documento.

- Strumenti esterni consente di eseguire comandi esterni da pluma.

- Pannello dell'esplorazione file consente di esplorare i propri file e cartelle nel riquadro laterale.

- Applica un rientro alle righe aggiunge o rimuove un rientro alle righe selezionate.

- Inserisci date e ora aggiunge al documento la data e l'ora correnti.

- Modeline consente di impostare delle preferenze di modifica per alcuni documenti e supporta le modeline in stile Emacs, Kate e Vim.

- Console python consente di eseguire comandi attraverso il linguaggio di programmazione python.

- Snippet consente di archiviare dei frammenti di testo usati frequentemente e di inserirli all'interno di un documento.

- Ordina organizza alfabeticamente le righe di testo selezionate.

- Correttore ortografico controlla l'ortografia del testo selezionato o evidenzia automaticamente gli errori nel documento.

- Elenco tag consente di inserire i tag più usati per l'HTML e altri linguaggi da un elenco nel riquadro laterale.

For more information on creating plugins, see the pluma website.

### Plugin «Cambia maiuscole/minuscole»

Il plugin Cambia maiuscole/minuscole cambia tra maiuscole e minuscole il testo selezionato.

I seguenti elementi sono aggiunti al menù Modifica quando il plugin Cambia maiuscole/minuscole è abilitato:

Voce di menù | Azione | Esempio
Edit Change Case All Upper Case | Modifica ogni carattere in maiuscolo. | `Questo testo` diventa `QUESTO TESTO`
Edit Change Case All Lower Case | Modifica ogni carattere in minuscolo. | `Questo Testo` diventa `questo testo`
Edit Change Case Invert Case | Modifica ogni carattere minuscolo in maiuscolo e viceversa. | `Questo Testo` diventa `qUESTO tESTO`
Edit Change Case Title Case | Modifica il primo carattere di ogni parola in maiuscolo. | `questo testo` diventa `Questo Testo`

### Plugin «Statistiche sul documento»

Il plugin Statistiche sul documento conta il numero di righe, parole, caratteri, compresi ed esclusi gli spazi, e byte del file attivo. I risultati vengono visualizzati nella finestra di dialogo Statistiche sul documento. Per usare il plugin «Statistiche sul documento», procedere come segue:

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

   - Numero di righe del documento.

   - Numero di parole del documento.

   - Numero di caratteri, compresi gli spazi, del documento.

   - Numero di caratteri, esclusi gli spazi, del documento.

   - Numero di byte del documento.

2. È possibile continuare ad aggiornare il file di pluma anche tenendo aperta la finestra di dialogo Statistiche sul documento. Per aggiornare il contenuto della finestra di dialogo Statistiche sul documento, fare clic su Aggiorna.

### Plugin «Strumenti esterni»

Il plugin Strumenti esterni consente di eseguire dei comandi esterni all'interno di pluma. È possibile inviare in pipe dei contenuti a un comando e sfruttarne l'output (per esempio sed) o eseguire un comando predefinito (come make).

Usare Gestore strumenti esterni per creare e modificare i comandi. Per eseguire un comando esterno, sceglierlo dal menù Strumenti.

#### Comandi integrati

I seguenti comandi sono forniti con il plugin Strumenti esterni:

Crea

- Esegue make nella directory del documento.

Directory Listing

- Elenca i contenuti della cartella del documento in un nuovo documento.

Environment Variables

- Visualizza l'elenco delle variabili d'ambiente nel riquadro inferiore.

Grep

- Cerca un termine in tutti i file nella directory del documento attuale usando una ricerca per corrispondenza. I risultati sono mostrati nel riquadro inferiore.

Rimuovi gli spazi di fine riga

- Rimuove tutti gli spazi alla fine di ogni riga del documento.

#### Definire un comando

Per aggiungere un comando esterno, scegliere Strumenti Strumenti esterni....

Nella finestra di Gestore strumenti esterni, fare clic su Nuovo. È possibile specificare i seguenti dettagli per il nuovo comando:

Descrizione

- La descrizione è mostrata nella barra di stato quando viene scelto il comando.

Tasto scorciatoia

- Inserire una scorciatoia da tastiera per il comando.

Comando/i

- I comandi da eseguire. È possibile utilizzare diverse variabili d'ambiente di pluma per passare i contenuti a questi comandi: consultare pluma-external-tools-plugin-variables.

Input

- Il contenuto da passare ai comandi (come `stdin`): l'intero documento, la selezione, una riga o una parola.

Output

- Cosa fare con l'output dei comandi: visualizzarlo nel riquadro inferiore, in un nuovo documento o posizionarlo alla fine del documento attuale, alla posizione del cursore o sostituire la selezione o tutto il documento.

Applicabilità

- Determina quali documenti sono interessati dal comando, per esempio i documenti salvati oppure no, i documenti locali o quelli remoti.

#### Modificare e rimuovere gli strumenti

Per modificare uno strumenti, selezionarlo dall'elenco e modificare le sue proprietà.

Per rinominare uno strumento, fare nuovamente clic su di esso nell'elenco.

Per ripristinare uno strumento integrato che è stato modificato, fare clic su Ripristina.

Per rimuovere uno strumento, selezionarlo dall'elenco e fare clic su Rimuovi. Non è possibile rimuovere gli strumenti integrati, solo quelli che vengono creati dall'utente.

#### Variabili

È possibile utilizzare le seguenti variabili nel campo Comando/i della definizione del comando:

- 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

### Plugin «Esplorazione file»

Il plugin Esplorazione file mostra i propri file e cartelle nel riquadro laterale, consentendo un'apertura veloce dei file.

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.

#### Esplorare i propri file

La scheda dei file, inizialmente, mostra i segnalibri del gestore dei file. Per esplorare il contenuto di un oggetto, fare doppio clic su di esso.

Per mostrare una cartella superiore, sceglierla dall'elenco a discesa o premere la freccia verso l'alto nella barra degli strumenti del riquadro.

Per mostrare la cartella del documento a cui si sta lavorando, fare clic col tasto destro all'interno dell'elenco e scegliere Imposta il documento attivo come radice.

#### Aprire un file

Per aprire un file in pluma, fare doppio clic su di esso nell'elenco.

#### Creare file e cartelle

Per creare un nuovo file nella cartella attuale mostrata nel riquadro, fare clic col tasto destro del mouse nell'elenco dei file e scegliere Nuovo file.

Per creare una nuova cartella nella cartella attuale mostrata nel riquadro, fare clic col tasto destro del mouse nell'elenco e scegliere Nuova cartella.

### Plugin «Applica un rientro alle righe»

Il plugin Applica un rientro alle righe aggiunge o rimuove degli spazi all'inizio delle righe di testo.

Per applicare o rimuovere un rientro, procedere come segue:

1. Selezionare le righe a cui si desidera applicare il rientro. Per applicare o rimuovere un rientro su una singola riga, posizionare il cursore all'interno di quella riga.

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

   - To remove the indentation, choose Edit Unindent .

La quantità di spazio usato, o l'uso di spazi o caratteri di tabulazione, dipende delle impostazione di Tabulazioni nelle preferenze: consultare pluma-prefs-editor.

### Plugin «Inserisci data e ora»

Il plugin Inserisci data e ora permette di inserire la data e l'ora corrente in un documento. Per usare il plugin «Inserisci data e ora», procedere come segue:

1. Choose Edit Insert Date and Time .

   Se il plugin non è stato configurato per inserire automaticamente la data e l'ora senza richiedere il formato all'utente, pluma visualizza la finestra di dialogo Inserisci data e ora. Selezionare dall'elenco il formato appropriato per la data e l'ora. Fare clic su Inserisci per chiudere la finestra di dialogo Inserisci data e ora;pluma inserisce la data e l'ora nella posizione del cursore.

   Se pluma è stato configurato per usare un determinato formato per la data e l'ora, la finestra di dialogo Inserisci data e ora non viene visualizzata; la data e l'ora vengono inserite automaticamente nella posizione del cursore.

#### Configurare il plugin «Inserisci data e ora»

Per configurare il plugin «Inserisci data e ora», procedere come segue:

1. Choose Edit Preferences .

2. Selezionare la scheda Plugin.

3. Selezionare il plugin Inserisci data e ora.

4. Fare clic su Configura plugin per aprire la finestra di dialogo Configura plugin «Inserisci data e ora».

5. Selezionare una delle seguenti opzioni:

   - Per specificare il formato da utilizzare ogni volta che si inseriscono la data e l'ora, selezionare l'opzione Chiedere il formato.

   - 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. Fare clic su OK per chiudere la finestra di dialogo Configura plugin «Inserisci data e ora».

7. Per chiudere la finestra di dialogo Preferenze, fare clic su Chiudi.

### Plugin «Modeline»

Il plugin Modeline consente di impostare delle preferenze per ogni documento. Una modeline è una riga di testo all'inizio o alla fine del documento con delle impostazioni riconosciute da pluma.

Le preferenze impostate usando le modeline hanno la precedenza su quelle specificate nella finestra di dialogo delle preferenze.

È possibile impostare le seguenti preferenze con le modeline:

- Larghezza tabulazioni

- Larghezza rientro

- Inserire spazi al posto di tabulazioni

- A capo automatico

- Larghezza margine destro

Il plugin Modeline supporta un sottoinsieme delle opzioni usate da altri editor di testi come Emacs, Kate e Vim.

#### Modeline Emacs

Le prime due righe di un documento vengono analizzate per le modeline di Emacs.

Le opzioni di Emacs per la larghezza delle tabulazioni, la modalità di rientro attraverso il tasto tabulatore e l'a capo automatico sono supportate. Per maggiori informazioni, consultare GNU Emacs Manual.

#### Modeline Kate

Le prime e le ultime dieci righe di un documento sono analizzate per le modeline di Kate.

Le opzioni di Kate per la larghezza delle tabulazioni, la larghezza del rientro, il rientro tramite la barra spaziatrice, l'a capo automatico e l'a capo a una colonna sono supportate. Per maggiori informazioni, consultare Kate website.

#### Modeline Vim

Le prime e le ultime tre righe di un documento sono analizzate per le modeline di Vim.

Le opzioni di Vim per et, expandtab, ts, tabstop, wrap e textwidth sono supportate. Per maggiori informazioni, consultare il sito web di Vim.

### Plugin «Console python»

Il plugin Console python consente di eseguire comandi con il linguaggio di programmazione Python all'interno di pluma. Abilitando il plugin, viene aggiunta una scheda nel riquadro inferiore. Questa mostra l'ultimo output e un prompt dei comandi.

I comandi digitati all'interno della console python non vengono verificati prima dell'esecuzione. È possibile anche bloccare pluma eseguendo un ciclo infinito.

### Plugin «Snippet»

Il plugin Snippet consente di memorizzare parti di testo molto usate, snippet, e di inserirle velocemente in un documento.

Le snippet sono specifiche del linguaggio del documento attuale. Per esempio, lavorando con un documento HTML, è possibile scegliere alcune snippet utili per l'HTML. Oltre a queste, alcune snippet sono globali e quindi disponibili in tutti i documenti.

Alcune snippet sono installate con pluma ed è possibile modificarle.

#### Inserire snippet

Per inserire una snippet in un documento, digitare il suo tab trigger e premere Tab. Un tab trigger è composto solitamente dalle prime lettere della snippet o qualsiasi altra cosa corta e facile da ricordare.

In alternativa, premere Ctrl Spazio per l'elenco degli snippet da poter inserire.

#### Aggiungere snippet

Per creare una nuova snippet, procedere come segue:

1. Scegliere Strumenti Gestione snippet... per aprire la finestra Gestione snippet.

2. L'elenco delle snippet è raggruppato per linguaggio. Selezionare il linguaggio per cui aggiungere una snippet o una snippet nel gruppo di linguaggi. Per aggiungere una snippet per tutti i linguaggi scegliere «Globale» in alto nell'elenco. Viene mostrata in modo predefinito la sintassi del documento attuale.

3. Fare clic su Nuovo per creare una nuova snippet nell'elenco.

4. Inserire le seguenti informazioni per la nuova snippet:

   Nome

5. Inserire un nome per la snippet nel campo di testo all'interno dell'elenco delle snippet. Il nome serve solo come promemoria per lo scopo della snippet. È possibile modificare il nome della snippet creata facendo clic su di esso.

Testo della snippet

- Inserire il testo della snippet nella casella di testo Modifica snippet. Per i codici speciali da poter usare, consultare pluma-snippets-plugin-syntax.

  È possibile ritornare alla finestra del documento per copiare il testo senza chiudere la finestra Gestore snippet.

Tab trigger

- Inserire il tab trigger per la snippet. Questo è il testo da digitare prima di premere il tasto Tab per inserire la snippet.

  L'etichetta deve essere una sola parola composta di sole lettere o qualsiasi carattere singolo. Il Tab trigger si colora di rosso se viene inserito un tab trigger non valido.

Tasto scorciatoia

- Digitare una scorciatoia per l'inserimento della snippet.

#### Modificare e rimuovere snippet

Per modificare una snippet, selezionarla dall'elenco e apportare le modifiche necessarie.

Per rinominare una snippet, fare nuovamente clic su di essa nell'elenco.

Per ripristinare una snippet integrata, modificata, fare clic su Ripristina.

Per rimuovere una snippet, selezionarla dall'elenco e fare clic su Rimuovi. Non è possibile rimuovere una snippet integrata, solamente quelle create personalmente.

#### Sostituire snippet

Oltre ad aggiungere del testo, una snippet può contenere del testo personalizzabile o segnalare degli spazi in cui è possibile inserire del testo una volta inserita la snippet nel documento.

È possibile utilizzare i seguenti simboli per i segnaposti nel testo della snippet:

Segnaposti di tabulazione

- `$`n`` definisce un segnaposto di tabulazione, in cui `n` è un numero da 1 in su.

  `${`n`:`default`}` definisce un segnaposto di tabulazione con un valore predefinito.

  Un segnaposto di tabulazione indica una posizione nel testo della snippet in cui è possibile aggiungere dell'altro testo una volta inserita la snippet.

  Per usare un segnaposto di tabulazione, inserire la snippet normalmente. Il cursore è posizionato al primo segnaposto. Digitare il testo e premere Tab per avanzare al segnaposto successivo. Il numero nel codice del segnaposto indica l'ordine con cui il tasto tab avanza nel testo.

  Premere Maiusc Tab per tornare al segnaposto precedente. Premendo Tab quando non ci sono altri segnaposti di tabulazione, il cursore viene spostato alla fine del testo della snippet o, se esiste, al segnaposto di terminazione.

Segnaposti rispecchiati

- Un segnaposto di tabulazione ripetuto, rispecchia (ripete) il segnaposto già definito. Questo consente di digitare il testo da far apparire più volte nella snippet una sola volta.

Segnaposto di terminazione

- `$0` definisce il segnaposto di terminazione. Questo consente di terminare il lavoro con la snippet con il cursore in una posizione diversa da quella della terminazione della snippet.

Variabili d'ambiente

- Le variabili d'ambiente come `$PATH` e `$HOME` vengono sostituite all'interno del testo della snippet. Possono essere usate anche le seguenti variabili specifiche di pluma:

  $PLUMA_SELECTED_TEXT

- Il testo attualmente selezionato.

$PLUMA_FILENAME

- Il nome completo del file o una stringa vuota se il documento non è ancora stato salvato.

$PLUMA_BASENAME

- Il nome del file o una stringa vuota se il documento non è ancora stato salvato.

$PLUMA_CURRENT_WORD

- La parola alla posizione del cursore. Quando questa variabile è usata, la parola attuale è sostituita con il testo dello snippet.

Segnaposti della shell

- `$(`cmd`)` è sostituito dal risultato dell'esecuzione di `cmd` nella shell.

  `$(`n`:`cmd`)` consente di impostare un riferimento a questo segnaposto, in cui `n` è un qualsiasi numero da 1 in su. Usare `$`n`` per utilizzare l'output di un segnaposto della shell come input per un altro segnaposto.

Segnaposti di python

- `$<`cmd`>` è sostituito dal risultato della valutazione di `cmd` nell'interprete python.

  `$<`a`:`cmd`>` specifica un altro segnalibro python come una dipendenza, dove `a` indica l'ordine nella snippet. Questo consente di usare funzioni python definite in un'altra snippet. Per specificare molte dipendenze, separare i numeri con delle virgole: `$<`a`,`b`:`cmd`>`

  Per usare una variabile in tutte le altre snippet, dichiararla `global` (globale).

### Plugin «Ordina»

Il plugin Ordina ordina alfabeticamente le righe selezionate in un file.

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 .

Per usare il plugin Ordina, procedere come segue:

1. Selezionare le righe di testo da ordinare.

2. Choose Edit Sort . The Sort dialog opens.

3. Scegliere le opzioni per l'ordinamento:

   - Per disporre il testo in ordine inverso, selezionare Ordine invertito.

   - Per eliminare le righe doppie, selezionare Rimuovere i duplicati.

   - Per ignorare le differenze tra maiuscole e minuscole, selezionare l'opzione Ignorare maiuscole/minuscole.

   - Affinché l'operazione di ordinamento ignori il primo carattere della riga, impostare il numero del primo carattere da ordinare attraverso il controllo di selezione Incomincia dalla colonna.

4. Per iniziare l'ordinamento, fare clic su Ordina.

### Plugin «Correttore ortografico»

Il plugin Correttore ortografico controlla l'ortografia nel testo selezionato. È possibile configurare pluma per il controllo automatico, o manuale, nella lingua specificata. L'impostazione della lingua e le proprietà del controllo automatico, si applicano al singolo documento. Per usare il plugin «Correttore ortografico» procedere come segue:

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.

   Le parole sconosciute sono mostrare in un colore diverso e sottolineate. Fare clic col tasto destro del mouse su una parola sconosciuta, quindi selezionare Suggerimenti ortografici dal menù a comparsa:

   - Per sostituire una parola sconosciuta con un'altra presente nell'elenco, selezionare la parola dal menù a comparsa Suggerimenti ortografici.

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

   Se non ci sono errori, una finestra di dialogo Informazioni visualizza un messaggio indicante l'assenza di errori. Fare clic su OK per chiudere la finestra di dialogo Informazioni.

   In caso di errori ortografici, viene mostrata la finestra di dialogo Controllo ortografico:

   - La Parola errata è mostrata nella parte alta della finestra di dialogo.

   - Una parola conosciuta è mostrata nella casella di testo Sostituisci con. È possibile sostituire questa parola con un'altra selezionandola dall'elenco Suggerimenti oppure è possibile digitare del testo direttamente nella casella di testo Sostituisci con.

   - Per controllare l'ortografia del testo nella casella di testo Sostituisci con, fare clic su Controlla parola. Se è una parola conosciuta, l'elenco Suggerimenti è sostituito con la scritta `(ortografia corretta)`. Se la parola non è conosciuta, vengono visualizzate delle nuove voci sotto Suggerimenti.

   - Per ignorare l'occorrenza attuale della parola sconosciuta, fare clic su Ignora. Per ignorare tutte le occorrenze, fare clic su Ignora tutto. La parola sconosciuta viene ignorata nella sessione attuale di pluma.

   - Per cambiare l'occorrenza della parola sconosciuta con il testo presente nella casella di testo Sostituisci con, fare clic su Modifica. Per cambiare tutte le occorrenze della parola sconosciuta, fare clic su Modifica tutto.

   - Per aggiungere la parola sconosciuta al proprio dizionario, fare clic su Aggiungi parola.

   - Per chiudere la finestra di dialogo Controllo ortografico, fare clic su Chiudi.

### Plugin «Elenco tag»

Il plugin Elenco tag consente di inserire, da un elenco nel riquadro laterale, dei tag comuni.

Per usare il plugin «Elenco tag», procedere come segue:

1. Choose View Side Pane .

2. In modo predefinito, il riquadro laterale mostra una scheda contenente un elenco di documenti aperti. Per visualizzare la scheda dell'elenco dei tag, fare clic sulla scheda indicante il segno più («+») in basso nel riquadro laterale.

3. Selezionare la categoria di tag appropriata dall'elenco a discesa; per esempio `HTML - Tag`.

4. Se necessario, scorrere l'elenco per cercare il tag richiesto.

5. Per inserire un tag nella posizione del cursore nel file corrente, fare doppio clic sul tag nell'elenco. È anche possibile procedere come segue:

   - Per inserire un tag nel file corrente e spostare il focus dal riquadro laterale all'area di visualizzazione, premere Invio.

   - Per inserire un tag nel file corrente e mantenere il punto attivo nella finestra Plugin Elenco tag, premere Maiusc Invio.