Manuale di Kate

Manuale di Kate

Anders Lund

Seth Rothberg

Dominik Haumann

T.C. Hollingsworth

Traduzione e manutenzione del documento: Paolo Zamponi
Traduzione della documentazione.: Nicola Ruggero
Traduzione della documentazione.: Luciano Montanaro
Traduzione della documentazione.: Luigi Toscano
Revisione Applications 18.08 (22/05/2018)

Kate è un editor avanzato di testi della comunità KDE.

Questo manuale si riferisce alla versione 18.08 di Kate


Indice

1. Introduzione
2. I Fondamenti
Avvio di Kate
Dal menu
Dalla riga di comando
Trascinamento
Lavorare con Kate
Avvio rapido
Scorciatoie
Lavorare con Kate MDI
Panoramica
L'area di modifica
Uso delle sessioni
Ricevere aiuto
Con Kate
Con i tuoi file di testo
Articoli su Kate
3. Lavorare con l'editor Kate
4. Lavorare con le estensioni
Estensioni dell'applicazione Kate
Estensione per il Navigatore backtrace
Usare l'estensione Navigatore backtrace
Configurazione
Estensione di generazione
Introduzione
Usare l'estensione di generazione
Struttura del menu
Ringraziamenti e riconoscimenti
Estensione di chiusura per gruppo
Introduzione
Usare l'estensione di chiusura per gruppo
Struttura del menu
Estensione CTags
Introduzione
Configurazione
Utilizzare l'estensione CTags
Struttura del menu
Estensione per l'anteprima del documento
Introduzione
Struttura del menu
Interfaccia
Estensione per lo scambio dei documenti
Struttura del menu
Il selettore dei file
Struttura del menu
Interfaccia
Configurazione
L'elenco dei documenti
Introduzione
Struttura del menu
Configurazione
Estensione per GDB
Introduzione
Menu e struttura della barra degli strumenti
Vista di debug
Pila di chiamate e Locali
Ringraziamenti e riconoscimenti
Estensione Lumen
L'estensione Apri intestazioni
Usare l'estensione Apri intestazioni
Struttura del menu
Estensione di progetto
Introduzione
Mostrare una vista strutturata dei file
Passaggio ad un altro progetto
Ricerca e sostituzione nei progetti
Completamento automatico semplice
Apertura rapida dei file
Supporto alla compilazione del progetto
Creare i progetti
Progetto attuale
Il menu Progetti
Estensione di completamento del codice Rust
Ricerca e sostituzione
Introduzione
Interfaccia
Struttura del menu
Frammenti di Kate
Introduzione
Struttura del menu
Pannello dei frammenti
Usare i frammenti
Ringraziamenti e riconoscimenti
Estensione SQL
Introduzione
Connessione ad una banca dati
Eseguire le interrogazioni
Sfogliare
Struttura del menu
Ringraziamenti e riconoscimenti
Estensione Visore di simboli
Usare l'estensione di chiusura per gruppo
Struttura del menu
Configurazione
Estensione Strumento visivo per terminale
Struttura del menu
Configurazione
L'estensione Filtro di testo
Usare l'estensione Filtro di testo
Struttura del menu
Validazione XML
Struttura del menu
Ringraziamenti e riconoscimenti
Completamento XML
Uso
Funzionalità e limitazioni
Struttura del menu
Ringraziamenti e riconoscimenti
5. Strumenti avanzati di modifica
6. Estensione di Kate
Introduzione
Lavorare con l'evidenziazione della sintassi
Scripting con JavaScript
Estensioni dell'applicazione Kate (C++)
7. La modalità di inserimento Vi
8. Le voci dei menu
Il menu File
Il menu Modifica
Il menu Visualizza
Il menu Segnalibri
Il menu Sessioni
Il menu Strumenti
I menu Impostazioni e Aiuto
9. Configurare Kate
Panoramica
La finestra di configurazione principale
La configurazione dell'applicazione Kate
Generale
Sessioni
Estensioni
Configurazione del componente editor
Configurazione con le variabili dei documenti
10. Riconoscimenti e licenza
A. Espressioni regolari
B. Installazione

Lista delle tabelle

4.1. Alcune estensioni KParts disponibili
Capitolo 1. Introduzione

Capitolo 1. Introduzione

Benvenuto in Kate, un editor avanzato di testi della comunità KDE. Tra le molte caratteristiche di Kate ci sono l'evidenziazione configurabile della sintassi per linguaggi che vanno dal C e C++ all'HTML e agli script di bash, la possibilità di creare e gestire progetti, un'interfaccia MDI (multiple document interface) ed un emulatore di terminale integrato.

Ma Kate è molto di più di editor avanzato di testi: la sua capacità di aprire diversi file contemporaneamente è l'ideale per modificare molti file di configurazione di UNIX®. Questa documentazione, per esempio, è stata scritta con Kate.

Scrittura di questo manuale...

Capitolo 2. I Fondamenti

Capitolo 2. I Fondamenti

Traduzione e manutenzione della documentazione: Paolo Zamponi
Traduzione della documentazione.: Nicola Ruggero

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 ApplicazioniUtilità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 ftp://ftp.kde.org/pub/kde/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 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 --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

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 VisualizzaViste 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 tasto sinistro del mouse 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+

Scheda successiva

Alt+

Scheda precedente

Inoltre puoi usare le scorciatoie fornite dal componente KatePart e da tutte le estensioni di Kate attivate.

Lavorare con Kate MDI

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 tasto destro del mouse.

La vista di uno strumento può essere indicata come persistente dal menu del tasto destro del mouse. 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

Uso delle sessioni

Le sessioni sono il metodo che Kate usa per raccogliere liste multiple di file e di configurazioni. 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:

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.

Ricevere aiuto

Ricevere aiuto

Con Kate

Questo manuale

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

Premi F1 o usa il menu AiutoManuale 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 AiutoChe 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

L'homepage di Kate fornisce alcuni articoli e how-to per approfondire aspetti che questo manuale non tratta.

Capitolo 3. Lavorare con l'editor Kate

Capitolo 3. Lavorare con l'editor Kate

Per informazioni sulle basi del lavoro con il componente di sottolineatura dell'editor Kate vedi il capitolo Lavorare con l'editor KatePart del manuale di KatePart.

Capitolo 4. Lavorare con le estensioni

Capitolo 4. Lavorare con le estensioni

Anders Lund

Traduzione e manutenzione della documentazione: Paolo Zamponi
Traduzione della documentazione: Vincenzo Reale
Traduzione della documentazione: Nicola Ruggero
Traduzione della documentazione: Federico Zenith

Kate ha molte estensioni, ma essenzialmente di due tipi: alcune sono scritte in C++ nativo, altre invece nel linguaggio di programmazione Python. Esistono delle sottili differenze tra questi, come descritto qui sotto.

Puoi abilitare qualsiasi tipo di estensione nella finestra di configurazione, che dà anche accesso ad opzioni di configurazione aggiuntive, se richieste dalle estensioni.

Estensioni dell'applicazione Kate

Le estensioni di Kate sono funzioni aggiuntive per l'editor Kate. Possono aggiungere nuovi menu e nuove scorciatoie, ed estendere le funzionalità di Kate. Puoi installarne quante ne vuoi, e dall'interno di Kate: apri la finestra di configurazione di Kate con ImpostazioniConfigura Kate..., seleziona ApplicazioneEstensioni e scegli quelle che vuoi.

Le estensioni per l'applicazione disponibili sono:

Estensione per il Navigatore backtrace

Estensione per il Navigatore backtrace

Usare l'estensione Navigatore backtrace

Questa estensione è destinata più agli sviluppatori che agli utenti: mostra in uno strumento visivo di Kate il backtrace consegnato da gdb in una vista a elenco: facendo clic su di un elemento si apre il file selezionato al numero di riga corretto. Funziona solo per i backtrace generati sulla tua macchina, ma funzionerà anche sui backtrace di altre, cioè verrà trovato /home/dummy/qt-copy/…/qwidget.cpp anche su altre macchine. Affinché questo funzioni devi indirizzare le cartelle in cui è localizzato il codice sorgente.

A volte ci sono più file con lo stesso nome, ad es.

kdegraphics/okular/generators/dvi/config.h
kdepim-runtime/resources/gmail/saslplugin/config.h

Per selezionare quello giusto l'estensione prende le ultime due parti dell'url, che in questo caso sarebbero

dvi/config.h
saslplugin/config.h

E quindi di solito l'estensione trova quello giusto.

L'indicizzazione di master e di altri rami porterà ovviamente ad un conflitto.

Configurazione

Aggiungi le cartelle che contengono il codice sorgente nella pagina di configurazione.

Configura i percorsi nella vista dello strumento di navigazione Backtrace

Un clic su OK fa iniziare l'indicizzazione; apri lo strumento visivo Navigatore Backtrace quando questa finisce.

Ora puoi caricare un backtrace dagli appunti (ad es., quando fai clic su Copia negli appunti in DrKonqi), o da un file.

Estensione di generazione

Estensione di generazione

Salma Sultana

T.C. Hollingsworth

Introduzione

L'estensione di generazione ti permette di eseguire azioni come la generazione, la pulizia e la compilazione di un progetto.

Usare l'estensione di generazione

L'estensione di generazione aggiunge la vista dello strumento Output compilazione in basso, ed un menu Compila nella barra dei menu. La vista dello strumento può essere usata per configurare le impostazioni degli obiettivi della compilazione, mentre il menu può essere usato per effettuare le azioni di generazione, di pulizia e di compilazione.

La vista dello strumento Output compilazione ha due schede:

  • Impostazioni obiettivo

  • Output

Scheda delle impostazioni degli obiettivi

La scheda delle impostazioni dell'obiettivo può essere usata per configurare i vari obiettivi della compilazione e per definire gli insiemi degli obiettivi.

Per cambiare i nomi o i comandi fai doppio clic sulle voci nella tabella e usa la casella a tendina per selezionare l'insieme degli obiettivi attivi; se invece spunti la casella davanti ad un obiettivo, allora lo definisci come predefinito.

Un nuovo insieme di obiettivi contiene molte opzioni di configurazione:

Cartella di lavoro

Qui puoi impostare il percorso del progetto; lascialo vuoto se vuoi usare la cartella in cui si trova il documento corrente.

Compila

Questa opzione ti permette di definire il comando di compilazione; l'impostazione predefinita è make.

Pulisci

Questa opzione ti permette di definire il comando di pulizia; l'impostazione predefinita è make clean.

Configurazione

Questa opzione permette di definire il comando di configurazione; l'impostazione predefinita è cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=/usr/local ../.

In alto questa estensione ha una barra degli strumenti, con i seguenti pulsanti:

Compila l'obiettivo selezionato
Aggiungi un nuovo obiettivo di compilazione
Crea un nuovo insieme di obiettivi
Copia un comando o un insieme di obiettivi
Elimina il comando o l'insieme degli obiettivi attuali

Scheda dell'output

La scheda Output mostra l'output della console generato dall'ultimo comando.

Usa il cursore presente nella parte superiore per mostrare o nascondere alcune categorie di output:

Output compilazione completo, Output compilazione ottimizzato, Errori ed avvisi oppure Solo errori

Ogni riga contiene un messaggio e, se disponibili, il nome del file e il numero di riga. Facendo clic sull'errore o sull'avviso vieni portato al file appropriato, e il cursore si trova già sulla riga corrispondente.

Per andare all'errore precedente premi Alt+Shift+, mentre per andare al successivo premi Alt+Shift+.

Struttura del menu

CompilaSeleziona obiettivo...

Seleziona da un elenco di obiettivi configurato dall'utente.

CompilaCompila l'obiettivo predefinito

Compila l'obiettivo definito come predefinito nell'insieme degli obiettivi attivi.

CompilaCompila l'obiettivo precedente

Passa al precedente obiettivo configurato dall'utente.

CompilaFerma

Ferma la compilazione di un obiettivo.

CompilaErrore precedente (Ctrl+Alt+)

Sposta il cursore sull'errore precedente nel documento.

CompilaErrore successivo (Ctrl+Alt+)

Sposta il cursore sull'errore successivo nel documento.

Ringraziamenti e riconoscimenti

L'estensione di compilazione di Kate è stata scritta da Kåre Särs.

Ringraziamenti speciali vanno alla partecipante del Google Code-In 2011, Salma Sultana, per aver scritto la gran parte di questa sezione.

Estensione di chiusura per gruppo

Estensione di chiusura per gruppo

Introduzione

Questa estensione ti permette di chiudere un gruppo di documenti in base alla loro estensione e al loro percorso.

Usare l'estensione di chiusura per gruppo

Assumendo che tu abbia questi documenti aperti in Kate:

