# 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ò anche 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;

### 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 precedentemente aperti. Questo permette di mantenere la banca dati delle informazioni aggiuntive entro dimensioni ragionevoli.

### 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 dell'applicazione.

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, o caricherà la predefinita se non ne sono state salvate. Questo è il comportamento predefinito. È comodo se usi molte sessioni diverse di frequente.

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

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

Per maggiori informazioni sulle estensioni disponibili, vedi plugins.

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

Modalità di visualizzazione

- Questo dà due opzioni che influenzano la visualizzazione della vista dei documenti. L'opzione Vista ad albero visualizzerà i documenti in un albero sotto le cartelle in cui si trovano, mentre l'opzione Vista a elenco li visualizzerà come un elenco semplice.

Mostra il percorso completo

- Quando la vista ad albero e questa opzione sono abilitate, le voci delle cartelle visualizzate nella vista dei documenti mostreranno il percorso completo alla cartella oltre al suo nome. Non ha alcun effetto nella vista a elenco.

&configuring-part-sections;

## Configurazione con le variabili dei documenti

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

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

    // kate: replace-tabs on; indent-width 4; indent-mode cstyle;

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

Inoltre, le variabili dei documenti possono essere messe in un file di nome `.kateconfig` in qualsiasi cartella, e le impostazioni configurate saranno applicate come se le modeline fossero inserite su ogni file nella cartella e nelle sue sottocartelle, fino alla profondità di ricerca configurata. Le variabili dei documenti in `.kateconfig` usano la stessa sintassi delle modeline.

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 &kappname; usa le variabili

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

- la configurazione globale;

- valori facoltativi di sessione;

- la configurazione Tipi di file;

- variabili del documento in `.kateconfig`;

- variabili del documento presenti nel documento stesso;

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

Come puoi vedere, le variabili del documento possono essere sostituite solo da modifiche fatte al momento dell'esecuzione. Ogni volta che un documento viene salvato, le sue variabili verranno rilette e sovrascriveranno i cambiamenti fatti 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 &kappname; versione 3.7. 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-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

- Abilita o disabilita la rimozione del rientro alla pressione di &Backspace;.

    block-selectionBOOL

- Attiva o disattiva la selezione a 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)

    encodingSTRING

- Imposta la codifica da usare per caricare o salvare il file. Siccome le variabili del documento verranno lette dopo il caricamento, questo ha effetto solo sul salvataggio. Se lo metti in un file `.kateconfig`, avrà effetto anche sul caricamento.

  Da: &kate; 3.10 (&kde; 4.10)

    bracket-highlight-colorSTRING

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

    current-line-colorSTRING

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

    default-dictionarySTRING

- Imposta il dizionario predefinito da usare per il controllo ortografico.

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

    dynamic-word-wrapBOOL

- Attiva o disattiva l'andata a capo dinamica.

    eol | end-of-lineSTRING

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

    folding-markersBOOL

- Attiva o disattiva la visualizzazione degli indicatori di raggruppamento.

    font-sizeINT

- Imposta la dimensione in punti dei caratteri del documento.

    fontSTRING

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

    hl | syntaxSTRING

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

    icon-bar-colorSTRING

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

    icon-borderBOOL

- Attiva o disattiva la visualizzazione del bordo delle icone.

    indent-modeSTRING

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

    indent-pasted-textBOOL

- Attiva o disattiva la regolazione del rientro del testo incollato dagli appunti.

  Da: &kate; 3.11 (&kde; 4.11)

    indent-widthINT

- Imposta la larghezza del rientro.

    keep-extra-spacesBOOL

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

    line-numbersBOOL

- Attiva o disattiva la visualizzazione del numero di riga.

    mixed-indentBOOL

- Attiva o disattiva il rientro misto, come in &Emacs;.

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

    newline-at-eofBOOL

- Aggiungi una riga vuota alla fine del file (EOF) al salvataggio del documento.

  Da: &kate; 3.9 (&kde; 4.9)

    overwrite-modeBOOL

- Attiva o disattiva la modalità sovrascrittura.

    persistent-selectionBOOL

- Attiva o disattiva la selezione persistente.

    remove-trailing-spaceBOOL

- Attiva o disattiva la ripulitura dinamica a fine riga.

  Nota: deprecata da &kde; 4.10. Usa invece remove-trailing-spaces con l'opzione desiderata.

    remove-trailing-spacesSTRING

- Rimuove gli spazi finali durante il salvataggio del documento. Le opzioni valide sono:

  - `none`, `-` o `0`: non rimuovere mai gli spazi finali.

  - `modified`, `mod`, `+` o `1`: rimuovi gli spazi finali solo nelle righe modificate. Le righe modificate vengono evidenziate dal sistema di evidenziazione delle righe.

  - `all`, `*` o `2`: rimuovi gli spazi finali in tutto il documento.

  Da: &kde; 4.10. Questo rende obsolete le opzioni `remove-trailing-space` e `replace-trailing-space-save`.

    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.

  Nota: deprecata da &kde; 4.10. Usa invece remove-trailing-spaces con l'opzione desiderata.

    schemeSTRING

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

    selection-colorSTRING

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

    show-tabsBOOL

- Attiva o disattiva il carattere di tabulazione visibile.

    smart-homeBOOL

- Attiva o disattiva la navigazione all'inizio intelligente.

    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-widthINT

- Imposta la larghezza a schermo del carattere di 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 la larghezza dell'andata a capo dinamica.

    word-wrap-marker-colorSTRING

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

    word-wrapBOOL

- Attiva o disattiva l'andata a capo statica.