&Anders.Lund; &Anders.Lund.mail;
Nicola
Ruggero
Traduzione della documentazione.
Luciano
Montanaro
Aggiornamento della traduzione per &kate; 2.5.6
Federico
Zenith

    federico.zenith@member.fsf.org

Aggiornamento per &kde; 4.3 e manutenzione

# Configurare &kate;

## Panoramica

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

La finestra di configurazione

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

Il menu Impostazioni

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

Il menu Visualizza

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

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

## La finestra di configurazione principale

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

La configurazione è divisa in due gruppi, cioè:

- Configurazione dell'applicazione

- Configurazione del componente editor

## La configurazione dell'applicazione &kate;

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

### La pagina Generale

Questa sezione contiene alcune opzioni globali di &kate;.

Comportamento
  Avverti se dei file vengono modificati da altri processi

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

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

Informazioni aggiuntive
  Ricorda le informazioni aggiuntive

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

  Elimina informazioni aggiuntive inutilizzate dopo

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

### La pagina Sessioni

Questa sezione contiene opzioni relative all'uso delle sessioni.

Elementi delle sessioni
  Includi la configurazione della finestra

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

Comportamento all'avvio dell'applicazione

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

  Avvia nuova sessione

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

  Carica l'ultima sessione usata

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

  Scegli a mano una sessione

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

Comportamento all'uscita dell'applicazione o al cambio di sessione
  Non salvare la sessione

    Le modifiche ai dati della sessione (i file aperti e la configurazione delle finestre, se abilitata) non saranno salvate. Naturalmente ti verrà chiesto cosa vuoi fare se hai dei file non salvati. Con questa opzione, puoi configurare le sessioni una volta per tutte, e non doverti preoccupare di altri file aperti che non vuoi rivedere la prossima volta che usi la sessione.

  Salva sessione

    &kate; salverà i dati della sessione, a meno che la sessione sia anonima. Con questa opzione, le sessioni sono sempre ripristinate come le hai lasciate. Questo è il comportamento predefinito.

  Chiedi all'utente

    Ti verrà chiesto se vuoi salvare la sessione ogni volta che una sessione non anonima viene chiusa.

### La pagina Elenco dei documenti

Sfumature sfondo

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

Ordina per

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

### La pagina Plugin

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

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

### La pagina Selettore dei file

Barra

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

Sincronizzazione automatica

  Puoi fare in modo che il navigatore del filesystem vada automaticamente alla cartella contenente il documento attuale in caso di eventi particolari:

  - Quando un documento viene attivato, e

  - Quando il selettore dei file diventa visibile.

  Anche se scegli di non usare questa funzionalità, puoi sincronizzare a mano il navigatore con il documento attuale premendo il pulsante Cartella dei documenti attuale della barra degli strumenti.
Ricorda gli indirizzi

  Scegli quanto la lunghezza della cronologia di navigazione. Il navigatore ricorda solo i singoli percorsi, i duplicati sono esclusi.

Ricorda i filtri

  Scegli quanti filtri vuoi che siano ricordati. Vengono ricordati solo i singoli filtri, i duplicati sono esclusi.

Sessione

  Configura se il navigatore del filesystem debba ricordare l'indirizzo e l'ultimo filtro tra una sessione e l'altra.

### La pagina Terminale

Sincronizza automaticamente il terminale con il documento attuale quando possibile

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

### Strumenti esterni

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

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

#### Proprietà degli strumenti esterni

Etichetta

  Un'etichetta amichevole per il menu Strumenti esterni.

Script

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

  %URL

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

  %URLS

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

  %directory

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

  %filename

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

  %line

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

  %column

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

  %selection

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

  %text

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

Eseguibile

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

Tipi MIME

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

Salva

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

Nome della riga di comando

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

## Configurazione del componente editor

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

### Aspetto

A capo automatico
  A capo automatico dinamico

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

  Indicatori di a capo automatico dinamico (se applicabile)

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

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

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

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

Bordi
  Mostra gli indicatori di raggruppamento

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

  Mostra bordo per le icone

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

  Mostra numeri di riga

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

  Mostra i segni nella barra di scorrimento

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

