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

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

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

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

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

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

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

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

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

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.

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

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

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

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

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.

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

La modifica di uno strumento apre una pagina di configurazione che permette una configurazione particolareggiata dello strumento:

Il pulsante Valori predefiniti è visibile solo per gli strumenti che vengono forniti con Kate. Se ci si fa clic, tutte le impostazioni dello strumento vengono riportate al loro valore predefinito (o di fabbrica).

Alcuni campi modificabili, quali Eseguibile, Argomenti, Ingresso e Cartella di lavoro supportano delle variabili che verranno espanse quando lo strumento verrà invocato: esse vengono indicate dall'icona {} che appare quando uno di questi campi di inserimento testuale ha il fuoco (vedi il cerchio rosso):

Se si passa col mouse sopra ad uno di questi campi di inserimento testuale viene anche mostrato un suggerimento col testo corrente espanso. Inoltre, facendo clic sull'azione {} si aprirà una finestra che elenca tutte le variabili disponibili:

Questa funzionalità fornisce una gran flessibilità quando si definisce uno strumento esterno, dal momento che tutte le variabili nella forma %{...} vengono espanse quando lo strumento viene invocato. Ci sono due tipi di variabili supportate:

. La prima forma, %{variable-name}, sostituisce semplicemente la variabile col suo contenuto. Per esempio, la variabile %{Document:FileName} viene sostituita dal nome del file del documento corrente senza il percorso. La seconda forma, %{variable-name:<value>}, prende <value> come contenuto, per esempio può essere usata per espandere una variabile d'ambiente con %{ENV:HOME}, oppure si può ottenere la data corrente nel formato preferito, come %{Date:yyyy-MM-dd}.

Molti strumenti sono compresi per impostazione predefinita, ad ogni modo, qualora ne avessi altri, contattaci su (kwrite-devel AT kde.org) affinché possiamo aggiungerli alla lista. Tutti gli strumenti predefiniti sono visibili nella vista ad elenco per impostazione predefinita, ma essi possono essere modificati a proprio piacimento, inclusa la categoria, oppure essere anche eliminati. Gli strumenti eliminati possono essere aggiunti nuovamente facendo clic sul pulsante Aggiungi nella pagina di configurazione, come descritto qui sopra.

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 per i backtrace generati sulla tua macchina, ma funzionerà anche sui backtrace di altre persone, cioè verrà trovato /home/dummy/qt-copy/…/qwidget.cpp anche su altre macchine. Affinché questo funzioni devi indicizzare le cartelle in cui è localizzato il codice sorgente.

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

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

E quindi di solito l'estensione trova quello giusto.

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

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.

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

L'estensione di compilazione 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:

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

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.

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

Assumendo che tu abbia questi documenti aperti in Kate:

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.

Questa estensione aggiunge nelle righe del testo un'anteprima colore/selettore (ad es., #FFFFFF, bianco).

Per caricare questa estensione apri la finestra di configurazione di Kate in Impostazioni → Configura Kate..., seleziona quindi Selettore di colore e chiudi la finestra.

Nella pagina delle impostazioni del Selettore di colore nella configurazione di Kate è possibile configurare le seguenti impostazioni del comportamento dell'estensione.

L'estensione parentesi colorate colora le coppie di parentesi corrispondenti con dei colori diversi, in modo da migliorare la leggibilità. Tuttavia, non tutte le parentesi vengono colorate: ad esempio, una la cui apertura o chiusura corrispondente non è visibile verrà ignorata. Allo stesso modo, l'unica coppia di parentesi su una riga non verrà colorata.

L'estensione non fornisce nessuna configurazione.

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.

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.

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.

L'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.

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

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

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

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 per eliminare i file; con Copia posizione 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:

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.

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

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.

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 Debug → Avvia il debug per cominciare.

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

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

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

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 dell'estensione GDB.

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

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

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.

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.

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:

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.

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

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

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

Se appropriato, nella spiegazione seguente viene menzionato anche un comando LSP corrispondente, la cui documentazione può quindi fornire informazioni e interpretazioni aggiuntive, sebbene possa variare a seconda del linguaggio effettivo. L'espressione "simbolo corrente" si riferisce al simbolo corrispondente alla posizione corrente del cursore, come determinato dal linguaggio e dall'implementazione del server.

Il client LSP può aiutarti a saltare a ogni simbolo nel progetto o nel file corrente. Per saltare ai simboli nel file usa lo strumento visivo «Schema del simbolo del client LSP» nel bordo destro di Kate. Lo strumento visivo elenca tutti i simboli che sono trovati dal server nel documento corrente.

Il comando per scambiare intestazione e sorgente è supportato. Per farlo in un progetto C o C++ puoi utilizzare l'opzione «Scambia sorgente e intestazione» sia dal menu contestuale che con la scorciatoia F12.

Puoi andare velocemente a un simbolo mettendo il mouse sopra di esso e poi premendo Ctrl più il pulsante sinistro del mouse.

