# Configura &kappname;

Selezionando Impostazioni Configura`Applicazione`... dal menu, si apre la finestra di dialogo Configura. Questa finestra di dialogo può essere utilizzata per modificare diverse impostazioni. Le impostazioni disponibili da cambiare variano a seconda della quale categoria scelta nella lista verticale sul lato sinistro della finestra. Per mezzo di tre pulsanti lungo la base della finestra l'utente può controllare il processo.

Si può invocare il sistema di Aiuto, accettare le impostazioni correnti e chiudere la finestra di dialogo con il pulsante OK o, con Annulla, annullare il processo. Le categorie Aspetto, Caratteri e colori, Modifica, Apri e salva e Estensioni sono descritte sotto.

## Configurazione del componente editor

Questo gruppo contiene tutte le pagine relative al componente editor di &kappname; 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

#### Generale

A capo automatico dinamico

- Se quest'opzione è marcata, le righe proseguiranno a capo quando raggiungeranno il bordo della finestra sullo schermo.

  Indicatori di a capo automatico dinamico (se applicabile)

- Scegli quando mostrare gli indicatori di a capo automatico dinamico, Spenti, Dopo i numeri di riga o Sempre attivi.

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

- Abilita l'allineamento verticale delle righe mandate a capo dinamicamente al livello di rientro della prima riga. Ciò può aiutare a rendere il codice e i marcatori più leggibili.

  Inoltre permette di impostare la massima larghezza dello schermo come percentuale, dopo la quale le righe andate a capo dinamicamente non saranno più allineate verticalmente. Ad esempio, a 50%, le righe il cui livello di rientro è più profondo del 50% della larghezza dello schermo non saranno allineate verticalmente alle seguenti righe andate a capo automaticamente.

Evidenziazione degli spazi

- Evidenzia le tabulazioni

- L'editor mostra un simbolo » per indicare la presenza di una tabulazione nel testo.

Evidenziazione degli spazi finali

- L'editor mostrerà dei punti per indicare la presenza di spazi finali in fondo alle righe.

Dimensione marcatore di evidenziazione

- Usa il cursore per modificare la dimensione del marcatore di evidenziazione visibile.

Avanzate

- Mostra righe di rientro

- Se marcata, l'editor mostrerà delle righe verticali per favorire l'identificazione delle righe rientrate.

Evidenzia intervallo tra parentesi selezionate

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

Anima le parentesi corrispondenti

- Se abilitato, un passaggio sopra le parentesi ({, [, ], },( or )) animerà rapidamente la parentesi corrispondente.

Contrai la prima riga

- Se abilitato, la prima riga è contratta, se possibile. Questo è utile se il file inizia con un commento, ad esempio un copyright.

Mostra il conteggio delle parole

- Visualizza il numero di parole e di caratteri nel documento e nella selezione corrente nella barra di stato. Questa opzione è disponibile anche nel menu contestuale della barra di stato.

Mostra il numero delle righe

- Visualizza nella barra di stato il numero totale delle righe del documento. Questa opzione è disponibile anche nel menu contestuale della barra di stato.

#### Bordi

Bordi

- Mostra segni di raggruppamento

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

Mostra l'anteprima del codice ripiegato

- Se marcata, l'anteprima del testo ripiegato viene mostrata in una finestra a comparsa al passaggio sopra ad una regione ripiegata

Mostra bordo per le icone

- Se marcata, sarà visualizzato sul lato sinistro un bordo per le icone. Il bordo per le icone mostra, ad esempio, i marcatori dei segnalibri.

Mostra numeri di riga

- Se marcata, sul lato sinistro saranno visualizzati i numeri di riga.

Mostra segni di modifica delle righe

- Se attivata, saranno visibili i segni di modifica delle righe. Per maggiori informazioni, vedi kate-part-line-modification.

Mostra i segni nella barra di scorrimento

- Se questa opzione è marcata la vista attuale mostrerà indicatori sulla barra di scorrimento verticale. Questi segni possono mostrare, ad esempio, i segnalibri.

Mostra l'anteprima del testo nella barra di scorrimento

- Se questa opzione è marcata e passi con il cursore del mouse sopra la barra di scorrimento, verrà visualizzata una piccola anteprima del testo di alcune righe intorno la posizione del cursore. Questo ti permette di passare rapidamente ad un'altra parte del documento.

Mostra minimappa di scorrimento

