# Manuale di &app; V&manrevision;

## Introduzione

L'applicazione &app; è un semplice editor di testo che può essere utilizzato per creare e modificare i file di testo. Sono inoltre disponibili una serie di plugin per &app; che consentono di eseguire varie attività legate alla modifica dei testi direttamente dalla finestra di &app;.

## Per iniziare

### Avviare &app;

Sono disponibili i seguenti metodi per avviare &app;:

Menu Programmi

- Scegliere Accessori Editor di testo .

Riga di comando

- Digitare `gedit` e premere Return.

### Avvio di &app;

All'avvio di &app; viene visualizzata la finestra seguente.

#### Finestra di &app;

Mostra la finestra principale di &app;.

La finestra di &app; contiene i seguenti elementi:

Barra dei menu

- I menu della barra dei menu contengono tutti i comandi necessari per le operazioni sui file in &app;.

Barra degli strumenti

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

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à correnti di &app; e altre indicazioni contestuali relative alle voci di menu.

Facendo clic con il pulsante destro del mouse nella finestra di &app;, l'applicazione visualizza un menu popup. Questo menu popup contiene i comandi di uso più frequente per la modifica del testo.

### Aprire un file

Per aprire un file, scegliere File Apri per visualizzare la finestra di dialogo Apri file. Selezionare il file da aprire e fare clic su OK. Il file viene visualizzato nella finestra di &app;.

&app; consente di aprire contemporaneamente più file. L'applicazione visualizza un file per volta nella sua finestra. Per ognuno dei file aperti viene aggiunta una scheda alla finestra. Per visualizzare un altro dei file aperti, fare clic sulla scheda che corrisponde al file desiderato. Per creare una nuova finestra di &app; per ogni file aperto, trascinare sullo sfondo del desktop le schede che corrispondono ai file È anche possibile utilizzare il menu Documenti per spostarsi da uno all'altro dei file aperti

L'applicazione memorizza inoltre il percorso e il nome degli ultimi quattro file che sono stati modificati, e li visualizza come voci del menu File File recenti .

### Aprire più di un file dalla riga di comando

È possibile eseguire &app; dalla riga di comando ed aprire automaticamente uno o più file. Per aprire più file dalla riga di comando, digitare il comando seguente e premere Return:

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

All'avvio dell'applicazione, i file specificati vengono visualizzati nella finestra di &app;

## Utilizzo

### Creare un nuovo file

Per creare un nuovo file, scegliere File Nuovo. L'applicazione visualizza un file nuovo nella finestra di &app;

### Salvare un file

Sono disponibili i seguenti metodi per salvare un file:

- Per salvare un file nuovo, scegliere File Salva o fare clic sul pulsante Salva nella barra degli strumenti. Se il file non possiede ancora un nome, &app; visualizza la finestra di dialogo Salva con nome. Inserire il nome da assegnare al file nella finestra di dialogo Salva con nome e quindi fare clic su OK.

- Per salvare un file nuovo o per salvare un file esistente con un nuovo nome, scegliere File Salva con nome . Inserire il nome da assegnare al file nella finestra di dialogo Salva con nome e quindi fare clic su OK.

- Per salvare tutti i file aperti in quel momento in &app;, scegliere File Salva tutto.

### Modificare il testo

Sono disponibili i seguenti metodi per la modifica del testo:

- Digitare il testo direttamente dalla tastiera.

- Usare il tasto Delete per eliminare il testo.

- Usare le voci di menu Taglia, Copia, Incolla e Cancella per modificare il testo.

Quando si effettua una selezione con il mouse, &app; copia automaticamente il testo selezionato in un buffer. È quindi possibile eseguire le seguenti operazioni sul testo selezionato:

- Per eliminare il testo selezionato dal file e spostarlo nel buffer, scegliere Modifica Taglia.

- Per eliminare in modo permanente il testo dal file, scegliere Modifica Elimina .

- Per inserire il contenuto del buffer nella posizione corrente del cursore, fare clic con il pulsante centrale del mouse o scegliere Modifica Incolla. Prima di poter incollare il testo nel file è sempre necessario copiarlo o tagliarlo.

