# Configurare &kate;

## Panoramica

&kate; offre molti modi per adattare l'applicazione alle proprie esigenze. I più importanti sono:

La finestra di configurazione

- Lo strumento principale di configurazione permette di configurare l'applicazione &kate;, il componente editor e l'uso delle estensioni.

Il menu Impostazioni

- Permette di cambiare le impostazioni usate più spesso e di aprire la finestra di configurazione.

Il menu Visualizza

- Permette di dividere il riquadro attuale, oltre a visualizzare le aree delle icone e dei numeri di riga per il documento su cui stai attualmente lavorando.

Il terminale integrato usa la configurazione definita nelle &systemsettings;, e può essere configurato facendo clic con il &RMB; per visualizzare un menu contestuale.

## La finestra di configurazione principale

La finestra di configurazione di &kate; mostra a sinistra un albero di argomenti, e a destra la pagina di configurazione corrispondente all'argomento selezionato.

La configurazione è divisa in due gruppi, cioè:

- Configurazione dell'applicazione

- Configurazione del componente editor

## La configurazione dell'applicazione &kate;

Questo gruppo contiene le pagine per configurare l'applicazione principale di &kate;

### La pagina Generale

Questa sezione contiene alcune opzioni globali di &kate;.

Comportamento

- Avverti se dei file vengono modificati da altri processi

- Se questa opzione è abilitata, &kate; segnalerà i file modificati dall'esterno dell'applicazione ogni volta che la finestra principale verrà attivata. Potrai gestire più file modificati alla volta, e puoi ricaricare, salvare o scartare i file modificati in gruppi.

  Se non è abilitata, &kate; chiederà che cosa fare quando un file modificato dall'esterno viene attivato nell'applicazione.

Informazioni aggiuntive

- Ricorda le informazioni aggiuntive

- Se questa opzione è abilitata, &kate; memorizzerà i dati aggiuntivi come i segnalibri e la configurazione della sessione anche quando chiudi i documenti. I dati saranno usati se il documento non è stato modificato alla riapertura.

Elimina informazioni aggiuntive inutilizzate dopo

- Imposta il massimo numero di giorni per cui conservare le informazioni aggiuntive per i file non aperti. Questo permette di mantenere la banca dati delle informazioni aggiuntive entro dimensioni ragionevoli.

### La pagina Sessioni

Questa sezione contiene opzioni relative all'uso delle sessioni.

Elementi delle sessioni

- Includi la configurazione della finestra

- Se questa opzione è abilitata, &kate; salverà la configurazione della finestra con ogni sessione.

Comportamento all'avvio dell'applicazione

- Seleziona il comportamento di &kate; all'avvio. Questa impostazione può essere ignorata specificando cosa fare dalla riga di comando.

  Avvia nuova sessione

- Con questa opzione, &kate; creerà una nuova sessione senza nome all'avvio.

Carica l'ultima sessione usata

- &kate; userà la sessione usata più di recente all'avvio. È comodo se vuoi usare sempre la stessa sessione o se la cambi raramente.

Scegli a mano una sessione

- &kate; mostrerà una finestrella per la scelta della sessione preferita. Questo è il comportamento predefinito. È comodo se usi molte sessioni diverse di frequente.

Le modifiche ai dati della sessione (file aperti e, se abilitata, la configurazione delle finestre) saranno sempre salvate.

### La pagina Elenco dei documenti

Sfumature sfondo

- Questa sezione permette di abilitare e disabilitare l'indicazione delle attività recenti attraverso le ombreggiature dello sfondo, e di scegliere quali colori usare se la usi. Vedi la sezione sull'elenco dei documenti per maggiori informazioni su questa funzione.

Ordina per

- Imposta il tipo di ordinamento da dare ai documenti. Può anche essere cambiato con il menu del &RMB; dall'elenco dei documenti.

### La pagina Estensioni

Questa pagina fornisce un elenco delle estensioni installate in &kate;. Ciascuna estensione è rappresentata dal suo nome e da una breve descrizione. Puoi spuntare la casella di una voce per abilitarne l'estensione.

Se un'estensione ha delle opzioni di configurazione, apparirà una sezione per accedervi come figlia di questa pagina.

### La pagina Navigatore del filesystem

Barra

- Configura i pulsanti della barra del selettore dei file spostando quelli desiderati nell'elenco Azioni selezionate, ed ordinali usando i pulsanti con le frecce di fianco alla lista.

### La pagina Terminale

Sincronizza automaticamente il terminale con il documento attuale quando possibile

- Questo farà passare il terminale incorporato nella cartella del documento attivo quando viene aperto e quando viene attivato un nuovo documento. Se non è abilitato, dovrai cambiare cartella a mano nel terminale.

### Strumenti esterni

Questa pagina sarà visualizzata se gli Strumenti esterni sono stati selezionati nella pagina delle Estensioni. In questo caso, nel menu Strumenti, si troverà un sottomenu indicato con Strumenti esterni. Questi strumenti avviano delle applicazioni con dei dati relativi al documento attuale, per esempio il suo URL, la cartella, il testo o la selezione. Questa pagina permette di gestire il menu, di modificare o rimuovere gli strumenti, o di aggiungerne di nuovi.

