&Anders.Lund; &Anders.Lund.mail;
Nicola
Ruggero

    nicola@nxnt.org

Traduzione della documentazione.
Luciano
Montanaro

    mikelima@cirulla.net

Aggiornamento della traduzione per &kate; 2.5.6

# Configurare &kate;

## Panoramica

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

La finestra di dialogo della Configurazione

  Lo strumento principale di configurazione ti permette di configurare l'applicazione &kate;, i componenti dell'editor e l'uso dei plugin.

Il menu Impostazioni

  Ti permette di cambiare le impostazioni usate più spesso e ti permette di aprire la finestra di dialogo della configurazione.

Il menu Visualizza

  Ti permette di dividere la finestra in cui lavori, visualizzare le icone e visualizzare il pannello con la numerazione di riga per documento che stai modificando.

La &konsole; integrata sta usando la configurazione definita nel &kcontrolcenter;, e può essere riconfigurata facendo clic con il pulsante destro del mouse e scegliendo Impostazioni dal sotto menu.

## La finestra principale di configurazione

La finestra di dialogo di &kate; mostra un menu ad albero, con varie voci sulla sinistra e a destra la pagina di configurazione corrispondente alla voce di destra.

La configurazione è divisa in due gruppi, rispettivamente

- Configurazione dell'applicazione

- Configurazione della componente dell'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;

Mostra l'intero percorso nel titolo

  Se è abilitata, Kate mostrerà l'URL completo del documento attuale nell titolo della finestra, invece del solo nome.

Comportamento
  Sincronizza l'emulatore di terminale con il documento attivo

    Questa opzione farà in modo che la &konsole; integrata cambi directory con il comando `cd` in modo tale da posizionarsi nella stessa directory del documento attivo. Questa opzione ha effetto sia all'apertura di un documento sia quando un nuovo documento va in primo piano. Se l'opzione non è attivata, devi cambiare directory manualmente nella &konsole;.

  Avverti se un file è modificato da un processo estraneo

    Se questa opzione è abilitata, &kate; ti avvertirà se dei file sono stati modificati al di fuori dell'applicazione quando la finestra principale è focalizzata. Potrai dover gestire più file modificati contemporaneamente, e potrai scegliere se ricaricare, salvare o scartare i file modificati in gruppi.

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

Dati aggiuntivi
  Ricorda le meta-informazioni

    Se questa opzione è abilitata &kate; memorizzerà i metadati come i segnalibri e la configurazione della sessione anche quando chiudi i documenti. I dati saranno usati se il documento non è stato cambiato prima di essere riaperto.

  Elimina meta informazioni inutilizzate dopo

    Imposta il massimo numero di giorni per cui conservare le meta-informazioni per i file non aperti. Ciò permette di mantenere la base dati delle meta-informazioni 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 annullata specificando che 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 utilizzata

    &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

    e modifiche ai dati della sessione (i file aperti, e, se abilitata, la configurazione delle finestre) non saranno salvate. Naturalmente verrai interpellato se hai dei file non salvati. Con questa opzione, puoi configurare la sessione una volta ed evitare di dover chiudere i file extra che ha aperto per non vederli aperti al successivo uso della sessione.

  Salva sessione

    &kate; salverà i dati di sessione, a meno che la sessione sia senza nome. 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 che ha un nome viene chiusa.

### La pagina Selettore dei file

Barra degli strumenti

  Configura i pulsanti della barra del gestore dei file spostando quelli desiderati sulla lista Azioni attuali, ed ordinali usando i pulsanti con le frecce a lato della lista.

Sincronizzazione automatica

  Puoi fare in modo che il navigatore del filesystem si posizioni automaticamente sulla directory contenente il documento attuale in caso di eventi particolari:

  - Quando un documento diventa quello attivo.

  - Quando il browser del filesystem diventa visibile.

  Anche se scegli di non usare questa funzione, puoi sincronizzare a mano il navigatore con il documento attuale premendo il pulsante Sincronizza della barra degli strumenti.
Ricorda gli indirizzi

  Scegli quanto deve essere lunga la cronologia della navigazione. Il navigatore ricorda solo i percorsi individuali, i duplicati sono esclusi.

Ricorda i filtri

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

Sessione

  Configura se il navigatore del file system debba ricordare le posizioni ed i filtri da una sessione all'altra.

### La pagina Lista documenti

Sfumature sfondo

  Questa sezione permette di abilitare e disabilitare la visualizzazione dell'ombreggiatura dello sfondo delle tue attività recenti, e di scegliere quali colori usare se la abiliti. Vedi la sezione La lista 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; dalla lista dei documenti.

