Nicola
Ruggero

    nicola@nxnt.org

Traduzione della documentazione.

# I Fondamenti

Se hai già usato un editor di testo, non avrai problemi usando &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; dal menu &kmenu; o dalla riga di comando.

### Dal menu

Apri il menu dei programmi di &kde; facendo clic sulla grossa K nel pannello in fondo a sinistra del tuo schermo. Questo ti farà raggiungere un menu. Muovi il tuo cursore verso la voce Applicazioni Utilità Editor di testi avanzato &kate;.

Finché non dici a &kate; di non farlo, caricherà l'ultimo file che hai modificato. Vedi Configurare &kate; per imparare come attivare o disattivare questa caratteristica.

### Dalla riga di comando

Puoi avviare &kate; digitando il nome dalla riga di comando. Se gli scrivi accanto anche il nome di un file, come nell'esempio qui sotto, ti apre o ti crea 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 ftp://ftp.kde.org/pub/kde/README

#### Opzioni dalla riga di comando

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

``kate` `--help``

  Questo elenca le opzioni di base più comuni disponibili dalla riga di comando.

``kate` `--help-qt``

  Questo elenca le opzioni disponibili per modificare il modo in cui &kate; interagisce con &Qt;.

``kate` `--help-kde``

  Questo elenca le opzioni disponibili per modificare il modo in cui &kate; interagisce con &kde;.

``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. Quando è usata con l'opzione `--use`, verrà usata allo stesso modo un'istanza in esecuzione con questa sessione.

``kate` `-u` `--use` `URL``

  Fa usare a &kate; un'istanza già esistente se ne esiste una. Se vuoi aprire tutti i documenti in una sola istanza di &kate;, puoi aggiungere questa opzione al comando predefinito nella configurazione delle applicazioni di &kde;, e puoi creare un alias per la shell, se il tuo interprete di comandi la supporta.

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

  Riutilizza un'istanza con il PID specifico (ID del processo) Usala con l'opzione `--use`.

``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` `--tempfile``

  Da &kate; 2.5.1 questa opzione standard di &kde; è supportata. Quando è usata, i file specificati sono trattati come file temporanei e cancellati (se sono locali ed hai i permessi appropriati) quando vengono chiusi, a meno che non siano modificati da quando sono stati aperti.

``kate` `--help-all``

  Questo elenca tutte le opzioni disponibili dalla riga di comando.

``kate` `--author``

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

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

  Elenca le informazioni sulla versione di &Qt;, &kde; e &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 le quali non è possibile o desiderabile usare il mouse.

### Avvio rapido

Questa sezione descrive alcuni degli elementi presenti nel menu Impostazioni 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 il pannello dei Documenti o del Selettore file dal menu Finestre Viste accessorie. Questo menu offre una prima occhiata alle potenzialità e alla flessibilità di &kate;. In questa sezione tratteremo tre elementi:

Mostra documenti

  Attiva o disattiva i Documenti. Se la finestra Documenti/Selettore file non è aperta, &kate; apre la barra laterale come una finestra separata e non agganciata. Per agganciare la finestra afferra le due sottili linee parallele sopra le linguette facendo clic su esse con il &LMB; e mantenendo premuto il pulsante. Trascina la finestra nella finestra dell'editor di &kate; e rilascia il &LMB; quando hai posizionato la finestra Documenti/Selettore file dove preferisci.

  Se hai afferrato con successo le due linee parallele il tuo puntatore del mouse si trasformerà in due frecce incrociate fin tanto che trascini.

Mostra Browser del filesystem

  Attiva o disattiva il Selettore file. Questo elemento del menu è lo stesso di Mostra Documenti con una differenza. Attivandolo apri la finestra con i Documenti in primo piano.

Mostra terminale

  Attiva o disattiva la visualizzazione dell'emulatore di terminale nella parte bassa della finestra di &kate;. In altre parole, ti fornisce una riga di comando integrata nell'applicazione.

### Scorciatoie

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

