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