Ogni strumento esterno è un comando di shell contenente delle macro che rappresentano i dati del documento. All'attivazione, le macro vengono sostituite dai dati del documento attivo.

### Proprietà degli strumenti esterni

Etichetta

- Un'etichetta amichevole per il menu Strumenti esterni.

Script

- Lo script da eseguire quando viene attivato lo strumento. Prima di passare lo script alla shell, vengono sostituite le seguenti macro:

  %URL

- L'URL completo del documento attuale, o una stringa vuota se il documento non è stato salvato.

%URL

- Una lista separata da spazi degli URL di tutti i documenti aperti (tranne quelli non salvati).

%directory

- La parte della cartella dell'URL del documento attuale, o una stringa vuota se il documento attuale non è stato salvato.

%filename

- Il nome del file del documento attuale senza il percorso, o una stringa vuota se il documento corrente non è stato salvato.

%line

- Il numero della riga a cui si trova il cursore di inserimento nel documento attuale.

%column

- Il numero della colonna a cui si trova il cursore di inserimento nel documento attuale.

%selection

- Il testo selezionato nel documento attuale, o una stringa vuota se non c'è testo selezionato.

%text

- Il testo completo del documento attuale. Fai attenzione, perché potrebbe eccedere la lunghezza massima dei comandi permessa sul tuo sistema. Va usato con prudenza.

Eseguibile

- L'eseguibile principale nello script. Questo è obbligatorio, ed è usato per verificare se il comando può essere eseguito. È ammesso un percorso completamente qualificato nel caso in cui l'eseguibile non sia nella variabile d'ambiente `PATH`.

Tipi MIME

- Una lista separata da punti e virgola dei tipi MIME per cui questo comando dovrebbe essere abilitato. Attualmente non è in uso.

Salva

- Puoi scegliere di far salvare il documento attuale o tutti i documenti prima di eseguire lo script. Questo è utile se lo script legge il file dal disco.

Nome della riga di comando

- Se compili questo campo, lo strumento sarà disponibile dalla riga di comando dell'editor come `exttool-`Nome della riga di comando`` (cioè la stringa che hai immesso qui, preceduta da `exttool-`).

## Configurazione del componente editor

Questo gruppo contiene tutte le pagine relative al componente editor di &kate;. La maggior parte delle impostazioni sono quelle predefinite, che possono venir sostituite definendo un tipo di file, con le variabili dei documenti o cambiandole nel documento in una sessione di lavoro.

### Aspetto

A capo automatico

- A capo automatico dinamico

- Se questa opzione è attiva, le righe andranno a capo quando raggiungeranno il limite di visualizzazione della finestra.

Indicatori di a capo automatico dinamico (se applicabile)

- Scegli se visualizzare gli indicatori di andata a capo automatica dinamica.

Allinea le righe andate a capo dinamicamente alla profondità di rientro:

- Allinea verticalmente l'inizio di una riga mandata a capo dinamicamente con il livello di rientro della prima riga. Ciò può aiutare a rendere il codice e la formattazione più leggibile.

  Permette inoltre di impostare una larghezza massima dello schermo, in percentuale, oltre la quale le righe andate a capo dinamicamente non saranno più allineate verticalmente. Ad esempio, al 50%, le righe il cui livello di rientro è più profondo del 50% della larghezza dello schermo non verranno seguite da righe allineate verticalmente.

Bordi

- Mostra gli indicatori di raggruppamento

- Se questa opzione è attivata, la vista attuale mostrerà degli indicatori per il raggruppamento del codice, se disponibile.

Mostra bordo per le icone

- Se attivata, vedrai un bordo di icone sul lato sinistro. Il bordo per le icone indica, per esempio, i segnalibri.

Mostra numeri di riga

- Se attivata, vedrai i numeri di riga sul lato sinistro.

Mostra i segni nella barra di scorrimento

- Se questa opzione è attivata, la vista attuale mostrerà degli indicatori sulla barra di scorrimento verticale. Questi possono indicare, per esempio, i segnalibri.

Ordina il menu dei segnalibri

- Per posizione

- I segnalibri saranno ordinati a seconda dei loro numeri di riga.

Per creazione

- Ogni nuovo segnalibro verrà aggiunto in coda, indipendentemente da dove si trova nel documento.

Avanzate

- Mostra righe di rientro

- Se attivata, l'editor mostrerà delle linee verticali aiutare a distinguere le righe rientrate.

Evidenzia intervallo tra parentesi selezionate

- Se abilitato, l'intervallo tra le parentesi corrispondenti selezionate sarà evidenziato.

### Caratteri e colori

Questo sezione della finestra permette di configurare tutti i caratteri e i colori in qualsiasi schema di colori tu abbia, oltre a creare nuovi schemi o eliminare quelli esistenti. Ciascuno schema ha delle impostazioni per i colori, per i caratteri e per gli stili del testo normale ed evidenziato.