- Se questa opzione è selezionata, ogni nuova vista mostrerà una minimappa del documento sulla barra di scorrimento verticale.

  Per maggiori informazioni sulla minimappa di scorrimento, vedi kate-part-scrollbar-minimap.

Larghezza della minimappa

- Regola la larghezza della minimappa di scorrimento, definita in pixel.

Visibilità delle barre di scorrimento

- Attiva le barre di scorrimento, disattivale o mostrale solo se sono necessarie. Fai clic con il &LMB; sul rettangolo blu per visualizzare l'intervallo del numero di righe del documento che sono visualizzate sullo schermo. Tieni il &LMB; premuto al di fuori del rettangolo blu per scorrere automaticamente il documento

Ordina il menu dei segnalibri

- Per creazione

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

Per posizione

- I segnalibri saranno ordinati a seconda dei numeri di riga a cui sono collocati.

### Caratteri e colori

Questa sezione della finestra permette di configurare tutti i caratteri e i colori in qualsiasi schema di colori, oltre a creare nuovi schemi o eliminare quelli esistenti. Ciascuno schema ha impostazioni per i colori, i tipi di carattere e per gli stili di evidenziazione del testo.

&kappname; preselezionerà lo schema attualmente attivo. Se si vuole lavorare su uno schema diverso si inizia selezionandolo dalla casella combinata Schema. Con i pulsanti Nuovo e Elimina si possono creare nuovi schemi e cancellare quelli esistenti.

Nella parte bassa della pagina si può selezionare lo schema predefinito per &kappname;.

Normalmente, &kappname; baserà il suo schema di colori su quello attuale di &kde;. Puoi riportare un singolo colore al suo valore predefinito facendo clic sulla freccia di azzeramento a destra della sua voce nell'editor dei colori, o puoi riportare tutti i colori ai loro valori predefiniti facendo clic su Usa lo schema di colori di &kde; in fondo al pannello.

Puoi regolare lo schema di colori di &kde; nel modulo Colori delle &systemsettings;.

#### Colori

Colori di sfondo dell'editor

- Area di testo

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

Testo selezionato

- Il colore di sfondo del testo selezionato. Il valore predefinito è il colore globale della selezione, così come è configurato dalle preferenze dei colori di &kde;.

Riga attuale

- Imposta il colore della riga attuale. Se è un po' diverso da quello del testo normale, permette di tenere l'attenzione sulla riga.

Evidenziazione delle ricerche

- Imposta il colore del testo che corrisponde all'ultima ricerca.

Evidenziazione delle sostituzioni

- Imposta il colore del testo che corrisponde all'ultima operazione di sostituzione.

Bordo delle icone

- Area di sfondo

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

Numeri di riga

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

Segno di ritorno a capo

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

Raggruppamento del codice

- Questo colore è usato per evidenziare la sezione di codice che sarebbe raggruppata al clic sulla freccia di raggruppamento a sinistra del documento Per maggiori informazioni, vedi la documentazione del raggruppamento del codice.

Righe modificate

- Questo colore viene usato per evidenziare indicare, alla sinistra di un documento, le righe che sono state modificate ma non ancora salvate.Per maggiori informazioni, vedi kate-part-line-modification.

Righe salvate

- Questo colore viene usato per evidenziare indicare, alla sinistra di un documento, le righe che sono state modificate e salvate in questa sessione. Per maggiori informazioni, vedi kate-part-line-modification.

Decorazioni del testo

- Linea degli errori di ortografia

- Questo colore si usa per indicare gli errori di ortografia.

Segni di tabulazione e spazio

- Questo colore è usato per gli indicatori di spazi bianchi, quando sono abilitati.

Linea di rientro

- Questo colore viene usato per disegnare una linea alla sinistra dei blocchi rientrati, se questa funzionalità è abilitata.

Evidenziazione delle parentesi

- Questo colore è usato per lo sfondo delle parentesi corrispondenti.

Colori degli indicatori

- Segnalibro

- Questo colore viene usato per indicare i segnalibri. Per maggiori informazioni, vedi kate-part-bookmarks.

Punto d'interruzione attivo

- Questo colore viene usato dall'estensione per GDB per indicare un punto d'interruzione attivo. Per maggiori informazioni, vedi la documentazione dell'estensione per GDB.

Punto d'interruzione raggiunto

- Questo colore viene usato dall'estensione per GDB per indicare un punto d'interruzione raggiunto durante il debugging. Per maggiori informazioni, vedi la documentazione dell'estensione per GDB.

