Paolo
Zamponi

    zapaolo@email.it

Traduzione e manutenzione della documentazione
Nicola
Ruggero

    nicola@nxnt.org

Traduzione della documentazione.

# I Fondamenti

Se hai già usato un editor di testo non avrai problemi ad usare &kate;. Nelle prossime due sezioni, Avvio di &kate; e Lavorare con &kate; ti mostreremo tutto quello che devi sapere per iniziare ad usarlo velocemente.

## Avvio di &kate;

Puoi avviare &kate; dall'avviatore di applicazioni o dalla riga di comando.

### Dal menu

Apri il menu dei programmi di &kde; facendo clic sull'avviatore di applicazioni nel pannello in fondo a sinistra del tuo schermo; questo farà sollevare un menu. Muovi il puntatore verso la voce Applicazioni Utilità Editor di testi avanzato &kate;.

### Dalla riga di comando

Puoi avviare &kate; digitando il suo nome dalla riga di comando. Se gli scrivi accanto anche il nome di un file, come nell'esempio qui sotto, ti aprirà o ti creerà quel file.

    %kate miofile.txt

Se hai una connessione attiva e i permessi, puoi approfittare del vantaggio della trasparenza nella rete di &kde; per aprire file in internet.

    %kate &kde-ftp;README

Per modificare la cartella dei file temporanei, che come impostazione predefinita è `/tmp`, imposta la variabile di ambiente `TMPDIR` prima di avviare &kate;, ad esempio:

    %mkdir /tmp/kate -p && export TMPDIR=/tmp/kate && kate

#### Opzioni dalla riga di comando

&kate; accetta le seguenti opzioni dalla riga di comando:

``kate` `--help``

  Questo elenca le opzioni disponibili dalla riga di comando.

``kate` `-s` `--start` `nome``

  Avvia &kate; con la sessione `nome`; la sessione è creata se non è già esistente. Se un'istanza di &kate; con la sessione specificata è già in esecuzione, i file specificati sono caricati in tale istanza.

``kate` `-p` `--pid` `PID``

  Riutilizza un'istanza con il PID specifico (ID del processo).

``kate` `-e` `--encoding` `codifica` `URL``

  Usa la codifica specificata per il documento.

``kate` `-l` `--line` `riga` `URL``

  Si posiziona alla riga specificata dopo aver aperto il documento.

``kate` `-c` `--column` `colonna` `URL``

  Si posiziona alla colonna specificata dopo aver aperto il documento.

``kate` `-i` `--stdin``

  Legge il contenuto del documento da STDIN. È simile all'opzione `-` comunemente usata in molti programmi da riga di comando, e permette di incanalare l'output di un comando in &kate;.

``kate` `--startanon``

  Avvia &kate; in una nuova sessione anonima, implica `-n`.

``kate` `-n` `--new``

  Forza l'avvio di una nuova istanza di &kate; (è ignorato se è usato `start` e un'altra istanza di &kate; ha la sessione specificata aperta). La forzatura avviene se non sono stati indicati parametri oppure URL.

``kate` `-b` `--block``

  Se è in uso un'altra sessione di &kate; già in esecuzione e se vengono specificati URL, blocca quella sessione fino a quando esci.

  Puoi usare &kate; con questa opzione come editor per messaggi di deposito nei sistemi di controllo versione come &git; oppure Subversion. Questi sistemi si aspettano di bloccare l'editor fino a quando on hai inserito il messaggio, perché aprono subito dopo il file temporaneo con il contenuto. Se &kate; ritorna immediatamente al chiamante, il file temporaneo è vuoto.

  Questa opzione è richiesta anche con KIO (&kde; input/Output) nel caso in cui tu apra un file remoto (che è stato scaricato in un file temporaneo) che debba essere rinviato dopo che lo hai salvato.

``kate` `--tempfile``

  Quando è usata i file specificati sono trattati come temporanei ed eliminati (se sono locali e hai i permessi appropriati) quando vengono chiusi, a meno che non siano modificati da quando sono stati aperti.