### La pagina Plugin

Questa pagina fornisce un elenco dei plugin installati in &kate;. Ciascun plugin è rappresentato con il nome ed una breve descrizione. Puoi marcare la casella di una voce per abilitare il plugin che rappresenta.

Se un plugin fornisce opzioni di configurazione apparirà una sezione per l'accesso ad esse.

### Strumenti esterni

Nel menu Strumenti c'è un sottomenu chiamato Strumenti esterni. Questi strumenti invocano applicazioni esterne con i dati correlati al documento esterno, ad esempio il suo URL, la directory, il testo o la selezione. Questa pagina permette di gestire il menu e modificare, eliminare o aggiungere nuovi strumenti.

Ciascuno strumento esterno è un comando di shell che contiene delle macro rappresentanti i dati del documento. Quando viene attivato, le macro vengono sostituite dai dati del documento attivo.

#### Proprietà degli strumenti esterni

Etichetta

  Un'etichetta amichevole per il menu degli 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 dei documenti aperti (esclusi quelli non salvati).

  %directory

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

  %filename

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

  %line

    Il numero di riga del cursore di inserimento nel documento attuale.

  %column

    Il numero della colonna del 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 della riga di comando permessa sul tuo sistema. Da usare con prudenza.

Eseguibile

  L'eseguibile principale è lo script. Questo è obbligatorio, ed è usato per provare se il comando può essere eseguito. UN percorso completamente qualificato è ammesso nel caso in cui l'eseguibile non sia fra i percorsi della variabile `PATH`.

Tipi MIME

  Una lista separata de punti e virgola dei tipi MIME per cui questo comando debba essere abilitato. Attualmente non è usata.

Salva

  Puoi scegliere di far salvare il documento corrente o tutti prima di eseguire lo script, se lo desideri. Ciò è utile se il tuo script legge il file da disco.

Nome da riga di comando

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

## Configurazione del componente dell'editor

Questo gruppo contiene tutte le pagine collegate con il componente dell'editor di &kate;. Quasi tutte le impostazioni sono quelle predefinite, che vengono sovrascritte dalla definizione di un tipo di file, dalle variabili dei documenti o cambiandole nel documento durante la sessione di modifica.

### Aspetto

A capo automatico
  A capo automatico dinamico

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

  Indicatori a capo automatico dinamico

    Scegli se gli indicatori di andata a capo automatico dinamico debbano essere visualizzati.

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

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

    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 indentazione è più profondo del 50% della larghezza dello schermo non avranno allineamento verticale applicato alle seguenti righe andate a capo automaticamente.

Raggruppamento codice
  Mostra gli indicatori di raggruppamento

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

Bordi
  Mostra bordo per le icone

    Se attivata, vedrai un bordo per le icone sul lato sinistro. Il bordo per le icone mostra, ad esempio, i marcatori dei 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à indicatori sulla barra di scorrimento verticale. Questi segni possono mostrare, ad esempio, i segnalibri.

Ordina il menu dei segnalibri

  Per posizione

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

  Per creazione

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

Mostra righe di indentazione

  Se attivato, l'editor mostrerà delle righe verticali per favorire l'identificazione delle righe indentate.

### 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 impostazioni per i colori, i tipi di carattere e per gli stili del testo normale ed evidenziato.

&kate; preselezionerà lo schema attualmente attivo, se vuoi lavorare su uno schema diverso inizia selezionandolo dalla casella combinata Schema.

#### Colori

Sfondo area del testo
  Testo normale

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

  Testo selezionato

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

  Riga corrente

    Imposta il colore della riga corrente. Se è un po' diverso da quello del testo normale, permette di tenere a fuoco la riga.

  Segnalibro

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

Elementi aggiuntivi
  Sfondo bordo sinistro

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

  Numeri di riga

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

  Evidenziazione parentesi

    Questo colore è usato per lo sfondo delle parentesi corrispondenti.

  Indicatori a capo automatico

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

  Marcatori di tabulazione

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

#### Tipi di carattere

Qui puoi scegliere il tipo di carattere dello schema. Puoi scegliere fra tutti i tipi di carattere disponibili nel sistema, ed impostare la dimensione predefinita. Un testo di esempio è mostrato nella parte inferiore della finestra, per darti un'idea dell'effetto della tua scelta.

#### Stili testo normale

Lo stile di testo normale è ereditato dagli stili di evidenziazione del testo; ciò permette all'editor di presentare il testo in modo coerente, ad esempio, il testo dei commenti è uguale in quasi tutti i formati di testo che &kate; può evidenziare.