Punto d'interruzione disabilitato

- Questo colore viene usato dall'estensione per GDB per indicare un punto d'interruzione inattivo. Per maggiori informazioni, vedi la documentazione dell'estensione per GDB.

Esecuzione

- Questo colore viene usato dall'estensione per GDB per indicare la riga attualmente in esecuzione. Per maggiori informazioni, vedi la documentazione dell'estensione per GDB.

Avviso

- Questo colore viene usato dall'estensione di generazione per indicare una riga che ha causato un avviso del compilatore. Per maggiori informazioni, vedi la documentazione dell'estensione di generazione.

Errore

- Questo colore viene usato dall'estensione di generazione per indicare una riga che ha causato un errore del compilatore Per maggiori informazioni, vedi la documentazione dell'estensione di generazione.

Modelli e frammenti di testo

- Sfondo

- Questo colore è usato dall'estensione dei frammenti di &kate; per colorare lo sfondo di un frammento.

Segnaposto modificabile

- Questo colore viene usato dall'estensione dei frammenti di &kate; per segnare un segnaposto modificabile con un clic.

Segnaposto modificabile attivo

- Questo colore viene usato dall'estensione dei frammenti di &kate; per segnare il segnaposto che stai attualmente modificando.

Segnaposto non modificabile

- Questo colore viene usato dall'estensione dei frammenti di &kate; per segnare un segnaposto non modificabile manualmente, per esempio uno che viene determinato automaticamente. Per maggiori informazioni, vedi la documentazione dei frammenti di &kate;.

Usa lo schema di colori di &kde;

- Fare clic su questo pulsante imposterà tutti i colori sopra definiti secondo lo schema di colori attualmente definito nelle &systemsettings; di &kde;. Per maggiori informazioni, vedi la documentazione del modulo di controllo dei colori di &kde;.

  Se non usi gli spazi di lavoro &plasma; di &kde;, questo pulsante non avrà effetto, e potrebbe non essere presente.

#### Carattere

Qui si può scegliere il tipo di carattere dello schema. Si può scegliere fra tutti i tipi di carattere disponibili nel sistema, ed impostare la dimensione predefinita. Un testo di esempio è mostrato nella parte inferiore della finestra, per vedere gli effetti delle modifiche.

Per maggiori informazioni su come selezionare un carattere, vedi la sezione Scegliere i caratteri della documentazione sui Fondamentali di &kde;.

#### Stili di testo predefiniti

Gli stili di testo predefiniti 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 della lista di stili usa lo stile configurato per tale elemento, fornendo un'anteprima quando si configura lo 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 di testo evidenziato

Qui si possono modificare gli stili del testo usati per una specifica definizione di evidenziazione. L'editor preseleziona l'evidenziazione usata per il documento attuale. Per modificare un'evidenziazione diversa, selezionarne una dalla casella combinata Evidenziazione sopra l'elenco degli stili.

Il nome della lista di stili usa lo stile configurato per tale elemento, fornendo un'anteprima quando si configura lo 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 è.

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

### Modifica

#### Generale

A capo automatico statico

- L'a capo automatico è una funzionalità che fa iniziare automaticamente all'editor una nuova riga di testo e sposta il cursore all'inizio di quella nuova riga. &kappname; comincerà automaticamente una nuova riga di testo quando la riga corrente raggiungerà la lunghezza specificata dall'opzione Colonna a cui andare a capo.

  Abilita a capo automatico statico

- Attiva o disattiva l'a capo automatico statico.

Mostra indicatore di a capo statico (se applicabile)

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

Colonna a cui andare a capo:

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

Modalità di inserimento

- La modalità di inserimento selezionata sarà abilitata quando si aprirà una nuova vista. Puoi sempre attivare o disattivare la modalità di inserimento Vi per una vista particolare nel menu Modifica.

Parentesi automatiche

- Quando l'utente digita una parentesi sinistra ([, (, o {) &kappname; inserirà automaticamente la parentesi destra (}, ) o ]) alla destra del cursore.

  Quando c'è del testo selezionato, la digitazione di uno dei caratteri spezza il testo selezionato.

Copia e incolla

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

- Se questa opzione è abilitata e la selezione è vuota, le operazioni di copia e taglia sono effettuate sulla riga in cui si trova il cursore.

#### Navigazione del testo

Movimento del cursore di testo

- Home e Fine intelligenti