&kappname; preselezionerà lo schema attualmente attivo; se vuoi lavorare su uno schema diverso, selezionalo dalla casella combinata Schema. Con i pulsanti Nuovo ed Elimina puoi rispettivamente creare un nuovo schema o eliminare quelli presenti.

In fondo alla pagina puoi selezionare lo Schema predefinito per Kate.

#### Colori

Sfondo area del testo

- Testo normale

- Questo è lo sfondo predefinito per l'area dell'editor, e ne sarà il colore dominante.

Testo selezionato

- Il colore di sfondo del testo selezionato. Quello predefinito è il colore globale di selezione, come configurato nelle preferenze dei colori di &kde;.

Riga corrente

- Imposta il colore della riga corrente. Se è un po' diverso da quello del testo normale, aiuta a tenere il segno.

Segnalibro

- Questa casella permette di impostare i colori da sovrapporre sui vari tipi di indicatori. Il colore viene miscelato con quello di sfondo di una riga indicata, in modo che una riga con più indicatori o una riga indicata che è anche quella corrente ha uno sfondo che è una miscela di più colori. I colori degli indicatori sono usati anche se abiliti la visualizzazione degli indicatori nella barra di scorrimento.

Elementi aggiuntivi

- Sfondo bordo sinistro

- Questo colore è usato per i bordi degli indicatori, dei numeri di riga e degli indicatori di raggruppamento sul lato sinistro della vista dell'editor, quando sono visualizzati.

Numeri di riga

- Questo colore è usato per disegnare i numeri di riga sul lato sinistro della vista, quando visualizzati.

Evidenziazione parentesi

- Questo colore è usato per colorare lo sfondo tra parentesi corrispondenti.

Indicatori a capo automatico

- Questo colore è usato per disegnare un motivo sulla sinistra delle righe mandate a capo automaticamente quando vengono allineate verticalmente, e anche per l'indicatore di a capo statico.

Segni di tabulazione e spazio

- Questo colore è usato per gli indicatori delle spaziature, quando sono abilitati.

Linea degli errori di ortografia

- imposta il colore della linea usata per indicare gli errori di ortografia.

#### Carattere

Qui puoi scegliere il carattere dello schema. Puoi scegliere fra tutti i caratteri disponibili sul sistema, ed impostarne la dimensione predefinita. In basso viene mostrato un testo esemplificativo, per vedere l'effetto delle tue scelte.

#### Stili testo normale

Gli stili di testo normale sono ereditati dagli stili di evidenziazione del testo, permettendo all'editor di presentare il testo in modo coerente: per esempio, il testo dei commenti è uguale in quasi tutti i formati di testo che &kate; può evidenziare.

Il nome nell'elenco di stili usa lo stile configurato per l'elemento, dando un'anteprima immediata alla configurazione dello stile.

Ogni stile permette di selezionare degli attributi comuni oltre ai colori di sfondo e di primo piano. Per rimuovere l'impostazione del colore di sfondo, fai clic con il &RMB; per usare il menu contestuale.

#### Stili testo evidenziazione

Qui puoi modificare gli stili del testo usati per una specifica definizione di evidenziazione. L'editor preseleziona l'evidenziazione usata dal documento attuale. Per lavorare con un'evidenziazione diversa, selezionala dalla casella combinata Evidenziazione sopra l'elenco di stili.

Il nome nell'elenco di stili usa lo stile configurato per l'elemento, dando un'anteprima immediata alla configurazione dello stile.

Ogni stile permette di selezionare attributi comuni oltre ai colori di sfondo e di primo piano. Per deimpostare un colore di sfondo, fai clic con il &RMB; per usare il menu contestuale. Puoi inoltre vedere se uno stile è uguale a quello predefinito dell'elemento, e renderlo tale se non lo è.

Noterai che molte evidenziazioni contengono altre evidenziazioni rappresentate da gruppi nell'elenco di stili. Per esempio, la maggior parte delle evidenziazioni importano l'evidenziazione Alerts, e molte altre importano l'evidenziazione per Doxygen. La modifica dei colori di questi gruppi ha effetto solo sugli stili quando è usata nel formato di evidenziazione modificato.

### Modifica

#### Generale

Tabulazioni

- Inserisci spazi invece delle tabulazioni

- Quando questa opzione è abilitata, l'editor inserirà un numero appropriato di spazi a seconda della posizione nel testo e dell'impostazione Ampiezza delle tabulazioni alla pressione del tasto .

Evidenzia le tabulazioni

- Quando questa opzione è abilitata, &kappname; mostra un puntino per rappresentare visivamente i caratteri di tabulazione.

  Ciò fa comparire anche dei puntini che indicano gli spazi in fondo alle righe. Questo verrà corretto in una versione successiva di &kappname;.

Ampiezza delle tabulazioni