Ordina il menu dei segnalibri

  Per posizione

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

  Per creazione

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

Avanzate

  Abilita modalità per utenti esperti (modalità KDE 3)

    Questa opzione non ha alcun effetto in &kappname;.

  Mostra righe di indentazione

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

  Evidenzia intervallo tra parentesi selezionate

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

### Caratteri e colori

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

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

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

#### Colori

Sfondo area del testo
  Testo normale

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

  Testo selezionato

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

  Riga corrente

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

  Segnalibro

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

Elementi aggiuntivi
  Sfondo bordo sinistro

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

  Numeri di riga

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

  Evidenziazione parentesi

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

  Indicatori a capo automatico

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

  Segni di tabulazione e spazio

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

#### Carattere

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

#### Stili testo normale

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

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

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

#### Stili testo evidenziazione

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

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

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

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

### Modifica

#### Generale

Tabulazioni
  Inserisci spazi invece delle tabulazioni

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

  Evidenzia le tabulazioni

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

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

  Ampiezza delle tabulazioni

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

A capo automatico statico

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

  Abilita a capo automatico statico

    Attiva o disattiva l'a capo automatico statico.

  Mostra indicatori di a capo automatico statico (se applicabili)

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

  Colonna a cui andare a capo:

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

Varie
  Rimuovi gli spazi finali durante la scrittura

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

  Evidenziazione degli spazi finali

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

  Parentesi automatiche

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

#### Cursore e selezione

Spostamento cursore testo
  Home e Fine intelligenti

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

  Cursore a capo

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

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

  PaginaSu/PaginaGiù sposta il cursore

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

  Centratura automatica del cursore (righe):

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

Modalità di selezione del testo
  Normale

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

  Persistente

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

#### Indentazione

Modalità di indentazione predefinita:

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

Regole di indentazione
  Larghezza dell'indentazione:

    La larghezza dell'indentazione è il numero di spazi usati per indentare una riga. Se l'opzione Inserisci spazi invece delle tabulazioni nella scheda Generale della pagina Modifica non è attiva, viene inserito un carattere &Tab; se l'indentazione è divisibile per la larghezza delle tabulazioni.

  Mantieni gli spazi aggiuntivi

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

  Regola l'indentazione del codice incollato dagli appunti

    Se questa opzione è attivata, il codice incollato dagli appunti verrà indentato. Si può rimuovere l'indentazione usando il comando Annulla.

Azioni di indentazione
  Il tasto Backspace nello spazio vuoto iniziale toglie l'indentazione

    Se questa opzione è attivata, il tasto Backspace diminuisce il livello di indentazione 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, rendi &Tab; una scorciatoia per l'azione Allinea.

    Avanza sempre alla prossima tabulazione

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

    Aumenta sempre il livello di indentazione

      Se questa opzione è attivata, il tasto &Tab; indenterà sempre la riga attuale del numero di posizioni specificato in Larghezza dell'indentazione.

    Aumenta il livello di indentazione se in uno spazio vuoto iniziale

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

#### Completamento delle parole

Generale
  Completamento automatico abilitato

    Se questa opzione è abilitata, l'editor calcolerà il numero di spazi fino alla prossima tabulazione, come definita dalla larghezza di tabulazione, e inserirà quel numero di spazi o un carattere &Tab;.

### Apri/Salva

#### Generale

Formato file
  Codifica:

    Questo imposta la codifica predefinita dei file.

  Fine di riga:

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

  Rilevamento automatico dei fine riga

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

Pulizia automatica al salvataggio/caricamento
  Rimuovi gli spazi finali durante la scrittura

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

#### Avanzate

Cartella file di configurazione
  Profondità di ricerca del file di configurazione:

    L'editor cercherà il file di configurazione di &kappname; nel numero dato di livelli di cartelle verso l'alto, e da esso caricherà la riga delle impostazioni.

Copia di sicurezza al salvataggio

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

  File locali

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

  File remoti

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

  Prefisso

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

  Suffisso

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

#### Modalità e tipi di file

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

Tipo di file:

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

  Nuovo

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

  Elimina

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