- Se è marcato, la pressione del tasto Home farà saltare al cursore gli spazi bianchi e lo farà posizionare all'inizio del testo della riga.

PagSu e PagGiù spostano il cursore

- Questa opzione cambia il comportamento del cursore quando l'utente preme il tasto Pag Su o Pag Giù. Se non è selezionato, il cursore del testo manterrà la sua posizione relativamente al testo visibile in &kappname;, quando del nuovo testo diventerà visibile come risultato dell'operazione. Così se il cursore è al centro del testo visibile, quando avviene l'operazione, rimarrà lì (eccetto quando si raggiunge l'inizio o la fine). Quando questa opzione è selezionata, il primo tasto premuto causerà lo spostamento del cursore alla cima o alla base del testo visibile non appena si visualizza una nuova pagina di testo.

Centratura automatica del cursore:

- Imposta il numero di righe che, se possibile, devono rimanere visibili sopra e sotto il cursore.

Modalità di selezione del testo

- Normale

- Le selezioni vengono sovrascritte con il testo digitato e vanno perse quando si muove il cursore.

Persistente

- Le selezioni rimangono anche dopo lo spostamento del cursore e l'inserimento di testo.

Permetti di scorrere oltre la fine del documento

- Questa opzione ti permette di scorrere oltre la fine del documento. Può essere usato per centrare verticalmente la parte bassa del documento, o portarla nella parte alta della vista.

Il tasto Backspace rimuove la base del carattere con i suoi diacritici

- Se selezionato, i caratteri composti sono rimossi insieme ai loro diacritici invece di rimuovere solo la base del carattere. Utile per le localizzazioni indiane.

#### Rientro

Modalità di rientro predefinita:

- Seleziona la modalità di rientro automatico da usare come predefinita. Si raccomanda caldamente di impostare `Nessuno` o `Normale` e di utilizzare le configurazioni specifiche per tipo di file per impostare altre modalità di rientro per formati di testo come codice C/C++ o &XML;.

Rientra con

- Tabulazioni

- Quando abilitato, l'editor inserirà caratteri di tabulazione quando premi il tasto o usi il rientro automatico.

Spazi

- 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 o usi il rientro automatico.

Tabulazioni e spazi

- Quando abilitato, l'editor inserirà spazi come sopra descritto quando rientri o premi il tasto all'inizio di una riga, ma inserirà tabulazioni quando il testo viene premuto all'interno o alla fine di una riga.

Ampiezza delle tabulazioni:

- Configura il numero di spazi mostrati al posto di un carattere di tabulazione.

Larghezza del rientro:

- La larghezza del rientro è il numero di spazi usati per fare rientrare una riga. Se configurato per rientrare con le tabulazioni, viene inserito un carattere di tabulazione se il rientro è divisibile per l'ampiezza delle tabulazioni.

Regole di rientro

- Mantieni gli spazi di troppo

- Se questa opzione non è marcata, la modifica del livello di rientro allineerà le righe a multipli della larghezza specificata in Larghezza di rientro.

Regola il rientro del testo incollato dagli appunti

- Se questa opzione è marcata, il testo incollato dagli appunti sarà fatto rientrare. Si può rimuovere il rientro con il comando Annulla.

Azioni di rientro

- Il tasto Backspace nello spazio vuoto iniziale toglie il rientro

- Se è marcato, 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 si vuole che allinei la riga attuale nel blocco di codice attuale come in emacs, si può rendere una scorciatoia per l'azione Allinea.

  Avanza sempre alla prossima tabulazione

- Se è marcato, il tasto inserirà sempre spazio bianco in modo da raggiungere la prossima tabulazione. Se l'opzione Inserisci spazi invece di tabulazioni nella pagina Modifica è abilitata, vengono inseriti spazi; altrimenti, viene inserita una tabulazione.

Aumenta sempre il livello di rientro

- Se è marcato, il tasto farà rientrare sempre la riga corrente del numero di posizioni specificato in Larghezza di rientro.

Aumenta il livello di rientro se in uno spazio vuoto iniziale

- Se è marcato, il tasto farà rientrare la riga corrente o avanzerà alla prossima tabulazione. Se il punto di inserimento è sul primo carattere non di spaziatura della riga (o prima), o se c'è una selezione, la riga corrente verrà fatta rientrare del numero di posizioni specificato in Larghezza di rientro. Se il punto di inserimento è dopo il primo carattere non di spaziatura della linea e non c'è selezione, viene inserito dello spazio bianco in modo da raggiungere la prossima tabulazione: se l'opzione Inserisci spazi invece di tabulazioni nella scheda Generale della pagina Modifica è abilitata, vengono inseriti spazi; altrimenti, viene inserita una tabulazione.