/tmp/subfolder/test.h
/tmp/test.cpp
/tmp/test.txt

Allora hai le seguenti opzioni per chiudere i documenti, come visualizzato nella schermata successiva:

Usa la casella nell'ultima voce della lista per abilitare o disabilitare una finestra di conferma. Le opzioni selezionate saranno applicate ad entrambe le azioni di chiusura.

Struttura del menu

FileChiudi tranne

Chiude tutti i documenti tranne quelli con il percorso o l'estensione selezionati dal sotto-menu.

FileChiudi simili

Chiude tutti i documenti con il percorso o l'estensione selezionati nel sotto-menu.

Estensione CTags

Estensione CTags

Introduzione

CTags genera un file indice (o tag) di oggetti del linguaggio trovati nei file sorgente, che permette a queste voci di essere velocemente e facilmente localizzate da Kate per mezzo di questa estensione.

Un tag è un oggetto del linguaggio per il quale è disponibile una voce indice (o in alternativa la voce indice creata per quell'oggetto).

La generazione di tag è supportata per questi linguaggi di programmazione.

Configurazione

L'estensione CTags usa due diversi file di banca dati per l'indice.

Nella pagina delle impostazioni di CTags nella configurazione di Kate puoi aggiungere o rimuovere le cartelle contenenti il codice sorgente e rigenerare la banca dati comune di CTags.

Indice comune

Configurare la banca dati globale di CTags

In basso alla pagina delle impostazioni puoi adattare il comando CTags.

Per ulteriori informazioni su tutte le opzioni disponibili leggi le pagine man di CTags, che sono presenti nel KHelpCenter; puoi anche digitare l'URL man/:ctags direttamente in Konqueror

L'indicizzazione inizia facendo clic su Aggiorna; quando finisce chiudi la finestra.

Sessione di indicizzazione

Per configurare la sessione di indicizzazione apri la vista CTags.

Fonti indicizzazione

In questa scheda puoi aggiungere o rimuovere le cartelle contenenti il codice sorgente e rigenerare manualmente la banca dati specifica per la sessione di CTags.

Banca dati
Configurare la banca dati per la sessione di CTags

Seleziona un altro file di banca dati di CTags, configura i comandi di CTags oppure ripristina quelli predefiniti.

Utilizzare l'estensione CTags

Metti il puntatore del mouse sugli oggetti del linguaggio come le funzioni, i simboli ecc. a cui sei interessato e seleziona una delle azioni dal menu CTags: salterai alla riga del file dove l'oggetto è stato definito o dichiarato.

Le azioni del menu CTags non hanno nessuna scorciatoia predefinita; per configurarle usa l'editor di scorciatoie da tastiera.

In alternativa puoi usare il campo di ricerca nella scheda Ricerca della vista CTags.

Digitando dei caratteri nel campo di ricerca, questa inizierà: saranno visualizzati i nomi corrispondenti degli oggetti del linguaggio, come funzioni, classi, simboli ecc., insieme al tipo ed al nome del file.

Seleziona una voce nella lista per saltare nel file sorgente alla riga corrispondente.

Struttura del menu

CTagsTorna indietro di un passo

Torna indietro all'ultimo tag visitato nella cronologia.

CTagsCerca testo corrente

Apre la scheda Ricerca della vista CTags e visualizza tutti gli oggetti del linguaggio corrispondenti all'attuale selezione di testo nella lista.

CTagsVai alla dichiarazione

Se il cursore è su una definizione di oggetto allora il documento contenente la dichiarazione dello stesso si aprirà, se necessario, e sarà attivata la sua vista, con il cursore posizionato all'inizio della dichiarazione.

CTagsVai alla definizione

Se il cursore è su una dichiarazione di oggetto, questa aprirà il documento contenente la dichiarazione dello stesso, se necessario, e attiverà la sua vista, con il cursore all'inizio della definizione.

Estensione per l'anteprima del documento

Estensione per l'anteprima del documento

Introduzione

Questa estensione abilita un'anteprima in diretta del documento di testo attualmente modificato; questo avviene nella barra laterale nel suo formato finale. Quindi il risultato sarà immediatamente visibile vicino al testo sorgente quando, ad esempio, modifichi un testo Markdown o un'immagine SVG.

Per la visualizzazione viene utilizzata l'estensione KParts che è attualmente selezionata come preferita per il tipo MIME del documento. L'anteprima non è quindi possibile se non c'è nessuna estensione KParts per quel tipo.

Per cambiare l'estensione preferita apri il modulo Associazioni dei file nelle Impostazioni di sistema e modifica l'Ordine di preferenza dei servizi nella scheda Integrazione.

Tabella 4.1. Alcune estensioni KParts disponibili

Tipo MIMEEstensione KParts
Testo MarkdownKMarkdownWebViewPart oppure OkularPart
Immagine SVGSVGPart
File UI di QtKUIViewerPart
File grafi DOTKGraphviewerPart

Struttura del menu

VisualizzaViste degli strumentiMostra anteprima

Mostra o nasconde in una barra laterale l'anteprima del documento di Kate.

Interfaccia

I pulsanti nella parte alta della finestra dell'anteprima forniscono queste azioni:

  • Blocca l'anteprima su un certo documento. Selezionando questa opzione ti assicuri che, se il fuoco passa ad un altro documento nella stessa finestra di Kate, l'anteprima non seguirà quel documento ma rimarrà invece sul precedente.

  • Abilita o disabilita l'aggiornamento del contenuto dell'anteprima del documento corrente

  • Aggiorna manualmente il contenuto dell'anteprima del documento corrente

  • Un menu a discesa con delle azioni dall'estensione KParts

Estensione per lo scambio dei documenti

Estensione per lo scambio dei documenti

Struttura del menu

VisualizzaUltime viste usate (Ctrl+Tab), VisualizzaUltime viste usate (Opposto) (Ctrl+Shift+Tab)

Apre una lista con i documenti visualizzati di recente:

Tieni il tasto Ctrl premuto ed usa Tab per scorrere avanti nell'elenco; premi anche il tasto Shift per invertire la direzione.

Tieni premuta la scorciatoia Ctrl+Tab e potrai usare i tasti , , o Fine per spostarti nella lista. Se invece premi più volte un carattere, allora passerai su tutte le voci della lista che cominciano con quella lettera; rilasciando la scorciatoia andrai al documento che hai selezionato.

Il selettore dei file

Il selettore dei file

Il selettore dei file è un visore di cartelle, che ti permette di aprire i file da una cartella visualizzata nel riquadro attuale.

Struttura del menu

VisualizzaViste degli strumentiMostra il selettore dei file

Mostra o nasconde il selettore dei file di Kate.

Interfaccia

Dall'alto al basso, il selettore dei file è composto dai seguenti elementi:

Una barra degli strumenti

Questa contiene i pulsanti standard per la selezione:

Indietro

Provoca l'esecuzione del comando cd nella cartella precedente nella cronologia. Questo pulsante è disabilitato se la cartella in questione non esiste.

Avanti

Provoca l'esecuzione del comando cd nella cartella successiva nella cronologia. Questo pulsante è disabilitato se la cartella in questione non esiste.

Segnalibri

Apre un sotto-menu da cui puoi modificare o aggiungere i segnalibri, e anche aggiungere una nuova cartella di segnalibri.

Cartella del documento attuale

Questo pulsante fa eseguire alla vista delle cartelle il comando cd nella posizione in cui è contenuto il documento attualmente attivo, se possibile. Questo pulsante è disabilitato se il documento attivo è un nuovo file che non è ancora stato salvato, oppure se la cartella in cui risiede non è individuabile.

Opzioni
Vista breve

Mostra solo i nomi dei file.

Vista dettagliata

Visualizza il Nome, la Data e la Dimensione dei file.

Vista ad albero

Come la vista breve, ma le cartelle possono essere espanse per visualizzarne i contenuti.

Vista ad albero dettagliata

Anche questa permette di espandere le cartelle, ma mostra le colonne aggiuntive disponibili nella vista dettagliata.

Mostra i file nascosti

Mostra i file che sono normalmente nascosti dal sistema operativo.

Sincronizza automaticamente con il documento attuale

Quando questa opzione è abilitata il selettore dei file eseguirà automaticamente il comando cd nella cartella del documento attualmente aperto nell'area di modifica ogni volta che cambia.

Una voce per la posizione

Questo mostra il percorso di navigazione della cartella attualmente aperta, come in Dolphin: puoi fare clic su qualsiasi cartella per sfogliarla, o fare clic su una delle frecce alla sinistra di una cartella per selezionare qualsiasi cartella sottostante. Puoi anche effettuare selezioni dall'elenco delle tue Risorse facendo clic sull'icona in fondo a sinistra nel percorso di navigazione, che mostra un'icona rappresentante la Risorsa attuale.

Puoi anche fare clic alla destra del percorso di navigazione per trasformarlo in una casella di testo; qui puoi digitare il percorso di una cartella da sfogliare. La voce URL mantiene una lista di tutti i percorsi precedentemente inseriti: per sceglierne uno usa il pulsante con la freccia alla sua destra.

Suggerimento

Il campo URL ha il completamento automatico dei nomi delle cartelle, che può essere impostato utilizzando il tasto destro del mouse sul campo di inserimento.

Una vista delle cartelle

Questa è una vista standard delle cartelle di KDE.

Una voce di filtro

La voce di filtro ti permette di definire un filtro per i file visualizzati nella vista delle cartelle. Il filtro usa gli schemi standard; questi devono essere separati da spazi, per esempio: *.cpp *.h *.moc.

Inserisci un asterisco singolo * per visualizzare tutti i file.

La voce di filtro salva gli ultimi dieci filtri inseriti durante la sessione: per usarne uno fai clic sul pulsante con la freccia a destra del campo di inserimento, e seleziona quello che desideri. Puoi disattivare il filtro premendo il pulsante Pulisci il testo, che si trova alla sinistra del pulsante di auto-completamento a freccia.

Configurazione

Questa estensione può essere configurata nella pagina del Selettore dei file della configurazione di Kate.

Barra degli strumenti

Configura i pulsanti della barra del selettore dei file spostando quelli che desideri nell'elenco Azioni selezionate, e ordinali con i pulsanti a freccia di fianco all'elenco.

L'elenco dei documenti

L'elenco dei documenti

Introduzione

L'elenco dei documenti mostra la lista di tutti i documenti attualmente aperti in Kate. Per indicarne lo stato, i file modificati avranno una piccola icona a forma di dischetto alla loro sinistra.

In alto all'elenco dei documenti c'è una barra degli strumenti, che ha i seguenti pulsanti:

Crea un nuovo documento
Apre un documento esistente
Il documento precedente
Il documento successivo
Salva il documento attuale
Salva il documento attuale con un nuovo nome

L'elenco dei documenti compare come impostazione predefinita nella Modalità ad albero, che mostra la struttura delle cartelle attorno a tutti i documenti aperti. È disponibile anche la Modalità a lista, che mostra invece un semplice elenco dei documenti aperti. Puoi cambiare la modalità facendo clic destro sull'elenco e selezionando la Modalità di visualizzazione dal menu.

Se due o più file (che si trovano in cartelle diverse) hanno lo stesso nome e sono aperti nella Modalità elenco, al nome del secondo file e dei successivi verrà anteposto un «(2)», e così via. Il suggerimento del file ti mostrerà comunque il suo nome con il percorso completo, permettendoti così di scegliere quello che desideri.

Fai clic sul nome del documento nella lista per visualizzare un documento nel riquadro attivo.

Il menu contestuale ha alcune azioni in comune con il menu File.

Ci sono anche le azioni proprie di un gestore di file, che servono per rinominare o cancellare i file; con Copia il nome del file potrai copiare negli appunti l'intero percorso del documento.

Facendo clic con il tasto destro sulla lista, e selezionando una voce dal menu Ordina per, potrai ordinare l'elenco in diversi modi. Le opzioni sono:

Nome documento

Elenca i documenti alfabeticamente per nome.

Percorso documenti

Elenca i documenti alfabeticamente in base al loro percorso.

Ordine di apertura

Elenca i documenti in base all'ordine di apertura.

L'elenco dei documenti visualizza, come impostazione predefinita, la cronologia, ombreggiando il colore dello sfondo dei documenti più recenti: se il documento viene modificato gli viene miscelato un altro colore. I documenti più recenti hanno colori più vivi, quindi potrai trovare facilmente quelli su cui stai lavorando. Questa funzionalità può essere disabilitata dalla pagina Documenti del pannello di configurazione.

La posizione predefinita dell'elenco dei documenti nella finestra di Kate è alla sinistra dell'area dell'editor.

Struttura del menu

VisualizzaDocumento precedente (Alt+)

Apre il documento visualizzato sopra il documento attualmente aperto nell'elenco dei documenti.

VisualizzaDocumento successivo (Alt+)

Apre il documento visualizzato sotto il documento attualmente aperto nell'elenco dei documenti.

VisualizzaMostra attivo

Mostra il documento attualmente aperto nell'elenco dei documenti.

Configurazione

Sfumature di sfondo

Questa sezione ti permette di abilitare o disabilitare la visualizzazione delle sfumature dello sfondo nelle tue attività recenti, e, se abilitata, di scegliere quali colori usare.

Ordina per

Imposta il tipo di ordinamento da dare ai documenti; può anche essere impostato con il menu che appare facendo clic con il tasto destro del mouse nell'elenco dei documenti.

Modalità di visualizzazione

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

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 della cartella, oltre al nome. Non ha effetto nella vista a elenco.

Estensione per GDB

Estensione per GDB

Martin Gergov

T.C. Hollingsworth

Introduzione

L'estensione per GDB di Kate fornisce una semplice interfaccia al popolare debugger del progetto GNU.

Importante

Una precedente esperienza con GDB è caldamente raccomandata; visita il sito Web di GDB per maggiori informazioni sul suo uso.

Puoi abilitare l'estensione per GDB nella sezione delle estensioni della configurazione di Kate.

Affinché l'estensione funzioni correttamente devi avere un file sorgente (di un qualsiasi tipo supportato da GDB), ed un eseguibile.

Suggerimento

Se compili usando gcc o g++, potresti aver bisogno di usare l'argomento da riga di comando -ggdb.

Fatte queste preparazioni apri il file sorgente in Kate, inserisci il percorso all'eseguibile nella scheda Impostazioni della vista dello strumento Vista di debug e seleziona dal menu DebugAvvia il debug per cominciare.

Menu e struttura della barra degli strumenti

Tutte queste opzioni sono disponibili nei menu di Kate, e molte sono disponibili anche nella barra degli strumenti di debug.

VisualizzaViste degli strumentiMostra Vista di debug

Mostra una vista contenente l'output di GDB, la riga di comando di GDB usata, ed altre impostazioni.

VisualizzaViste degli strumentiMostra locali e pila

Mostra un elenco di tutte le variabili attualmente in memoria, i loro valori ed un backtrace di GDB.

DebugObiettivi

Un sotto-menu contenente un elenco di obiettivi (eseguibili).

DebugAvvia il debug

Avvia GDB con un obiettivo.

DebugTermina / interrompi il debug

Interrompe GDB.

DebugRiavvia il debug

Riavvia GDB.

DebugCommuta punto di interruzione / interrompi

Imposta un punto di interruzione alla posizione attuale del cursore.

DebugEntra

Esegui l'istruzione attuale (sarà effettuato il debug della chiamata a funzione).

DebugPassa oltre

Esegui l'istruzione attuale (non sarà effettuato il debug della chiamata a funzione).

DebugEsci

Riprende l'esecuzione fino alla conclusione del programma in esecuzione.

DebugSposta contatore dei programmi

Sposta contatore dei programmi (prossima esecuzione).

DebugEsegui fino al cursore

Esegue il programma fino a raggiungere l'attuale posizione del cursore.

DebugContinua

Ignora qualsiasi punto di interruzione ed esegue il programma fino alla sua conclusione (corretta o meno).

DebugStampa valore

Stampa il valore della variabile attualmente indicata dal cursore.

ImpostazioniBarre mostrateEstensione GDB

Mostra la barra degli strumenti di debug.

Vista di debug

La vista dello strumento Vista di debug è composta da diverse schede:

Uscita di GDB

Contiene l'uscita di GDB ed una riga di comando per GDB.

La scheda Uscita.

La scheda Uscita mostra il risultato generato sulla console da una sessione di debug.

Impostazioni
Eseguibile

Percorso dell'obiettivo (l'eseguibile) su cui eseguire il debug.