Il nome della lista di stili usa lo stile configurato per tale elemento, fornendoti un'anteprima quando configuri lo stile.

Ogni stile permette di selezionare degli attributi comuni oltre ai colori di sfondo e primo piano. Per rimuovere l'impostazione del colore di sfondo, fai clic con il tasto destro 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 per il documento attuale. Per lavorare con un'evidenziazione diversa, selezionane una dalla casella combinata Evidenziazione sopra l'elenco di stili.

Il nome della lista di stili usa lo stile configurato per tale elemento, fornendoti un'anteprima quando configuri lo stile.

Ciascuno stile permette di selezionare attributi comuni oltre ai colori di sfondo e primo piano. Per eliminare il colore di sfondo, fai clic con il tasto destro per usare il menu contestuale. Inoltre puoi vedere se uno stile è uguale a quello predefinito dell'elemento, ed assegnarlo ad esso se non lo è.

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

### Cursore e selezione

Spostamento cursore testo
  Home e Fine intelligenti

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

  Cursore a capo

    Quando è attiva, l'uso dei tasti freccia a sinistra e freccia a destra sul cursore di inserimento ne causerà lo sposterà alla riga precedente/successiva all'inizio/fine della riga, come nella maggior parte degli editor.

    Quando non è attiva, il cursore di inserimento non può essere spostato a sinistra dell'inizio di una riga, ma può esserlo oltre la fine di una riga, funzione molto comoda per i programmatori. Quando questa opzione viene scelta, spostare il cursore con il tasto freccia destra oltre la fine di una riga (a destra) lo farà saltare all'inizio della successiva.Allo stesso modo quando il cursore è mosso indietro oltre l'inizio di una riga (a sinistra) salterà alla fine della riga precedente. Quando questa opzione non è selezionata, spostare il cursore a destra dopo la fine della riga, lo farà soltanto continuare orizzontalmente sulla stessa riga e cercare di muoverlo 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 PaginaSu o il tasto PaginaGiù. Se non è selezionato il cursore del testo manterrà la sua posizione relativamente al testo visibile in &kate;, 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.

  Centramento automatico cursore (righe):

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

Modalità di selezione
  Normale

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

  Permanente

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

### Modifica

Tabulazioni
  Inserisci spazi invece delle tabulazioni

    Quando questa opzione è abilitata, l'editor inserirà un numero appropriato di spazi a seconda della posizione del testo e dell'ampiezza delle tabulazioni (`tab-width`) quando premi il tasto Tab.

  Mostra le tabulazioni

    Quando questa voce è abilitata, &kate; mostra un puntino come rappresentazione visibile di un carattere di tabulazione.

    Mostra anche dei puntini per gli spazi bianchi in fondo alle riga. Ciò verrà corretto in una futura versione di &kate;

  Larghezza tabulazioni

    Se l'opzione Inserisci spazi invece delle tabulazioni è selezionata questa casella determina il numero di spazi con cui l'editor sostituirà le tabulazioni.

A capo automatico statico

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

  Abilita a capo automatico statico

    Attiva o disattiva l'a capo automatico statico.

  Mostra indicatori a capo automatico statico (se possibile)

    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 utilizzi un font a spaziatura fissa.

  Colonna a cui andare a capo:

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

Rimuovi gli spazi finali

  &kate; eliminerà automaticamente gli spazi extra alla fine delle righe di testo.

Parentesi automatiche

  Quando l'utente scrive una parentesi aperta ([, ( o {) &kate; inserisce automaticamente la parentesi chiusa corrispondente (}, ) o ]) alla destra del cursore.

Massimo numero diannullamenti:

  Qui l'utente può specificare il numero di azioni che &kate; terrà in memoria allo scopo di azioni di annulla. Ciò significa che più alto è il numero di azioni, più memoria &kate; userà per questo. Impostare questa voce a 10 significherebbe che l'utente sarebbe in grado di revocare le ultime dieci operazioni, cioè facendo clic 10 volte sul pulsante di annulla e ottenendo i risultati.

Fonte del testo da cercare:

  Questa opzione determina la fonte da cui &kate; prenderà il testo da cercare, cioè il testo inserito automaticamente nella finestra Trova testo:

  - Nessuna: non indovinare il testo da cercare.

  - Solo la selezione: usa il testo attualmente selezionato, se possibile.

  - La selezione, poi la parola attuale: usa la selezione attuale se possibile, altrimenti usa la parola attuale.

  - Solo la parola attuale: usa la parola su cui si trova il cursore, se possibile.

  - La parola attuale, poi la selezione: usa la parola attuale se possibile, altrimenti usa la selezione attuale.

  Nota che, in tutte le modalità indicate, se non è possibile determinare una stringa di ricerca allora verrà usato l'ultimo testo cercato.