#### Completamento delle parole

Generale

- Abilita il completamento delle parole

- Se è abilitato, si aprirà automaticamente un riquadro di completamento durante la digitazione, che visualizza un elenco di modi in cui è possibile completare il testo presente alla posizione del cursore.

Lunghezza minima delle parole da completare

- Mentre si digita, il completamento automatico cerca nel documento le parole che iniziano con i caratteri già digitati. Questa opzione permette di configurare il numero minimo di caratteri che bisogna digitare prima che il completamento automatico si attivi e visualizzi le corrispondenze trovate.

Rimuovi coda al completamento

- Rimuovi la coda di una parola precedente quando l'elemento di completamento viene scelto da un elenco.

Completamento delle parole

- Se abilitato, il completamento automatico integrato usa le parole chiave definite dall'evidenziazione della sintassi.

#### Controllo ortografico

Queste opzioni di configurazione sono spiegate nella documentazione del modulo Controllo ortografico di &systemsettings; .

#### Modalità di inserimento Vi

Generale

- Lascia che i comandi Vi abbiano precedenza su quelli di Kate

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

Visualizza i numeri di riga relativi

- Se abilitato, la riga attuale diventa la riga 0. Le righe sopra e sotto incrementano il numero relativamente.

Mappatura dei tasti

- La mappatura dei tasti è usata per cambiare il significato dei tasti mappati. Questo permette di spostare comandi su altri tasti o impostare dei tasti in modo da eseguire una serie di comandi.

  Esempio:

  F2 → I-- &Esc;

  Questo anteporrà un `I--` a una riga quando si preme F2.

### Apri e salva

#### Generale

Formato dei file

- Codifica

- Questo definisce la codifica normale da usare per aprire e salvare i file, se non viene modificata nelle finestre di apertura e salvataggio o usando un'opzione dalla riga di comando.

Rilevamento della codifica

- Selezionare un elemento dal menu a discesa, per disabilitare il rilevamento automatico o per usare Universale per abilitare il rilevamento automatico per tutte le codifiche. Dato che probabilmente rileverà solo utf-8/utf-16, è meglio selezionare una regione per poter indovinare meglio. Se né la codifica scelta come normale sopra, né quella specificata nella finestra di apertura e salvataggio, né quella specificata sulla riga di comando corrispondono ai contenuti del file, verrà usato 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 riga

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

Rilevamento automatico delle fini di riga

- Si può per far riconoscere automaticamente all'editor il tipo di fine riga. Il primo tipo di fine riga incontrato verrà usato per tutto il file.

Abilita il marcatore dell'ordine dei byte (BOM)

- Il marcatore dell'ordine dei byte è una sequenza speciale all'inizio dei documenti unicode. Permette ai programmi di aprire i documenti di testo con le impostazioni unicode corrette. Per maggiori informazioni, vedere Byte Order Mark.

Limite di lunghezza delle righe

- Sfortunatamente, a causa di mancanze dovute a &Qt;, &kappname; non funziona bene con righe estremamente lunghe. Per quel motivo, &kappname; manderà a capo automaticamente le righe più lunghe del numero di caratteri qui specificato. Per disattivarlo, impostalo a `0`.

Pulizia automatica al salvataggio

- Rimuovi gli spazi finali durante la scrittura

- L'editor eliminerà automaticamente gli spazi di troppo alla fine delle righe di testo durante il salvataggio del file. Puoi selezionare di non usare Mai questa funzionalità, o di usarla solo Sulle righe modificate dall'ultimo salvataggio del documento, o di rimuoverli incondizionatamente In tutto il documento.

Aggiungi un ritorno a capo alla fine del file al salvataggio

- L'editor aggiungerà automaticamente un ritorno a capo alla fine del file se non ce n'è già uno al momento del salvataggio.

#### Avanzate

Copia di sicurezza al quando si salva

- 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 è ~ ed il prefisso è vuoto.

  File locali

- Marcare la casella se si vuole una copia di sicurezza dei file locali quando si salva.

File remoti

- Marcare la casella se si vuole una copia di sicurezza dei file remoti quando si salva.

Prefisso

