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

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

### 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, o caricherà la predefinita se non ne sono state salvate. 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.

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

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

Mostra il percorso completo

  Quando abilitato, in modalità vista ad albero, le cartelle di livello superiore mostreranno il loro percorso completo invece del solo nome della cartella.

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.

### Terminale

Questa pagina è visualizzata solo dall'estensione dello strumento visivo per terminale, che come impostazione predefinita è attiva.

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.

Imposta la variabile d'ambiente EDITOR a «kate -b»

  Questo imposta la variabile d'ambiente `EDITOR` in modo che i programmi eseguiti nel terminale incorporato che aprono automaticamente un file lo facciano in &kate; invece dell'editor predefinito configurato nella shell. Non potrai continuare a usare il terminale finché non avrai chiuso il file in &kate;, in modo che il programma sappia che hai finito di lavorare sul file.

&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 opzionali 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 vedi, 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 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.

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

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

    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.