``kate` `--desktopfile` `nome``

  Il nome file della voce del desktop per questa applicazione.

  Questo è utile in particolare per applicazioni adattatori e per applicazioni in generale con più file desktop. In questo modo ogni file desktop può specificare il proprio nome nel comando `Exec`.

``kate` `--author``

  Elenca gli autori di &kate; nella finestra del terminale.

``kate` `-v` `--version``

  Elenca le informazioni sulla versione di &kate;.

``kate` `--license``

  Mostra le informazioni sulla licenza.

### Trascinamento

&kate; usa il protocollo di trascinamento (drag and drop protocol) di &kde;. I file possono essere trascinati e rilasciati in &kate; dal Desktop, dal gestore di file &dolphin; o da alcuni siti &FTP; aperti in più finestre di &dolphin;.

## Lavorare con &kate;

Avvio rapido ti mostrerà come modificare quattro semplici opzioni che ti consentiranno di configurare alcune della più potenti caratteristiche di &kate;. Scorciatoie visualizza alcune delle scorciatoie predefinite per quelli che non possono o non vogliono utilizzare il mouse.

### Avvio rapido

Questa sezione descrive alcuni degli elementi presenti nel menu Visualizza, in modo che tu possa configurare rapidamente &kate; per lavorare nella maniera che desideri.

Avviando &kate; per la prima volta vedrai due finestre con lo sfondo bianco. Sopra le due finestre c'è una barra degli strumenti con le solite icone etichettate. E sopra a questa, la barra dei menu.

La finestra di sinistra è una barra laterale. Combina le finestre Documenti e Selettore dei file. Cambia da una finestra all'altra facendo clic sulle linguette a sinistra della finestra.

Se hai avviato &kate; con un file, la finestra a destra mostrerà il file che stai modificando, ed il pannello Documenti nella barra laterale mostrerà il nome del file. Usa la finestra del Selettore dei file per aprire i file.

Puoi attivare o disattivare tutte le finestre della barra laterale dal menu Visualizza Viste degli strumenti, oppure usare &Ctrl;&Alt;&Shift;F. Questo menu offre una prima occhiata alle potenzialità e alla flessibilità di &kate;.

In Viste degli strumenti c'è una lista di tutte le estensioni abilitate. Fai clic nella casella davanti a ciascun elemento, oppure sul pulsante dello strumento con &LMB; nella barra laterale per attivare o disattivare questa vista dello strumento.

### Scorciatoie

Molte scorciatoie di &kate; possono essere configurate attraverso il menu Impostazioni. Le impostazioni predefinite di &kate; prevedono le seguenti associazioni di tasti.

F1 | Aiuto
&Shift;F1 | Che cos'è?
&Ctrl;N | Nuovo documento
&Ctrl;L | Salva tutti
&Ctrl;O | Apre apri un documento
&Ctrl;&Alt;O | Apertura rapida
&Ctrl;&Shift;F | Modalità a tutto schermo
&Ctrl;&Shift;, | Configura &kate;
&Ctrl;W / &Ctrl;&Esc; | Chiudi
&Ctrl;Q | Esci - chiude la copia attiva dell'editor
&Ctrl;&Alt;&Shift;F | Mostra le barre laterali
&Ctrl;&Shift;T | Dividi orizzontalmente
&Ctrl;&Shift;L | Dividi verticalmente
F8 | Vista divisa successiva
&Shift;F8 / &Ctrl;&Esc; | Vista divisa precedente
&Ctrl;&Shift;R | Chiudi la vista corrente
&Alt;&Right; | Scheda successiva
&Alt;&Left; | Scheda precedente

Inoltre puoi usare le scorciatoie fornite dal componente &katepart; e da tutte le estensioni di &kate; attivate.

## Lavorare con &kate; MDI

### Panoramica

Finestra, Vista, Documento, Cornice, Editor... Che cosa sono tutti queste voci nella terminologia di &kate;, e come ottenerne il massimo? Questo capitolo spiegherà tutte queste cose, e molto di più.

#### La finestra principale

La finestra principale di &kate; è una finestra standard di &kde;, con l'aggiunta di barre laterali contenenti le viste degli strumenti. Ha una barra con tutti i menu più comuni e qualcuno in più, e una barra degli strumenti che dà accesso ai comandi usati più spesso.