- Se l'opzione Inserisci spazi invece delle tabulazioni è selezionata, questa casella determina con quanti spazi l'editor sostituirà le tabulazioni.

A capo automatico statico

- L'a capo automatico è una funzionalità che fa iniziare automaticamente una nuova riga di testo all'editor e ne sposta il cursore al suo inizio. &kappname; inizierà automaticamente una nuova riga di testo al raggiungere della lunghezza specificata dall'opzione Colonna a cui andare a capo.

  Abilita a capo automatico statico

- Attiva o disattiva l'a capo automatico statico.

Mostra indicatori di a capo automatico statico (se applicabili)

- Se questa opzione è selezionata, verrà disegnata una barra verticale sulla colonna di andata a capo definita in Impostazioni Configura editor... nella scheda Modifica. Nota che l'indicatore di andata a capo sarà disegnato solo se usi un carattere a spaziatura fissa.

Colonna a cui andare a capo:

- Se l'opzione Abilita a capo automatico è selezionata, questa casella determina la lunghezza (in caratteri) alla quale l'editor comincerà automaticamente una nuova riga.

Varie

- Rimuovi gli spazi finali durante la scrittura

- &kappname; eliminerà automaticamente gli spazi di troppo in fondo alle righe di testo.

Evidenziazione degli spazi finali

- &kappname; evidenzierà gli spazi di troppo in fondo alle righe di testo.

Parentesi automatiche

- Quando si scrive una parentesi aperta (`[`, `(`, o `{`), &kappname; inserisce automaticamente la parentesi chiusa corrispondente (`]`, `)`, o `}`) a destra del cursore.

Copia o taglia la riga attuale se non c'è una selezione

- Se questa opzione è abilitata e la selezione di testo è vuota, le azioni di copiatura o ritaglio vengono fatte per l'intera riga di testo sulla quale si trova il cursore.

Permetti di scorrere oltre la fine del documento

- Questa opzione permette di scorrere oltre la fine del documento. Questo può servire per centrare verticalmente il fondo del documento, o per metterlo in cima alla vista attuale.

#### Cursore e selezione

Spostamento cursore testo

- Home e Fine intelligenti

- Se questa casella è selezionata, premere il tasto Home farà saltare al cursore gli spazi e lo manderà all'inizio del testo della riga.

Cursore a capo

- Quando attivata, spostare il cursore con i tasti ← e → quando si è rispettivamente all'inizio o alla fine di una riga lo manderà alla fine della riga precedente o all'inizio della successiva, come nella maggior parte degli editor.

  Quando disattivata, il cursore di inserimento non può essere spostato a sinistra dell'inizio di una riga, ma può esserlo oltre la fine di una riga, il che può fare comodo ai programmatori. Quando questa opzione viene scelta, spostare il cursore con i tasti freccia oltre la fine di una riga (a destra) lo farà passare all'inizio della successiva. Allo stesso modo quando si sposta il cursore oltre l'inizio di una riga (a sinistra) passerà alla fine della riga precedente. Quando questa opzione non è selezionata, spostare il cursore a destra dopo la fine della riga lo farà soltanto continuare sulla stessa riga, e cercare di spostarlo a sinistra dell'inizio della riga non farà nulla.

PaginaSu/PaginaGiù sposta il cursore

- Questa opzione cambia il comportamento del cursore quando l'utente preme il tasto Pag↑ o Pag↓. Se non è selezionato, il cursore del testo manterrà la sua posizione relativa nel testo visibile in &kappname; quando del nuovo testo diviene visibile come risultato dell'operazione. Così, se il cursore è al centro del testo visibile quando avviene l'operazione, rimarrà lì (tranne quando si raggiunge l'inizio o la fine). Quando questa opzione è selezionata, la prima pressione di un tasto farà spostare il cursore in cima o in fondo al testo visibile non appena si visualizza una nuova pagina di testo.

Centratura automatica del cursore (righe):

- Imposta il numero di righe da mantenere visibili sopra e sotto il cursore, quando possibile.

Modalità di selezione del testo

- Normale

- Le selezioni vengono sovrascritte dal testo digitato e si perdono quando si muove il cursore.

Persistente

- Le selezioni rimangono anche dopo aver spostato il cursore e aver inserito del testo.

#### Rientro

Modalità di rientro predefinita:

- Seleziona la modalità di rientro automatico che vuoi usare come predefinita. Si raccomanda caldamente di impostare `Nessuna` o `Normale`, e di usare le configurazioni per tipo di file per impostare altre modalità di rientro per formati di testo come codice C, C++ o &XML;.

Regole di rientro

- Larghezza del rientro:

- La larghezza del rientro è il numero di spazi usati per fare rientrare una riga. Se l'opzione Inserisci spazi invece delle tabulazioni nella scheda Generale della pagina Modifica non è attiva, viene inserito un carattere se il rientro è divisibile per la larghezza delle tabulazioni.

Mantieni gli spazi aggiuntivi