Cartella di lavoro

La cartella di lavoro attuale fornita all'obiettivo.

Argomenti

Argomenti passati al programma.

Mantieni attivazione

Mantiene attiva la riga di comando di GDB.

Ridireziona I/O

Apre una nuova scheda I/O nella Vista di debug, dove puoi vedere l'uscita ed inserire gli ingressi al programma in esecuzione.

La finestra delle impostazioni

La finestra Impostazioni, che mostra la configurazione di una sessione di debug.

I/O

Contiene un'area che mostra l'uscita del programma attuale, ed una riga di comando dalla quale puoi passare degli ingressi.

La scheda I/O.

La scheda I/O, che mostra l'uscita di un semplice programma di prova.

Pila di chiamate e Locali

La vista dello strumento Pila delle chiamate contiene un elenco di backtrace formattati restituiti da GDB.

La vista dello strumento Pila delle chiamate.

La vista dello strumento Pila delle chiamate dell'estensione GDB.

La vista dello strumento Locali mostra un elenco di tutte le variabili attualmente in memoria del programma, ed i loro valori corrispondenti.

La vista dello strumento Locali.

La vista dello strumento Locali dell'estensione GDB.

Ringraziamenti e riconoscimenti

Ringraziamenti speciali vanno al partecipante del Google Code-In 2011, Martin Gergov, per aver scritto la maggior parte di questa sezione.

Estensione Lumen

Estensione Lumen

Lumen è un'estensione che fornisce il completamento del codice per il linguaggio di programmazione D; è solo una connessione tra l'editor ed il demone di completamento di D, che è chiamato DCD. Attualmente l'estensione supporta tutte le principali funzionalità del server di completamento: inserimento nel server dei file importati, visualizzazione della documentazione e molti tipi di completamento:

Importazioni:

Completamento per Bash:

Completamento (funzione sovraccaricata):

Calltips:

Per far funzionare Lumen devi installare DCD; usa le informazioni fornite dalla comunità D.

Dopo aver installato DCD modifica (o crea, se non esiste) il file ~/.config/dcd/dcd.conf aggiungendo un percorso per i file D da includere o importare, ad es. /usr/include/dlang/dmd, oppure /usr/include/d.

Inoltre Lumen cercherà un file .lumenconfig in ogni cartella superiore a quella del file sorgente D attualmente aperto, e gli aggiungerà in ogni riga un percorso di inclusione al server DCD. Aggiungi in questo file tutte le dipendenze del progetto attuale.

Ora avvia il server di completamento con il comando dcd-server e abilita l'estensione per Lumen nelle impostazioni: potrai così disporre del completamento del codice per il linguaggio di programmazione D all'interno di Kate

L'estensione Apri intestazioni

L'estensione Apri intestazioni

Usare l'estensione Apri intestazioni

Durante la scrittura di codice C o C++ questo comando passerà dal file di intestazione al corrispondente file C/C++ o viceversa.

Per esempio, se stai editando myclass.cpp questa azione visualizzerà, se disponibile nella stessa cartella, il file myclass.h.

Funziona con coppie che hanno le seguenti estensioni:

File di intestazioni: h, H, hh, hpp
File sorgenti: c, cpp, cc, cp, cxx

Struttura del menu

FileApri .h/.cpp/.c (F12)

Apri il corrispondente file sorgente o di intestazione per il documento attivo.

Estensione di progetto

Estensione di progetto

Introduzione

L'idea di base dell'estensione di progetto è quella di avere una lista strutturata di file che appartengono al progetto, con le seguenti proprietà:

  1. Fornire una vista strutturata dei file

  2. Rendere semplice e molto veloce l'apertura ed il passaggio tra i vari progetti

  3. Supportare la ricerca e la sostituzione nel progetto

  4. Fornire un semplice completamento automatico

  5. Rendere semplice l'apertura rapida dei file del progetto

  6. Supportare la compilazione dei progetti

Mostrare una vista strutturata dei file

Apri un file di un progetto una volta che l'estensione di progetto è caricata nella pagina di configurazione di Kate: ti apparirà una barra laterale elencante tutti i progetti, così come i loro file, in questo modo:

Come puoi vedere, «Kate» è il progetto attualmente attivo, ed il suo contenuto è elencato nella vista ad albero; facendo clic sui file nella vista, questi si apriranno nell'editor. Viene inoltre fornito un menu contestuale con il quale puoi aprire i file con altre applicazioni, ad esempio i file .ui con Qt Designer.

Puoi filtrare le voci: digita una parte del nome del file che stai cercando nella barra di ricerca che è in fondo alla lista.

Passaggio ad un altro progetto

L'idea è che non devi mai aprire un progetto manualmente, questo non è affatto supportato. Quindi, quello che succede quando apri un file è che l'estensione di progetto scansiona la sua cartella e quelle superiori alla ricerca di un file .kateproject: se lo trova, il progetto viene caricato automaticamente.

Inoltre l'estensione di progetto cambierà automaticamente l'attuale progetto se apri con Kate un documento che appartiene ad un altro progetto: in questo modo il progetto pertinente sarà attivo sempre. Naturalmente puoi anche cambiare il progetto attualmente attivo usando la casella combinata.

Ricerca e sostituzione nei progetti

Kate dispone di un'estensione di ricerca e sostituzione, che si trova nella barra laterale in basso: se c'è un progetto caricato apri la barra laterale Cerca e Sostituisci e passa alla modalità di ricerca e sostituzione nel progetto attuale:

Completamento automatico semplice

Grazie alla conoscenza di tutti i file che appartengono ad un progetto, l'estensione di progetto fornisce un semplice servizio di auto-completamento basato su CTags: se c'è un progetto aperto, CTags analizza in un processo in background tutti i file del progetto, e salva le informazioni CTags in /tmp; questo file viene poi utilizzato per popolare la finestra a comparsa del completamento automatico di Kate.

Di contro, senza questo auto-completamento Kate è capace solo di mostrare le voci di auto-completamento basandosi solo sulle parole del file attuale. In questo modo l'auto-completamento fornito dall'estensione di progetto è molto più potente.

Una finestrella passiva ti avviserà sull'eventuale mancanza di CTag. Degno di nota è il fatto che il file di CTags in /tmp viene cancellato alla chiusura di Kate: così l'estensione non inquinerà nessuna cartella con dei file indesiderati.

Apertura rapida dei file

Dato che fare clic su un file in una vista ad albero non è il modo più rapido per aprirlo, Kate fornisce un veloce meccanismo integrato; lo puoi attivare con Ctrl+Alt+O. Ottieni un elenco come questo:

Puoi filtrare digitando parte del nome del file che stai cercando, e puoi anche spostarti nella lista sia con i tasti freccia sia con Pagina su/giù.; con Invio attiverai invece il file selezionato, mentre con Esc nasconderai la vista di apertura rapida.

Inoltre l'apertura rapida si ricorda del file precedente, che viene selezionato quando passi alla vista di apertura rapida; così tu non devi far altro che premere Invio, cosa generalmente molto comoda.

Supporto alla compilazione del progetto

Un'altra caratteristica è quella di offrire supporto all'Estensione di compilazione, che così viene configurata correttamente.

Creare i progetti

Caricare i progetti automaticamente

L'estensione di progetto ha una funzionalità di auto-caricamento, che ti consente di leggere la lista dei file dal sistema di controllo della versione. Questa funzionalità deve essere abilitata nelle impostazioni (lo è in maniera predefinita):

Creare i progetti manualmente

Devi solo creare un file .kateproject nella cartella principale del progetto. Ad esempio, il file .kateproject di «Kate» apparirà così:

{
  "name": "Kate"
, "files": [ { "git": 1 } ]
}

Il contenuto del file è scritto con la sintassi JSON: il nome del progetto è «Kate», ed i file in esso contenuti dovrebbero essere letti da git.

Al posto di git sono supportati anche subversion, attraverso svn, e mercurial con hg. Se non vuoi leggere da un sistema di controllo di versione puoi caricare ricorsivamente i file dalle cartelle, come segue:

{
  "name": "Kate"
, "files": [ { "directory": "kate", "filters": ["*.cpp", "*.h", "*.ui", "CMakeLists.txt", "Find*.cmake"], "recursive": 1 } ]
}

Qui le sottocartelle ed i filtri definiscono ciò che fa parte del progetto; puoi anche mescolare il controllo della versione con dei file basati sui filtri.

Se vuoi aggiungere il supporto all'estensione di compilazione, allora puoi scrivere il file .kateproject così:

{
  "name": "Kate"
, "files": [ { "git": 1 } ]
, "build": {
    "directory": "build"
  , "build": "make all"
  , "clean": "make clean"
  , "install": "make install"
  }
}

Progetto attuale

Usando ProgettiVai a (Alt+1) potrai aprire il Progetto attuale, che è visualizzato in basso nella finestra dell'editor ed ha quattro schede:

