# Manuale di Pluma

2015-2021 MATE Documentation Project
2007 GNOME Documentation Project
2002 2003 2004 Sun Microsystems
2000 Eric Baudais
Progetto Documentazione di MATE Progetto Documentazione di GNOME

Questo documento può essere copiato, distribuito e/o modificato in conformità con i termini della GNU Free Documentation License (GFDL) Versione 1.1 o una qualsiasi versione successiva pubblicata dalla Free Software Foundation senza sezioni invariabili, frontespizi e testi di copertina. Una copia della GFDL è disponibile a questo collegamento o nel file COPYING-DOCS distribuito con questo manuale.

Questo manuale fa parte di una raccolta di manuali MATE distribuita in conformità con la GFDL. Per poter distribuire questo manuale separatamente, è necessario inserirvi una copia della licenza, come descritto nella sezione 6 della licenza.

Molti dei nomi usati dalle aziende per distinguere i propri prodotti e servizi sono rivendicati come marchi registrati. Quando questi nomi compaiono nella documentazione di MATE, e i partecipanti al MATE Documentation Project sono consapevoli del loro utilizzo, essi vengono scritti in lettere maiuscole o con l'iniziale maiuscola.

IL DOCUMENTO E LE VERSIONI MODIFICATE DEL DOCUMENTO VENGONO RILASCIATE SECONDO I TERMINI DELLA GNU FREE DOCUMENTATION LICENSE TENENDO PRESENTE CHE:

