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

Puoi invocare il sistema di Aiuto, accettare le impostazioni correnti e chiudere la finestra di dialogo con il pulsante OK oppure, 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

Carattere dell'editor

  Qui puoi scegliere il tipo di carattere dell'editor di testo. È possibile scegliere qualsiasi carattere disponibile nel sistema ed impostare una dimensione predefinita. Un testo di esempio è mostrato nella parte inferiore della finestra, per valutare gli effetti delle tue scelte.

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

Mostra gli indicatori degli spazi
  Mai

    L'editor non mostrerà mai dei punti per indicare la presenza di spazi.

  Alla fine di una riga

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

  Sempre

    L'editor mostrerà sempre dei punti per indicare la presenza di spazi.

Dimensioni indicatore degli spazi

  Usa il cursore per modificare la dimensione del marcatore dell'indicatore visibile.

Mostra indicatori delle schede

  Se spuntato l'editor mostra un simbolo » per indicare la presenza di una tabulazione nel testo.

Verifica delle parentesi

  Evidenzia intervallo tra parentesi selezionate

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

  Mostra un'anteprima della parentesi aperta corrispondente

    Se abilitato, l'editor mostra un suggerimento della parentesi aperta corrispondente.

  Fai lampeggiare la parentesi corrispondente quando il cursore si sposta sull'altra parentesi della coppia

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

Mostra righe di rientro

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

Conteggi

  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.

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.

A capo automatico dinamico

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

  Ritorno a capo dinamico al marcatore di ritorno a capo statico

    Se abilitato, l'editor fa andare a capo dinamicamente nella posizione dell'andata a capo dinamica.

  Ignora i limiti delle parole per il ritorno a capo dinamico

    Se selezionato, l'editor non terrà conto dei limiti delle parole facendo andare a capo le righe di testo.

Indicatori dinamici di ritorno a capo

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

Rientra righe a capo

  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 righe seguenti che sono andate a capo automaticamente.

Moltiplicatore dell'altezza della linea

  Questo valore sarà moltiplicato per l'altezza della linea predefinita del carattere. Un valore di 1,0 significa che sarà utilizzata l'altezza predefinita.

#### Bordi

Raggruppamento dei blocchi di codice
  Mostra le frecce per contrarre i blocchi di codice

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

  Mostra un'anteprima del codice raggruppato al passaggio del puntatore

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

Visibilità delle frecce di espansione

  Cambia le frecce di espansione tra Mostra al passaggio del puntatore e Mostra sempre.

Lato sinistro
  Mostra i marcatori

    Se spuntata, 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 spuntata, sul lato sinistro saranno visualizzati i numeri di riga.

  Evidenzia le righe modificate e non salvate

    Se attivata, saranno visibili i segni di modifica delle righe. Per maggiori informazioni, vedi .

Barre di scorrimento
  Mostra i marcatori

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

  Mostra un'anteprima passando sulla barra di scorrimento

    Se questa opzione è spuntata 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.

Minimappa
  Mostra la minimappa

    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 .

  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 data di creazione

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

  Per numero di riga

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

### Temi di colori

Questa sezione della finestra ti permette di configurare tutti i colori in qualsiasi tema tu abbia, di creare nuovi schemi o di eliminare quelli esistenti, oppure semplicemente di Seguire lo schema di colori di sistema. Ciascuno schema ha le impostazioni per i colori, per i tipi di carattere e per gli stili del testo normale o evidenziato.

&kappname; preselezionerà per te il tema attualmente attivo. Se vuoi lavorare su uno schema diverso, inizia selezionandolo dalla casella combinata Seleziona tema. Con i pulsanti Copia ed Elimina puoi creare nuovi temi ed eliminare quelli esistenti.

È descritto nei dettagli in .

### Modifica

#### Generale