Terminale

Un Emulatore di terminale che parte dalla cartella principale del progetto.

Indice del codice

La digitazione di caratteri nella barra di ricerca inizierà la ricerca, e visualizzerà i corrispondenti nomi delle funzioni, delle classi, dei simboli ecc., insieme al tipo, al nome del file e al numero di riga.

Seleziona una voce nella lista per saltare nel file sorgente alla riga corrispondente.

Analisi del codice

Fai clic su Inizia analisi per iniziare un'analisi statica del codice C e C++ usando cppcheck, e per generare un rapporto mostrante il nome del file, il numero delle righe, la gravità (stile, avvisi ecc.) e il problema trovato.

Seleziona una voce nella lista per saltare nel file sorgente alla riga corrispondente.

Note

Il testo inserito in questa scheda sarà salvato nel file nomeprogetto.kateproject.notes.

Il menu Progetti

Il menu Progetti ti permette di passare tra i progetti attualmente aperti. Viene visualizzato dall'estensione dei progetti.

ProgettiIndietro (Ctrl+Alt+)

Passa al progetto precedente.

ProgettiAvanti (Ctrl+Alt+)

Passa al progetto successivo

ProgettiVai a (Alt+1)

Apre la vista del Progetto attuale nella parte bassa della finestra di modifica.

Estensione di completamento del codice Rust

Estensione di completamento del codice Rust

Questa estensione fornisce il completamento del codice per il linguaggio di programmazione Rust.

Una volta che hai abilitato la voce di completamento del codice Rust nella pagina delle estensioni ti apparirà una nuova pagina nella finestra di configurazione di Kate.

Modifica il comando per eseguire Racer, un'utilità avente lo scopo di fornire il completamento per il codice Rust negli editor.

Hai anche bisogno del codice sorgente di Rust, e devi inoltre indicare il percorso per l'albero del sorgente.

Mentre stai digitando il codice ti apparirà in una lista a finestrella, con le voci per il completamento:

In aggiunta alle finestrelle per il completamento del codice, l'estensione installerà nel menu Modifica e nel menu contestuale l'azione Vai alla definizione. Puoi anche configurare una scorciatoia da tastiera.

Questa azione aprirà, se necessario, il documento contenente la definizione, attiverà la sua vista e metterà il cursore all'inizio della definizione.

Ricerca e sostituzione

Ricerca e sostituzione

T.C. Hollingsworth

Introduzione

L'estensione di ricerca e sostituzione di Kate ti consente di cercare del testo o delle espressioni regolari in molti file contemporaneamente. Puoi cercare in tutti i file aperti, in tutti i file di una cartella e, se vuoi, nelle sue sottocartelle, oppure nei file attivi. Puoi filtrare anche in base al nome del file, ad esempio cercando solo nei file che hanno un'estensione particolare.

Interfaccia

Interrogazione di ricerca

Le opzioni seguenti sono sempre visualizzate in cima alla vista dello strumento di ricerca nei file:

Puoi avere tante ricerche aperte quante vuoi allo stesso tempo: basta fare clic sul pulsante nuova scheda nell'angolo in alto a sinistra nella vista dello strumento di ricerca. Apparirà una nuova scheda di risultati, che ti permette di effettuare una nuova ricerca.

Il pulsante nell'angolo in alto a destra dello strumento di ricerca nei file visualizzerà alternativamente nella metà inferiore della vista dello strumento le opzioni aggiuntive per la modalità di ricerca nelle cartelle e i risultati della tua ricerca.

Trova

Qui è dove scrivi quello che vuoi cercare. Puoi inserire del testo normale oppure un'espressione regolare, se queste sono abilitate.

Sostituisci (casella di testo)

Il testo di sostituzione che verrà aggiunto ai file al posto del testo nella casella Trova.

Cerca

Quando hai finito di configurare tutto premi il pulsante Cerca per effettuare la ricerca. Per fare la stessa cosa puoi anche premere Invio nella casella di testo Trova.

Sostituisci

Quando hai finito di configurare tutto premi il pulsante Sostituisci per sostituire il testo inserito nella casella Trova con quello della casella Sostituisci. Per fare la stessa cosa puoi anche premere Invio nella casella di testo Sostituisci.

Successivo

Vai alla corrispondenza successiva della ricerca, cambiando file se necessario.

Sostituisci spuntati

Come per Sostituisci, ma la sostituzione sarà effettuata solo nei file che sono spuntati nel pannello sottostante.

Opzioni di ricerca nelle cartelle

Queste opzioni sono mostrate sotto le opzioni di interrogazione di cui sopra. Se sono invece visualizzati i risultati della ricerca premi il pulsante per mostrarle.

Cerca in

Qui ci sono tre opzioni: seleziona File aperti per cercare in tutti i file attualmente aperti in Kate, Cartella per cercare in una cartella e, a scelta, nelle sue sottocartelle, oppure File attuale per cercare solo nel file attivo.

Se l'estensione dei Progetti è caricata, puoi cercare sia nel Progetto attuale che in Tutti i progetti aperti.

Distingui le maiuscole

Limita i risultati a quelli che hanno le stesse maiuscole e minuscole specificate nella ricerca.

Espressioni regolari

Ti permette di usare le espressioni regolari invece che del semplice testo come stringa di ricerca.

Espandi i risultati

Visualizza tutti i risultati trovati in ogni file, invece che solo un elenco di file che contengono la stringa cercata.

Cartella

Puoi inserire il percorso della cartella in cui vuoi cercare; ad esempio, potresti inserire ~/sviluppo/kde/kate/ se volessi cercare nel codice sorgente di Kate. Questa opzione è disponibile solo se utilizzi la modalità nella cartella.

Apri finestra di selezione dei file

Premi questo pulsante per localizzare la cartella nel navigatore delle cartelle del tuo sistema. Questo pulsante funziona solo se si utilizza la modalità Cartella.

Premi questo pulsante per sostituire la Cartella con la cartella superiore a quella attualmente selezionata. Questo pulsante funziona solo se utilizzi la modalità Cartella.

Questo pulsante imposterà la voce della Cartella a quella in cui si trova il documento attuale. Il pulsante funziona solo se utilizzi la modalità Cartella.

Filtro

Questa opzione ti permette di cercare solo i nomi di file che corrispondano ad un certo schema. Cambialo ad esempio in *.cpp per cercare solo file scritti in C++, e in kate* per quelli che cominciano per kate. Puoi inserire più filtri separandoli con delle virgole (,); quest'opzione non è però disponibile nella modalità file aperti.

Escludi

Il contrario di Filtro: impedisce a Kate di cercare dei file che corrispondono a modelli precisi. Come per il Filtro puoi digitare più modelli separandoli con delle virgole (.); quest'opzione non è però disponibile nella modalità File aperti.

Ricorsivo

Se questa opzione è abilitata, Kate cercherà anche in tutte le sottocartelle della cartella selezionata. Questa opzione è disponibile solo se si utilizza la modalità cartella.

Includi i file nascosti

Se questa opzione è abilitata, Kate cercherà anche nei file o nelle cartelle che sono normalmente nascosti dal sistema operativo. Questa opzione è disponibile solo se si utilizza la modalità Cartella.

Segui i collegamenti simbolici

L'estensione di ricerca nei file normalmente non segue i collegamenti simbolici. Se questa opzione è abilitata l'estensione invece li seguirà, e cercherà nei file e nelle cartelle a cui riferiscono. Questa opzione è disponibile solo utilizzando la modalità Cartella.

Avvertimento

È possibile che i collegamenti simbolici puntino alla cartella genitore di quella attualmente cercata, o che altre cartelle contenenti collegamenti simbolici puntino ad essa. Se è presente un simile collegamento e l'opzione è abilitata, Kate seguirà ripetutamente il collegamento, e la ricerca non si concluderà mai.

Includi i file binari

Se questa opzione è abilitata, Kate cercherà anche nei file che non sembrano essere file di testo.

Risultati della ricerca

I risultati della ricerca sono visualizzati sotto le opzioni dell'interrogazione. Se sono mostrate le opzioni per la modalità di ricerca nelle cartelle basta premere il pulsante per mostrarli. Saranno inoltre automaticamente visualizzati non appena verrà effettuata una ricerca.

I risultati di ricerca visualizzano un elenco di file che contengono il testo che corrisponde alla ricerca effettuata, seguito dal numero di occorrenze trovate in quei file.

