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

Le modifiche ai dati della sessione (file aperti e, se abilitata, la configurazione delle finestre) saranno sempre salvate.

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

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 Navigatore del filesystem

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.

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

  %URL

    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 rientro:

    Allinea verticalmente l'inizio di una riga mandata a capo dinamicamente con il livello di rientro 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 rientro è 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

  Mostra righe di rientro

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

  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.

  Linea degli errori di ortografia

    imposta il colore della linea usata per indicare gli errori di ortografia.

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

  Copia o taglia la riga attuale se non c'è una selezione

    Se questa opzione è abilitata e la selezione di testo è vuota, le azioni di copiatura o ritaglio vengono fatte per l'intera riga di testo sulla quale si trova il cursore.

  Permetti di scorrere oltre la fine del documento

    Questa opzione permette di scorrere oltre la fine del documento. Questo può servire per centrare verticalmente il fondo del documento, o per metterlo in cima alla vista attuale.

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

#### Rientro

Modalità di rientro predefinita:

  Seleziona la modalità di rientro automatico 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 rientro per formati di testo come codice C, C++ o &XML;.

Regole di rientro
  Larghezza del rientro:

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

  Mantieni gli spazi aggiuntivi

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

  Regola il rientro del codice incollato dagli appunti

    Se questa opzione è attivata, il codice incollato dagli appunti verrà fatto rientrare. Si può rimuovere il rientro usando il comando Annulla.

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

    Se questa opzione è attivata, il tasto &Backspace; diminuisce il livello di rientro se il cursore si trova nello spazio iniziale di una riga.

  Azione del tasto Tab (senza selezione)

    Se vuoi che &Tab; allinei la riga attuale nel blocco di codice attuale come in emacs, 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 rientro

      Se questa opzione è attivata, il tasto &Tab; farà rientrare sempre la riga attuale del numero di posizioni specificato in Larghezza del rientro.

    Aumenta il livello di rientro se in uno spazio vuoto iniziale

      Se questa opzione è attivata, il tasto &Tab; farà rientrare la riga attuale o avanzerà alla prossima tabulazione. Se il punto di inserimento è sul primo carattere non di spaziatura della riga o prima di esso, o se c'è una selezione, la riga attuale verrà fatta rientrare del numero di posizioni specificato in Larghezza del rientro. 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 abilitato, appare automaticamente un riquadro di completamento delle parole durante la battitura, presentando un elenco di voci testuali per completare il testo attualmente sotto il cursore.

Lunghezza minima delle parole da completare

  Quando si scrive, il completamento delle parole cerca le parole nello stesso documento che cominciano con il testo già scritto. Questa opzione configura il numero minimo di caratteri per attivare il completamento e far comparire un riquadro di completamento.

#### Modalità di inserimento Vi

Generale
  Usa modalità di inserimento VI

    Se selezionato, verrà abilitata la modalità di inserimento Vi all'apertura di una nuova vista. La puoi comunque attivare o disattivare per una vista particolare dal menu Modifica.

  Lascia che i comandi VI abbiano precedenza su quelli di Kate

    Se selezionato, i comandi Vi avranno precedenza sui comandi interni di &kate;. Per esempio, &Ctrl;R rifarà le modifiche, e sostituirà l'azione normale, che sarebbe mostrare la finestra di ricerca e sostituzione.

  Nascondi la barra di stato della modalità VI

    Come impostazione predefinita, si usa un'ulteriore barra di stato quando la modalità di inserimento Vi è attivata. Questa barra mostra i comandi mentre vengono scritti e i messaggi e gli errori prodotti dai comandi di Vi.

    Attivare questa opzione nasconderà questa ulteriore barra di stato.

Mappatura dei tasti

  La mappatura dei tasti si usa per cambiare il significato dei tasti premuti. Ciò permette di spostare i comandi su altri tasti, o di creare sequenze speciali per effettuare serie di comandi.

  Esempio:

  `KDE` nella prima colonna, `Iviva KDE!` nella seconda.

  Questo metterà un `Viva KDE!` all'inizio di una riga quando si digita `KDE`.

#### Controllo ortografico

Queste opzioni di configurazione sono descritte nella documentazione del modulo delle &systemsettings; del Correttore ortografico.

### Apri e salva

#### Generale

Formato file
  Codifica:

    Questo definisce la codifica standard da usare pre aprire e salvare i file, se non viene cambiata nella finestra di apertura e salvataggio o usando un'opzione dalla riga di comando.

  Rilevamento della codifica

    Seleziona un elemento dalla casella a cascata, o per disattivare il rilevamento automatico, o usa Universale per abilitarlo per tutte le codifiche. Questo potrebbe però rilevare solo UTF-8 e UTF-16, e selezionare una regione userà permetterà di ottenere risultati migliori. Se né la codifica scelta come standard sopra, né quella specificata nella finestra di apertura o salvataggio, né quella specificata sulla riga di comando corrispondono al contenuto del file, si eseguirà questo rilevamento.

  Codifica di riserva

    Qui si definisce la codifica di riserva per provare ad aprire file se né la codifica sopra indicata come normale, né quella specificata nella finestra di apertura o salvataggio, né quella specificata sulla riga di comando corrispondono ai contenuti del file. Prima di usare questa, si proverà a determinare la codifica da usare cercando un indicatore di ordinamento dei byte all'inizio del file: se ne si trova uno, sarà scelta la codifica Unicode corretta; altrimenti, verrà avviato il rilevamento della codifica, se entrambe le codifiche di riserva saranno provate.

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

  Abilita l'indicatore dell'ordine dei byte

    L'indicatore dell'ordine dei byte è una sequenza particolare all'inizio dei documenti codificati con Unicode. Aiuta gli editor a aprire i documenti di testo con la codifica Unicode giusta. Per maggiori informazioni, vedi la Wikipedia.

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. Maggiori informazioni su questa cartella nascosta di file di configurazione si possono trovare in questo articolo sul file .kateconfig.

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 rientro, 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.

  Modalità di rientro:

    La casella a cascata specifica la modalità di rientro per i nuovi documenti.

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