- Per selezionare tutto il testo incluso in un file, scegliere Modifica Seleziona tutto.

### Annullare o ripetere le modifiche

Per annullare un'operazione di modifica, scegliere Modifica Annulla. Per ripetere una operazione di modifica, scegliere Modifica Ripeti. Il numero di modifiche che è possibile annullare è determinato dall'impostazione di Imposta limite delle operazioni annullabili a nella scheda gedit-prefs-undo della finestra di dialogo Preferenze. Nell'impostazione predefinita, il limite per le operazioni che è possibile annullare è di 25.

### Trovare un testo

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

1. Scegliere Cerca Trova per visualizzare la finestra di dialogo Trova.

2. Digitare la stringa da trovare nel campo Cerca.

3. Selezionare una delle seguenti opzioni:

   - Inizia ricerca dall'inizio del documento

   - Inizia ricerca dalla posizione del cursore

4. Selezionare l'opzione Maiuscole/minuscole per individuare solo le occorrenze della stringa che corrispondono esattamente al testo digitato.

5. Fare clic su Trova per cercare la prima occorrenza della stringa nel file. Se &app; trova la stringa, l'applicazione sposta il cursore in corrispondenza della stringa e la seleziona.

6. Per trovare la successiva occorrenza, fare clic su Trova successivo.

7. Per terminare la ricerca, fare clic su Chiudi.

### Trovare e sostituire un testo

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

1. Scegliere Cerca Sostituisci per visualizzare la finestra di dialogo Sostituisci.

2. Digitare la stringa da trovare nel campo Cerca.

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

4. Selezionare una delle seguenti opzioni:

   - Inizia ricerca dall'inizio del documento

   - Inizia ricerca dalla posizione del cursore

5. Selezionare l'opzione Maiuscole/minuscole per individuare solo le occorrenze della stringa che corrispondono esattamente al testo digitato.

6. Fare clic su Trova per cercare la prima occorrenza della stringa nel file. Se &app; trova la stringa, l'applicazione sposta il cursore in corrispondenza della stringa e la seleziona.

7. Fare clic su Sostituisci per sostituire l'occorrenza della stringa con il testo che era stato immesso nel campo Sostituisci con. Fare clic su Sostituisci tutto per sostituire tutte le occorrenze della stringa.

8. Per trovare la successiva occorrenza, fare clic su Trova successivo.

9. Per terminare la ricerca, fare clic su Chiudi.

### Aprire un file da un URI

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

- Scegliere File Apri da URI per visualizzare la finestra di dialogo Apri da URI. Inserire l'URI del file da aprire e quindi fare clic su Apri.

- Digitare `gedit `http://...`` dalla riga di comando, dove `http://...` indica l'URI del file da aprire, quindi premere Return.

L'applicazione apre il file che si trova all'URI indicato in modalità di sola lettura.

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

È possibile usare &app; per inviare con una pipe l'output di un comando a un file di testo. Ad esempio, per inviare in pipe l'output del comando `ls` a un file di testo, digitare `ls | gedit`, quindi premere Return.

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

In alternativa, è possibile usare il plugin Output shell per inviare l'output di un comando al file corrente. Per usare il plugin Output shell, procedere come segue:

1. Caricare il plugin Output shell. Vedere gedit-install-plugins per informazioni su come caricare un plugin.

2. Scegliere Modifica Inserisci output shell per visualizzare la finestra di dialogo Output shell.

3. Digitare il comando della shell da eseguire nel campo Comando per la shell.

4. Modificare il campo Directory corrente, se necessario. Nell'impostazione predefinita, il plugin Output shell esegue il comando specificato nella directory corrente.

5. Fare clic su Esegui. Il plugin Output shell esegue il comando e inserisce l'output nel file corrente.

### Passare a una riga specifica

Per spostarsi in corrispondenza di una riga specifica del file corrente, procedere come segue:

1. Scegliere Cerca Vai alla riga per visualizzare la finestra di dialogo Vai alla riga.

2. Digitare il numero della riga in cui si intende spostare il cursore nel campo Riga numero.

3. Fare clic su Vai alla riga. L'applicazione sposta il cursore al numero di riga specificato.