Per vedere un elenco di corrispondenze in quel file basta fare clic sulla freccia di espansione a sinistra del nome del file. (Se è stata selezionata l'opzione Espandi i risultati, ciò avverrà automaticamente). Sarà visualizzato il numero di riga di ogni corrispondenza seguito dal contenuto di tale riga, con i termini di ricerca indicati in grassetto.

Per aprire il file in cui è stato trovato il risultato basta fare doppio clic su di esso: se necessario Kate lo aprirà. Puoi inoltre spostare il cursore nella posizione di una corrispondenza particolare facendo doppio clic sulla voce in elenco anziché sul nome del file.

Struttura del menu

ModificaCerca nei file (Ctrl+Alt+F)

Avvia la vista dello strumento Ricerca e sostituisci

ModificaVai alla corrispondenza successiva

Vai alla corrispondenza successiva in una ricerca eseguita dall'estensione Cerca e sostituisci.

ModificaVai alla corrispondenza precedente

Vai alla corrispondenza precedente in una ricerca eseguita dall'estensione Cerca e sostituisci.

VisualizzaViste degli strumentiMostra cerca e sostituisci

Attiva o disattiva la visualizzazione dello strumento Cerca e sostituisci di Kate.

Frammenti di Kate

Frammenti di Kate

Martin Gergov

T.C. Hollingsworth

Introduzione

I frammenti di Kate sono un'estensione usata per risparmiare tempo con il supporto dei cosiddetti «frammenti» (codice sorgente, codice macchina o testo riutilizzabile). L'estensione supporta anche il completamento del codice e JavaScript.

Struttura del menu

VisualizzaViste degli strumentiMostra frammenti

Mostra il pannello contenente tutti i frammenti del tuo deposito che sono disponibili per il tipo di file attualmente aperto.

StrumentiCrea frammento

Crea un nuovo frammento, cioè un pezzo di testo riutilizzabile che puoi inserire in qualsiasi parte di qualsiasi documento.

Pannello dei frammenti

Il pannello dei frammenti di Kate.

Il pannello per i frammenti di Kate.

Nel pannello dovresti vedere un elenco di depositi di frammenti, insieme alle opzioni per crearne di tuoi, di recuperarli da Internet o di caricarli da un file locale. Ogni deposito ha una casella con cui puoi attivarlo o disattivarlo; ci sono anche dei pulsanti per modificare ed eliminare i depositi esistenti.

Caricare i file dei depositi di frammenti

Puoi scaricare i depositi di frammenti da Internet: basta che fai clic su Ottieni nuovi frammenti e ti apparirà una finestra con un elenco di depositi di frammenti. Dopo aver scaricato il frammento desiderato assicurati di attivarlo.

Creare e modificare i depositi

Per creare un nuovo deposito di frammenti fai clic su Aggiungi deposito. Ora dovresti vedere una finestrella che chiede il nome, la licenza e l'autore del file di frammenti: dopo aver scelto le opzioni desiderate fai clic su Ok.

L'editor di depositi.

L'interfaccia dell'editor di depositi.

L'editor dei depositi di frammenti contiene le seguenti opzioni:

Nome

Appare nell'elenco dei frammenti nella vista degli strumenti, e viene usato per la funzionalità di completamento del codice.

Spazio dei nomi

Prefisso usato nel completamento del codice.

Licenza

Seleziona la licenza per il tuo deposito di frammenti.

Autori

Inserisci i nomi degli autori del file di frammenti.

Tipi di file

Seleziona i tipi di file a cui vuoi che si applichi il deposito: l'impostazione predefinita è «», in modo che il deposito si applichi a tutti i file. Puoi cambiarla, per esempio in qualcosa come C++, oppure selezionare da un elenco mediante un clic sulle voci, e puoi specificare anche più di un tipo di file: basta che premi Shift mentre aggiungi i tipi.

Creare e modificare i frammenti

L'editor di frammenti.

L'interfaccia dell'editor di frammenti.

Nome

Il nome che sarà mostrato nell'elenco di completamento.

Scorciatoia

Premendo questa scorciatoia il frammento sarà inserito nel documento.

Frammenti

Il testo che il tuo frammento inserirà nel documento.

Un frammento può contenere campi modificabili, su cui puoi spostarti premendo Tab. Per creare i campi nel testo del modello si possono usare le seguenti espressioni:

${field_name} crea un semplice campo modificabile. Tutte le successive occorrenze dello stesso field_namecreano campi che rispecchiano i contenuti del primo durante la modifica.

${field_name=default} può essere usato per specificare un valore predefinito per il campo. default può essere una qualsiasi espressione JavaScript.

Usa ${field_name=testo} per specificare una stringa fissa come valore predefinito.

${func(other_field1, other_field2, ...)} può essere usato per creare un campo che valuta una funzione JavaScript per ciascuna modifica e che contiene il suo contenuto. Vedi la scheda Script per maggiori informazioni.

${cursor} può essere usato per segnare la posizione finale del cursore dopo che è stato riempito tutto il resto.

Script

Funzioni di supporto in Javascript da usare nei tuoi frammenti.

Tutte le funzioni JavaScript dovrebbero ritornare i contenuti che vuoi mettere nel modello di campo come una stringa.

Le funzioni sono chiamate in un ambito che contiene i contenuti di tutti i campi modello come variabili locali. Per esempio, in un frammento che contiene ${field} sarà presente una variabile, chiamata field , contenente i contenuti aggiornati del campo modello. Quelle variabili possono sia usate staticamente nella funzione sia passate come argomento usando la sintassi ${func(field)} oppure ${field2=func(field)} nella stringa del frammento.

Puoi usare l'API di scripting di Kate per ottenere il testo selezionato, l'intero testo, il nome del file ed altro usando i metodi appropriati degli oggetti document e view. Fai riferimento alla documentazione dell'API di scripting per ulteriori informazioni.

Usare i frammenti

Accesso ai frammenti di Kate da una vista degli strumenti e un menu a cascata.

Selezione da un elenco di frammenti.

Puoi richiamare i frammenti in due modi:

  • Scegliendo il frammento dalla vista dello strumento.

  • Premendo Ctrl+Spazio mentre scrivi: questo ti mostrerà tutti i frammenti in una comoda finestra da cui potrai sceglierne uno. Questa combinazione di tasti fornisce funzionalità simili a quelle del completamento del codice.

Se il frammento contiene variabili (oltre a ${cursor}) il cursore andrà automaticamente alla prima occorrenza di una variabile, e aspetterà che tu scriva qualcosa. Quando hai finito puoi premere Tab per passare alla prossima variabile, e così via.

Ringraziamenti e riconoscimenti

I frammenti di Kate sono stati scritti da Joseph Wenninger.

Ringraziamenti speciali vanno al partecipante del Google Code-In 2011, Martin Gergov, per aver scritto la maggior parte di questa sezione.

Estensione SQL

Estensione SQL

Ömer Faruk Oruç

T.C. Hollingsworth

Introduzione

Il linguaggio strutturato di interrogazione (SQL) è un linguaggio specializzato per l'aggiornamento, l'eliminazione e la richiesta di informazioni dalle banche dati.

L'estensione SQL per Kate ti permette di:

  • Creare una banca dati

  • Connetterti a banche dati esistenti

  • Inserire ed eliminare dati dalle banche dati

  • Eseguire le interrogazioni

  • Visualizzare i risultati in una tabella

Connessione ad una banca dati

Seleziona Aggiungi connessione dal menu o dalla barra degli strumenti SQL, e quindi seleziona il driver di banca dati di Qt che vuoi usare (inclusi QSQLITE, QMYSQL3, QMYSQL, QODBC3, QODBC, QPSQL7, e QPSQL); se non lo trovi devi installarlo. Premi quindi Successivo.

Se la banca dati che hai selezionato usa un file, basta che ne indichi la posizione e che premi il pulsante Successivo; se è invece richiesta la connessione ad un server devi inserire il nome host, il tuo nome utente, la tua password e qualsiasi altra informazione che il driver ti richieda. Premi quindi Successivo.

Infine dai un nome alla connessione e premi Successivo.

Eseguire le interrogazioni

INSERT/DELETE/UPDATE

Con l'estensione SQL puoi inserire, eliminare ed aggiornare i dati, proprio come faresti da riga di comando o da un programma: basta che inserisci un'interrogazione e che premi il pulsante Esegui interrogazione nella barra degli strumenti, oppure SQLEsegui interrogazione (Ctrl+E).

Esempio 4.1. Alcune interrogazioni d'esempio

INSERT
INSERT INTO nome_tabella ("campo1", "campo2", "campo3", "campo4", "campo5")
VALUES ("valore1", "valore2", "valore3", "valore4", "valore5" )
DELETE
DELETE FROM nome_tabella WHERE name = "testo"
UPDATE
UPDATE nome_tabella SET "campo1" = "testo", "campo2" = "testo", "campo3" = "testo", "campo4" = "testo", "campo5" = "testo"

SELECT

Dopo aver eseguito un'interrogazione di tipo SELECT puoi vederne i risultati in una tabella; questa apparirà nella vista degli strumenti Risultato di dati SQL in fondo a Kate, oppure come testo in Risultato di testo SQL. Se c'è un errore potrai vederlo dal risultato.

Esempio 4.2. Interrogazione SELECT d'esempio

SELECT * FROM nome_tabella

Nella vista degli strumenti Risultato di dati SQL ci sono diversi pulsanti:

Ridimensiona le colonne in base ai contenuti

Cambia le dimensioni delle colonne per adattarsi al loro contenuto.

Ridimensiona le righe in base ai contenuti

Cambia le dimensioni delle righe per adattarsi al loro contenuto.

Copia

Seleziona tutto il contenuto della tabella e lo copia negli appunti.

Esporta

Esporta tutto il contenuto della tabella in un file, negli appunti o nel documento attuale in formato di valori separati da virgole (CSV).

Pulisci

Rimuove qualsiasi cosa dalla vista della tabella

Puoi ora cambiare i colori visualizzati nella tabella andando nella sezione SQL dopo aver selezionato ImpostazioniConfigura Kate.

Sfogliare

Puoi sfogliare la banca dati usando la vista dello strumento Schema di banca dati sulla sinistra. Le informazioni mostrate variano a seconda del driver per la banca dati che stai usando.

Per aggiornare questo elenco fai clic con il tasto destro del mouse in qualsiasi parte nella vista dello strumento, e seleziona Aggiorna. Per generare un'interrogazione su una qualsiasi voce dell'elenco fai clic con il tasto destro del mouse, seleziona Genera, e quindi il tipo di interrogazione (SELECT, UPDATE, INSERT, o DELETE) dal sotto-menu che compare.

Struttura del menu

SQLAggiungi connessione...

Aggiunge una nuova connessione usando un qualsiasi driver per le banche dati.

SQLRimuovi connessione

Rimuove la connessione selezionata.

SQLModifica connessione...

Modifica le impostazioni della connessione attuale.

Connessioni

Tutte le connessioni alle banche dati che hai creato sono elencate tra gli elementi del menu Modifica connessione ed Esegui interrogazione; selezionane una per eseguire interrogazioni o per modificarla.

SQLEsegui interrogazione (Ctrl+E)

Esegue l'interrogazione.

Ringraziamenti e riconoscimenti

L'estensione SQL è stata scritta da Marco Mentasti.

Ringraziamenti speciali vanno al partecipante del Google Code-In 2011, Ömer Faruk Oruç, per aver scritto la maggior parte di questa sezione.

Estensione Visore di simboli

Estensione Visore di simboli

Usare l'estensione di chiusura per gruppo

Permette agli sviluppatori di visualizzare i simboli (funzioni, macro e strutture) nel codice sorgente.

Puoi agevolmente sfogliare il codice facendo clic sulle informazioni analizzate.

Al momento sono supportati i seguenti linguaggi:

C/C++, Java, Perl, PHP, Python, Ruby, XSLT, Tcl/Tk e Fortran

Elenco delle funzionalità:

Modalità ad albero
Abilita o disabilita l'ordinamento
Mostra o nasconde i parametri delle funzioni
Espande o collassa la modalità ad albero
Auto-aggiorna dopo i cambiamenti
L'analisi del codice è basata sull'infrastruttura di evidenziazione della sintassi di KDE Frameworks

Struttura del menu

VisualizzaVista degli strumentiMostra lista dei simboli (Ctrl+\)

Commuta la vista della lista di simboli di Kate visualizzando alternativamente le funzioni, le macro e le strutture del codice sorgente del documento attivo.

Configurazione

Scegli le opzioni di elaborazione predefinite

Estensione Strumento visivo per terminale

Estensione Strumento visivo per terminale

L'emulatore di terminale integrato è, per tua comodità, una copia dell'applicazione di terminale Konsole di KDE. È disponibile alla voce di menu VisualizzaViste degli strumentiMostra terminale, e acquisirà il fuoco nel momento in cui viene visualizzato. In aggiunta, se l'opzione Sincronizza automaticamente il terminale con il documento attuale quando possibile è abilitata, passerà alla cartella del documento attuale quando viene visualizzato, se è possibile, oppure quando il documento corrente cambia.

La posizione predefinita nella finestra di Kate è in basso, sotto l'area di modifica.

Puoi configurare Konsole utilizzando il menu del tasto destro del mouse; per ulteriori informazioni vedi il manuale di Konsole.

L'emulatore di terminale incorporato è fornito dall'estensione Strumento visivo per terminale.

Struttura del menu

VisualizzaViste degli strumentiMostra terminale

Mostra o nasconde l'emulatore di terminale integrato.

Il terminale sarà creato alla prima attivazione.

Quando l'emulatore di terminale viene visualizzato, il fuoco si sposterà su di esso, in modo che tu possa digitare immediatamente i comandi. Se l'opzione Sincronizza automaticamente il terminale con il documento attuale quando possibile è abilitata nella pagina Terminale della finestra principale di configurazione, la sessione della shell passerà alla cartella del documento attuale, se questo è un file locale.

StrumentiIncanala al terminale

Passa il testo selezionato all'emulatore di terminale integrato. Non viene aggiunto alcun carattere di fine riga dopo il testo.

StrumentiSincronizza terminale con il documento attuale

Ciò avrà come effetto l'esecuzione del comando cd da parte del terminale incorporato, nella cartella del documento attivo.

In alternativa puoi configurare Kate in modo che mantenga sempre il terminale sincronizzato con il documento attuale, vedi la sezione chiamata «Configurazione» per ulteriori informazioni.

StrumentiAttiva/Disattiva il terminale

Passa il fuoco dal documento attuale al terminale e viceversa.

Configurazione

Puoi configurare l'estensione Strumento visivo per terminale dalla pagina Terminale della finestra di configurazione.

Sono disponibili le seguenti opzioni:

Sincronizza automaticamente, quando è possibile, il terminale con il documento attuale

Ciò comporterà l'esecuzione nel terminale integrato del comando cd nella cartella del documento attivo al momento dell'avvio e quando un nuovo documento acquisisce il fuoco. Se non è abilitata, sarà necessario eseguire manualmente tutta la navigazione nel terminale.

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

Questa opzione imposta la variabile d'ambiente EDITOR in modo che i programmi eseguiti nel terminale integrato che aprono file in un editor li aprano in Kate invece che nell'editor predefinito configurato nella tua shell. Affinché il programma che lo ha invocato sappia che la modifica del file è terminata, non sarà possibile continuare a utilizzare il terminale fino alla chiusura del file in Kate.

L'estensione Filtro di testo

L'estensione Filtro di testo

Usare l'estensione Filtro di testo

Puoi usare questa estensione per eseguire dei comandi da shell. Una selezione sarà utilizzata come argomento per il comando da shell, il risultato rimpiazzerà la selezione o la copierà negli appunti.

Esempi:

  • less /etc/fstab - incolla il contenuto di questo file o lo copia negli appunti

  • wc - conta le righe, le parole e i caratteri della selezione e li incolla nel documento, o li copia negli appunti

  • sort - ordina le righe della selezione e incolla il risultato nel documento, o lo copia negli appunti

Struttura del menu

StrumentiFiltro di testo (Ctrl+\)

Apre la finestra Filtro di testo:

Inserisce il comando da shell nella casella combinata, oppure seleziona dalla cronologia un comando usato in precedenza.

Copia il risultato invece di incollarlo

Copia il risultato negli appunti senza modificare il documento.

Unisce STDOUT a STDERR

Se selezionato verranno fusi i risultati da STDOUT e STDERR, e non saranno riportati gli errori. Diversamente STDERR sarà visualizzato come un messaggio passivo.

Validazione XML

Validazione XML

Daniel Naber

Questa estensione controlla che i file XML siano validi e siano scritti correttamente.

L'estensione controlla il file attuale: sul fondo della finestra principale di Kate apparirà un elenco con gli avvertimenti e gli errori; puoi fare clic su un messaggio d'errore per saltare al punto corrispondente nel file. Se il file ha un «DOCTYPE», allora per controllarne la validità si userà il DTD dato da questo. Ci si aspetta che il DTD sia in una posizione relativa al file attuale: per esempio, se il doctype si riferisce a DTD/xhtml1-transitional.dtd e il file è /home/pippo/prova.xml, allora ci si aspetta che il DTD sia a /home/pippo/DTD/xhtml1-transitional.dtd. Sono comunque supportati anche i DTD remoti specificati con http.

Se il file non ha un doctype, ne sarà controllata la corretta formattazione.

Per saperne di più su XML, vedi le pagine ufficiali del W3C su XML.

Internamente questa estensione chiama il comando esterno xmllint, che fa parte di libxml2; l'estensione non funzionerà se questo comando non è correttamente installato nel tuo sistema.

Per caricare questa estensione apri la finestra di configurazione di Kate in ImpostazioniConfigura Kate. Seleziona quindi Validazione XML, che apparirà nella sezione Estensioni, in Applicazione, e chiudi la finestra.

Struttura del menu

XMLConvalida XML

Questo avvierà il controllo, come descritto sopra.

Ringraziamenti e riconoscimenti

Estensione di Kate «Validazione XML», copyright 2002 di Daniel Naber .

Copyright 2002 della documentazione di Daniel Naber

Completamento XML

Completamento XML

Daniel Naber

Questa estensione suggerisce cosa è ammissibile in un certo punto di un file XML, secondo la DTD del file. Saranno elencati i possibili elementi, gli attributi, i valori degli attributi o le entità, a seconda della posizione del cursore (per esempio, se il carattere a sinistra del cursore è «&», vengono elencate tutte le entità). È anche possibile chiudere l'ultimo tag aperto a sinistra.

La DTD deve esistere in formato XML, come prodotta dal programma Perl dtdparse; indicheremo una tale DTD come «meta-DTD». Sono fornite alcune meta-DTD, che sono installate in katexmltools/ in qtpaths --paths GenericDataLocation ; questa è anche la cartella predefinita alla selezione di Assegna meta-DTD. Per produrre le tue meta-DTD recupera dtdparse da questo indirizzo.

Uso

Avvia Kate e apri la finestra di configurazione da ImpostazioniConfigura Kate.... Seleziona quindi Completamento XML, che apparirà nella sezione Estensioni sotto Applicazione, e chiudi la finestra, dopodiché seleziona XMLAssegna meta-DTD.... Se il documento non contiene alcun «DOCTYPE» o questo è sconosciuto, dovrai selezionare una meta-DTD dal filesystem, altrimenti sarà automaticamente caricata la meta-DTD corrispondente al DOCTYPE del documento attuale.

Puoi ora usare l'estensione mentre scrivi del testo:

< (minore)

Questo attiverà un elenco di elementi possibili, a meno che il cursore sia già dentro a un tag. Nota che attualmente non puoi usarlo per inserire degli elementi di massimo livello (per esempio «<html>»).

< / (minore e sbarra)

Inserendo questi caratteri avrai la possibilità di chiudere l'elemento attuale (l'ultimo aperto a sinistra del cursore); premi Invio per accettare il suggerimento. Contrariamente all'elemento del menu Chiudi elemento questo funziona solo quando è stata assegnata una DTD.