- Se questa opzione è disattivata, la modifica del livello di rientro allinea una riga a un multiplo della larghezza specificata come Larghezza del rientro.

Regola il rientro del codice incollato dagli appunti

- Se questa opzione è attivata, il codice incollato dagli appunti verrà fatto rientrare. Si può rimuovere il rientro usando il comando Annulla.

Azioni di rientro

- Il tasto Backspace nello spazio vuoto iniziale toglie il rientro

- Se questa opzione è attivata, il tasto &Backspace; diminuisce il livello di rientro se il cursore si trova nello spazio iniziale di una riga.

Azione del tasto Tab (senza selezione)

- Se vuoi che allinei la riga attuale nel blocco di codice attuale come in emacs, rendi una scorciatoia per l'azione Allinea.

  Avanza sempre alla prossima tabulazione

- Se questa opzione è attivata, il tasto inserirà sempre spazi in modo da raggiungere la prossima tabulazione. Se l'opzione Inserisci spazi invece delle tabulazioni nella scheda Generale della pagina Modifica è abilitata, vengono inseriti spazi; altrimenti, viene inserita una tabulazione.

Aumenta sempre il livello di rientro

- Se questa opzione è attivata, il tasto farà rientrare sempre la riga attuale del numero di posizioni specificato in Larghezza del rientro.

Aumenta il livello di rientro se in uno spazio vuoto iniziale

- Se questa opzione è attivata, il tasto farà rientrare la riga attuale o avanzerà alla prossima tabulazione. Se il punto di inserimento è sul primo carattere non di spaziatura della riga o prima di esso, o se c'è una selezione, la riga attuale verrà fatta rientrare del numero di posizioni specificato in Larghezza del rientro. Se il punto di inserimento è dopo il primo carattere non di spaziatura della linea e non c'è selezione, si inseriscono degli spazi fino a raggiungere la prossima tabulazione: se l'opzione Inserisci spazi invece delle tabulazioni nella scheda Generale della pagina Modifica è abilitata, si inseriscono spazi, altrimenti una tabulazione.

#### Completamento delle parole

Generale

- Completamento automatico abilitato

- Se abilitato, appare automaticamente un riquadro di completamento delle parole durante la battitura, presentando un elenco di voci testuali per completare il testo attualmente sotto il cursore.

Lunghezza minima delle parole da completare

- Quando si scrive, il completamento delle parole cerca le parole nello stesso documento che cominciano con il testo già scritto. Questa opzione configura il numero minimo di caratteri per attivare il completamento e far comparire un riquadro di completamento.

#### Modalità di inserimento Vi

Generale

- Usa modalità di inserimento VI

- Se selezionato, verrà abilitata la modalità di inserimento Vi all'apertura di una nuova vista. La puoi comunque attivare o disattivare per una vista particolare dal menu Modifica.

Lascia che i comandi VI abbiano precedenza su quelli di Kate

- Se selezionato, i comandi Vi avranno precedenza sui comandi interni di &kate;. Per esempio, &Ctrl;R rifarà le modifiche, e sostituirà l'azione normale, che sarebbe mostrare la finestra di ricerca e sostituzione.

Nascondi la barra di stato della modalità VI

- Come impostazione predefinita, si usa un'ulteriore barra di stato quando la modalità di inserimento Vi è attivata. Questa barra mostra i comandi mentre vengono scritti e i messaggi e gli errori prodotti dai comandi di Vi.

  Attivare questa opzione nasconderà questa ulteriore barra di stato.

Mappatura dei tasti

- La mappatura dei tasti si usa per cambiare il significato dei tasti premuti. Ciò permette di spostare i comandi su altri tasti, o di creare sequenze speciali per effettuare serie di comandi.

  Esempio:

  `KDE` nella prima colonna, `Iviva KDE!` nella seconda.

  Questo metterà un `Viva KDE!` all'inizio di una riga quando si digita `KDE`.

#### Controllo ortografico

Queste opzioni di configurazione sono descritte nella documentazione del modulo delle &systemsettings; del Correttore ortografico.

### Apri e salva

#### Generale

Formato file

- Codifica:

- Questo definisce la codifica standard da usare pre aprire e salvare i file, se non viene cambiata nella finestra di apertura e salvataggio o usando un'opzione dalla riga di comando.

Rilevamento della codifica

- Seleziona un elemento dalla casella a cascata, o per disattivare il rilevamento automatico, o usa Universale per abilitarlo per tutte le codifiche. Questo potrebbe però rilevare solo UTF-8 e UTF-16, e selezionare una regione userà permetterà di ottenere risultati migliori. Se né la codifica scelta come standard sopra, né quella specificata nella finestra di apertura o salvataggio, né quella specificata sulla riga di comando corrispondono al contenuto del file, si eseguirà questo rilevamento.

Codifica di riserva