### 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, viene abilitato l'eventuale pulsante Configura per configurarla.

#### Estensioni del componente editor

Graffe automatiche

  L'estensione per graffe automatiche sostituisce la funzionalità interna di &kate; per le quadre automatiche. Inserisce automaticamente una graffa chiusa, }, in fondo alla riga successiva dopo aver concluso una riga con una aperta, {, e aver premuto il tasto &Enter;.

Strumenti per dati

  Abilita gli strumenti di dati come il dizionario dei sinonimi e il controllo ortografico (se installato). Gli strumenti di dati sono disponibili solo quando c'è del testo selezionato, o quando il &RMB; viene premuto su una parola. Se non sono presenti strumenti di dati, anche quando c'è del testo selezionato, devi installarli. Alcuni strumenti di dati fanno parte del pacchetto &koffice;. Se questa estensione è abilitata e gli strumenti di dati sono installati, appariranno degli altri elementi in fondo al menu contestuale.

Esportatore

  Questo comando permette di esportare il documento attuale con tutte le informazioni di evidenziazione in un documento HTML con File Esporta come HTML. Inoltre, puoi usare Modifica Copia come HTML per copiare il testo attualmente selezionato come HTML negli appunti di sistema.

Inserisci file

  Questa estensione permette di inserire qualsiasi file leggibile alla posizione del cursore. Se abilitata, il menu Strumenti avrà l'ulteriore elemento Inserisci file.

Controlla codifica Python

  Questa estensione è sempre attiva. Se stai cercando di salvare un file Python come non ASCII, senza specificare una riga di codifica del sorgente corretta come per esempio `# -*- coding: utf-8 -*-`, apparirà una finestra di avviso che permetterà di aggiungere l'appropriata riga di codifica del sorgente per la codifica attuale del file.

## 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 rientro 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 il rientro automatico 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 il rientro col tasto Backspace.

    block-selectionBOOL

  Attiva o disattiva la selezione per blocchi.

    bom | byte-order-markerBOOL

  Attiva o disattiva l'indicatore dell'ordine dei byte quando si salvano file in formato Unicode (utf8, utf16, utf32).

  Da: &kate; 3.4 (&kde; 4.4)

    bracket-highlight-colorSTRING

  Imposta il colore per l'evidenziazione delle parentesi. Deve essere qualcosa leggibile come un colore valido, come `#ff0000`.

    current-line-colorSTRING

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

    default-dictionarySTRING

  Imposta il dizionario predefinito da usare per il controllo ortografico.

  Da: &kate; 3.4 (&kde; 4.4)

    dynamic-word-wrapBOOL

  Attiva o disattiva l'andata a capo 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`.

    folding-markersBOOL

  Attiva o disattiva la visualizzazione degli indicatori di raggruppamento.

    font-sizeINT

  Imposta la dimensione in punti dei caratteri del documento.

    fontSTRING

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

    hl | syntaxSTRING

  Imposta l'evidenziazione della sintassi. Le stringhe valide sono tutti i nomi disponibili nel menu. Per esempio, per il C++ basta scrivere `C++`.

    icon-bar-colorSTRING

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

    icon-borderBOOL

  Attiva o disattiva la visualizzazione del bordo delle icone.

    indent-modeSTRING

  Imposta la modalità di rientro automatico. Sono riconosciute le opzioni `none`, `normal`, `cstyle`, `haskell`, `lilypond`, `lisp`, `python`, `ruby` e `xml`. Vedi per i dettagli.

    indent-widthINT

  Imposta la larghezza del rientro.

    keep-extra-spacesBOOL

  Imposta se tenere gli spazi aggiuntivi quando si calcola la larghezza del rientro.

    keep-indent-profileBOOL

  Se assegni TRUE a questa variabile, si impedisce la rimozione del rientro di un blocco se almeno una riga non ha rientro.

  Nota: rimosso in &kate; 3 (&kde; 4)

    line-numbersBOOL

  Attiva o disattiva la visualizzazione del numero di riga.

    mixed-indentBOOL

  Attiva o disattiva il rientro misto in stile Emacs.

  Nota: deprecato da &kate; 3 in &kde; 4. Questa variabile è ignorata, in futuro imposta invece `replace-tabs on;`.

    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 il rientro con spazi.

  Nota: deprecato da &kate; 3 in &kde; 4. Il rientro misto è il comportamento predefinito. Imposta `replace-tabs on;` per avere un rientro con soli spazi.

    tab-indentsBOOL

  Attiva o disattiva il rientro col tasto &Tab;.

    tab-widthINT

  Imposta la larghezza a schermo della tabulazione.

    undo-stepsINT

  Imposta il numero di annullamenti da ricordare.

  Nota: deprecato da &kate; 3 in &kde; 4. Questa variabile è ignorata. Il numero massimo di annullamenti è illimitato.

    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.