" (virgolette)

Il tasto delle virgolette attiverà un elenco di valori possibili per gli attributi (se ce ne sono), se sei all'interno di un tag.

  (spazio)

Questo tasto attiverà un elenco di attributi possibili per l'elemento attuale, se sei dentro a un tag.

& (e commerciale)

Questo tasto attiverà un elenco di entità.

Funzionalità e limitazioni

Puoi provare tutte le funzioni e le limitazioni caricando in Kate katexmltools/testcases.xml in qtpaths --paths GenericDataLocation e seguendo le istruzioni.

Struttura del menu

XMLInserisci elemento... (Ctrl+Invio)

Questo aprirà una finestra che ti permette di inserire un elemento XML, mentre saranno inseriti automaticamente i caratteri <, > e il tag di chiusura. Il testo sarà incluso tra i tag di apertura e chiusura se lo avevi selezionato al momento della selezione di questo elemento del menu. Se hai assegnato una meta-DTD con Assegna meta-DTD... la finestra offre il completamento per tutti gli elementi che possono essere inseriti alla posizione attuale del cursore.

XMLChiudi elemento (Ctrl+<)

Questo cercherà nel testo un tag non ancora chiuso, e lo chiuderà inserendone il tag di chiusura corrispondente. La ricerca inizia dalla posizione del cursore e va verso sinistra. Se non è possibile trovare un tag aperto non succederà nulla.

XMLAssegna meta-DTD...

Questo dirà all'estensione quale meta-DTD usare per il documento attuale. Nota che questa assegnazione non verrà salvata, dovrai ripeterla al prossimo riavvio di Kate.

Ringraziamenti e riconoscimenti

Estensione di Kate «Completamento XML», copyright 2001, 2002 di Daniel Naber .

Copyright della versione per KDE SC 4 2010 di Tomáš Trnka

Copyright 2001, 2002 della documentazione di Daniel Naber

Capitolo 5. Strumenti avanzati di modifica

Capitolo 5. Strumenti avanzati di modifica

Per informazioni sugli strumenti di modifica avanzati inclusi in Kate vedi il capitolo Strumenti avanzati di modifica del manuale di KatePart Handbook.

Capitolo 6. Estensione di Kate

Capitolo 6. Estensione di Kate

T.C. Hollingsworth

Traduzione e manutenzione del documento: Paolo Zamponi
Traduzione della documentazione.: Nicola Ruggero
Aggiornamento per Kate 2.5.6: Luciano Montanaro

Introduzione

Come ogni editor di testi avanzato, Kate offre una moltitudine di modi per espandere le sue funzionalità. Puoi scrivere semplici script per aggiungere funzionalità con JavaScript, oppure aggiungere ulteriori caratteristiche all'editor con estensioni di Kate scritte in C++. Infine, dopo aver esteso Kate saresti il benvenuto nel nostro gruppo per condividere il tuo lavoro con il mondo intero!

Lavorare con l'evidenziazione della sintassi

Lavorare con l'evidenziazione della sintassi

Per informazioni sull'aggiunta o la modifica delle definizioni di evidenziazione della sintassi vedi la sezione evidenziazione del manuale sullo sviluppo di KatePart.

Scripting con JavaScript

Scripting con JavaScript

Per informazioni sullo scripting con JavaScript vedi la sezione sullo scripting del capitolo del manuale sullo sviluppo di KatePart.

Estensioni dell'applicazione Kate (C++)

Estensioni dell'applicazione Kate (C++)

Le estensioni per l'applicazione Kate estendono le funzionalità dell'editor Kate in tutti i modi che riesci ad immaginare, utilizzando lo stesso linguaggio di programmazione usato per Kate: il C++.

Per iniziare, vedi la guida su come scrivere un'estensione per Kate sul sito web di Kate.

Capitolo 7. La modalità di inserimento Vi

Capitolo 7. La modalità di inserimento Vi

Per informazioni sulla modalità di inserimento Vi di Kate vedi il capitolo La modalità di inserimento Vi del manuale di KatePart.

Capitolo 8. Le voci dei menu

Capitolo 8. Le voci dei menu

Il menu File

FileNuovo (Ctrl+N)

Questo comando crea un nuovo documento nella finestra di modifica; nell'elenco dei Documenti sulla sinistra il nuovo file è indicato come Senza nome.

FileApri.. (Ctrl+O)

Visualizza la finestra Apri file standard di KDE. Usa la vista dei file per selezionare quello che vuoi aprire, e fai clic su Apri per aprirlo.

FileApri recenti

Questa è una scorciatoia per aprire i documenti salvati di recente: un clic su questo elemento apre un elenco a fianco del menu con alcuni degli ultimi file salvati. Se fai clic su di uno in particolare questa applicazione lo aprirà, purché che il file sia ancora nello stesso posto.

FileApri con

Questo sotto-menu presenta un elenco di applicazioni in grado di gestire il tipo di file del documento attuale; l'attivazione di una voce aprirà il documento con l'applicazione corrispondente.

Inoltre la voce Altro... apre una finestra per selezionare un'altra applicazione con cui aprire il file attivo. Il file resterà aperto in Kate.

FileSalva (Ctrl+S)

Permette di salvare il documento corrente. Se c'è già un salvataggio del documento questa operazione sovrascriverà il file precedente, senza chiedere il consenso all'utente. Se è invece il primo salvataggio di un nuovo documento, verrà invocata la finestra di dialogo «Salva come...» (descritta più sotto).

FileSalva come... (Ctrl+Shift+S)

Permette di salvare un documento con un nuovo nome. Questo viene fatto attraverso la finestra di dialogo descritta sopra, nella sezione Apri di questa guida.

FileSalva come con codifica

Salva un documento con un nuovo nome in una codifica diversa.

FileSalva copia come

Salva una copia del documento con un nuovo nome, e continua a modificare il documento originale.

FileSalva tutto (Ctrl+L)

Questo comando salva tutti i file modificati aperti.

FileRicarica (F5)

Ricarica il file attivo da disco. Questo comando è utile se un altro programma o processo ha cambiato il file mentre era aperto in questa applicazione.

FileRicarica tutto

Ricarica tutti i file aperti.

FileStampa... (Ctrl+P)

Apre una semplice finestra di dialogo di stampa, che permette all'utente di specificare cosa, dove e come stampare.

FileEsporta come HTML

Salva il documento attualmente aperto come file HTML, che verrà formattato con l'evidenziazione della sintassi e le impostazioni dello schema di colori attuali.

FileChiudi (Ctrl+W)

Chiude il file attivo con questo comando. Se hai fatto delle modifiche senza salvarle ti verrà chiesto se vuoi salvarle prima che Kate lo chiuda.

FileChiudi gli altri

Chiudi gli altri documenti aperti.

FileChiudi tutti

Questo comando chiude tutti i file aperti in Kate.

FileChiudi orfani

Chiudi tutti i documenti nell'elenco dei file che non possono venire riaperti all'avvio perché non sono più accessibili.

FileEsci (Ctrl+Q)

Questo comando chiude Kate e tutti i file che stavi modificando. Se hai delle modifiche non salvate in uno o più file ti verrà chiesto se le vuoi salvare.

Il menu Modifica

Il menu Modifica

ModificaAnnulla (Ctrl+Z)

Annulla l'ultima azione di modifica (inserimento di testo, copia, taglio eccetera).

Nota

Potrebbe annullare diversi comandi di modifica dello stesso tipo, come l'inserimento di caratteri.

ModificaRifai (Ctrl+Shift+Z)