### Modificare il metodo di input

Per modificare il metodo di input, fare clic con il pulsante destro del mouse nella finestra di testo, quindi selezionare Metodi di input. La voce di menu Inserisci carattere di controllo Unicode contiene alcune opzioni di layout utili per operare con i set di caratteri non latini.

### Stampare un file

&app; consente di eseguire le seguenti operazioni di stampa:

- Stampare un file su una stampante.

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

Se si stampa su un file, &app; invia l'output al file in un formato di prestampa. I più diffusi formati di prestampa sono PostScript e PDF (Portable Document Format).

Per visualizzare un'anteprima delle pagine che verranno stampate, fare clic su File Anteprima di stampa per visualizzare la finestra di dialogo gedit - Anteprima di stampa.

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

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

#### Scheda Lavoro

Intervallo di stampa

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

  - Tutto

    Selezionare questa opzione per stampare tutte le pagine del file.

  - Selezione

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

  Impostazione predefinita: Tutto.

Copie

- Usare questa casella di selezione per specificare il numero di copie del file da stampare.

  Impostazione predefinita: 1.

Fascicola

- Se si intendono stampare più copie del file, selezionare questa opzione per fascicolare le copie stampate.

  Impostazione predefinita: non selezionato.

#### Scheda Stampante

Stampante

- Usare questa casella di riepilogo per selezionare la stampante su cui stampare il file.

  Impostazione predefinita: Stampante predefinita di Gnome.

Impostazioni

- Usare questa casella di riepilogo per configurare le impostazioni della stampante. Per configurare la stampante, fare clic su Configura.

  Impostazione predefinita: Stampante predefinita

Destinazione

- Usare questa casella di riepilogo per selezionare la destinazione della stampa. Per stampare il file su una stampante, scegliere lpr. Per stampare su un file, scegliere File. Se si seleziona l'opzione File, digitare il nome del file di output nella casella di testo.

  Impostazione predefinita: lpr.

#### Scheda Carta

Dimensione carta

- Usare questa casella di riepilogo per selezionare la dimensione della carta su cui stampare il file.

  Impostazione predefinita: A4.

Larghezza

- Usare questa casella di selezione per specificare la larghezza della carta. Usare la casella di riepilogo Centimetri per modificare l'unità di misura per indicare la dimensione della carta.

  Impostazione predefinita: 21,00 centimetri.

Altezza

- Usare questa casella di selezione per specificare l'altezza della carta.

  Impostazione predefinita: 29,70 centimetri.

Orientamento pagina

- Usare questa casella di riepilogo per selezionare l'orientamento della pagina.

  Impostazione predefinita: Verticale.

Disposizione

- Usare questa casella di riepilogo per selezionare la disposizione della pagina. Un'anteprima viene visualizzata nell'area Anteprima.

  Impostazione predefinita: Normale.

### Usare i plugin di &app;

Un plugin è un programma supplementare che aggiunge nuove funzionalità a un'applicazione. I plugin disponibili per &app; consentono di eseguire varie attività direttamente dalla finestra di &app;. La tabella seguente elenca i plugin disponibili.

Nome del plugin | Funzione
Tabella ASCII | Visualizza una finestra di dialogo che contiene la tabella dei caratteri ASCII. Questa tabella può essere usata per inserire i caratteri ASCII in un file.
Confronta file | Confronta due file e ne visualizza le differenze in una nuova finestra di &app;. Questo plugin utilizza il programma diff per confrontare i file.
CVS ChangeLog | Apre i messaggi di log associati con i comandi CVS commit.
Inserisci data/ora | Inserisce nel file la data e l'ora correnti.
Output shell | Inserisce l'output testuale di un comando della shell nel file corrente.
Elenco tag | Visualizza una finestra di dialogo con un elenco dei tag più frequenti. Questa finestra di dialogo può essere usata per inserire i tag in un file.
User name | Inserisce nel file il nome dell'utente corrente.
Conta parole | Conta il numero di righe, parole, caratteri con spazi, caratteri senza spazi e byte presenti nel file corrente. Il plugin visualizza i risultati nella finestra Conta parole.