inserisci | Cambia tra la modalità Inserisci e Sovrascrivi. Quando sei nella modalità Inserisci l'editor aggiunge al testo i caratteri digitati e spinge il testo già presente a sinistra del cursore. La modalità Sovrascrivi fa in modo che l'inserimento di ogni carattere elimini il carattere immediatamente a destra del cursore.
Freccia sinistra | Muove il cursore un carattere a sinistra
Freccia destra | Muove il cursore un carattere a destra
Freccia su | Muove il cursore su di una riga
Freccia giù | Muove il cursore giù di una riga
Pagina su | Muove il cursore su di una pagina
Pagina giù | Muove il cursore giù di una pagina
Backspace | Cancella il carattere a sinistra del cursore
Home | Muove il cursore all'inizio della riga
Fine | Muove il cursore alla fine della riga
Canc | Cancella il carattere a destra del cursore (o qualsiasi testo selezionato)
&Shift;Invio | Inserisce una nuova riga includendo i caratteri iniziali della riga corrente che non siano lettere o numeri. È utile ad esempio per scrivere commenti al codice: Alla fine della riga // del testo premi questa scorciatoia e la riga successiva inizierà già con // . In questo modo eviti di inserire ogni volta i caratteri di commento all'inizio di ogni riga che va commentata.
&Shift;Freccia sinistra | Seleziona il testo un carattere a sinistra
&Shift;Freccia destra | Seleziona il testo un carattere a destra
F1 | Aiuto
&Shift;F1 | Che cos'è?
&Ctrl;F | Trova
F3 | Trova ancora
&Ctrl;B | Imposta un segnalibro
&Ctrl;C | Copia il testo selezionato negli appunti.
&Ctrl;N | Nuovo documento
&Ctrl;P | Stampa
&Ctrl;Q | Esci - chiude la copia attiva dell'editor
&Ctrl;R | Sostituisci
&Ctrl;S | Salva il file.
&Ctrl;V | Incolla.
&Ctrl;X | Cancella il testo selezionato e lo copia negli appunti.
&Ctrl;Z | Annulla
&Ctrl;&Shift;Z | Rifai

## Uso delle sessioni

Le sessioni sono il metodo che &kate; usa per raccogliere liste multiple di file e di configurazioni. Puoi avere tante sessioni con nome quante ne vuoi, 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; versioni future di &kate; potrebbero aggiungere altre caratteristiche 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 faceva normalmente 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 dalla riga di comando.

- Il menu Sessioni che permette di cambiare, salvare e gestire le 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 nominata, &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` o se selezioni una sessione dal selettore delle sessioni, la sessione specificata è caricata prima dei file specificati dalla riga di comando. Per aprire file dalla riga di comando in una sessione nuova e senza nome, configura kate per avviare una nuova sessione in modo predefinito 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 alla 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 sulla riga di comando.

### Ripristinare il comportamento delle vecchie versioni di &kate;

Quando ti sarai abituato all'uso delle sessioni, speriamo che tu le trovi un metodo semplice ed efficiente per lavorare in vari campi. Però se preferisci il vecchio comportamento di &kate; (un'istanza apre tutti i file), puoi facilmente ottenerlo seguendo questa semplice strategia:

- Fai in modo che &kate; sia avviato sempre con il parametro `--use`, aggiungendo l'opzione al comando fra le preferenze dell'applicazione, e aggiungendo un alias per la shell.

- Configura &kate; per caricare l'ultima sessione usata all'avvio.

- Configura &kate; per salvare l'elenco dei file quando viene chiusa una sessione.

- Carica la sessione predefinita una volta

## Ricevere aiuto

### Con &kate;

Questo manuale

  Offre una documentazione dettagliata su tutti i comandi dei menu, opzioni di configurazione, strumenti, finestre di dialogo, plugin &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 i pulsanti o altre aree della finestra.

  Noi ci sforziamo di fornire l'aiuto Che cos'è? a 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 centro di &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 Emulatore terminale integrato per vedere le pagine del manuale di &UNIX; o la documentazione di info, oppure puoi usare &konqueror;.