La pagina di configurazione dell'estensione permette principalmente la configurazione persistente di alcune delle voci di menu di cui sopra. Tuttavia esiste una voce aggiuntiva per specificare il file di configurazione del server: è un file JSON che può essere utilizzato per specificare il server LSP da avviare (e quindi con cui comunicare tramite stdin e stdout). Per comodità sono incluse alcune configurazioni predefinite, che possono essere ispezionate nella pagina di configurazione dell'estensione. Per aiutare nella spiegazione di seguito, viene fornito un estratto di tale configurazione:

{
    "servers": {
        "bibtex": {
            "use": "latex",
            "highlightingModeRegex": "^BibTeX$"
        },
        "c": {
            "command": ["clangd", "-log=error", "--background-index"],
            "commandDebug": ["clangd", "-log=verbose", "--background-index"],
            "url": "https://clang.llvm.org/extra/clangd/",
            "highlightingModeRegex": "^(C|ANSI C89|Objective-C)$"
        },
        "cpp": {
            "use": "c",
            "highlightingModeRegex": "^(C\\+\\+|ISO C\\+\\+|Objective-C\\+\\+)$"
        },
        "d": {
            "command": ["dls", "--stdio"],
            "url": "https://github.com/d-language-server/dls",
            "highlightingModeRegex": "^D$"
        },
        "fortran": {
            "command": ["fortls"],
            "rootIndicationFileNames": [".fortls"],
            "url": "https://github.com/hansec/fortran-language-server",
            "highlightingModeRegex": "^Fortran.*$"
        },
        "javascript": {
            "command": ["typescript-language-server", "--stdio"],
            "rootIndicationFileNames": ["package.json", "package-lock.json"],
            "url": "https://github.com/theia-ide/typescript-language-server",
            "highlightingModeRegex": "^JavaScript.*$",
            "documentLanguageId": false
        },
        "latex": {
            "command": ["texlab"],
            "url": "https://texlab.netlify.com/",
            "highlightingModeRegex": "^LaTeX$"
        },
        "go": {
            "command": ["go-langserver"],
            "commandDebug": ["go-langserver", "-trace"],
            "url": "https://github.com/sourcegraph/go-langserver",
            "highlightingModeRegex": "^Go$"
        },
        "python": {
            "command": ["python3", "-m", "pyls", "--check-parent-process"],
            "url": "https://github.com/palantir/python-language-server",
            "highlightingModeRegex": "^Python$"
        },
        "rust": {
            "command": ["rls"],
            "path": ["%{ENV:HOME}/.cargo/bin", "%{ENV:USERPROFILE}/.cargo/bin"],
            "rootIndicationFileNames": ["Cargo.lock", "Cargo.toml"],
            "url": "https://github.com/rust-lang/rls",
            "highlightingModeRegex": "^Rust$"
        },
        "ocaml": {
            "command": ["ocamlmerlin-lsp"],
            "url": "https://github.com/ocaml/merlin",
            "highlightingModeRegex": "^Objective Caml.*$"
        }
    }
}

Nota che ciascun «command» può essere un vettore o una stringa (nel qual caso viene divisa in un vettore), inoltre viene considerata anche una voce «global» di livello massimo (vicina a «server»), vedi sotto. Il binario specificato viene cercato nel solito modo, ad es usando PATH. Se è installato in posizioni personalizzate, allora l'ultimo metodo potrebbe dover essere esteso. In alternativa si può utilizzare un collegamento (simbolico) o uno script wrapper per una posizione nel PATH usuale. Come illustrato sopra, uno può specificare un «percorso» in cui cercare dopo averlo fatto nelle posizioni standard.

Tutte le voci in «command», «root» e «path» sono soggette all'espansione delle variabili.

«HighlightingModeRegex» viene usato per associare la modalità di evidenziazione usata da Kate all'ID del linguaggio del server. Se non viene fornita alcuna espressione regolare, viene utilizzato l'id del linguaggio stesso. Se una voce «documentLanguageId» viene impostata a falso allora non viene fornito al server nessun ID del linguaggio all'apertura del documento. Questo potrebbe dare dei risultati migliori su alcuni server che sono più precisi nel determinare il tipo di documento piuttosto che farlo in base alla modalità di kate.

Dall'esempio qui sopra, il principio è probabilmente chiaro. Inoltre, ciascun oggetto di voce del server può avere anche una voce «initializationOptions», che viene passata al server come parte del metodo «initialize». Se presente, viene passata al server una voce «settings» per mezzo della notifica «workspace/didChangeConfiguration».

Vengono applicate varie fasi di sovrapposizione/unione;