A capo automatico

  L'a capo automatico è una funzionalità che fa in modo che l'editor inizi automaticamente una nuova riga di testo spostando (a capo) il cursore all'inizio di quella nuova riga. &kappname; comincerà automaticamente una nuova riga di testo quando la riga attuale raggiungerà la lunghezza specificata dall'opzione Torna a capo dopo:.

  Ritorna a capo a una colonna prefissata

    Attiva o disattiva l'a capo automatico statico.

  Disegna una linea verticale alla colonna di ritorno a capo

    Se questa opzione è spuntata, 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 utilizzi un carattere a spaziatura fissa.

  Torna a capo dopo:

    Se l'opzione Ritorna a capo a una colonna prefissata è selezionata, questa voce determina la lunghezza (in caratteri) dopo la quale l'editor inizierà automaticamente una nuova riga.

Modalità di inserimento predefinita

  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

  Se l'opzione Chiudi automaticamente le parentesi quando si digita la parentesi aperta, quando l'utente digita una parentesi sinistra ([, (, o {) &kappname; inserirà automaticamente la parentesi destra (}, ) o ]) alla destra del cursore.

Caratteri di delimitazione

  È possibile selezionare i caratteri di delimitazione usando l'elenco a tendina corrispondente.

  Quando il testo è selezionato, la digitazione di uno di questi caratteri spezza il testo selezionato.

Copia e incolla
  Sposta il testo selezionato con il trascinamento

    Questa opzione abilita il trascinamento del testo selezionato nella finestra dell'editor.

  Copia/taglia la riga attuale senza un testo selezionato

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

  Non spostare il cursore del testo quando si incolla con il mouse

    Se questa opzione è abilitata e incolli del testo nella finestra dell'editor con un clic sul &MMB;, &kappname; non sposterà il cursore del testo alla posizione in cui hai fatto clic.

#### Navigazione del testo

Movimento del cursore di testo
  Home e Fine intelligenti

    Se è spuntato, 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 &PgUp; o &PgDn;. 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.

  Abilita il movimento del cursore sulla notazione delle maiuscole a cammello

    Questa opzione modifica il comportamento del cursore quando l'utente preme la scorciatoia &Ctrl;Freccia sinistra or &Ctrl;Freccia destra. Se non è selezionata il cursore salta parole intere, mentre se lo è il cursore si interrompe sulle gobbe della notazione delle maiuscole a cammello.

  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.

Modificatore multi cursore

  Questa opzione ti permette di impostare il modificatore che verrà usato per creare più cursori con un clic del &LMB;: devi premerlo e fare clic sul &LMB; per creare un cursore alla posizione desiderata. Vedi Creazione di più cursori per scoprire altre modalità per creare più cursori.

#### 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 &Tab; 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 &Tab; o usi il rientro automatico.

  Tabulazioni e spazi

    Quando abilitato, l'editor inserirà spazi come sopra descritto quando rientri o premi il tasto &Tab; all'inizio di una riga, ma inserirà tabulazioni quando il testo &Tab; 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 è spuntata, 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 è spuntata, il testo incollato dagli appunti verrà fatto rientrare. Puoi rimuovere il rientro con il comando Annulla.

Azioni di rientro
  Il tasto Backspace nello spazio vuoto iniziale toglie il rientro

    Se è spuntato, 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 &Tab; allinei la riga attuale nel blocco di codice attuale come in &Emacs;, puoi rendere &Tab; una scorciatoia per l'azione Rientro formato.

    Avanza sempre alla prossima tabulazione

      Se è spuntato, il tasto &Tab; 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 è spuntato, il tasto &Tab; farà rientrare sempre la riga attuale del numero di posizioni specificato in Larghezza di rientro.

    Aumenta il livello di rientro se in uno spazio vuoto iniziale

      Se è spuntato, il tasto &Tab; 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), 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.

  Seleziona automaticamente la prima voce di completamento

    Se abilitato, la prima voce di completamento automatico viene sempre preselezionata, così da poter essere inserita con &Enter;. Se non vuoi questo comportamento, &eg; se vuoi premere &Enter; solo per inserire una nuova riga, disabilita questo elemento.

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. Puoi scegliere tra &UNIX;, DOS/&Windows; oppure Macintosh.

  Rilevamento automatico delle fini di riga

    Spuntalo se vuoi che l'editor riconosca automaticamente 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.