### Indentazione

Indentazione automatica
  Modalità di indentazione:

    Seleziona la modalità di indentazione automatica che vuoi utilizzare 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 indentazione per formati di testo come codice C/C++ o &XML;.

  Inserisci un "*" iniziale per Doxygen durante la scrittura

    Inserisce automaticamente un "*" quando si scrive un commento in stile Doxygen. Questa impostazione è abilitata solo quando si applica alla situazione.

Indentazione con spazi
  Usa gli spazi invece delle tabulazioni per indentare

    Questo sostituisce le tabulazioni con il numero di spazi impostato in Numero di spazi: più sotto.

  Modalità mista stile Emacs

    Usa una miscela di tabulazioni e caratteri di spazio per l'indentazione.

  Numero di spazi:

    Imposta il numero di spazi da usare per l'indentazione per l'opzione Usa gli spazi invece delle tabulazioni.

Conserva il profilo di indentazione

  Quando questa opzione è abilitata,l'editor non eliminerà ulteriormente l'indentazione dalle righe selezionate quando essa viene annullata dalla riga con indentazione minima. Se talvolta togli l'indentazione da blocchi di codice dove essa è presente, questa opzione può essere utile.

Conserva gli spazi extra

  Le indentazioni maggiori del numero di spazi selezionato non saranno accorciate.

Tasti da usare
  Il tasto Tab indenta

    Permette di usare il tasto Tab per indentare.

  Il tasto Backspace indenta

    Permette di usare il tasto Backspace per indentare.

Modalità tasto Tab in caso di assenza di selezione
  Inserisci carattere di indentazione

    Permette che Tab inserisca caratteri di rientro.

  Inserisci carattere di tabulazione

    Permette che Tab inserisca caratteri di tabulazione.

  Indenta la riga attuale

    Permette che Tab indenti la riga attuale.

### Apri/Salva

Formato file
  Codifica:

    Imposta la codifica predefinita dei tuoi file.

  Fine della riga:

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

  Rilevazione automatica fine riga

    Marca la casella 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.

Uso della memoria
  Massimo blocchi caricati per file:

    L'editor caricherà in memoria il numero di blocchi di testo indicato (di circa 2048 righe); se la dimensione del file è più grande il resto dei blocchi saranno mantenuti sul disco e caricati in modo trasparente quando necessario.

    Questo può causare brevi ritardi quando ci si sposta nel documento; un numero di blocchi più grande migliora la velocità in cambio di un maggior uso della memoria.

    Per un uso normale, scegli il numero di blocchi più alto possibile: metti un limite solo se hai problemi di uso della memoria.

Pulizia automatica al salvataggio/caricamento
  Rimuovi gli spazi finali

    L'editor eliminerà automaticamente gli spazi in eccesso alla fine delle righe di testo durante il caricamento/salvataggio del file.

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

    L'editor cercherà più in su nell'albero delle cartelle del numero di livelli indicato per trovare i file di configurazione di &kate; e caricare le impostazioni da esso.

Copia di sicurezza al salvataggio

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

  File locali

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

  File remoti

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

  Prefisso

    Inserisci il prefisso per i nomi delle copie di sicurezza.

  Suffisso

    Inserisci il suffisso per i nomi delle copie di sicurezza.

### Evidenziazione

Questo gruppo di opzioni è usato per personalizzare gli stili di evidenziazione per ogni tipo di linguaggio di programmazione. Qualsiasi cambiamento fatto in altre aree di questa finestra di dialogo si applica solamente a questo tipo.

Evidenziazione:

  È usata per scegliere il tipo di linguaggio da configurare.

Informazioni

  Mostra le proprietà delle regole di evidenziazione del linguaggio scelto: nome dell'autore e licenza.

Proprietà
  Estensioni file:

    Questa è la lista delle estensioni dei file usata per determinare quali file evidenziare con la modalità di evidenziazione della sintassi attuale.

  Tipi MIME:

    Facendo clic sul pulsante della procedura guidata apparirà una finestra con la lista dei tipi MIME disponibili da cui scegliere.

    Verrà modificata anche la voce Estensioni file.

  Priorità:

    Imposta la priorità della regola di evidenziazione.

Scarica...

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

### Tipi di file