- Qui si definisce la codifica di riserva per provare ad aprire file se né la codifica sopra indicata come normale, né quella specificata nella finestra di apertura o salvataggio, né quella specificata sulla riga di comando corrispondono ai contenuti del file. Prima di usare questa, si proverà a determinare la codifica da usare cercando un indicatore di ordinamento dei byte all'inizio del file: se ne si trova uno, sarà scelta la codifica Unicode corretta; altrimenti, verrà avviato il rilevamento della codifica, se entrambe le codifiche di riserva saranno provate.

Fine di riga:

- Sceglie la modalità di fine riga preferita per il documento attuale. Puoi scegliere tra &UNIX;, DOS/&Windows; o Macintosh.

Rilevamento automatico dei fine riga

- Segna la casella se vuoi che l'editor rilevi automaticamente il tipo di fine riga. Il primo tipo di fine riga incontrato verrà usato per tutto il file.

Abilita l'indicatore dell'ordine dei byte

- L'indicatore dell'ordine dei byte è una sequenza particolare all'inizio dei documenti codificati con Unicode. Aiuta gli editor a aprire i documenti di testo con la codifica Unicode giusta. Per maggiori informazioni, vedi la Wikipedia.

Pulizia automatica al salvataggio/caricamento

- Rimuovi gli spazi finali durante la scrittura

- L'editor eliminerà automaticamente gli spazi di troppo in fondo alle righe di testo durante il caricamento e il salvataggio del file.

#### Avanzate

Cartella file di configurazione

- Profondità di ricerca del file di configurazione:

- L'editor cercherà il file di configurazione di &kappname; nel numero dato di livelli di cartelle verso l'alto, e da esso caricherà la riga delle impostazioni. Maggiori informazioni su questa cartella nascosta di file di configurazione si possono trovare in questo articolo sul file .kateconfig.

Copia di sicurezza al salvataggio

- La copia di sicurezza al salvataggio fa copiare a &kappname; il file su disco in `<prefisso><nomefile>suffisso<` prima di salvare le modifiche. Il suffisso predefinito è `~`, mentre il prefisso predefinito è vuoto.

  File locali

- Segna la casella se vuoi una copia di sicurezza dei file locali al salvataggio.

File remoti

- Segna la casella se vuoi una copia di sicurezza dei file remoti al salvataggio.

Prefisso

- Inserisci il prefisso da aggiungere ai nomi delle copie di sicurezza.

Suffisso

- Inserisci il suffisso da aggiungere ai nomi delle copie di sicurezza.

#### Modalità e tipi di file

Questa pagina permette di modificare la configurazione predefinita per documenti con specifici tipi di file. Quando l'editor carica un documento, prova a vedere se corrisponde a un tipo di file conosciuto, e in tal caso applica le variabili definite. Se si trovano più corrispondenze, si userà quella con la priorità più alta.

Tipo di file:

- Il tipo di file con la priorità più alta è quello mostrato nella prima casella a cascata. Se si trovano più tipi di file, verranno mostrati tutti.

  Nuovo

- Questo è usato per creare un nuovo tipo di file. Dopo aver fatto clic su questo pulsante, i campi sottostanti si svuotano, e puoi inserire le proprietà che vuoi per il nuovo tipo di file.

Elimina

- Per eliminare un tipo di file esistente, selezionalo dalla casella a cascata e premi il pulsante Elimina.

Proprietà di `tipo di file attuale`

- Il tipo di file con la priorità più alta è quello mostrato nella prima casella a cascata. Se si trovano più tipi di file, verranno mostrati tutti.

  Nome:

- Il nome del tipo di file sarà il testo della corrispondente voce del menu. Questo nome è mostrato in Strumenti Modalità

Sezione:

- Il nome della sezione è usato per organizzare i tipi di file nei menu. Viene usato anche nel menu Strumenti Modalità.

Variabili:

- Questa stringa permette di configurare le impostazioni di &kappname; per i file selezionati da questo tipo usando le variabili di &kappname;. Puoi impostare quasi ogni opzione, come l'evidenziazione, la modalità di rientro, la codifica, eccetera.

  Per un elenco completo di tutte le variabili, vedi il manuale.

Evidenziazione:

- Se crei un nuovo tipo di file, questa casella a cascata permette di selezionare un tipo di l'evidenziazione.

Modalità di rientro:

- La casella a cascata specifica la modalità di rientro per i nuovi documenti.

Estensioni dei file:

- La maschera per i caratteri jolly permette di selezionare i file per nome. Una maschera tipica usa un asterisco e l'estensione del file, ad esempio `*.txt; *.text`. La stringa è un elenco di maschere separato da punti e virgola.

Tipi MIME:

- Mostra una procedura guidata che aiuta a scegliere facilmente i tipi MIME.

Priorità:

- Imposta una priorità per questo tipo di file. Se più di un tipo di file seleziona uno stesso file, verrà usato quello con priorità maggiore.

Scarica file di evidenziazione...

- Fai clic su questo pulsante per scaricare descrizioni delle sintassi nuove o aggiornate dal sito Web di &kate;.

### Estensioni

