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

Avvio di
Puoi avviare dall'avviatore di applicazioni o dalla riga di comando.

Dal menu
Apri il menu dei programmi di 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 .

Dalla riga di comando
Puoi avviare 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 per aprire file in internet.

%kate README

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

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

Opzioni dalla riga di comando
accetta le seguenti opzioni dalla riga di comando:
kate --help 	 Questo elenca le opzioni disponibili dalla riga di comando.
kate -s --start nome 	 Avvia con la sessione nome; la sessione è creata se non è già esistente. Se un'istanza di 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 --startanon 	Avvia in una nuova sessione anonima, implica -n.
kate -n --new 	Forza l'avvio di una nuova istanza di (è ignorato se è usato start e un'altra istanza di 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 già in esecuzione e se vengono specificati URL, blocca quella sessione fino a quando esci.
Puoi usare con questa opzione come editor per messaggi di deposito nei sistemi di controllo versione come 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 ritorna immediatamente al chiamante, il file temporaneo è vuoto.
Questa opzione è richiesta anche con KIO ( 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 nella finestra del terminale.
kate -v --version 	 Elenca le informazioni sulla versione di .
kate --license 	 Mostra le informazioni sulla licenza.

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

Lavorare con
Avvio rapido ti mostrerà come modificare quattro semplici opzioni che ti consentiranno di configurare alcune della più potenti caratteristiche di . 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 per lavorare nella maniera che desideri.
Avviando 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 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 F. Questo menu offre una prima occhiata alle potenzialità e alla flessibilità di .
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 nella barra laterale per attivare o disattivare questa vista dello strumento.

Scorciatoie
Molte scorciatoie di possono essere configurate attraverso il menu Impostazioni. Le impostazioni predefinite di prevedono le seguenti associazioni di tasti.
F1	Aiuto
F1	Che cos'è?
N	Nuovo documento
L	Salva tutti
O	Apre apri un documento
O	Apertura rapida
F	Modalità a tutto schermo
,	Configura
W /	Chiudi
Q	Esci - chiude la copia attiva dell'editor
F	Mostra le barre laterali
T	Dividi orizzontalmente
L	Dividi verticalmente
F8	Vista divisa successiva
F8 /	Vista divisa precedente
R	Chiudi la vista corrente
	Scheda successiva
	Scheda precedente
Inoltre puoi usare le scorciatoie fornite dal componente e da tutte le estensioni di attivate.

Lavorare con MDI

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

La finestra principale
La finestra principale di è una finestra standard di , 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 .
La vista di uno strumento può essere indicata come persistente dal menu del . 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 .

L'area di modifica
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 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 usa per raccogliere liste multiple di file e di configurazioni della . 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 può salvare la lista dei file aperti e la configurazione generale della finestra in una sessione, ma versioni future di potrebbero aggiungere altre caratteristiche che siano memorizzabili nelle sessioni. Con l'introduzione delle sessioni, 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 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 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 mostra il nome della sessione all'inizio del titolo, che quindi avrà la forma Nome sessione: Nome o del documento - .
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 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 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 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 il file selezionato verrà aperto, mentre con 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 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
Questo manuale 	 Offre una documentazione dettagliata su tutti i comandi dei menu, opzioni di configurazione, strumenti, finestre di dialogo, estensioni così come le descrizioni delle finestre di , l'editor e i vari concetti usati nell'applicazione.
Premi F1 o usa il menu Aiuto Manuale di 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 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 e quindi la documentazione collegata.

Con i tuoi file di testo
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 o la documentazione info, oppure puoi usare .

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