La parte più importante della finestra è l'area dell'editor che, per impostazione predefinita, visualizza un solo componente editor di testi; qui puoi lavorare con i tuoi documenti.

La capacità di agganciarsi delle finestre viene utilizzata dai pannelli degli strumenti di ogni estensione abilitata nella finestra delle impostazioni.

Le viste degli strumenti possono essere posizionate in una qualsiasi barra laterale; per spostare uno strumento fai clic sul pulsante dalla sua barra e selezionalo dal menu con il &RMB;.

La vista di uno strumento può essere indicata come persistente dal menu del &RMB;. La barra laterale può contenere più strumenti per volta, in modo che quando uno strumento è persistente gli altri possono essere mostrati in contemporanea.

Se un'estensione ha le sue opzioni di configurazione puoi usare il primo elemento del menu contestuale per aprire la relativa pagina nella finestra delle impostazioni di &kate;.

### L'area di modifica

&kate; può avere più documenti aperti allo stesso tempo, ed inoltre può dividere l'area dell'editor in qualsiasi numero di finestre, in maniera simile a &konqueror; o al popolare emacs. In questa maniera puoi vedere diversi documenti allo stesso tempo, o più istanze dello stesso documento, per esempio se il tuo documento contiene definizioni all'inizio che vuoi vedere spesso per riferimento. Potresti anche vedere l'intestazione del sorgente di un programma in una finestra, e intanto modificare il file di implementazione in un'altra.

Quando un documento è disponibile in più di un editor i cambiamenti effettuati su uno degli editor saranno immediatamente riflessi negli altri; questo include la selezione e la modifica del testo. Le operazioni di ricerca o i movimenti del cursore si rifletteranno solo nell'editor corrente.

Attualmente non è possibile avere più istanze aperte dello stesso documento, nel senso che in una istanza compaiono le modifiche che si stanno facendo mentre nell'altra no.

Quando dividi l'editor in due appaiono due riquadri della stessa dimensione, che visualizzano entrambi il documento corrente. Il nuovo riquadro sarà in basso (nel caso di divisione orizzontale) o a destra (con la divisione verticale), e sarà attivato; questo viene palesato dalla presenza del cursore lampeggiante.

## Uso delle sessioni

Le sessioni sono il metodo che &kate; usa per raccogliere liste multiple di file e di configurazioni della &GUI;. Puoi avere tutte le sessioni con nome di cui hai bisogno, e puoi usare le sessioni senza nome o anonime per i file che vuoi usare solo una volta. Attualmente &kate; può salvare la lista dei file aperti e la configurazione generale della finestra in una sessione, ma versioni future di &kate; potrebbero aggiungere altre caratteristiche che siano memorizzabili nelle sessioni. Con l'introduzione delle sessioni, &kate; permette anche di aprire un numero a piacere di istanze dell'applicazione invece di una sola, come invece faceva prima.

Le sessioni sono utilizzate in tre aree:

- Le opzioni da riga di comando, che permettono di selezionare ed avviare sessioni quando si avvia &kate; da riga di comando.

- Il menu Sessioni, che permette di cambiare, salvare, avviare e gestire le tue sessioni.

- Le opzioni di configurazione, che permettono di decidere come debbano comportarsi generalmente le sessioni.

Quando si avvia una nuova sessione viene caricata la configurazione della &GUI; della Sessione predefinita. Per salvare la configurazione della finestra come sessione predefinita devi abilitare il salvataggio della configurazione della finestra nella pagina di configurazione delle sessioni della finestra di configurazione e poi caricare la sessione predefinita, impostare la finestra come preferisci e salvare nuovamente la sessione.

Quando viene caricata una sessione con nome &kate; mostra il nome della sessione all'inizio del titolo, che quindi avrà la forma Nome sessione: Nome o &URL; del documento - &kate;.

Aprendo i file da riga di comando con `--start nome`, oppure selezionando una sessione dal selettore delle sessioni, la sessione specificata viene caricata prima dei file specificati da riga di comando. Per aprire i file da riga di comando in una sessione nuova e senza nome configura &kate; in modo che avvii come predefinito una nuova sessione dalla pagina delle sessioni della finestra di configurazione, oppure usa l'opzione `--start` con una stringa vuota: ''.