La scheda Estensioni elenca tutte le estensioni disponibili, tra cui puoi spuntare tutte quelle che vuoi usare. Fai clic sul pulsante Informazioni per aprire la finestra Informazioni su di un'estensione.

Una volta che un'estensione è spuntata, viene abilitato l'eventuale pulsante Configura per configurarla.

### Estensioni del componente editor

Graffe automatiche

- L'estensione per graffe automatiche sostituisce la funzionalità interna di &kate; per le quadre automatiche. Inserisce automaticamente una graffa chiusa, }, in fondo alla riga successiva dopo aver concluso una riga con una aperta, {, e aver premuto il tasto &Enter;.

Strumenti per dati

- Abilita gli strumenti di dati come il dizionario dei sinonimi e il controllo ortografico (se installato). Gli strumenti di dati sono disponibili solo quando c'è del testo selezionato, o quando il &RMB; viene premuto su una parola. Se non sono presenti strumenti di dati, anche quando c'è del testo selezionato, devi installarli. Alcuni strumenti di dati fanno parte del pacchetto &koffice;. Se questa estensione è abilitata e gli strumenti di dati sono installati, appariranno degli altri elementi in fondo al menu contestuale.

Esportatore

- Questo comando permette di esportare il documento attuale con tutte le informazioni di evidenziazione in un documento HTML con File Esporta come HTML. Inoltre, puoi usare Modifica Copia come HTML per copiare il testo attualmente selezionato come HTML negli appunti di sistema.

Inserisci file

- Questa estensione permette di inserire qualsiasi file leggibile alla posizione del cursore. Se abilitata, il menu Strumenti avrà l'ulteriore elemento Inserisci file.

Controlla codifica Python

- Questa estensione è sempre attiva. Se stai cercando di salvare un file Python come non ASCII, senza specificare una riga di codifica del sorgente corretta come per esempio `# -*- coding: utf-8 -*-`, apparirà una finestra di avviso che permetterà di aggiungere l'appropriata riga di codifica del sorgente per la codifica attuale del file.

## Configurazione con le variabili dei documenti

Le variabili di &kate; sono l'implementazione KatePart delle variabili dei documenti, simili ai file modeline di emacs e di vi. Nella componente KatePart le righe hanno la forma `kate: NOME_VARIABILE VALORE; [ NOME_VARIABILE VALORE; ... ]`. Le righe possono naturalmente essere in un commento, se il formato del file lo prevede. I nomi delle variabili sono costituiti da una sola parola (cioè senza spazi), e tutto quello che c'è fino al successivo punto e virgola è il valore. Il punto e virgola è necessario.

Ecco un esempio di riga di variabili, che impone le regole di rientro per un file C++, Java o JavaScript:

    // kate: space-indent on; indent-width 4; mixedindent off; indent-mode cstyle;

Le righe di variabili vengono cercate solo nelle prime e nelle ultime dieci righe.

In KatePart ci sono variabili per gestire quasi tutte le configurazioni; inoltre, anche le estensioni possono usare le variabili, il che andrebbe documentato nel manuale dell'estensione.

### Come &kate; usa le variabili