### Caricare i plugin di &app;

Per caricare i plugin di &app;, scegliere Strumenti Gestione plugin. La finestra di dialogo Gestione plugin visualizza le seguenti informazioni:

- Un elenco dei plugin disponibili.

- Un pulsante Configura plugin. In alcuni plugin, questo pulsante può essere usato per aprire una finestra di configurazione.

- Una breve descrizione dei plugin. Per visualizzare la descrizione, selezionare il plugin nell'elenco.

- Informazioni sull'autore del plugin e il nome del modulo.

Per caricare un plugin, selezionare la casella di controllo accanto al suo nome. &app; aggiunge il plugin al menu appropriato, come viene descritto nella tabella seguente.

Nome del plugin | Aggiunto al menu
Tabella ASCII | Modifica Tabella ASCII
Confronta file | File Confronta file
CVS ChangeLog | File Apri CVS ChangeLogs
Conta parole | Cerca Conta parole
Output shell | Modifica Inserisci output shell
Elenco tag | Visualizza Elenco tag
Inserisci data/ora | Modifica Inserisci data/ora
User name | Modifica Inserisci nome utente

Per rimuovere un plugin, deselezionare la casella di controllo accanto al suo nome.

Per chiudere la finestra di dialogo del Gestione plugin, fare clic su Chiudi.

### Personalizzare la barra degli strumenti e la barra di stato

Per visualizzare o nascondere la barra degli strumenti, scegliere Visualizza Barra degli strumenti . Per personalizzare il modo in cui &app; visualizza la barra degli strumenti, scegliere Visualizza Personalizza barra degli strumenti , quindi selezionare una delle seguenti voci del menu:

- Predefinita

  Visualizza la barra degli strumenti predefinita.

- Icona

  Visualizza solo le icone.

- Icona e testo

  Visualizza le icone e il testo.

Per visualizzare o nascondere la barra di stato, scegliere Visualizza Barra di stato . Per personalizzare il modo in cui &app; visualizza la barra di stato, scegliere Visualizza Personalizza barra di stato , quindi selezionare una delle seguenti voci del menu:

- Mostra posizione cursore

  Visualizza il numero di riga e di colonna in cui è posizionato il cursore.

  Impostazione predefinita: selezionato.

- Mostra modalità sovrascrittura

  Visualizza la 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 SVR.

  Impostazione predefinita: selezionato.

## Preferenze

Per configurare &app;, scegliere Modifica Preferenze . La finestra di dialogo Preferenze contiene le seguenti categorie:

- gedit-prefs-editor

- gedit-prefs-print

### Editor

La categoria Editor è suddivisa nelle seguenti sottocategorie:

#### Font e colori

Usa carattere del tema predefinito

- Selezionare questa opzione per usare il tipo di carattere predefinito del sistema nella finestra di testo di &app;.

  Impostazione predefinita: non selezionato.

Carattere usato dall'editor

- Questo campo visualizza il tipo di carattere utilizzato da &app; per visualizzare il testo. Fare clic sul pulsante per specificare il tipo di carattere, lo stile e la dimensione da usare per il testo.

  Impostazione predefinita: Courier Medium 12 punti.

Usa colori del tema predefinito

- Selezionare questa opzione per usare i colori del tema predefinito nella finestra di testo di &app;.

  Impostazione predefinita: selezionato.

Colore del testo

- Fare clic sul pulsante Colore del testo per visualizzare la finestra di dialogo per la selezione dei colori. Scegliere un colore per il testo da visualizzare nella finestra di testo di &app;.

  Impostazione predefinita: nero.

Colore di sfondo

- Fare clic sul pulsante Colore di sfondo per visualizzare la finestra di dialogo per la selezione dei colori. Selezionare un colore di sfondo per la finestra di testo di &app;.

  Impostazione predefinita: bianco.

Colore del testo selezionato

- Fare clic sul pulsante Colore del testo selezionato per visualizzare la finestra di dialogo per la selezione dei colori. Selezionare un colore da usare per visualizzare il testo selezionato.

  Impostazione predefinita: bianco.

Colore della selezione