Questa pagina ti 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 è usato per creare un nuovo tipo di file. Dopo aver fatto clic su questo pulsante, i campi sottostanti si svuotano e puoi riempire quelli 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 in Strumenti Tipi di file

  Sezione:

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

  Variabili:

    Questa stringa permette di configurare le impostazioni di &kate; per i file selezionati da questo tipo mime usando le variabili di &kate;. Puoi impostare quasi tutte le opzioni di configurazione, come l'evidenziazione, la modalità di indentazione, la codifica ecc.

    Per un elenco completo delle variabili vedi il manuale.

  Estensioni 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 ti consente di 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à utilizzato il tipo di file con priorità più alta.

### Scorciatoie

Puoi cambiare da qui la configurazione dei tasti scorciatoia. Seleziona un'azione e fai clic su Personalizzata se vuoi una scorciatoia diversa per questa azione.

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

### Plugin

Questa scheda elenca tutti i plugin disponibili; puoi marcare tutti quelli che vuoi usare. Una volta che hai marcato un plugin, il pulsante Configura è abilitato e puoi fare clic su di esso per configurare il plugin evidenziato.

## Configurazione con le variabili del documento

Le variabili di Kate rappresentano l'implementazione come componente KatePart delle variabili del documento, simili alle modeline di emacs e di vi. Nella componente KatePart le righe hanno la forma `kate: NOMEVARIABILE VALORE; [ NOMEVARIABILE VALORE; ... ]` le righe possono naturalmente essere in un commento, se il formato del file prevede i commenti. I nomi delle variabili sono costituiti da un'unica parola (senza spazi) ed ogni cosa fino al successivo punto e virgola è interpretato come valore. Il punto e virgola è necessario.

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

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

Solo le prime e le ultime 10 righe di ogni file vengono controllate alla ricerca di righe di variabili.

Ci sono variabili per gestire quasi tutte le configurazioni di un componente KatePart, e i plugin aggiuntivi possono usare le variabili, che in tal caso devono essere documentate nel manuale del plugin.

### Come kate usa le variabili

Quando legge la configurazione, la componente KatePart controlla nelle seguenti posizioni (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 da riga di comando.

Come puoi ben capire le variabili del documento hanno la priorità più alta. Quando un documento viene salvato, le variabili corrispondenti verranno lette nuovamente e sovrascriveranno i cambiamenti fatti tramite voci di menu o riga di comando.

Le variabili non elencate qui sotto possono essere inserite nel documento e possono essere utilizzate da altri oggetti come i plugin, che possono usarle per i propri scopi. Ad esempio la modalità di indentazione variabile usa le variabili del documento per la propria configurazione.

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

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

- INTEGER - 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 che venga valutato come un colore valido, come "#ff0000".

    backspace-indentsBOOL

  Abilita o disabilita l'indentazione alla pressione del tasto Backspace.

    block-selectionBOOL

  Attiva o disattiva la selezione per blocchi.

    bracket-highlight-colorSTRING

  Il colore per l'evidenziazione delle parentesi. Deve essere qualcosa che venga valutato come un colore valido, come "#ff0000"

    current-line-colorSTRING

  Il colore della riga corrente. Il valore deve essere qualcosa che venga valutato come un colore valido, come "#ff0000".

    dynamic-word-wrapBOOL

  Attiva o disattiva l'a capo automatico dinamico.

    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 valida, come utf-8.

    font-sizeINT

  Imposta la dimensione in punti del tipo di carattere del documento.

    fontSTRING

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

    icon-bar-colorSTRING

  Imposta il colore della barra per le icone. Il valore deve essere qualcosa che venga valutato come un colore valido, come `#ff0000`.

    icon-borderBOOL

  Attiva o disattiva la visualizzazione del bordo per le 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 la sezione per i dettagli.

    indent-widthINT

  Imposta l'ampiezza dell'indentazione.

    keep-extra-spacesBOOL

  Imposta de devono essere tenuti gli spazi extra quando si calcolano le ampiezze 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. La stringa deve essere il nome di uno schema di colori che esiste nella tua configurazione perché abbia effetto.

    selection-colorSTRING

  Imposta il colore della selezione. Il valore deve essere qualcosa che venga valutato come un colore valido, ad esempio "#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 passi di annullamento da ricordare.

    word-wrap-columnINT

  Imposta l'ampiezza per l'a capo forzato.

    word-wrap-marker-colorSTRING

  Imposta il colore per l'indicatore di a capo. Il valore deve essere qualcosa che venga valutato come un colore valido, come "#ff0000".

    word-wrapBOOL

  Attiva o disattiva l'a capo forzato.

    wrap-cursorBOOL

  Attiva o disattiva l'a capo automatico del cursore.