Questo annullerà la modifica più recente (se c'è) fatta usando Annulla

ModificaTaglia (Ctrl+X)

Questo comando cancella la selezione corrente e la mette negli appunti. Gli appunti lavorano in maniera invisibile, e forniscono un modo per trasferire dei dati tra le applicazioni.

ModificaCopia (Ctrl+C)

Copia la selezione corrente negli appunti, così che possa essere incollata da qualche altra parte. Gli appunti lavorano in maniera invisibile, e forniscono un modo per trasferire dei dati tra le applicazioni.

ModificaIncolla (Ctrl+V)

Inserisce il primo elemento negli appunti, alla posizione del cursore. Gli appunti lavorano in maniera invisibile, e forniscono un modo per trasferire dei dati tra le applicazioni.

Nota

Se l'opzione di sovrascrittura della selezione è attiva, il testo incollato sovrascriverà l'eventuale selezione.

FileCronologia degli appunti

Questo sotto-menu mostrerà l'inizio delle porzioni di testo recentemente copiate negli appunti. Seleziona un elemento da questo menu per incollarlo nel file attualmente aperto.

ModificaCopia come HTML

Copia la selezione come HTML, formattato con l'evidenziazione della sintassi e le impostazioni dello schema dei colori attuali.

ModificaSeleziona tutto (Ctrl+A)

Seleziona l'intero documento. Può essere molto utile per copiare l'intero file in un'altra applicazione.

ModificaDeseleziona (Ctrl+Shift+A)

Deseleziona l'eventuale testo selezionato nell'editor.

ModificaModalità di selezione a blocchi (Ctrl+Shift+B)

Cambia la modalità di selezione. Quando la modalità di selezione è quella BLOCCO la barra di stato contiene la stringa [BLOCCO] e puoi fare selezioni verticali, ad es. selezionare le colonne dalla 5 alla 10 e le righe dalla 9 alla 15.

ModificaModalità di inserimento

Passa da una modalità di editing normale ad una stile Vi, modale. La modalità Vi supporta i comandi più usati, gli spostamenti dalla modalità normale alla visuale di vim, ed ha una barra di stato facoltativa per la modalità vi, che visualizza i comandi che vengono dati, i loro risultati e la modalità corrente. Il comportamento di questa modalità può essere configurato nella sezione Modalità di inserimento Vi della pagina Modifica nella finestra delle impostazioni di questa applicazione.

ModificaModalità di sovrascrittura (Ins)

Alterna le modalità di inserimento e sovrascrittura. Quando la modalità è INS, i caratteri vengono inseriti alla posizione del cursore. Quando la modalità è SSC, i caratteri digitati sostituiranno quelli presenti se il cursore è posizionato davanti a un carattere. La barra di stato mostra lo stato attuale della modalità di sovrascrittura, con INS o SSC.

ModificaTrova... (Ctrl+F)

Apre la barra di ricerca incrementale nella parte bassa della finestra dell'editor. Nella parte sinistra della barra c'è un pulsante con un'icona per chiuderla, seguita da una piccola casella di testo per inserire la chiave di ricerca.

Quando si inizia ad inserire la chiave di ricerca, la ricerca inizia immediatamente. Se c'è una corrispondenza nel testo questa viene evidenziata, e lo sfondo della casella di testo diventa verde chiaro. Se la ricerca non dà risultati, lo sfondo della casella di testo diventa rosso chiaro.

Usa il pulsante oppure per andare alla corrispondenza precedente o successiva nel documento.

Le corrispondenze nel documento sono evidenziate anche quando chiudi la barra di ricerca; premi il tasto Esc per togliere questa evidenziazione.

Puoi scegliere di limitare la ricerca alle corrispondenze con le stesse maiuscole nello schema di ricerca. Selezionando la ricerca si limiterà ai risultati con le maiuscole e minuscole uguali a quelle specificate nello schema di ricerca.

Fai clic sul pulsante nella parte destra della barra di ricerca incrementale per usare la barra potenziata di ricerca e sostituzione.

ModificaTrova variantiTrova successivo (F3)

Ripete l'ultima ricerca, se c'è, senza richiamare la barra di ricerca incrementale, cercando in avanti nel documento a partire dalla posizione del puntatore.

ModificaTrova variantiTrova precedente (Shift+F3)

Ripete l'ultima ricerca, se c'è, senza richiamare la barra di ricerca incrementale, cercando all'indietro invece che in avanti nel documento.

EditTrova variantiTrova selezionato (Ctrl+H)

Trova l'occorrenza successiva del testo selezionato.

ModificaTrova variantiTrova selezionato all'indietro (Ctrl+Shift+H)

Trova l'occorrenza precedente del testo selezionato.

ModificaSostituisci... (Ctrl+R)

Questo comando apre la barra avanzata di trova e sostituisci. Nella parte a sinistra in alto della barra c'è un pulsante con un'icona per chiuderla, seguita da una piccola casella di testo per inserire la chiave di ricerca.

Si può modificare la modalità di ricerca marcando Testo semplice, Parole intere, Sequenze di escape o Espressioni regolari dal menu a discesa.

Se sono selezionate Sequenze di escape o Espressione regolare, l'elemento di menu Aggiungi... in fondo al menu contestuale delle caselle di testo sarà abilitato, e ti permetterà di aggiungere delle sequenze di escape o delle espressioni regolari per cercare o sostituire dei modelli da liste predefinite.

Usa il pulsante oppure per andare alla corrispondenza precedente o successiva nel documento.

Inserisci il testo da sostituire nella casella di testo indicata con Sostituisci e premi il pulsante Sostituisci per sostituire solo il testo evidenziato; premi il pulsante Sostituisci tutto per sostituire il testo cercato in tutto il documento.

Puoi modificare il comportamento di ricerca e sostituzione selezionando opzioni diverse in fondo alla barra. Selezionando restringerai i risultati a quelli che corrispondono alle maiuscole e minuscole di ogni carattere dello schema di ricerca, mentre con effettuerai la ricerca e la sostituzione solo all'interno della selezione attuale. Il pulsante Trova tutti evidenzia tutte le corrispondenze nel documento, e ne mostra il numero in una finestrella a comparsa.

Fai clic sul pulsante sul lato destro della barra potenziata di ricerca e sostituzione per passare alla barra di ricerca incrementale.

ModificaVai aVai alla parentesi corrispondente (Ctrl+6)

Sposta il cursore alla parentesi di apertura o di chiusura associata.

ModificaVai aSeleziona fino alla parentesi corrispondente (Ctrl+Shift+6)

Seleziona il testo tra le parentesi di apertura e di chiusura associate.

ModificaVai aVai alla riga modificata precedente

Le righe che sono cambiate dall'apertura del file sono chiamate righe modificate. Questa azione salta alla riga modificata precedente.

ModificaVai aVai alla riga modificata successiva

Le righe che sono cambiate dall'apertura del file sono chiamate righe modificate. Questa azione salta alla riga modificata successiva.

ModificaVai aVa alla riga... (Ctrl+G)

Apre la barra vai alla riga nella parte bassa della finestra, che serve per far saltare il cursore ad una particolare riga (specificata dal numero) nel documento. Il numero della riga può essere inserito direttamente nella casella di testo oppure graficamente, facendo clic sulle frecce direzionali su o giù a lato della casella di testo. La piccola freccia su incrementerà il numero della riga, e la freccia giù lo decrementerà. Si può chiudere la barra facendo clic sul pulsante con un'icona nella parte sinistra.

Il menu Visualizza

Il menu Visualizza

VisualizzaNuova finestra

Apre una nuova istanza di Kate, che sarà identica alla precedente.

VisualizzaScheda successiva (Alt+)

Attiva la scheda successiva nella barra delle schede.

VisualizzaScheda precedente (Alt+)

Attiva la scheda precedente nella barra delle schede.

VisualizzaApertura rapida (Ctrl+Alt+O)

Mostra un campo di ricerca ed un elenco di file aperti nell'area dell'editor: inserendo del testo nel campo lo si cerca tra i nomi e gli URL dei documenti. Mentre inserisci il testo nel campo di ricerca puoi usare i tasti e per scorrere la vista a elenco. Premendo il tasto Invio o facendo doppio clic su un elemento dell'elenco si visualizzerà il documento selezionato; ciò facilita il passaggio tra i documenti, se ce ne sono molti aperti.

Questa azione è disponibile anche usando l'icona che si trova in alto a destra nella finestra dell'editor.

VisualizzaDividi vistaVista divisa precedente (Shift+F8)

Attiva la vista precedente del documento, se hai suddiviso l'area di modifica in più viste.

VisualizzaDividi vistaVista divisa successiva (F8)

Attiva la vista successiva del documento, se hai suddiviso l'area di modifica in più viste.

VisualizzaDividi vistaDividi verticalmente (Ctrl+Shift+L)

Divide il riquadro (che può essere l'intera area di modifica) in due riquadri di uguale dimensione, quello nuovo a destra dell'attuale. Il nuovo riquadro è attivo, e mostra lo stesso documento di quello vecchio.

Vedi anche Lavorare con Kate MDI

VisualizzaDividi vistaDividi orizzontalmente (Ctrl+Shift+T)

Divide il riquadro (che può essere l'intera area di modifica) in due riquadri di uguale dimensione, il nuovo sotto l'attuale. Quello nuovo è attivo, e mostra lo stesso documento di quello vecchio.

Vedi anche Lavorare con Kate MDI

VisualizzaDividi vistaCommuta orientamento

Passa dalla divisione orizzontale a quella verticale e viceversa.

VisualizzaDividi vistaChiudi la vista corrente (Ctrl+Shift+R)

Chiude il riquadro attivo, identificabile dal cursore lampeggiante. Se c'è solo un riquadro (l'area di modifica principale) questa voce è disabilitata.

Nessun documento viene chiuso chiudendo un riquadro: i documenti saranno ancora disponibili nel menu Visualizza, oltre che nell'elenco dei file.

Vedi anche Lavorare con Kate MDI

VisualizzaDividi vistaChiudi le viste inattive

Chiude tutti i riquadri tranne quello attivo (quello con il cursore lampeggiante). Questa voce è disabilitata se c'è un solo riquadro (l'area di modifica principale).

Nessun documento viene chiuso chiudendo un riquadro: i documenti saranno ancora disponibili nel menu Visualizza, oltre che nell'elenco dei file.

VisualizzaDividi vistaNascondi le viste inattive

Nasconde tutte le viste inattive tranne quella attuale.

VisualizzaDividi vistaSposta la divisione a sinistra

Quando la vista divisa è abilitata, questo sposta a sinistra la divisione tra i due documenti divisi verticalmente.

VisualizzaDividi vistaSposta la divisione a destra

Quando la vista divisa è abilitata, questo sposta a destra la divisione tra i due documenti divisi verticalmente.

VisualizzaDividi vistaSposta la divisione in alto

Quando la vista divisa è abilitata, questo sposta in alto la divisione tra i due documenti divisi orizzontalmente.

VisualizzaDividi vistaSposta la divisione in basso

Quando la vista divisa è abilitata, questo sposta in basso la divisione tra i due documenti divisi orizzontalmente.

Nota

Alcune delle azioni comuni nel VisualizzaDividi vista sono disponibili usando il pulsante che si trova nell'angolo in alto a destra della finestra dell'editor

VisualizzaViste degli strumenti
VisualizzaViste degli strumentiMostra barre laterali (Ctrl+Alt+Shift+F)

Attiva o disattiva la visualizzazione delle barre dei pulsanti laterali. Questo comando non influenza la visualizzazione del contenuto della barra laterale, le barre visibili lo resteranno, e, se hai assegnato delle scorciatoie ai comandi seguenti, queste continueranno a funzionare normalmente.

VisualizzaViste degli strumentiMostraEstensione

Una lista di tutte le estensioni abilitate. Usa la casella davanti a ciascun elemento per attivare o disattivare la visualizzazione della vista strumento.

VisualizzaPassa alla riga di comando (F7)

Questo comando commuta la visualizzazione della riga di comando integrata.

VisualizzaIngrandisci i caratteri (Ctrl++)

Aumenta la dimensione dei caratteri.

VisualizzaRimpicciolisci i caratteri (Ctrl+-)

Diminuisce la dimensione dei caratteri.

VisualizzaSchema

Questo menu elenca tutti gli schemi di colore disponibili. Da qui puoi cambiare lo schema per la vista attuale, mentre per cambiare lo schema predefinito devi usare la pagina Caratteri e colori nella finestra di configurazione.

VisualizzaA capo automaticoRitorno a capo dinamico (F10)

Attiva o disattiva l'andata a capo automatica dinamica della vista attuale. L'andata a capo dinamica rende tutto il testo di una vista visibile senza scorrere orizzontalmente, rendendo una riga di testo effettivo su una o più righe quando necessario.

VisualizzaA capo automaticoIndicatori di a capo dinamico

Scegli quando e come visualizzare gli indicatori di andata a capo automatica dinamica. Ciò è disponibile solo se è spuntata l'opzione A capo automatico dinamico.

VisualizzaA capo automaticoMostra indicatore di ritorno a capo statico

Attiva o disattiva la visualizzazione della riga verticale che indica l'ampiezza della pagina come configurata nella finestra di configurazione. Questa funzione presuppone che si usi un carattere a spaziatura fissa.

VisualizzaBordiMostra bordo delle icone (F6)

Questa è una voce di commutazione. Renderà visibile o meno il bordo per le icone sul lato sinistro dell'editor attivo. Il bordo dell'icona indica le posizioni delle righe segnate nell'editor.

VisualizzaBordiMostra i numeri di riga (F11)

Attivando questo elemento verrà visualizzato un pannello sul bordo sinistro dell'editor attivo per visualizzare i numeri di riga del documento, disattivandolo il pannello non sarà mostrato.

VisualizzaBordiMostra i segni nella barra di scorrimento

Attiva o disattiva la visualizzazione dei segnalibri (ed altri segni) sulla barra di scorrimento verticale. Quando è attiva, un indicatore è rappresentato da sottili righe nel colore di evidenziazione sulla barra di scorrimento; un clic col tasto centrale del mouse farà scorrere la vista ad una posizione prossima all'indicatore.

VisualizzaBordiMostra minimappa di scorrimento

Questo sostituirà la barra di scorrimento con una rappresentazione del documento attuale. Per maggiori informazioni sulla mini-mappa di scorrimento, vedi la sezione sulla mini-mappa della barra di scorrimento del manuale di KatePart.

VisualizzaRaggruppamento del codice

Queste opzioni sono rilevanti per il raggruppamento del codice:

Mostra segni di raggruppamento (F9)

Attiva e disattiva la visualizzazione degli indicatori di raggruppamento a sinistra della vista.

Contrai il nodo attuale

Contrae la regione contenente il cursore.

Espandi il nodo attuale

Espande la regione contenente il cursore.

Contrai nodi di massimo livello (Ctrl+Shift+-)

Contrae tutte le regioni di massimo livello nel documento. Fai clic sul triangolo che punta a destra per espandere tutte le regioni di massimo livello.

Contrai nodi di massimo livello (Ctrl+Shift++)

Espande tutte le regioni di livello superiore nel documento.

Mostra spazi non stampabili

Mostra/nasconde i riquadri che delimitano gli spazi non stampabili.

Il menu Segnalibri

Il menu Segnalibri

Sotto le voci qui descritte ne sarà disponibile una per ciascun segnalibro nel documento attivo. Il testo sarà composto dalle prime parole della riga indicata: scegli una voce per spostare il cursore all'inizio della riga corrispondente, e l'editor scorrerà il testo di quanto è necessario per mostrarla.

SegnalibriMetti segnalibro (Ctrl+B)

Imposta o rimuove un segnalibro nella riga attuale del documento attivo (se c'è un segnalibro questo viene rimosso, altrimenti viene impostato).

SegnalibriPulisci tutti i segnalibri

Questo comando rimuoverà tutti i segnalibri dal documento, così come la lista dei segnalibri che si trova sotto questo elemento del menu.

SegnalibriPrecedente (Alt+PgUp)

Questo sposterà il cursore all'inizio della prima riga superiore avente un segnalibro. Il testo dell'elemento del menu include il numero di riga e l'inizio del testo della riga. Questo elemento è disponibile solo quando esiste un segnalibro in una riga sopra al cursore.

SegnalibriSuccessivo (Alt+Pag Giù)

Sposta il cursore all'inizio della prossima riga avente un segnalibro. La voce nel menu conterrà il numero della riga e il primo pezzo del testo nella riga. Questa voce è disponibile quando esiste un segnalibro in una riga sotto al cursore.

Il menu Sessioni

Il menu Sessioni

Questo menu contiene le voci per usare e gestire le sessioni di Kate. Per maggiori informazioni vedi Usare le sessioni.

SessioniNuova

Crea una nuova sessione vuota. Tutti i file attualmente aperti saranno chiusi.

SessioniApri sessione...

Apri una sessione esistente. Per permetterti la scelta viene visualizzata la finestra di scelta delle sessioni.

SessioniApri sessione rapidamente

Questo sotto-menu ti permette di aprire una sessione esistente.

SessioniSalva sessione

Salva la sessione attuale. Se la sessione è anonima ti verrà chiesto di sceglierle un nome.

SessioniSalva sessione come...

Salva la sessione attuale con un nuovo nome. Ti verrà chiesto il nome da usare.

SessioniGestisci sessioni...

Mostra la finestra di gestione delle sessioni, che ti permette di rinominare e di eliminare le sessioni.

Il menu Strumenti

Il menu Strumenti

StrumentiModalità di sola lettura

Imposta il documento attuale nella modalità di sola lettura. Ciò impedisce l'aggiunta di testo e le modifiche alla formattazione del documento.

StrumentiModalità

Scegli lo schema del tipo di file che preferisci per il documento attivo. Questo sostituisce la modalità del tipo di file globale impostata da ImpostazioniConfigura Kate... nella scheda Modalità e tipi di file solo per il documento attuale.

StrumentiEvidenziazione

Sceglie il tuo schema di evidenziazione preferito per il documento attivo. Questo sostituisce unicamente per il documento attuale quella globale impostata da ImpostazioniConfigura editor....

StrumentiRientro

Scegli lo stile di rientro che preferisci per il documento attivo. Questo sostituisce solo per il documento attuale quella globale impostata da ImpostazioniConfigura editor....

StrumentiCodifica

Puoi sovrascrivere l'impostazione di codifica predefinita in ImpostazioniConfigura editor... nella pagina Apri e salva per impostare una differente codifica per il documento corrente. La codifica qui impostata sarà valida unicamente per il documento corrente.

StrumentiFine riga

Sceglie la modalità di fine riga preferita per il documento attivo. Questa avrà priorità rispetto quella globale impostata da SettingsConfigura editor... unicamente per il documento corrente.

StrumentiAggiungi indicatore dell'ordine dei byte (BOM)

Attivando questa azione puoi aggiungere esplicitamente un indicatore dell'ordine dei byte per i documenti codificati con Unicode. L'indicatore dell'ordine dei byte (BOM) è un carattere Unicode usato per indicare appunto l'ordine dei byte (in gergo inglese, endianness) di un file o flusso di testo; per maggiori informazioni vedi su Wikipedia.

StrumentiScript

Questo sotto-menu contiene un elenco di tutte le azioni di script. L'elenco può essere facilmente modificato scrivendo i tuoi script. In questo modo Kate può essere esteso con strumenti definiti dall'utente.

C'è un elenco completo di script nella documentazione di KatePart.

StrumentiInvoca completamento del codice (Ctrl+Spazio)

Invoca manualmente il completamento del codice, di solito usando una scorciatoia associata a questa azione.

StrumentiCompletamento delle parole

Riusa parola sotto (Ctrl+9) e Riusa parola sopra (Ctrl+8) completano il testo durante la digitazione, cercando parole simili prima o dopo la posizione attuale. Completamento di shell fa apparire un riquadro di completamento con le voci corrispondenti.

StrumentiOrtografiaControllo ortografico automatico (Ctrl+Shift+O)

Quando il Controllo ortografico automatico è attivo, gli errori di ortografia rilevati vengono immediatamente sottolineati nel documento.

StrumentiOrtografiaOrtografia...

Questo avvia il programma di correzione ortografica, che ti aiuta a individuare e correggere gli errori di ortografia.

Per maggiori informazioni su come usare il programma di correzione ortografica di KDE vedi la sezione Controllo ortografico nella documentazione sui Fondamentali di KDE.

StrumentiOrtografiaOrtografia (dal cursore)...

Ciò avvierà il programma di correzione ortografica iniziando dalla posizione corrente del cursore invece che dall'inizio del documento.

StrumentiOrtografiaOrtografia della selezione...

Controlla l'ortografia della selezione attuale.

StrumentiOrtografiaCambia dizionario

Visualizza un menu a discesa nella parte bassa della finestra dell'editor, con i dizionari disponibili per la correzione ortografica. Permette di cambiare il dizionario in modo veloce, ad esempio per la correzione ortografica di documenti in più lingue.

StrumentiPulisci rientro

Pulisce il rientro della selezione attuale o per la riga su cui si trova al momento il cursore. La pulizia del rientro garantisce che tutto il testo selezionato segua quella scelta.

StrumentiAllinea

Riallinea la riga attuale o le righe selezionate usando la modalità e le impostazioni di rientro del documento.

StrumentiCommenta (Ctrl+D)

Aggiunge i caratteri necessari per rendere la riga attuale o tutte le righe selezionate un commento, a seconda del tipo di file.

StrumentiDecommenta (Ctrl+Shift+D)

Rimuove i caratteri che rendono la riga attuale o le righe selezionate dei commenti, a seconda del tipo di file.

StrumentiMaiuscolo (Ctrl+U)

Mette il testo selezionato, o la lettera dopo il cursore, in maiuscolo.

StrumentiMinuscolo (Ctrl+Shift+U)

Mette il testo selezionato, o la lettera dopo il cursore, in minuscolo.

StrumentiIniziali maiuscole (Ctrl+Alt+U)

Mette le iniziali del testo selezionato, o della parola attuale, in maiuscolo.

StrumentiUnisci righe (Ctrl+J)

Unisce le righe selezionate, o la riga attuale e quella successiva, con un carattere di spazio come separatore. Gli spazi bianchi iniziali o finali delle righe unite saranno rimossi dalle estremità coinvolte.

StrumentiApplica il ritorno a capo automatico

Applica l'andata a capo statica all'intero documento. Ciò significa che una nuova riga di testo verrà iniziata automaticamente quando la riga attuale supererà la lunghezza specificata dall'opzione Colonna a cui andare a capo nella scheda Modifica in ImpostazioniConfigura editor....

I menu Impostazioni e Aiuto

I menu Impostazioni e Aiuto

Nel menu di Kate compaiono due voci comuni dei menu di KDE, Impostazioni e Aiuto. Per maggiori informazioni leggi le sezioni Menu impostazioni e Menu di aiuto nei Fondamentali di KDE, con due voci aggiuntive:

ImpostazioniMostra schede

Le schede possono essere spostate usando il tasto sinistro del mouse, e hanno delle azioni nel menu contestuale per chiudere i documenti, copiare il percorso negli appunti, o per aprire la cartella del documento nel gestore dei file. Usare il pulsante Apertura rapida rende semplice il passaggio tra i documenti. Fai clic sul pulsante con il tasto sinistro del mouse per aprire un menu con le azioni del menu VisualizzaDividi vista.

ImpostazioniMostra il percorso nella barra del titolo

Se abilitato viene visualizzato il percorso completo del documento attivo, diversamente solo il nome del file. Questo è utile se modifichi molti file con lo stesso nome, in modo da poterli distinguere.

Capitolo 9. Configurare Kate

Capitolo 9. Configurare Kate

Anders Lund

Traduzione della documentazione.: Nicola Ruggero
Aggiornamento della traduzione per Kate 2.5.6: Luciano Montanaro
Aggiornamento per KDE
4.3 e manutenzione
: Federico Zenith

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 Impostazioni di sistema, e può anche essere configurato facendo clic con il tasto destro del mouse per visualizzare un menu contestuale.

La finestra di configurazione principale

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è:

La configurazione dell'applicazione Kate

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 metadati 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 della sessione
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 Capitolo 4, Lavorare con le estensioni.

Configurazione del componente editor

Per informazioni su questa sezione della finestra di configurazione, vedi la sezione sulla configurazione del componente editor del manuale di KatePart.

Configurazione con le variabili dei documenti

Per informazioni sull'uso delle variabili dei documenti con Kate, vedi la sezione sulla configurazione delle variabili dei documenti del manuale di KatePart.

Capitolo 10. Riconoscimenti e licenza

Capitolo 10. Riconoscimenti e licenza

Kate. Copyright 2000, 2001, 2002 - 2005 - La squadra di sviluppo di Kate.

La squadra di Kate:

Christoph Cullmann

Responsabile progetto & sviluppatore principale

Anders Lund

Sviluppatore principale, evidenziazione del linguaggio Perl, documentazione

Joseph Wenninger

Sviluppatore principale, modalità di evidenziazione

Michael Bartl

Sviluppatore principale

Phlip

Compilatore del progetto

Waldo Bastian

L'ingegnoso sistema di buffer

Matt Newell

Prove...

Michael McCallum

Sviluppatore principale

Jochen Wilhemly

Autori di KWrite

Michael Koch

Port di KWrite su KParts

Christian Gebauer

Altro

Simon Hausmann

Altro

Glen Parker

Sistema di Annulla/Rifai di KWrite con elenco azioni e integrazione con KSpell

Scott Manson

Supporto per l'evidenziazione dei file XML in KWrite

John Firebaugh

Varie patch

Dominik Haumann

Sviluppatore, procedura guidata evidenziazione

Molta altra gente che ha contribuito:

Matteo Merli

Evidenziazione dei file RPM Spec, Diff e altro

Rocky Scaletta

Evidenziazione per VHDL

Yury Lebedev

Evidenziazione dei file SQL

Chris Ross

Evidenziazione per Ferite

Nick Roux

Evidenziazione per ILERPG

John Firebaugh

Evidenziazione del Java™ e molto di più

Carsten Niehaus

Evidenziazione per LaTeX

Per Wigren

Evidenziazione per Makefile, Python

Jan Fritz

Evidenziazione per Python

Daniel Naber

Piccole correzioni bug, estensione XML

Documentazione Copyright 2000,2001 Seth Rothberg

Documentazione Copyright 2002, 2003, 2005 Anders Lund

Traduzione e manutenzione a cura di Paolo Zamponi

Documentazione tradotta da: Nicola Ruggero

Questa documentazione è concessa in licenza sotto i termini della GNU Free Documentation License.

Questo programma è concesso in licenza sotto i termini della GNU General Public License.

Appendice A. Espressioni regolari

Appendice A. Espressioni regolari

Per informazioni sull'uso delle espressioni regolari in Kate vedi l'appendice Espressioni regolari del manuale di KatePart.

Appendice B. Installazione

Appendice B. Installazione

Per imparare ad installare Kate ed altre applicazioni di KDE sul tuo sistema vedi il capitolo Installazione della documentazione dei Fondamentali di KDE.