- Fare clic sul pulsante Colore della selezione per visualizzare la finestra di dialogo per la selezione dei colori. Selezionare un colore di sfondo da usare per evidenziare una selezione di testo.

  Impostazione predefinita: blu.

#### Tabulazioni

Imposta larghezza tabulazioni su

- Usare questa casella di selezione per specificare la quantità di spazi che viene inserita da &app; quando si preme il tasto Tab.

  Impostazione predefinita: 8 caratteri.

#### A capo

A capo

- Selezionare una delle seguenti opzioni per determinare il modo con cui &app; deve mandare a capo il testo:

  - Nessun a capo automatico

    Selezionare questa opzione per non mandare mai a capo le righe. Il testo digitato viene visualizzato su una singola riga finché non si preme il tasto Return.

  - A capo automatico tra parole

    Selezionare questa opzione per mandare a capo il testo inserendo un'interruzione tra due parole quando si raggiunge il margine della finestra.

  - A capo automatico tra caratteri

    Selezionare questa opzione per mandare a capo il testo inserendo un'interruzione tra due caratteri quando si raggiunge il margine della finestra.

  Impostazione predefinita: A capo automatico tra caratteri

#### Numeri di riga

Visualizza numeri di riga

- Selezionare questa opzione per visualizzare i numeri di riga nella parte sinistra della finestra di &app;.

  Impostazione predefinita: non selezionato.

#### Salvataggio

Crea una copia di backup dei file prima del salvataggio

- Selezionare questa opzione per creare una copia di backup di un file ogni volta che viene salvato. La copia di backup ha l'estensione `.bak`.

  Impostazione predefinita: non selezionato.

Salva automaticamente il file ogni

- Selezionare questa opzione per impostare il salvataggio automatico del file a intervalli regolari. Usare la casella di selezione per specificare l'intervallo per il salvataggio automatico del file.

  Impostazione predefinita: non selezionato, 10 minuti.

Durante il salvataggio

- Selezionare una delle seguenti opzioni per il salvataggio:

  - Usa sempre la codifica UTF-8

    Selezionare questa opzione per salvare i file con la codifica UTF-8.

  - Usa codifica della versione locale corrente, se possibile

    Selezionare questa opzione per salvare i file usando la versione locale corrente. È possibile configurare diverse versioni locali per i vari metodi di input.

  - Usa codifica originale, se possibile

    Selezionare questa opzione per salvare il file con la versione locale corrente solo se era già stato salvato in precedenza in questo modo.

  Impostazione predefinita: Usa sempre la codifica UTF-8

#### Annullamento modifiche

Imposta limite delle operazioni annullabili a

- Selezionare questa opzione per impostare un limite al numero di operazioni di modifica che è possibile annullare. Usare la casella di selezione per specificare il numero massimo di azioni annullabili.

  Impostazione predefinita: selezionato, 25 azioni.

### Stampa

La categoria Stampa è suddivisa nelle seguenti sottocategorie:

#### Page

Stampa le intestazioni delle pagine

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

  Impostazione predefinita: selezionato.

A capo automatico (tra caratteri)

- Selezionare questa opzione per mandare a capo il testo automaticamente quando si stampa un file. L'applicazione conteggia le righe mandate a capo come una singola riga ai fini della numerazione.

  Impostazione predefinita: selezionato.

Stampa i numeri di riga ogni

- Selezionare questa opzione per includere i numeri di riga quando si stampa un file. Usare la casella di selezione per specificare la frequenza con cui stampare i numeri, ad esempio ogni 5 righe, ogni 10 righe e così via.

  Impostazione predefinita: non selezionato, 1 riga.

#### Tipi di carattere

Carattere usato per stampare il testo

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

  Impostazione predefinita: Courier 9.0.

Carattere usato per la stampa dei titoli

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

  Impostazione predefinita: Helvetica 11.0.

Carattere usato per stampare i numeri di riga

- Fare clic su questo pulsante per selezionare il tipo di carattere con cui stampare i numeri di riga.

  Impostazione predefinita: Helvetica 8.0.

Per ripristinare i caratteri predefiniti per la stampa dei file da &app; fare clic sul pulsante Ripristina caratteri predefiniti.