Un'istanza del server viene utilizzata per ogni combinazione (root, servertype). Se «root» viene specificata come un percorso assoluto viene utilizzato così com'è, diversamente è relativo a «projectBase» (come determinato dall'estensione di progetto) se applicabile, oppure è relativo alla cartella del documento. Se non è stato specificato, e se «rootIndicationFileNames» è un vettore, allora viene selezionata una cartella genitore del documento corrente che contiene il file che è selezionato. In alternativa, se «root» non è specificato e «rootIndicationFilePatterns» è un vettore di modelli di file, viene selezionata una cartella genitore del documento corrente che corrisponde al modello di file che è selezionato. Come ultimo ripiego viene selezionata come «root» la cartella home. Per qualsiasi documento la cartella «root» risultante determina se è necessaria o meno un'istanza separata. Se sì, «root» viene passata come rootUri/rootPath.

In generale viene raccomandato di lasciare root non specificata poiché non è così importante per un server (ma dipende dalle tue esigenze). Un numero minore di istanze del server è ovviamente più efficiente e ha anche una visione "più ampia" rispetto a molte istanze separate.

Come menzionato sopra, molte voci sono soggette all'espansione delle variabili. Un'applicazione adatta di essa, associata ad uno «script adattatore», permette la personalizzazione in molte circostanze. Ad esempio, considera uno scenario di sviluppo in Python formato da più progetti (ad esempio repository git), ciascuno con le proprie impostazioni di ambiente virtuale (venv). Usando la configurazione predefinita il server del linguaggio Python non sarà a conoscenza dell'ambiente virtuale. A questo però si può rimediare col seguente approccio: per prima cosa, nell'estensione «User Server Settings» di LSPClient si può inserire il seguente frammento:

{
        "servers":
        {
                "python":
                {
                        "command": ["pylsp_in_env"], ["%{Project:NativePath}"],
                        "root": "."
                }
        }
}

La voce principale qui sopra è relativa alla cartella del progetto e garantisce che sia stato avviato un server di lingua separato per ogni progetto. In questo caso ciò è necessario, in quanto ciascuno ha un ambiente virtuale distinto.

pylsp_in_env è un piccolo «script adattatore» che dovrebbe essere messo in PATH, col seguente contenuto (da sistemare):

#!/bin/bash
cd $1
# avvia il server (python-lsp-server) nell'ambiente virtuale
# (ad esempio con le impostazioni delle variabili dell'ambiente virtuale)
# quindi sorgente dell'ambiente virtuale
source XYZ
# il server e gli argomenti possono variare
exec myserver

{
    "servers": {
        "python": {
            "settings": {
                "pyls": {
                    "plugins": {
                        "pylint": {
                            "enable": true
                        }
                    }
                }
            }
        }
    }
}

{
    "servers": {
        "c": {
            "suppressions": {
                "rulename": ["filename", "pippo"],
                "clang_pointer": ["", "clang-tidy", "clear_pointer"],
            }
        }
    }
}

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.

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.

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.

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'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'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. Per ulteriori informazioni fai riferimento alla documentazione dell'API di scripting.

Per script più complessi può essere importante capire che prima il frammento grezzo viene inserito nel documento, poi le funzioni vengono valutate. Ad esempio, se una funzione restituisce il testo della riga nella quale è stato inserito il frammento, quel testo conterrà anche ${functionCall()}.

Questo frammento è un esempio di come lavorare con le selezioni usando lo scripting con l'API. È un modo semplice per avvolgere il testo selezionato all'interno di etichette: <strong>${view.selectedText()}</strong>

L'esempio seguente invoca uno script che inserisce un testo predefinito nel caso non ci sia nessuna selezione. Frammento:

${rangeCommand("<strong>%%1</strong>", "Bold")}

Script:

function rangeCommand(command, def) {
    if (view.selectedText().length 
> 0) {
        return command.replace("%%1", view.selectedText());
    } else {
        return command.replace("%%1", def);
    }
}

Selezione da un elenco di frammenti.

Puoi richiamare i frammenti in due modi:

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.

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.

Registra ed esegui le macro da tastiera (cioè una sequenza di azioni da tastiera).

È possibile salvare le macro da tastiera dandogli un nome.

Le macro con nome sono persistenti tra le sessioni di Kate: vengono salvate nel file keyboardmacros.json che si trova nella cartella dei dati utente di Kate (di solito ~/.local/share/kate/).

Al momento le macro da tastiera non vengono eseguite correttamente se nell'interfaccia vengono utilizzati alcuni oggetti, ad esempio QMenu, QuickOpenLineEdit o TabSwitcherTreeView. Non sono sicuro sul perché, ma il mio primo pensiero è che questi oggetti funzionino in una modalità non standard riguardo agli eventi da tastiera.

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:

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.

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.

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.

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

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

Sono disponibili le seguenti opzioni:

Puoi usare questa estensione per elaborare il testo selezionato usando i comandi da terminale. La selezione sarà utilizzata come input per il comando, e il risultato rimpiazzerà la selezione o sarà copiato negli appunti, a seconda delle preferenze dell'utente.

Estensione di Kate «Validazione XML», copyright 2002 di Daniel Naber (daniel.naber AT t-online.de).

Copyright 2002 della documentazione di Daniel Naber

Avvia Kate e apri la finestra di configurazione da Impostazioni → Configura Kate.... Seleziona quindi Completamento XML, che apparirà nella sezione Estensioni sotto Applicazione, e chiudi la finestra, dopodiché seleziona XML → Assegna 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:

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

Estensione di Kate «Completamento XML», copyright 2001, 2002 di Daniel Naber (daniel.naber AT t-online.de).

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

Copyright 2001, 2002 della documentazione di Daniel Naber