- Inserisci il prefisso per i nomi delle copie di sicurezza.

Suffisso

- Inserisci il suffisso per i nomi delle copie di sicurezza.

Opzioni dei file di swap

- &kappname; può recuperare (la maggior parte di) ciò che è stato scritto dall'ultimo salvataggio in caso di errore o caduta di corrente. Un file di swap (`.swp.<nome_file>`) viene creato alla prima azione di modifica di un documento. Se l'utente non salva le modifiche e &kappname; si impianta, il file di swap rimane sul disco. All'apertura di un file, &kappname; controlla se c'è un file di swap associato, e in tal caso chiede all'utente se vuole recuperare i dati persi o meno. L'utente ha anche la possibilità di vedere le differenze tra il file originale e quello recuperato. Il file di swap viene eliminato dopo ogni salvataggio e all'uscita normale dal programma.

  &kappname; sincronizza i file di swap sul disco ogni 15 secondi, ma solo se sono cambiati dall'ultima sincronizzazione. L'utente può scegliere di disabilitare la sincronizzazione, spuntando la casella Disabilita, ma ciò può portare a una perdita di dati maggiore.

  Quando abilitato, i file di swap sono salvati nella stessa cartella del file. Se viene scelta una Cartella alternativa i file di swap sono creati nella cartella specificata. Questo è utile nei filesystem di rete, per da evitare traffico di rete non necessario.

#### Modi e tipi di file

Questa pagina permette di modificare la configurazione predefinita per documenti aventi specifici tipi mime. Quando l'editor carica un documento, ne cerca la corrispondenza, tramite le maschere o i tipi mime, con un tipo di file conosciuto. Se viene trovata più di una corrispondenza verrà usata quella con la più alta priorità.

Tipo di file:

- Il tipo di file con la priorità più alta è quello mostrato nella prima casella combinata. Se vengono trovati più tipi di file, verranno mostrati tutti.

  Nuovo

- Questo si usa per creare un nuovo tipo di file. Dopo aver fatto clic su questo pulsante, i campi sottostanti si svuotano e si possono riempire con i dati appropriati per il nuovo tipo di file.

Elimina

- Per eliminare un tipo di file esistente, lo si seleziona dalla casella combinata e si preme il pulsante Elimina.

Proprietà del `tipo di file attuale`

- Il tipo di file con la priorità più alta è quello mostrato nella prima casella combinata. Se vengono trovati 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 Tipi di file

Sezione:

- Il nome della sezione è usato per organizzare i tipi di file nei menu. Può essere anche usato nel menu Strumenti Tipi di file.

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

  Premi Modifica per vedere un elenco di tutte le variabili possibili e le loro descrizioni. Spunta la casella a sinistra per abilitare una variabile in particolare e impostane quindi il valore sulla destra. Alcune variabili forniscono un menu a cascata per selezionarne i valori possibili, mentre altre permettono di inserire un valore valido manualmente.

  Per tutte le informazioni su queste variabili, vedi la configurazione delle variabili dei documenti.

Evidenziazione:

- Quando si crea un nuovo tipo di file, questa casella combinata permette di selezionare un tipo di file per l'evidenziazione.

Modalità di indentazione:

- Il menu a discesa permette di specificare la modalità di indentazione per i nuovi documenti.

Estensioni dei file:

- La maschera per i caratteri jolly permette di selezionare i file per nome. Una tipica maschera 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 consente di scegliere facilmente i tipi MIME.

Priorità:

- Imposta una priorità per questo tipo di file. Se uno stesso file è associato a più di un tipo di file, verrà utilizzato quello con priorità più alta.

## Configurazione con le variabili dei documenti

Le variabili di &kappname; sono l'implementazione di &kappname; delle variabili dei documenti, simili ai file modeline di &Emacs; e di vi. Nella componente KatePart le righe hanno la seguente 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: replace-tabs on; indent-width 4; indent-mode cstyle;

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

Inoltre, le variabili dei documenti possono essere messe in un file chiamato `.kateconfig` in qualsiasi cartella, e le impostazioni configurate saranno applicate come se le modeline fossero inserite su ogni file nella cartella e nelle sue sottocartelle. Le variabili dei documenti in `.kateconfig` usano la stessa sintassi delle modeline, ma con delle opzioni estese.

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

&kappname; supporta la lettura delle configurazioni dai file `.editorconfig` se è installata la libreria editorconfig. &kappname; cerca automaticamente un `.editorconfig` quando apri un file, pur dando priorità ai file `.kateconfig`.