Da &kate; 2.5.1 il PID dell'istanza attuale è esportato nella variabile di ambiente `KATE_PID`. Quando vengono aperti dei file dal terminale integrato, Kate selezionerà automaticamente l'istanza attuale se non viene indicato nient'altro da riga di comando.

## Apertura rapida

Per essere in grado di aprire e di passare rapidamente tra i file, Kate ha una finestra di apertura rapida integrata. Puoi aprirla con &Ctrl;&Alt;O.

L'apertura rapida può mostrare tutti i documenti aperti in Kate e in tutti i file nei progetti aperti. Per poter vedere i file di progetto devi abilitare l'Estensione di progetto.

### Uso dell'apertura rapida

L'uso dell'apertura rapida è molto semplice. Una volta aperta, digita il nome o la porzione del nome del file che vuoi aprire: la funzione filtrerà l'elenco in base a ciò che hai digitato. Premendo &Enter; il file selezionato verrà aperto, mentre con &Esc; l'apertura rapida verrà nascosta.

Per impostazione predefinita, durante il filtraggio verrà associato solo il nome. Se vuoi associare il percorso ci deve essere un «/» nel testo digitato. Ad esempio, «documenti/pippo» farà corrispondere tutti i file nella cartella «documenti» che contengono «pippo».

Quando la finestra si apre, i documenti già aperti sono evidenziati i grassetto e vengono elencati in cima. Inoltre, quando l'apertura rapida compare, il documento aperto in precedenza è già selezionato: devi solo premere &Enter; e verrai portato in quel documento.

### Configurazione dell'apertura rapida

Apertura rapida

L'apertura rapida fornisce un paio di opzioni di configurazione. Per avere accesso a queste opzioni, tasto destro nella riga di modifica.

Le opzioni attualmente disponibili sono:

  `Progetto attuale` - mostra solo i file dal progetto attuale

  `Tutti i progetti` -mostra i file da tutti i progetti aperti

  `Filtraggio approssimato` - usa l'algoritmo di ricerca approssimata per filtrare i file

  `Filtraggio con caratteri jolly` - usa la corrispondenza con caratteri jolly per filtrare i file

## Ricevere aiuto

### Con &kate;

Questo manuale

  Offre una documentazione dettagliata su tutti i comandi dei menu, opzioni di configurazione, strumenti, finestre di dialogo, estensioni &etc; così come le descrizioni delle finestre di &kate;, l'editor e i vari concetti usati nell'applicazione.

  Premi F1 o usa il menu Aiuto Manuale di &kate; per visualizzare questo manuale.

Guida a Che cos'è?

  Che cos'è? offre un aiuto immediato con i singoli elementi delle finestre grafiche, come pulsanti o altre aree della finestra.

  Noi ci sforziamo di fornire l'aiuto Che cos'è? per tutti gli elementi per cui ha senso che esista. È disponibile nella finestra di dialogo della configurazione, e in molte altre finestre di dialogo.

  Per usare l'aiuto Che cos'è?, premi &Shift;F1 oppure usa il menu Aiuto Che cos'è? per abilitare la modalità Che cos'è?. In questo caso il cursore si trasformerà in una freccia con un punto di domanda: ora puoi fare clic su qualsiasi elemento della finestra, e leggere l'aiuto Che cos'è? per quell'elemento (se disponibile).

Pulsanti di aiuto nelle finestre di dialogo

  Alcune finestre di dialogo possiedono il pulsante Aiuto: se lo premi aprirai il &khelpcenter; e quindi la documentazione collegata.

### Con i tuoi file di testo

&kate; non fornisce (non ancora!) tutti gli strumenti per leggere la documentazione relativa ai documenti. A seconda del file che stai modificando, puoi trovare utile la sezione emulatore di terminale integrato per vedere le relative pagine del manuale di &UNIX; o la documentazione info, oppure puoi usare &konqueror;.

### Articoli su &kate;

La page iniziale di &kate; fornisce alcuni articoli e how-to per approfondire aspetti che questo manuale non tratta.