Quando legge la configurazione, KatePart cerca i questi posti (nell'ordine):

- la configurazione globale;

- valori opzionali di sessione;

- la configurazione Tipi di file;

- variabili del documento presenti nel documento stesso;

- impostazioni modificate in fase di modifica da menu o dalla riga di comando.

Come ovvio, le variabili del documento hanno la seconda priorità. Ogni volta che un documento viene salvato, le sue variabili verranno rilette e sovrascriveranno i cambiamenti fatti con voci di menu o dalla riga di comando.

Ogni variabile non elencata qui sotto può essere inserita nel documento e ritrovata da altri oggetti, come estensioni, che possono usarle per i propri scopi. Per esempio, la modalità di rientro variabile usa le variabili dei documenti per la propria configurazione.

Le variabili qui elencate documentano &kate; versione 2.4. In futuro potrebbero essere aggiunte altre variabili. Ci sono tre possibili tipi di valori per le variabili, con le seguenti espressioni valide:

- BOOL - on|off|true|false|1|0

- INT - un numero intero

- STRING - qualsiasi altra cosa

### Variabili disponibili

    auto-bracketsBOOL

- Attiva o disattiva l'inserimento automatico delle parentesi.

    auto-center-linesINT

- Imposta il numero di righe autocentranti.

    auto-insert-doxygenBOOL

- Attiva o disattiva l'inserimento dell'asterisco iniziale nei commenti Doxygen. Non ha effetto se non si usa il rientro automatico in stile C.

    background-colorSTRING

- Imposta il colore di sfondo del documento. Il valore deve essere qualcosa leggibile come un colore valido, come `#ff0000`.

    backspace-indentsBOOL

- Attiva o disattiva il rientro col tasto Backspace.

    block-selectionBOOL

- Attiva o disattiva la selezione per blocchi.

    bom | byte-order-markerBOOL

- Attiva o disattiva l'indicatore dell'ordine dei byte quando si salvano file in formato Unicode (utf8, utf16, utf32).

  Da: &kate; 3.4 (&kde; 4.4)

    bracket-highlight-colorSTRING

- Imposta il colore per l'evidenziazione delle parentesi. Deve essere qualcosa leggibile come un colore valido, come `#ff0000`.

    current-line-colorSTRING

- Imposta il colore della riga attuale. Il valore deve essere qualcosa leggibile come un colore valido, come `#ff0000`.

    default-dictionarySTRING

- Imposta il dizionario predefinito da usare per il controllo ortografico.

  Da: &kate; 3.4 (&kde; 4.4)

    dynamic-word-wrapBOOL

- Attiva o disattiva l'andata a capo automatica dinamica.

    eol | end-of-lineSTRING

- Imposta la modalità di fine riga. Le impostazioni valide sono `unix`, `mac` e `dos`.

    encodingSTRING

- Imposta la codifica del documento. Il valore deve essere un nome di codifica valido, come `utf-8`.

    folding-markersBOOL

- Attiva o disattiva la visualizzazione degli indicatori di raggruppamento.

    font-sizeINT

- Imposta la dimensione in punti dei caratteri del documento.

    fontSTRING

- Imposta il carattere del documento. Il valore deve essere un nome di carattere valido, per esempio `courier`.

    hl | syntaxSTRING

- Imposta l'evidenziazione della sintassi. Le stringhe valide sono tutti i nomi disponibili nel menu. Per esempio, per il C++ basta scrivere `C++`.

    icon-bar-colorSTRING

- Imposta il colore della barra delle icone. Il valore deve essere qualcosa leggibile come un colore valido, come `#ff0000`.

    icon-borderBOOL

- Attiva o disattiva la visualizzazione del bordo delle icone.

    indent-modeSTRING

- Imposta la modalità di rientro automatico. Sono riconosciute le opzioni `none`, `normal`, `cstyle`, `haskell`, `lilypond`, `lisp`, `python`, `ruby` e `xml`. Vedi kate-part-autoindent per i dettagli.

    indent-widthINT

- Imposta la larghezza del rientro.

    keep-extra-spacesBOOL

- Imposta se tenere gli spazi aggiuntivi quando si calcola la larghezza del rientro.

    keep-indent-profileBOOL

- Se assegni TRUE a questa variabile, si impedisce la rimozione del rientro di un blocco se almeno una riga non ha rientro.

  Nota: rimosso in &kate; 3 (&kde; 4)

    line-numbersBOOL

- Attiva o disattiva la visualizzazione del numero di riga.

    mixed-indentBOOL

- Attiva o disattiva il rientro misto in stile Emacs.

  Nota: deprecato da &kate; 3 in &kde; 4. Questa variabile è ignorata, in futuro imposta invece `replace-tabs on;`.

    overwrite-modeBOOL

- Attiva o disattiva la modalità sovrascrittura.

    persistent-selectionBOOL

- Attiva o disattiva la selezione persistente.

    remove-trailing-spaceBOOL

- Attiva o disattiva la ripulitura dinamica a fi di riga.

    replace-tabs-saveBOOL

- Attiva o disattiva la conversione di tabulazioni in spazi in fase di salvataggio.

    replace-tabsBOOL

- Attiva o disattiva la conversione dinamica di tabulazioni in spazi.

    replace-trailing-space-saveBOOL

- Attiva o disattiva la ripulitura della fine della riga in fase di salvataggio.

    schemeSTRING

- Imposta lo schema di colori. Per avere effetto, La stringa deve essere il nome di uno schema di colori presente nella configurazione.

    selection-colorSTRING

- Imposta il colore della selezione. Il valore deve essere qualcosa leggibile come un colore valido, come `#ff0000`.

    show-tabsBOOL

- Attiva o disattiva il carattere di tabulazione visibile.

    smart-homeBOOL

- Attiva o disattiva la modalità di navigazione intelligente verso l'inizio della riga.

    space-indentBOOL

- Attiva o disattiva il rientro con spazi.

  Nota: deprecato da &kate; 3 in &kde; 4. Il rientro misto è il comportamento predefinito. Imposta `replace-tabs on;` per avere un rientro con soli spazi.

    tab-indentsBOOL

- Attiva o disattiva il rientro col tasto .

    tab-widthINT

- Imposta la larghezza a schermo della tabulazione.

    undo-stepsINT

- Imposta il numero di annullamenti da ricordare.

  Nota: deprecato da &kate; 3 in &kde; 4. Questa variabile è ignorata. Il numero massimo di annullamenti è illimitato.

    word-wrap-columnINT

- Imposta l'ampiezza per l'andata a capo forzata.

    word-wrap-marker-colorSTRING

- Imposta il colore per l'indicatore di andata a capo. Il valore deve essere qualcosa leggibile come un colore valido, come `#ff0000`.

    word-wrapBOOL

- Attiva o disattiva l'andata a capo forzata.

    wrap-cursorBOOL

- Attiva o disattiva l'andata a capo automatica del cursore.