# 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 kate-part-line-modification.

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 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 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 color-themes-gui.

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

  Avanza sempre alla prossima tabulazione

- Se è spuntato, 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 è spuntato, il tasto 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 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, ⪚ 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, ⪚, 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 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.

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