### Come &kappname; usa le variabili

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

- la configurazione globale;

- valori facoltativi di sessione;

- la configurazione Tipi di file;

- variabili del documento in `.kateconfig`;

- variabili del documento presenti nel documento stesso;

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

Come puoi vedere, le variabili del documento possono essere sostituite solo da modifiche fatte al momento dell'esecuzione. 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 &kappname; versione 5.38. 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

- Abilita l'inserimento automatico delle parentesi.

    auto-center-linesINT

- Imposta il numero di righe autocentranti.

    background-colorSTRING

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

    backspace-indentsBOOL

- Abilita o disabilita la rimozione del rientro alla pressione di &Backspace;.

    block-selectionBOOL

- Attiva o disattiva la selezione a blocchi.

    bom | byte-order-mark | byte-order-markerBOOL

- Attiva o disattiva il marcatore dell'ordine dei byte quando si salvano dei 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 dinamica.

    eol | end-of-lineSTRING

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

    folding-markersBOOL

- Attiva o disattiva la visualizzazione degli indicatori di raggruppamento.

    folding-previewBOOL

- Abilita l'anteprima del ripiegamento nei bordi dell'editor.

    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-pasted-textBOOL

- Attiva o disattiva la regolazione del rientro del testo incollato dagli appunti.

  Da: &kate; 3.11 (&kde; 4.11)

    indent-widthINT

- Imposta la larghezza del rientro.

    keep-extra-spacesBOOL

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

    line-numbersBOOL

- Attiva o disattiva la visualizzazione del numero di riga.

    newline-at-eofBOOL

- Aggiungi una riga vuota alla fine del file (EOF) al salvataggio del documento.

  Da: &kate; 3.9 (&kde; 4.9)

    overwrite-modeBOOL

- Attiva o disattiva la modalità sovrascrittura.

    persistent-selectionBOOL

- Attiva o disattiva la selezione persistente.

    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.

    remove-trailing-spacesSTRING

- Rimuove gli spazi finali durante il salvataggio del documento. Le opzioni valide sono:

  - `none`, `-` o `0`: non rimuovere mai gli spazi finali.

  - `modified`, `mod`, `+` o `1`: rimuovi gli spazi finali solo nelle righe modificate. Le righe modificate vengono evidenziate dal sistema di evidenziazione delle righe.

  - `all`, `*` o `2`: rimuovi gli spazi finali in tutto il documento.

  Da: &kde; 4.10.

    scrollbar-minimapBOOL

- Mostra minimappa di scorrimento.

    scrollbar-previewBOOL

- Mostra l'anteprima nella barra di scorrimento.

    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 navigazione all'inizio intelligente.

    tab-indentsBOOL

- Attiva o disattiva il rientro col tasto .

    tab-widthINT

- Imposta la larghezza a schermo del carattere di tabulazione.

    undo-stepsINT

- Imposta il numero di passi di annullamento da memorizzare.

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

    word-wrap-columnINT

- Imposta la larghezza dell'andata a capo dinamica.

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

### Opzioni estese nei file `.kateconfig`

&kappname; cerca sempre un file `.kateconfig` per i file locali (non per quelli remoti), inoltre è possibile impostare delle opzioni basate sui caratteri jolly (estensioni dei file) come segue:

    kate: tab-width 4; indent-width 4; replace-tabs on;
    kate-wildcard(*.xml): indent-width 2;
    kate-wildcard(Makefile): replace-tabs off;

In questo esempio tutti i file usano un valore di tab-width ed uno di indent-width di 4 spazi, e le tabulazioni sono sostituite con gli spazi. Tuttavia la larghezza di rientro è impostata a 2 spazi per tutti i file `*.xml` e i Makefile usano le tabulazioni, &ie; queste non sono sostituite dagli spazi.

I caratteri jolly sono separati da virgole, ad esempio puoi specificare più estensioni di file così:

    kate-wildcard(*.json;*.xml): indent-width 2;

Inoltre puoi usare il tipo MIME per associare certi file; ad esempio per indentare tutti i file sorgente C con 4 spazi puoi scrivere:

    kate-mimetype(text/x-c++src): indent-width 4;

Oltre al supporto nei file `.kateconfig` i caratteri jolly e le variabili dei documenti dipendenti dal tipo MIME sono anche supportati nel file stesso come commenti.