Abilita il salvataggio automatico (solo file locali)

  Spuntalo se vuoi che l'editor salvi automaticamente i documenti mentre ci stai lavorando.

  Salva automaticamente il documento quando il fuoco lascia l'editor

    L'editor salverà automaticamente i documenti quando passi ad un elemento al di fuori di esso, &eg;, il pannello del terminale di &kate;.

  Intervallo di salvataggio automatico

    Qui puoi determinare l'intervallo per il salvataggio automatico in secondi: se è 0, il documento non verrà salvato automaticamente dopo tale intervallo.

#### Avanzate

Scrivi una copia di sicurezza al salvataggio di

  La copia di sicurezza al salvataggio fa copiare a &kappname; il file su disco (la sua versione precedentemente salvata) in <prefisso><nomefile><suffisso> prima di salvare le nuove modifiche. Una copia di sicurezza può aiutarti a recuperare il lavoro se qualcosa va storto nel salvataggio, oppure se in seguito vuoi recuperare la versione precedente al salvataggio. Il suffisso predefinito è ~, ed il prefisso è vuoto.

  File locali

    Spunta la casella se vuoi una copia di sicurezza dei file locali quando salvi.

  File remoti

    Spunta la casella se vuoi una copia di sicurezza dei file remoti quando salvi.

  Prefisso per le copie di sicurezza

    Inserisci il prefisso per i nomi delle copie di sicurezza.

  Suffisso per le copie di sicurezza

    Inserisci il suffisso per i nomi delle copie di sicurezza.

  Modalità file di swap

    &kappname; può recuperare (la maggior parte) del lavoro non salvato in caso di arresto anomalo o di mancanza di corrente. Quando un documento viene modificato viene creato un file di swap (.<nomefile>.kate-swp): se l'utente non salva le modifiche e &kappname; subisce un arresto anomalo, questo rimane invece sul disco. All'apertura di un file &kappname; controlla se c'è un file di swap associato: in caso affermativo chiede all'utente se voglia o meno recuperare i dati persi. C'è anche la possibilità di vedere le differenze tra il file originale e quello recuperato. Il file di swap viene eliminato dopo ogni salvataggio, e alla normale uscita 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 il file di swap è abilitato, è possibile passare tra due modalità, chiamate Abilitata, archivia nella cartella predefinita e Abilitata, archivia in una cartella personalizzata.

  Archivia i file di swap in

    Per impostazione predefinita i file di swap vengono salvati nella stessa cartella del file. Se viene come modalità di file di swap viene scelta Abilitata, archivia in una cartella personalizzata, essi vengono creati nella cartella specificata. Questo è utile nei filesystem di rete, per evitare del traffico di rete non necessario.

  Salva file di swap ogni

    &kappname; sincronizza i file di swap sul disco ogni 15 secondi, ma solo se sono cambiati dall'ultima sincronizzazione. Ad ogni modo puoi scegliere un intervallo di sincronizzazione a tuo piacimento.

#### 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 viene usato per creare un nuovo tipo di file. Se fai clic su questo pulsante i campi sottostanti si svuotano, quindi possono essere riempiti con i dati appropriati per il nuovo tipo di file.

  Elimina

    Per eliminare un tipo di file esistente, selezionalo dalla casella combinata e premi 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 nel menu Strumenti Tipi di file

  Sezione:

    Il nome della sezione viene 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 &MIME; 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 da cui selezionarne i valori possibili, mentre altre richiedono che tu inserisca manualmente un valore valido.

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

  Evidenziazione:

    Quando crei un nuovo tipo di file, questa casella combinata ti 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 in questi posti (nell'ordine):

- nella configurazione globale;

- nei valori facoltativi di sessione;

- nella configurazione Tipi di file;

- nelle variabili del documento in `.kateconfig;`

- nelle variabili del documento presenti nel documento stesso;

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

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

    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; &eg; 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.