1. IL DOCUMENTO VIENE FORNITO SULLA BASE DEL "COME È", SENZA GARANZIE DI ALCUN TIPO, ESPLICITE O IMPLICITE, INCLUSE, MA SENZA LIMITAZIONE, LE GARANZIE ATTESTANTI CHE IL DOCUMENTO O LE SUE VERSIONI MODIFICATE SIANO PRIVI DI DIFETTI, COMMERCIALIZZABILI, IDONEI A UN DETERMINATO SCOPO O CHE NON VIOLINO DIRITTI DI TERZI. SI DECLINA QUALUNQUE RESPONSABILITÀ RIGUARDO AI RISCHI INERENTI LA QUALITÀ, L'ACCURATEZZA E LE PRESTAZIONI DEL DOCUMENTO O DI UNA SUA VERSIONE MODIFICATA. QUALORA UN DOCUMENTO O UNA SUA VERSIONE MODIFICATA DOVESSERO PRESENTARE QUALUNQUE TIPO DI DIFETTO, IL COSTO DI EVENTUALI INTERVENTI DI ASSISTENZA, RIPARAZIONE O CORREZIONE SARÀ A CARICO DELL'UTENTE (NON DEL REDATTORE INIZIALE, DELL'AUTORE O DI ALTRI COLLABORATORI). QUESTA LIMITAZIONE DELLA GARANZIA COSTITUISCE PARTE ESSENZIALE DELLA LICENZA. L'USO DEL DOCUMENTO O DELLE SUE VERSIONI MODIFICATE È CONSENTITO SOLO ENTRO I TERMINI DI QUESTA LIMITAZIONE DELLA GARANZIA; E

2. IN NESSUNA CIRCOSTANZA E PER NESSUNA RAGIONE LEGALE, INCLUSI I PRINCIPI DI COLPA (INCLUSA LA NEGLIGENZA), ACCORDO CONTRATTUALE O ALTRO, SARÀ POSSIBILE CONSIDERARE L'AUTORE, IL REDATTORE INIZIALE, GLI ALTRI COLLABORATORI, QUALUNQUE DISTRIBUTORE DEL DOCUMENTO O DI UNA SUA VERSIONE MODIFICATA O QUALUNQUE FORNITORE DELLE PERSONE CITATE, RESPONSABILE NEI CONFRONTI DI QUALUNQUE PERSONA PER DANNI DIRETTI, INDIRETTI, SPECIALI, INCIDENTALI O CONSEGUENTI DI QUALUNQUE NATURA, INCLUSI, MA SENZA LIMITAZIONE, I DANNI PER PERDITA DI AVVIAMENTO, INTERRUZIONE DEL LAVORO, GUASTO O MALFUNZIONAMENTO DEL COMPUTER O QUALUNQUE ALTRO DANNO O PERDITA DERIVANTE O CORRELATA ALL'USO DEL DOCUMENTO O DI UNA SUA VERSIONE MODIFICATA, ANCHE QUALORA LE PERSONE CITATE FOSSERO STATE INFORMATE DELLA POSSIBILITÀ DI TALI DANNI.

Commenti

Per segnalare un bug o dare un suggerimento sull'applicazione pluma o su questo manuale, seguire le indicazioni alla Pagina Feedback di MATE.

Progetto Documentazione di MATE
Desktop MATE
Joachim Noreiko
Progetto Documentazione di GNOME
GNOME
Hal Canary Ha aggiunto la Tabella per le Scorciatoie da Tastiera
Team Documentazione Sun Java Desktop System
Sun Microsystems
gdocteam@sun.com
Eric Baudais
Progetto Documentazione di GNOME
baudais@okstate.edu
Baris Cicek Ha fornito informazioni sulle versioni precedenti di Pluma.
George Ajit Ha fornito informazioni sui plugin.
1.0
2000

Eric Baudais baudais@okstate.edu

Progetto Documentazione di GNOME

2.0
Marzo 2002

Team Documentazione GNOME Sun

Progetto Documentazione di GNOME

2.1
Giugno 2002

Team Documentazione GNOME Sun

Progetto Documentazione di GNOME

2.2
Agosto 2002

Team Documentazione GNOME Sun

Progetto Documentazione di GNOME

2.3
Settembre 2002

Team Documentazione GNOME Sun

Progetto Documentazione di GNOME

2.4
Gennaio 2003

Team Documentazione GNOME Sun

Progetto Documentazione di GNOME

2.5
Marzo 2003

Team Documentazione GNOME Sun

Progetto Documentazione di GNOME

2.6
Settembre 2003

Team Documentazione GNOME Sun

Progetto Documentazione di GNOME

2.7
Marzo 2004

Team Documentazione GNOME Sun

Progetto Documentazione di GNOME

2.8
Luglio 2015

Team Documentazione Sun Java Desktop System

Progetto Documentazione di GNOME

2.9
Luglio 2006

Team Documentazione di GNOME

Progetto Documentazione di GNOME

3.0
Luglio 2015

Team Documentazione di MATE

Progetto Documentazione di MATE

Questo manuale si riferisce alla versione 1.10 di Pluma

## Introduzione

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

Lo scopo di pluma è quello di essere un editor di testi semplice e facile da usare. Le funzioni più avanzate possono essere abilitate con differenti plugin, che permettono una varietà di compiti relativi alla modifica del testo.

## Per iniziare

### Avviare pluma

È possibile avviare pluma nei seguenti modi.

menù Applicazioni

  Selezionare Accessori Pluma .

Riga di comando

  Eseguire il comando: `pluma`

Per impostazione predefinita, quando si apre un documento di testo dal gestore dei file viene avviato pluma che mostra il documento scelto.

### La finestra di pluma

Quando si avvia pluma, viene mostrata la seguente finestra:

### Finestra di pluma

Mostra la finestra principale di pluma.

La finestra di pluma contiene i seguenti elementi:

Barra dei menù

  I menù nella barra dei menù contengono tutti i comandi di cui c'è bisogno per lavorare sui file in pluma.

Barra degli strumenti

  La barra degli strumenti contiene un sottoinsieme di comandi accessibili dalla 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 mostra le informazioni sull'attività corrente di pluma e le informazioni contestuali sugli oggetti dei menù. La barra di stato mostra inoltre la seguente informazione:

  - Posizione del cursore: numero di linea e numero di colonna in cui si trova il cursore.

  - Modalità di modifica: se l'editor è nella modalità inserimento, la barra di stato contiene il testo INS. Se l'editor si trova in modalità sovrascrittura, la barra di stato contiene il testo OVR. Premete il tasto Insert sulla tastiera per cambiare modalità.

Pannello laterale

  Il pannello laterale mostra una lista dei documenti aperti e altre informazioni a seconda di quali plugin sono attivi.

  Per default il pannello laterale non viene mostrato. Per visualizzarlo, selezionare Visualizza Pannello laterale.

Pannello inferiore

  Il pannello inferiore è utilizzato dagli strumenti di programmazione come ad esempio il plugin Console Python per mostrare il loro output.

  Per Default il pannello inferiore non viene mostrato. Per visualizzarlo selezionare Visualizza Pannello inferiore.

Quando si fa clic con il tasto destro del mouse nella finestra di pluma, l'applicazione mostra un menu a comparsa che contiene i comandi più comuni per la modifica del testo.

Come per altre applicazioni MATE, le azioni in pluma possono essere eseguite in più modi: mediante il menù, dalla barra degli strumenti o via tasti scorciatoia. Le scorciatoie comuni a tutte le applicazioni sono elencate nella Guida Utente.

### Lanciare pluma dalla riga di comando

È possibile avviare pluma dalla riga di comando e aprire uno o più file contemporaneamente. Per aprire più file dalla riga di comando, inserire il seguente comando e premere Invio:

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

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

Fare riferimento alla pagina man pluma 1 per avere ulteriori informazioni su come avviare pluma da una riga di comando.

## Lavorare con i file

### Creare un nuovo documento

Per creare un nuovo documento, selezionare File Nuovo. L'applicazione mostrerà un documento vuoto nella finestra principale del programma.

### Aprire un file.

Per aprire un file, selezionare File Apri per mostrare la finestra di dialogo Apri File. Selezionare il file che si vuole aprire e fare clic su Apri. Il file selezionato viene mostrato nella finestra principale di pluma.

L'applicazione registra i percorsi ed i nomi dei 5 file modificati più recentemente e li mostra come oggetti nel menù File. È anche possibile fare clic sull'icona

Icona del menu Mostra file recenti
nella barra degli strumenti per visualizzare la lista dei file recenti.

Si possono aprire più documenti in pluma. L'applicazione creerà una scheda per ciascun file aperto. Per maggiori informazioni vedere .

È possibile scrivere il percorso del file nella finestra di dialogo Apri File. Per alternare tra posizione e pulsanti, premere Ctrl |, .,~ o /.

### Salvataggio di un file

È possibile salvare un file nei modi seguenti:

- Per salvare i cambiamenti di un file esistente, selezionare File Salva.

- Per salvare un nuovo file o per salvare un file esistente sotto un altro nome, scegliere File Salva come. Inserire un nome nella finestra di dialogo Salva come e fare clic su Salva.

- Per salvare tutti i documenti aperti in pluma, selezionare Documenti Salva tutto .

Per chiudere tutti i documenti aperti in pluma, selezionate Documenti Chiudi tutto.

### Lavorare con le schede

Quando è aperto più di un file, pluma mostra una scheda per ogni documento sopra l'area di visualizzazione. Per cambiare il file visualizzato, fare clic sulla sua scheda.

Per muovere un documento su un'altra finestra di pluma, trascinare la scheda corrispondente al file sulla finestra in cui si vuole spostarlo.

Per spostare un documento su una nuova finestra di pluma, si può trascinare la sua scheda sul desktop, o selezionare Documenti Sposta in una nuova finestra.

## Lavorare con il testo

### Modificare il testo

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

- Scrivere il nuovo testo dalla tastiera. Il cursore di inserimento lampeggiante segna il punto in cui comparirà il nuovo messaggio. Per modificarlo, utilizzare i tasti freccia sulla tastiera o fare clic con il mouse.

- Per copiare il testo selezionato negli appunti, selezionare Modifica Copia.

- Per cancellare da un file il testo evidenziato e copiarlo negli appunti, selezionare Modifica Taglia.

- Per cancellare permanentemente il testo selezionato da un file, selezionare Modifica Cancella.

- Per inserire il contenuto degli appunti alla posizione del cursore, selezionare Modifica Incolla . Occorre tagliare o copiare del testo da un file pluma o da un'altra applicazione prima di poterlo incollare in un file.

- Per selezionare tutto il testo di un file, selezionare Modifica Seleziona tutto .

### Annullare o ripetere una modifica

Per annullare un cambiamento fatto al file, selezionare Modifica Annulla. Per ripetere la modifica appena annullata, selezionare Modifica Ripeti.

## Cercare e sostituire

In pluma, ci sono due modi per cercare del testo in un file. Si può utilizzare la finestra di dialogo Trova per cercare uno specifico frammento di testo, oppure utilizzare Ricerca incrementale per evidenziare il testo corrispondente mentre lo si digita.

### Cercare del testo

Per cercare una stringa di testo in un file, procedere come segue:

1. Selezionare Cerca Trova per mostrare la finestra di dialogo Trova.

2. Scrivere il testo che si desidera trovare nel campo di testo Cerca. È possibile includere caratteri speciali come ad esempio new line o tab: vedere

3. Fare clic su Trova per cercare nel file la prima occorrenza della stringa oltre la posizione corrente del cursore. Se pluma trova la stringa, l'applicazione seleziona la prima occorrenza di essa. Le altre occorrenze verranno evidenziate.

4. Per trovare la successiva occorrenza della stringa, fare clic su Trova o selezionare Cerca Trova successivo. Per trovare l'occorrenza precedente del testo, selezionare Cerca Trova precedente.

Dopo aver chiuso la finestra di dialogo Trova, è ancora possibile spostare la selezione su altre occorrenze del testo selezionando Cerca Trova Successivo e Cerca Trova Precedente

Per rimuovere l'evidenziazione dal testo, selezionare Cerca Cancella evidenziazione.

Fare riferimento a pcrepattern 3 per maggiori informazioni sulla sintassi e la semantica delle espressioni regolari supportate dalla finestra di dialogo Trova.

### Ricerca Incrementale

La ricerca incrementale evidenzia nel documento il testo corrispondente mentre lo si digita lettera per lettera. (Il funzionamento è simile alla ricerca offerta in diversi browser web).

Per avviare una ricerca incrementale, selezionare Cerca Ricerca incrementale. La casella di ricerca appare in cima all'area di visualizzazione.

Iniziate a digitare, e il testo corrispondente sarà evidenziato. Verrà selezionata anche la prima istanza dopo la posizione del cursore.

Per avanzare la selezione alla successiva occorrenza mantenendo aperta la casella di ricerca incrementale, premere Ctrl G. Premere Ctrl Shift G per tornare indietro alla corrispondenza precedente.

È anche possibile utilizzare i tasti freccia sulla tastiera o la rotellina del mouse per muovere la selezione tra le corrispondenze.

### Sostituire il testo

Per cercare del testo in un file e sostituirlo con uno alternativo, procedere come segue:

1. Selezionare Cerca Sostituisci per mostrare la finestra di dialogo Sostituisci.

2. Scrivere il testo che si vuole trovare nel campo di testo Cerca. È possibile includere caratteri speciali come ad esempio new line o tab: vedere .

3. Digitare il testo nella campo Sostituisci con, per sostituire la stringa trovata con il testo specificato.

Per ispezionare ogni occorrenza della stringa prima di sostituirla, fare clic su Trova. Se pluma trova la stringa, l'applicazione la seleziona. Fare clic su Sostituisci per sostituire l'occorrenza della stringa selezionata. Per trovare l'occorrenza successiva, cliccare su Trovaancora una volta.

Per sostituire tutte le occorrenze, fare clic su Sostituisci tutti.

### Opzioni di trova e sostituisci

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

- Selezionare l'opzione Maiuscole/Minuscole per trovare solamente quelle occorrenze della stringa che corrispondono esattamente al testo digitato. Per esempio se è attiva l'opzione Maiuscole/Minuscole, "TESTO" non corrisponderà all'inserimento di "testo".

- Selezionare l'opzione Solo parole intere per trovare solo le occorrenze della stringa che corrispondono alle parole intere del testo inserito. Per esempio, se è attiva l'opzione Solo parole intere, "text" non corrisponderà a "texture".

- Selezionare l'opzione Cercare all'indietro per ricercare all'indietro verso l'inizio del documento.

- Selezionare l'opzione Ricominciare dall'inizio per cercare fino ad una estremità del documento e continuare la ricerca dall'altra estremità del file.

### Caratteri speciali

Per rappresentare i caratteri speciali, potete includere le seguenti sequenze nei testi da cercare o sostituire.

`\n`

  Specifica una nuova linea.

`\t`

  Specifica un carattere di tabulazione.

`\r`

  Specifica un ritorno di carrello.

`\\`

  Per cercare un carattere di backslash "\", questo deve essere trattato in modo speciale. Per esempio, se state cercando il letterale "`\n`", dovrete inserire il testo "\\n" nel campo Cerca. Se si cerca una sequenza di backslash, occorre raddoppiare il numero di caratteri "\" da cercare.

### Posizionare il cursore su una riga specifica

Per posizionare il cursore all'inizio di una specifica riga nel file corrente, selezionare Cerca Vai alla riga. Comparirà un riquadro in cima all'area di visualizzazione in cui inserire il numero di linea desiderato.

Iniziando a scrivere il numero di linea su cui spostare il cursore, il documento mostrerà la linea specificata.

Per chiudere il riquadro e muovere il cursore in quella riga specifica, premere Invio.

## Stampa

### Impostare le opzioni della pagina

Per impostare le opzioni della pagina, selezionare File Imposta Pagina per mostrare la finestra di dialogo Imposta pagina.

La finestra Imposta pagina permette di specificare le seguenti opzioni di stampa:

#### Sezione scheda generale

Stampa l'evidenziazione della sintassi

  Selezionare questa opzione per stampare l'evidenziazione della sintassi. Per maggiori informazioni sull'evidenziazione della sintassi, vedere .

Stampa intestazioni di pagina

  Selezionare questa opzione per stampare una intestazione su ogni pagina stampata. Non è possibile configurare l'intestazione.

Numeri di Riga

  Selezionare l'opzione Stampa numeri di riga per includere i numeri di riga nella stampa del file.

  Utilizzare il riquadro Numera ogni ... righe per indicare la frequenza di stampa dei numeri di riga, ad esempio ogni 5 linee, ogni 10 linee etc.

A capo automatico

  Selezionare l'opzioneAbilita a capo automatico per mandare la riga alla linea di testo successiva a livello di caratteri, quando si stampa un file. L'applicazione conterà queste linee come una soltanto dal punto di vista del computo delle righe.

  Selezionare l'opzione Non dividere le parole su due righe per usare l'a capo automatico, a livello delle parole, quando si stampa un file.

#### Font

Corpo

  Fare clic su questo pulsante per selezionare il formato del carattere impiegato per stampare il corpo del testo di un file.

Numeri di Linea

  Fare clic su questo pulsante per selezionare il formato del carattere impiegato per stampare i numeri di riga.

Intestazione e piè di pagina

  Fare clic su questo pulsante per selezionare il formato del carattere da impiegare per stampare le intestazioni e i piè di pagina in un file.

Per resettare al font predefinito per la stampa di un file in pluma, fare clic su Ripristina i font predefiniti

### Stampare un documento

È possibile usare pluma per compiere le seguenti operazioni di stampa:

- Stampare il documento su una stampante.

- Stampare il risultato del comando stampa su un file.

Se si stampa su un file, pluma invia l'output del file ad un file di formato pre-stampa. I più comuni formati di pre-stampa sono PostScript and Portable Document Format (PDF).

Per visualizzare l'anteprima delle pagine che si vuole stampare, selezionare File Anteprima di stampa.

Per stampare il file corrente su una stampante o su un file, selezionare File Stampa per mostrare la finestra di dialogo Stampa.

La finestra di dialogo Stampa permette di specificare le seguenti opzioni di stampa:

#### Sezione scheda lavoro

Intervallo di stampa

  Selezionare una delle seguenti opzioni per impostare quante pagine stampare:

  - Tutto

    Selezionare questa opzione per stampare tutte le pagine del documento

  - Righe

    Selezionare questa opzione per specificare di stampare solo le righe indicate. Usare i riquadri Dalla e Allaper specificare l'intervallo desiderato.

  - Selezione

    Selezionare questa opzione per stampare solo il testo evidenziato. Questa opzione è disponibile solo se si seleziona del testo.

Copie

  Utilizzare il riquadro Numero di copie per indicare il numero di copie del file che si vuole stampare.

  Se si stampano più copie, selezionare l'opzione raggruppa per raggruppare le copie stampate.

#### Sezione scheda stampante

Stampante

  Utilizzare il menu a tendina per selezionare la stampante su cui effettuare la stampa.

Impostazioni

  Utilizzare questo elenco a tendina per selezionare le impostazioni di stampa.

  Per configurare la stampante, fare clic su Configura. Ad esempio è possibile abilitare o meno la stampa fronte-retro o posticipare la stampa, se le funzionalità sono supportate dalla stampante.

Posizione

  Utilizzare l'elenco a tendina per selezionare una delle destinazioni di stampa:

  CUPS

    Stampa il file su una stampante CUPS.

    Se la stampante selezionata utilizza CUPS, CUPS sarà l'unica voce di questa lista.

  lpr

    Stampa il file su una stampante.

  File

    Stampa il file in un file PostScript.

    Fare clic suSalva come... per mostrare una finestra di dialogo in cui specificare il nome e la posizione del file PostScript.

  Personalizzato

    Utilizzare il comando specificato per stampare il file.

    Digitare il nome del comando nella casella di testo. Includere tutti gli argomenti della linea di comando necessari.

Stato

  Questa funzionalità non è supportata in questa versione di pluma.

Tipo

  Questa funzionalità non è supportata in questa versione di pluma.

Commento

  Questa funzionalità non è supportata in questa versione di pluma.

#### Sezione scheda carta

Dimensione della carta

  Utilizzare questo elenco per selezionare la dimensione della carta su cui verrà stampato il documento.

Larghezza

  Utilizzare questa casella per definire la larghezza della carta. Impiegare l'elenco a tendina per cambiare l'unità di misura.

Altezza

  Utilizzare la casella per specificare l'altezza della carta.

Orientamento

  Utilizzare questo elenco per selezionare l'orientamento della carta sui cui stampare.

Orientamento delle pagine

  Utilizzare questo elenco per selezionare l'orientamento delle pagine.

Orientamento

  Utilizzare questo elenco per scegliere l'orientamento della pagina. Viene mostrata un'anteprima dell'orientamento selezionato nell'area Anteprima .

Vassoio della carta

  Utilizzare questo elenco per selezionare il vassoio sorgente della carta.

## Funzionalità rivolte alla programmazione

Molte delle caratteristiche di pluma specifiche per la programmazione sono offerte mediante plugin. Ad esempio il plugin elenco dei tag fornisce un elenco dei tag per i diversi linguaggi di markup: vedere .

### Evidenziazione della sintassi

L'evidenziazione della sintassi rende il codice sorgente più leggibile mostrando le diverse parti del testo in colori differenti.

pluma seleziona il modo di evidenziazione della sintassi appropriato basandosi sul tipo di documento. Per impostare manualmente il modo di evidenziazione, selezionare Visualizza Modalità di evidenziazione e poi scegliere uno dei seguenti oggetti:

Testo semplice

  Non mostra alcuna evidenziazione della sintassi.

Sorgenti

  Mostra l'evidenziazione della sintassi per modificare il codice sorgente. Utilizzare il sotto-menu Sorgenti per selezionare il tipo di codice sorgente.

Markup

  Mostra l'evidenziazione della sintassi per modificare codice di markup. Utilizzare il sotto-menu Markup per selezionare il tipo di codice di markup.

Script

  Mostra l'evidenziazione della sintassi per modificare codice di script. Utilizzare il sotto-menu Script per selezionare il tipo di codice di script.

Altro

  Mostra l'evidenziazione della sintassi per modificare altri tipi di codice. Utilizzare il sotto-menu Altro per selezionare il tipo di codice.

### Reindirizzamento dell'output di un comando in un file

È possibile utilizzare pluma per reindirizzare il risultato di un comando verso un file di testo. Per esempio, per reindirizzare l'output di un comando `ls` in un file di testo scrivere `ls | pluma`, e premere Invio

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

In alternativa, si può usare il plugin Strumenti esterni per reindirizzare il risultato di un comando sul file corrente.

## Tasti Scorciatoia

Utilizzare i tasti scorciatoia per effettuare azioni comuni più velocemente che con il mouse e i menu. Le tabelle seguenti elencano tutti i tasti scorciatoia di pluma.

Per maggiori informazioni sui tasti scorciatoie, vedere la Guida dell'utente.

#### Schede

Scorciatoie per le Schede:

Tasti scorciatoia | Comando
--- | ---
Ctrl + Alt + PagSu | Sposta la visualizzazione sulla scheda di sinistra.
Ctrl + Alt + PagGiù | Sposta la visualizzazione sulla scheda di destra.
Ctrl + W | Chiude la scheda.
Ctrl + Shift + L | Salva tutte le schede.
Ctrl + Shift + W | Chiude tutte le schede.
Alt + n | Salta alla scheda n-sima.

#### File

Scorciatoie per lavorare con i file:

Tasti scorciatoia | Comando
--- | ---
Ctrl + N | Crea un nuovo documento.
Ctrl + O | Apre un documento.
Ctrl + S | Salva il documento corrente su disco.
Ctrl + Shift + S | Salva il file corrente con un nome diverso.
Ctrl + P | Stampa il file corrente.
Ctrl + Shift + P | Anteprima di stampa.
Ctrl + W | Chiude il documento corrente.
Ctrl + Q | Esce da pluma.

#### Modifica

Scorciatoie per modificare documenti:

Tasti scorciatoia | Comando
--- | ---
Ctrl + Z | Annulla l'ultima azione.
Ctrl + Shift + Z | Ripete l'ultima azione annullata.
Ctrl + X | Taglia il testo o la regione selezionata e li pone 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 | Cancella la riga corrente.
Ctrl + U | Modifica il testo in maiuscolo.
Ctrl + L | Modifica il testo in minuscolo
Alt + U | Alterna maiuscolo/minuscolo per ogni carattere.
Alt + L | Rendi maiscola l'iniziale di ciascuna parola.
Alt + Freccia in Alto | Sposta la riga corrente in alto di una linea.
Alt + Freccia in Basso | Sposta la riga corrente in basso di una linea.
Tab | Incrementa l'indentazione delle righe selezionate.
Shift + Tab | Riduce l'indentazione delle righe selezionate.

#### Visualizza

Scorciatoie alla visualizzazione corrente:

Tasti scorciatoia | Comando
--- | ---
Ctrl + Y | Mostra/nasconde i numeri di linea.

#### Riquadri

Scorciatoie per mostrare e nascondere i pannelli:

Tasti scorciatoia | Comando
--- | ---
F9 | Mostra/Nasconde il pannello laterale.
Ctrl + F9 | Mostra/Nasconde il pannello inferiore.

#### Ricerca

Scorciatoie per la ricerca:

Tasti scorciatoia | Comando
--- | ---
Ctrl + F | Trova una stringa.
Ctrl + G | Trova l'occorrenza successiva di una stringa.
Ctrl + Shift + G | Trova l'occorrenza precedente di una stringa.
Ctrl + K | Ricerca Interattiva.
Ctrl + H | Cerca e Sostituisci.
Ctrl + Shift + K | Cancella parole evidenziate.
Ctrl + I | Vai alla riga.

#### Strumenti

Scorciatoie degli strumenti:

Tasti scorciatoia | Comando
--- | ---
Shift + F7 | Controlla l'ortografia (richiede plugin)
Alt + F12 | Rimuove spazi a fine riga (richiede plugin).
Ctrl + T | Aumenta indentazione (richiede plugin).
Ctrl + Shift + T | Rimuovi indentazione (richiede plugin).
F8 | Esegue "make" nella directory corrente (richiede plugin).
Ctrl + Shift + D | Elenco di una cartella (richiede plugin).

#### Aiuto

Scorciatoie per aiuto:

Tasti scorciatoia | Comando
--- | ---
F1 | Apre il manuale utente di pluma.

## Preferenze

Per configurare pluma, selezionare Modifica Preferenze. La finestra di dialogo Preferenze contiene le seguenti categorie:

### Preferenze di visualizzazione

A capo automatico

  Selezionare l'opzione Attivare a capo automatico per mandare il flusso di testo di lunghe linee di testo a capo su una riga successiva invece che farlo fuoriuscire dal bordo della finestra. Questo evita di dover scorrere il testo in orizzontale.

  Selezionare l'opzione Non dividere le parole su due righe per fare in modo che l'a capo automatico mantenga le parole intere quando il testo scorre su una linea successiva. Questo rende il testo più semplice da leggere.

Numeri di Riga

  Selezionare l'opzione Mostrare i numeri di riga per mostrare i numeri di riga alla sinistra della finestra di pluma.

Riga corrente

  Selezionare l'opzioneEvidenzia riga correnteper evidenziare la riga su cui si trova il cursore.

Margine destro

  Selezionare l'opzione Mostrare il margine destro per mostrare una linea verticale che delimita il margine destro del foglio.

  Utilizzare la casella Margine destro alla colonna per specificare la posizione della linea verticale.

Parentesi corrispondente

  Selezionare l'opzione Evidenzia la parentesi corrispondente per mettere in evidenza la parentesi corrispondente quando il cursore è posizionato su un carattere di parentesi.

### Preferenze dell'editor

Schede

  Utilizzare la casella Larghezza di tabulazione per specificare l'ampiezza dello spazio che pluma inserisce quando si preme il tastoTab.

  Selezionare l'opzione Insere spazi invece di tabulazioni per specificare che pluma inserisca degli spazi invece che tabulazioni quando si preme il tasto Tab.

Rientro automatico

  Selezionare l'opzione Attivare rientro automatico per specificare che la successiva riga di testo inizi allo stesso livello di indentazione della riga corrente.

Salvataggio dei file

  Selezionare l'opzione Creare una copia di backup dei file prima di salvareper creare una copia di backup di un file ogni volta che si salva. La copia di backup del file contiene un carattere tilde '~' alla fine del nome.

  Selezionare l'opzione Salvataggio automatico del file corrente ogni ... minutiper salvare automaticamente il file a intervalli di tempo regolari. Utilizzare la casella per indicare quanto spesso si desidera salvare il file.

### Preferenze di caratteri e colori

Font

  Selezionare l'opzione Utilizzare il carattere del tema predefinito per utilizzare il carattere predefinito di sistema per il testo nella finestra principale di pluma.

  Il campo font dell'editor mostra il font che pluma utilizza per gestire il testo. Fare clic sul pulsante per specificare il font, lo stile e la dimensione del carattere da utilizzare per il testo.

Schema di colore

  È possibile scegliere uno schema di colore dalla lista Schema di colore. Sono preinstallati i seguenti schemi di colore:

  Classico

    Schema colore classico basato su gvim.

  Cobalto

    Schema di colore Blu.

  Kate

    Schema di colore utilizzato nell'editor Kate.

  Oblivion

    Schema di colore scuro che utilizza i colori del tema Tango.

  Tango

    Schema che utilizza i colori del tema Tango.

  È possibile aggiungere nuovi schemi colore facendo clic su Aggiungi ... e selezionando un file di schema di colore.

  È possibile rimuovere lo schema di colore selezionato facendo clic sul pulsante Rimuovi.

### Preferenze dei plugin

I plugin forniscono funzionalità aggiuntive a pluma. Per maggiori informazioni sui plugin e su come utilizzare quelli predefiniti, vedere .

#### Attivare un Plugin

Per attivare un plugin in pluma, seguire questi passaggi:

1. Selezionare Modifica Preferenze.

2. Selezionare la scheda Plugin.

3. Spuntare la casella accanto al nome del plugin che si vuole attivare.

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

#### Disabilitare un Plugin

Un plugin rimane attivo anche quando si chiude pluma.

Per disabilitare un plugin pluma, seguire questi passaggi:

1. Selezionare Modifica Preferenze.

2. Selezionare la scheda Plugin.

3. Deselezionare la casella accanto al nome del plugin che si vuole disabilitare.

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

## Plugin

### Lavorare con i plugin

È possibile aggiungere funzionalità aggiuntive a pluma abilitando i plugin. Un plugin è un programma supplementare che migliora la funzionalità di un'applicazione. I plugin aggiungono nuovi oggetti al menu di pluma in base alle funzionalità che essi forniscono.

Diversi plugin sono preinstallati in pluma.

Per abilitare e disabilitare i plugin o per vedere quali plugin sono attualmente attivi, utilizzare .

I seguenti plugin vengono forniti preinstallati con pluma:

- mostra il numero di linee, parole e caratteri nel documento.

- permette di eseguire comandi esterni in pluma.

- permette di esplorare i vostri file e cartelle nel pannello laterale.

- Aggiunge o rimuove l'indentazione dalle righe selezionate.

- aggiunge la data e l'ora correnti in un documento.

- Permette di modificare le preferenze per documenti individuali, e supporta le modalità stile Emacs, Kate e Vim.

- permette di eseguire comandi nel linguaggio di programmazione Python.

- consente di eliminare gli spazi di fine riga dal vostro documento dopo averlo salvato.

- permette di memorizzare porzioni di testo usate frequentemente e di inserirle in un documento.

- organizza le righe di testo selezionate in ordine alfabetico.

- corregge la sintassi delle parole nel testo selezionato o segna gli errori nel documento in modo automatico.

- permette di inserire tag HTML o di altri linguaggi di markup da una lista nel pannello laterale.

Per maggiori informazioni su come creare un plugin, vedere .

### Plugin Statistiche sul documento

Il plugin Statistiche sul documento conta il numero di righe, parole, caratteri, caratteri totali, caratteri esclusi gli spazi, e numero di byte del file corrente. Il risultato viene mostrato nella finestra di dialogo Statistiche del Documento. Per utilizzare il plugin Statistiche del Documento procedere come segue:

1. Selezionare Strumenti Statistiche del documento per mostrare la finestra di dialogoStatistiche del documento. La finestra mostra le seguenti informazioni:

   - Numero di righe di testo nel documento corrente.

   - Numero di parole nel documento corrente.

   - Numero di caratteri, inclusi gli spazi, nel documento corrente.

   - Numero di caratteri, esclusi gli spazi, nel documento corrente.

   - Numero di byte del documento corrente.

2. È possibile aggiornare il file in pluma mentre la finestra di dialogo Statistiche del Documento è ancora aperta. Per aggiornarne il contenuto della finestra Statistiche del Documento, fare clic sul pulsante Aggiorna.

### Plugin Strumenti esterni

il plugin Strumenti esterni permette di eseguire comandi esterni dall'interno di pluma. È possibile reindirizzare qualche contenuto in un comando e sfruttarne l'output (ad esempio, sed), o lanciare un comando predefinito (per esempio, make).

Utilizzarei Gestore degli Strumenti Esterni per creare e modificare i comandi. Per eseguire un comando esterno selezionarlo dal menu Strumenti.

#### Comandi predefiniti.

i seguenti comandi sono forniti assieme al plugin Strumenti esterni:

Build

  Esegue make nella directory del documento corrente.

Elenco della cartella

  Elenca il contenuto della directory che contiene il documento corrente creando un nuovo documento

Variabili di ambiente

  Mostra le variabili di ambiente nel pannello inferiore.

Grep

  Cerca un termine in tutti i file della directory del documento corrente utilizzando il "pattern matching". I risultati sono mostrati nel pannello inferiore.

Elimina gli spazi a fine riga

  Elimina tutti gli spazi superflui dalla fine di ogni riga del documento.

#### Definire un comando

Per aggiungere un comando esterno, selezionare Strumenti Strumenti esterni.

Nella finestra del Gestore degli Strumenti esterni, fare clic su Nuovo. È possibile specificare i seguenti dettagli per un nuovo comando:

Descrizione

  La descrizione viene mostrata nella barra di stato quando viene selezionato il comando.

Acceleratore

  Inserire una scorciatoia da tastiera per il comando.

Comandi

  I comandi attuali da eseguire. Diverse variabili di ambiente di pluma possono essere utilizzate per passare del contenuto a questi comandi. Vedere .

Input

  Il contenuto da fornire al comandi (come stdin): l'intero contenuto del documento corrente, la selezione corrente, una linea o parola.

Output

  Cosa fare con l'output dei comandi: mostrarlo nel pannello inferiore o piazzarlo nel documento corrente, alla fine, alla posizione del cursore o sostituire il testo selezionato o l'intero documento.

Applicabilità

  Determina che tipo di documenti possono essere bersaglio del comando, ad esempio i documenti, salvati o non salvati, quelli locali o remoti.

#### Modificare e rimuovere gli strumenti

Per modificare uno strumento, selezionarlo dalla lista e apportare i cambiamenti alle sue proprietà.

Per rinominare uno strumento fare nuovamente clic su di esso nella lista.

Per ripristinare uno strumento predefinito che avete modificato fare clic su Ripristina.

Per rimuovere uno strumento selezionarlo e premere Rimuovi. Non è possibile rimuovere uno strumento predefinito ma solo uno di quelli creati da voi.

#### Variabili

Possono essere usate le seguenti variabili nel campo Comandi 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 Pannello esplorazione dei file

il plugin Pannello esplorazione dei file mostra i vostri file e cartelle nel pannello laterale, consentendo di aprirli più velocemente.

Per mostrare l'esploratore dei file, selezionare Visualizza Pannello laterale e in seguito fare clic sulla scheda che mostra l'icona di Esplorazione dei file situata in fondo al pannello laterale.

#### Sfogliare i vostri file

L'esploratore dei file inizialmente mostra i segnalibri del vostro file manager. Per sfogliare i contenuti di ogni oggetto della lista, fare due volte clic su di esso.

Per selezionare una directory superiore, selezionarla dal menu a tendina o premete la freccia rivolta verso l'alto sulla barra degli strumenti del plugin Esplorazione dei file.

Per mostrare la cartella contenente il file su cui attualmente si sta lavorando, fare clic col pulsante destro sula lista e selezionare la voce Imposta il documento attivo come radice.

#### Aprire un file.

Per aprire un file in pluma, fare doppio clic su di esso nella lista dei file.

#### Creare file e cartelle

Per creare un file di testo vuoto nella directory corrente mostrata nell'esploratore dei file, fare clic col pulsante destro del mouse e selezionare Nouvo File.

Per creare una nuova cartella nella directory corrente mostrata nell'esploratore dei file, fare clic col pulsante destro del mouse e selezionare Nuova cartella.

### plugin Indenta righe

Il plugin Indenta righe aggiunge o rimuove i caratteri di spazio all'inizio delle righe di testo.

Per indentare o rimuovere l'indentazione, procedere come segue:

1. Selezionare le righe che si vogliono indentare. Per indentare o rimuovere l'indentazione di una singola riga di testo, piazzare il cursore in un qualsiasi punto della riga.

2. - Per indentare la riga, selezionare Modifica Indenta.

   - Per rimuovere l'indentazione della riga, selezionare Modifica Rimuovi indentazione.

La quantità di spazi bianchi inseriti e l'utilizzazione del carattere di tabulazione o quello di spazio, dipendono dalle impostazioni di tabulazione nella scheda Editor delle preferenze: vedere .

### Plugin Inserisci data e ora

Il plugin Inserisci data e ora inserisce la data e l'ora corrente in un documento. Per utilizzare il plugin Inserisci data e ora, procedere come segue:

1. Selezionare Modifica Inserisci data e ora.

   Se non è stato configurato il plugin Inserisci data e ora per inserire la data e l'ora automaticamente senza chiedervi il formato da utilizzare, pluma mostra la finestra di dialogo Inserisci data e ora. Selezionare il formato data/orario dalla lista e fare clic su Inserisci per chiudere la finestra di dialogo Inserisci data e ora. pluma inserisce la data e l'ora alla posizione corrente del cursore.

   Se avete configurato pluma per utilizzare un particolare formato di data e ora, la finestra di dialogo Inserisci data e ora non verrà mostrata. La data e l'ora saranno automaticamente inserite alla posizione del cursore nel file corrente.

#### Configurare il plugin Inserisci data e ora

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

1. Selezionare Modifica Preferenze.

2. Selezionare la scheda Plugin.

3. Selezionare il plugin Inserisci data e ora.

4. Fare clic su Preferenze per mostrare la finestra di dialogo Configura plugin Inserisci data e ora.

5. Selezionare una delle opzioni come segue:

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

   - Per utilizzare sempre lo stesso formato di data e ora tra quelli forniti da pluma, selezionare l'opzione Usa il formato selezionatoe quindi scegliere il formato appropriato dall'elenco. Se si sceglie questa opzione, pluma non chiederà il formato di data e ora da utilizzare quando si seleziona Modifica Inserisci data e ora.

   - Per utilizzare ogni volta il formato di data e ora personalizzato, selezionare l'opzione Usa un formato personalizzato, quindi inserire nella casella di testo il formato appropriato. Per maggiori informazioni su come specificare un formato personalizzato, fate riferimento a strftime 3 . Se si sceglie questa opzione, pluma non chiederà il formato di data e ora da utilizzare quando si seleziona Modifica Inserisci data e ora .

6. Fare clic su Chiudi per chiudere la finestra di dialogo Configura plugin Inserisci data e ora.

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

### Plugin Modeline

Il plugin Modeline permette di impostare le preferenze per documenti individuali. Una modeline è una linea di testo all'inizio del documento con impostazioni che pluma riconosce.

Le preferenze impostate utilizzando una modeline hanno la precedenza su quelle specificate nella finestra di dialogo preferenze.

Con una modeline è possibile impostare le seguenti preferenze:

- Larghezza tabulazione

- Ampiezza del rientro

- Inserire spazi al posto di tabulazioni

- A capo automatico

- Ampiezza del margine destro

Il plugin Modeline supporta un sottoinsieme delle opzioni utilizzate dagli editor Emacs, Kate e Vim.

#### Modeline Emacs

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

Sono supportate le opzioniEmacs tab-width, indent-offset, indent-tabs-mode and autowrap. Per ulteriori informazioni, vedere il Manuale GNU Emacs.

#### Modeline Kate

La prima e le ultime dieci righe di un documento sono analizzate per le modeline di Kate.

Sono supportate le opzioni per specificare l'ampiezza di tabulazione, l'ampiezza del rientro, l'indentazione con spazi, l'a-capo automatico e la colonna per l'a-capo automatico. Per ulteriori informazioni vedere il sito web di Kate.

#### Modeline Vim

La prima e le ultime tre righe di un documento sono analizzate per le modeline di Vim.

Sono supportate le opzioni et, expandtab, ts, tabstop, sw e shiftwidth di Vim. Per maggiori informazioni vedere il sito web di Vim.

### Plugin Console Python

Il plugin Console Python permette di eseguire in plumacomandi nel linguaggio di programmazione python. Abilitando questo plugin verrà aggiunta una scheda nel pannello inferiore che mostrerà l'output dei comandi recenti e un prompt dei comandi.

I comandi inseriti nella console python non vengono controllati prima della loro esecuzione. C'è quindi la possibilità di bloccare pluma, inserendo ad esempio un ciclo infinito.

### Plugin Salva senza spazi di fine riga

Il plugin Salva senza spazi di fine riga rimuove i caratteri bianchi come gli spazi (`˽`), le tabulaizoni (`\t`), i ritorni di carrello (`\r`), etc. dalla fine di una riga. Per utilizzare il plugin Salva senza Spazi di fine riga, procedere come segue:

1. Abilitare il plugin come descritto in .

2. Quando il documento è pronto, salvatelo.

3. Vedrete che ogni spazio bianco è stato rimosso dopo che il documento viene salvato.

### Plugin Snippet

Il plugin Snippet permette di memorizzare porzioni di testo frequentemente utilizzate, chiamate snippet, e di inserirle rapidamente in un documento.

Gli snippet sono specifici alla sintassi del linguaggio del documento corrente. Ad esempio, se si lavora con un documento HTML, si può scegliere tra un elenco di snippet utili per l'HTML. In aggiunta, alcuni snippet sono globali e sono resi disponibili in tutti i documenti.

In pluma sono disponibili diversi snippet pre-installati, che possono essere modificati.

#### Inserire uno snippet

Per inserire uno snippet in un documento, digitare il suo tab trigger e premere il tasto Tab. Il tab trigger di uno snippet è il suo nome o le prime lettere di esso, o qualcos'altro che sia breve e facile da ricordare.

In alternativa, premere Ctrl Spazio per vedere la lista degli snippet che possono essere inseriti.

#### Aggiungere Snippet

Per creare un nuovo snippet, procedere come segue:

1. Selezionare Strumenti Preferenze. Si aprirà la finestra di dialogo Gestore degli Snippet.

2. L'elenco degli snippet è raggruppato per linguaggio. Selezionare il linguaggio a cui aggiungere uno snippet, o uno snippet esistente in quel gruppo. Per aggiungere uno snippet per tutti i linguaggi, selezionare Globale in cima alla lista. Viene mostrato per default la sintassi del linguaggio con cui si sta lavorando.

3. Fare clic su Nuovo. Apparirà un nuovo snippet nella lista.

4. Immettere le seguenti informazioni del nuovo snippet:

   Nome

     Inserire il nome da usare per lo snippet nella casella di testo contenuta nella lista degli snippet. Il nome dello snippet serve solo per promemoria del suo scopo. Si può cambiare il nome ad uno snippet che avete creato facendo clic su di esso nella lista.

   Testo dello Snippet

     Immettere il testo dello snippet nella casella di testo Modifica snippet. Per i codici speciali che si possono utilizzare, vedere .

     È possibile tornare alla finestra del documento per copiare il testo dello snippet senza chiudere la finestra Gestore degli Snippet.

   Tab Trigger

     Inserire il tab trigger per lo snippet. Questo sarà il testo che scriverete prima di premere Tab per inserire lo snippet vero e proprio.

     Il tag deve essere costituito da una sola parola contenente solo lettere, o un singolo carattere. Il Tab Trigger sarà evidenziato in rosso qualora si inserisca un tab trigger non valido.

   Tasto Scorciatoia

     Inserire la combinazione di tasti per inserire lo snippet.

#### Modificare e rimuovere gli snippet

Per modificare uno snippet, selezionarlo dalla lista e apportare i cambiamenti al suo testo e alle sue proprietà di attivazione.

Per modificare il nome di uno snippet, fare nuovamente clic su di esso nella lista

Per ripristinare uno snippet predefinito che è stato modificato, premere Ripristina.

Per rimuovere uno snippet, selezionarlo e premere Rimuovi. Non è possibile rimuovere gli snippet pre-definiti, ma solo quelli da voi creati.

#### Sostituzione dello Snippet

Oltre ad inserire un testo memorizzato, uno snippet può includere testo modificabile, oppure evidenziare gli spazi in cui inserire del testo una volta che lo snippet è stato inserito nel documento.

Potete utilizzare i seguenti codici segnaposto nel testo di uno snippet:

Segnaposto di Tabulazione

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

  `${n:default}` definisce un segnaposto di tabulazione con un valore pre-definito.

  Un segnaposto di tabulazione segnala uno spazio nel testo dello snippet in cui è possibile aggiungere del testo addizionale dopo che lo snippet è stato inserito.

  Per utilizzare un segnaposto di tabulazione, inserire lo snippet normalmente. Il cursore viene posto sul primo segnaposto di tabulazione. Inserite il testo e digitate il tasto Tab per avanzare al segnaposto successivo. Il numero nel codice del segnaposto definisce l'ordine in cui Tab avanza su ciascun posto nel testo.

  Premere Shift Tab per tornare al segnaposto precedente. Premere Tab quando non ci sono più segnaposti sposta il cursore alla fine del testo dello snippet, o al segnaposto di conclusione, se questo esiste.

Segnaposto Specchio.

  Un segnaposto di tabulazione ripetuto rispecchierà il segnaposto già definito. Questo consente di inserire del testo una volta soltanto, ma che si vuole far comparire più volte nello snippet.

Segnaposto di Conclusione

  `$0` definisce il segnaposto di conclusione. Questo permette di finire di lavorare con lo snippet portando il cursore in un punto diverso dalla fine dello snippet.

Variabili di ambiente

  Le variabili di ambiente come `$PATH$` e `$HOME$` vengono espanse nel testo dello snippet. Possono inoltre essere utilizzate le seguenti variabili specifiche di pluma:

  $PLUMA_SELECTED_TEXT

    Il testo attualmente selezionato.

  $PLUMA_FILENAME

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

  $PLUMA_BASENAME

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

  $PLUMA_CURRENT_WORD

    La parola alla posizione del cursore. Quando questa variabile è utilizzata, la parola corrente verrà sostituita con il testo dello snippet.

Segnaposto di shell

  `$(cmd)` viene sostituito con il risultato dell'esecuzione di cmd in una console.

  `$(n:cmd)` permette di assegnare a questo segnaposto un riferimento, dove n is un numero da 1 a salire. Utilizzare `$n` per fornire l'output da un segnaposto di console come input ad un altro.

Segnaposti python

  `$<cmd>` viene sostituito con la valutazione di cmd nell'interprete python.

  `$<a:cmd>` specifica un altro segnaposto python come dipendenza, dove a indica il suo ordine nello snippet. Ciò consente di usare funzioni python definite in un altro snippet. Per specificare diverse dipendenze, separate i numeri con delle virgole in questo modo: `$<a,b:cmd>`

  Per utilizzare una variabile in tutti gli altri snippet python, dichiararla come `globale`.

### Plugin Ordina

Il plugin Ordina dispone le righe di testo selezionate in ordine alfabetico.

Per utilizzare il plugin Ordina, procedere come segue:

1. Selezionare le linee da ordinare.

2. Selezionare Modifica Ordina. Si aprirà la finestra di dialogo Ordina.

3. Selezionare le opzioni di ordinamento desiderate:

   - Per disporre le righe in ordine inverso, selezionare Ordine inverso.

   - Per eliminare righe doppie, selezionare Rimuovi i duplicati.

   - Per ignorare maiuscole e minuscole, selezionare Ignora Maiuscole/minuscole.

   - Per ignorare i caratteri all'inizio delle righe, impostare il primo carattere che dovrebbe essere utilizzato per l'ordinamento nella casella Inizia dalla colonna.

4. Per eseguire l'ordinamento , premere il pulsante Ordina.

### Correttore Ortografico

Il plugin Correttore Ortografico controlla l'ortografia nel testo selezionato. È possibile configurare pluma per controllare automaticamente l'ortografia, oppure controllare manualmente l'ortografia nella lingua specificata. Le impostazioni della lingua e le proprietà di autocontrollo, si applicano al documento. Per utilizzare il plugin Correttore ortografico, procedere come segue:

1. Selezionare Strumenti Configura la lingua per mostrare la finestra di dialogo Configura la lingua. Selezionare la lingua appropriata dall'elenco. Fare clic su OK per chiudere la finestraConfigura la lingua.

2. Per controllare automaticamente l'ortografia, selezionare Strumenti Controllo ortografico automatico. Per deselezionare il controllo ortografico automatico, selezionare nuovamente Strumenti Controllo ortografico automatico. Quando il controllo ortografico è attivo, compare un'icona accanto all'oggetto di menù Controllo ortografico automatico. Il controllo ortografico automatico è disabilitato per default, ogni volta che viene avviato pluma.

   Le ortografie sconosciute vengono mostrate in un altro colore, e sottolineate. Fare clic con il pulsante destro su una parola sconosciuta, e selezionare Suggerimenti ortografici dal menù a comparsa::

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

   - Per aggiungere la parola sconosciuta al vostro dizionario personale, selezionare Suggerimenti ortografici Aggiungi.

   - Per ignorare tutte le occorrenze dell'ortografia sconosciuta, in modo che non sia più segnalata come sconosciuta ma non venga aggiunta al dizionario personale, selezionare Suggerimenti ortografici Ignora tutto . La parola sconosciuta verrà ignorata solo per la sessione corrente di pluma.

3. Per controllare l'ortografia manualmente, sezionare Strumenti Controllo Ortografico .

   Se non sono presenti errori ortografici, una finestra di dialogo di Informazione mostrerà un messaggio in cui si afferma che il documento non contiene parole errate. Fare clic su OK per chiudere la finestra di dialogo di Informazione.

   Se sono presenti errori di ortografia, verrà mostrata la finestra di dialogo Controllo Ortografico.

   - La parola scritta in modo errato viene mostrata in cima alla finestra di dialogo.

   - Una parola di ortografia conosciuta viene mostrata nella casella di testo Sostituisci con. È possibile rimpiazzare questa parola con un'altra di ortografia nota selezionandola dall'elenco Suggerimenti, oppure scrivendola direttamente nel campo di testo Sostituisci con.

   - Per controllare l'ortografia della parola scritta nella casella di testo Sostituisci con, fare clic su Controlla la parola. Se questa è una parola conosciuta, l'elenco Suggerimenti sarà sostituito dal testo `(ortografia corretta)`. Se la parola è sconosciuta, nella lista Suggerimenti compariranno nuove voci.

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

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

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

   - Per uscire dalla finestra di dialogo Controllo ortografico, fare clic su Chiudi.

### Plugin Elenco dei Tag

Il plugin Elenco dei tag consente di inserire tag comuni da una elenco visualizzato nel pannello laterale.

Per utilizzare il plugin Elenco dei tag, procedere come segue.

1. Selezionare Visualizza Pannello laterale .

2. Per impostazione predefinita, il pannello laterale mostra una scheda con l'elenco dei documenti aperti. Fare clic sulla scheda contrassegnata dall'icona a forma di + in basso al pannello laterale per mostrare la scheda elenco dei tag.

3. Selezionare la categoria appropriata dal menu a tendina, ad esempio Tag - HTML.

4. Scorrere nella lista dei tag per trovare quello richiesto.

5. Per inserire un tag nel file alla posizione corrente del cursore, fare doppio clic sul tag richiesto. È possibile inserire un tag anche nei seguenti modi:

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

   - Per inserire un tag nel file corrente e mantenere il focus sulla finestra plugin Elenco tag, premere Shift Invio .

pluma
editor di testo