Proprietà di tipo di file attuale

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

  Nome:

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

  Sezione:

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

  Variabili:

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

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

  Evidenziazione:

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

  Estensioni file:

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

  Tipi MIME:

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

  Priorità:

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

Scarica file di evidenziazione...

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

### Scorciatoie

Qui puoi cambiare la configurazione dei tasti di scorciatoia. Seleziona un'azione e fai clic su Personalizzato se vuoi una scorciatoia diversa per questa azione.

La riga di ricerca permette di cercare un'azione specifica e vederne la scorciatoia associata.

### Estensioni

La scheda Estensioni elenca tutte le estensioni disponibili, tra cui puoi spuntare tutte quelle che vuoi usare. Fai clic sul pulsante Informazioni per aprire la finestra Informazioni su di un'estensione. Una volta che un'estensione è spuntata, l'eventuale pulsante Configura viene abilitato per configurare l'estensione evidenziata.

Le estensioni selezionate sono disponibili nel menu Strumenti.

## Configurazione con le variabili dei documenti

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

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

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

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

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

### Come &kate; usa le variabili

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

- la configurazione globale;

- valori opzionali di sessione;

- la configurazione Tipi di file;

- variabili del documento presenti nel documento stesso;

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

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

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

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

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

- INT - un numero intero

- STRING - qualsiasi altra cosa

#### Variabili disponibili

    auto-bracketsBOOL

  Attiva o disattiva l'inserimento automatico delle parentesi.

    auto-center-linesINT

  Imposta il numero di righe autocentranti.

    auto-insert-doxygenBOOL

  Attiva o disattiva l'inserimento dell'asterisco iniziale nei commenti Doxygen. Non ha effetto se non si usa l'indentazione automatica in stile C.

    background-colorSTRING

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

    backspace-indentsBOOL

  Attiva o disattiva l'indentazione col tasto Backspace.

    block-selectionBOOL

  Attiva o disattiva la selezione per blocchi.

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

    dynamic-word-wrapBOOL

  Attiva o disattiva l'andata a capo automatica dinamica.

    eol | end-of-lineSTRING

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

    encodingSTRING

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

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

    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.

    folding-markersBOOL

  Attiva o disattiva la visualizzazione degli indicatori di raggruppamento.

    indent-modeSTRING

  Imposta la modalità di indentazione automatica. Sono riconosciute le opzioni `none`, `normal`, `cstyle`, `csands`, `python` e `xml`. Vedi per i dettagli.

    indent-widthINT

  Imposta la larghezza dell'indentazione.

    keep-extra-spacesBOOL

  Imposta se tenere gli spazi aggiuntivi quando si calcola la larghezza dell'indentazione.

    keep-indent-profileBOOL

  Se assegni TRUE a questa variabile, viene impedito la disindentazione di un blocco se almeno una riga non ha indentazione.

    line-numbersBOOL

  Attiva o disattiva la visualizzazione del numero di riga.

    mixed-indentBOOL

  Attiva o disattiva l'indetazione mista in stile Emacs.

    overwrite-modeBOOL

  Attiva o disattiva la modalità sovrascrittura.

    persistent-selectionBOOL

  Attiva o disattiva la selezione persistente.

    remove-trailing-spaceBOOL

  Attiva o disattiva la ripulitura dinamica a fi di riga.

    replace-tabs-saveBOOL

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

    replace-tabsBOOL

  Attiva o disattiva la conversione dinamica di tabulazioni in spazi.

    replace-trailing-space-saveBOOL

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

    schemeSTRING

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

    selection-colorSTRING

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

    show-tabsBOOL

  Attiva o disattiva il carattere di tabulazione visibile.

    smart-homeBOOL

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

    space-indentBOOL

  Attiva o disattiva l'indentazione con spazi.

    tab-indentsBOOL

  Attiva o disattiva l'indentazione col tasto &Tab;.

    tab-widthINT

  Imposta la larghezza a schermo della tabulazione.

    undo-stepsINT

  Imposta il numero di annullamenti da ricordare.

    word-wrap-columnINT

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

    word-wrap-marker-colorSTRING

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

    word-wrapBOOL

  Attiva o disattiva l'andata a capo forzata.

    wrap-cursorBOOL

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