&Anders.Lund; &Anders.Lund.mail;
Nicola
Ruggero
Traduzione della documentazione
Federico
Zenith

    federico.zenith@member.fsf.org

Traduzione della documentazione

# Lavorare con le estensioni

Kate usa due diversi tipi di estensione: quelle per l'applicazione completa di &kate;, e quelle per il solo componente editor. Queste ultime sono disponibili per qualsiasi applicazione usi il componente editor, come KDevelop, Quanta, Kile, Kwrite e molte altre. Le estensioni per l'applicazione sono invece specificamente per &kate;.

Puoi abilitare entrambi i tipi di estensioni nella finestra di configurazione, che dà anche accesso alle opzioni di configurazione aggiuntive per le estensioni che le richiedano.

Ci sono molte estensioni disponibili per diversi scopi, e puoi trovarne delle altre sul Web. Alcune sono distribuite assieme al componente editor, come le graffe automatiche, l'inserimento dei file, e l'esportazione di testo come &HTML;.

## Estensioni dell'applicazione &kate;

Le estensioni di &kate; sono funzioni aggiuntive per l'editor &kate;. Possono aggiungere nuovi menu e scorciatoie, ed estendere le funzionalità di &kate;. Puoi installarne quante ne vuoi dall'interno di &kate;. Apri la finestra di configurazione di &kate; con Impostazioni Configura Kate.... Seleziona Applicazione Estensioni per scegliere quelle che vuoi.

Le estensioni per l'applicazione disponibili sono:

- Browser di backtrace: vista dello strumento di navigazione dei backtrace;

- Estensione di compilazione: compila o esegui `make` ed elabora i messaggi d'errore;

- Estensione CTags: cerca definizioni e dichiarazioni con CTags;

- Browser del filesystem: strumento di visualizzazione del filesystem;

- Modelli di file: crea nuovi file partendo da dei modelli;

- &gdb;: fornisce una semplice interfaccia a &gdb;;

- Pronuncia Jovie: aggiunge una voce del menu per pronunciare il testo;

- Invia file: invia file per posta elettronica;

- Barra di schede multilinea: aggiunge una barra delle linguette con più righe alla finestra principale di &kate;;

- Apri intestazioni: apri il file `.h/[.cpp|.c]`;

- Estensione per progetti: un'estensione di progettazione per &kate;;

- Estensioni Python: raccolta generica di estensioni Python

- Estensione di ricerca e sostituzione: cerca o sostituisci schemi in tutti i file aperti o in tutti i file in una cartella;

- Strumento per frammenti di testo: vista che incorpora la gestione dei frammenti;

- Estensione SQL: interroga banche dati SQL;

- Visore di simboli: estrae e visualizza i simboli di riferimento dal sorgente;

- Barra delle linguette: aggiunge una normale barra delle linguette alla finestra principale di &kate;;

- Strumento visivo per terminale: vista che incorpora un terminale;

- Filtro di testo: filtraggio facile del testo;

- Validazione &XML;: valida i file &XML; con `xmllint`;

- Completamento &XML;: elenca elementi, attributi, valori di attributi ed entità permessi dalla DTD.

&plugins-part-sections;
&Anders.Lund; &Anders.Lund.mail;

## Modelli di file

L'estensione per i modelli di file permette di creare file in base ad altri file.

Quando si installa &kate; per la prima volta, si deve abilitare l'estensione:

1. Fai clic su Impostazioni Configura Kate.

2. Nell'albero sulla sinistra, fai clic su Estensioni.

3. Nel pannello Gestore delle estensioni a destra, seleziona Modelli di file, e fai quindi clic su OK.

Si può ora usare qualsiasi file come modello (ciò crea una copia del file con un &URL; vuoto). Dei file modello speciali possono contenere macro per inserire informazioni come nomi, indirizzi di posta, la data attuale, e posizionare il cursore in un posto appropriato del nuovo file.

Si può facilmente creare un nuovo modello da un documento aperto.

I modelli salvati nella cartella dei modelli sono elencati nel menu File Nuovo da modello.

La cartella dei modelli fa parte del filesystem di &kde;, e consiste almeno di:

- `$`KDEDIR`/share/applications/kate/plugins/katefiletemplates/templates`

- `$`KDEHOME`/share/applications/kate/plugins/katefiletemplates/templates`

Se la variabile d'ambiente `KDEDIRS` contiene altre cartelle, saranno cercate delle sottocartelle simili anche in queste. Se vengono trovati modelli con lo stesso nome, viene scelto quello nella cartella locale (`$`KDEHOME``).

### Struttura dei menu

File Nuovo da modello Qualsiasi file

  Presenta il selettore dei file, che permette di usare qualsiasi file come modello. Se il file scelto ha l'estensione `.katetemplate`, verrà analizzato alla ricerca di informazioni del modello e di macro.

File Nuovo da modello

  Il resto dei sottomenu contiene dei collegamenti a modelli. Fai clic su un elemento per creare un file come descritto dal suo testo.

Impostazioni Gestisci modelli...

  Questo avvierà una finestra con un elenco di tutti i modelli trovati nelle cartelle dei modelli, insieme alle opzioni di aggiungerne, modificarli o rimuoverli.

### Usare un modello di &kate;

Quando si crea un file da un modello che contenga delle macro per modelli, alcune macro appaiono come variabili modificabili nel testo. Queste variabili appaiono nel testo come parole sottolineate.

La prima variabile sarà selezionata, quindi devi solo scrivere per modificarla. Se il testo del documento contiene più occorrenze della stessa variabile, vengono cambiate mentre la modifichi. Per andare alla variabile modificabile successiva, premi il tasto &Tab;. Quando è stata modificata l'ultima variabile, l'elenco viene rimosso, e il tasto &Tab; funziona come normale.

### Creare i tuoi modelli

Per creare un nuovo modello, usa l'elemento Impostazioni Gestisci modelli per avviare la finestra di gestione dei modelli. In questa, fai clic su Nuovo... per avviare l'assistente dei modelli di file. Verranno chiesti un file facoltativo da far diventare modello e le impostazioni delle sue informazioni, e sarà quindi creato un file modello.

In alternativa, puoi creare un modello manualmente aggiungendone le informazioni all'inizio di qualsiasi file, aggiungere testo e macro, e salvarlo con l'estensione `.katetemplate`.

Il menu dei modelli viene aggiornato automaticamente se scegli di salvare il modello nella cartella dei modelli.

### Modificare i modelli

Per modificare un modello, usa Impostazioni Gestisci modelli.... Seleziona il modello sul quale vuoi lavorare e fai clic su Modifica..., e il file del modello verrà aperto. Chiudi la finestra, modifica il file del modello come desideri, salvalo e chiudilo. I cambiamenti ai modelli hanno effetto immediato, puoi attivare il modello per provare le modifiche dopo averlo salvato.

### Il formato dei modelli di &kate;

Se usi dei file con estensione `.katetemplate`, saranno analizzati alla ricerca di informazioni, macro del modello e una posizione del cursore.

#### Informazioni del modello

Leggendo nel file, il programma di analisi tiene da parte le righe che cominciano per `katetemplate:` e ci cerca le informazioni di modello nella forma nome_variabile=valore. La prima riga che non comincia per `katetemplate:` sarà considerata l'inizio dei contenuti del modello. valore può contenere qualsiasi carattere tranne il segno di uguale (=). I nomi di variabile ammessi sono:

`Template`

  Questo è il nome del modello, mostrato nel menu File Nuovo da modello.

`Group`

  Il gruppo posiziona il modello in un sottomenu del menu File Nuovo da modello.

`Name`

  Questo è il nome che sarà impostato per il documento, e mostrato nell'elenco dei file e nella barra del titolo. Se il nome contiene `%N`, questo verrà rimpiazzato con un numero, aumentandolo se ci sono altri documenti con lo stesso nome.

`Highlight`

  L'estensione cercherà di impostare l'evidenziazione del nuovo documento al valore di questa variabile. Il valore dovrebbe essere un nome, come si trova nel menu Strumenti Modalità di evidenziazione.

`Description`

  Una breve descrizione informativa del modello. È attualmente usata per impostare una stringa Che cos'è? per l'elemento del menu, ma potrà essere usata per altre cose in futuro.

Author

  Una stringa che identifica l'autore, per esempio nella forma `Nome <indirizzo di posta>`. È attualmente usata per impostare una stringa Che cos'è? per l'elemento del menu, ma potrà essere usata per altre cose in futuro.

#### Macro dei modelli

Nell'analisi dei contenuti del modello, vengono espanse le macro nella forma `%{nome}` o `${nome}`. Se usi il prefisso `$`, la macro espansa sarà trattata come variabile modificabile quando viene creato un documento dal modello, mentre se usi `%` non lo sarà, a meno che l'espansione non riesca.

Vengono espanse le macro seguenti:

`time`

  Si espande nell'ora attuale nel formato locale.

`date`

  Si espande alla data attuale nel formato breve.

`datetime`

  Si espande alle data e ora correnti, formattate come una stringa secondo le impostazioni locali.

`year`

  L'anno corrente come numero di quattro cifre.

`month`

  Il nome completo del mese corrente, secondo la localizzazione.

`day`

  Si espande all'attuale giorno del mese.

`hostname`

  Si espande al nome host del computer.

`index`

  Si espande a `i`.

`fullname`

  Si espande al tuo nome completo, come definito nell'indirizzo del proprietario nella rubrica di &kde;.

`firstname`

  Si espande al tuo nome, come definito nell'indirizzo del proprietario nella rubrica di &kde;.

`lastname`

  Si espande al tuo cognome, come definito nell'indirizzo del proprietario nella rubrica di &kde;.

email

  Si espande al tuo indirizzo di posta elettronica, come definito nell'indirizzo del proprietario nella rubrica di &kde;.

Qualsiasi macro al di fuori dall'elenco qui sopra è trattata come modificabile, indipendentemente dal prefisso. Se la stessa variabile ricorre più volte nel modello, può essere modificata immediatamente dopo aver creato un documento dal modello.

#### Impostare la posizione del cursore

La macro speciale `${cursor}` sarà sostituita con una barra verticale e aggiunta alla fine dell'elenco delle variabili modificabili, indipendentemente dalla sua posizione nel testo.

### Ringraziamenti e riconoscimenti

Estensione di &kate; Modelli di file, copyright 2004 di &Anders.Lund; &Anders.Lund.mail;.

Copyright della documentazione 2004 di &Anders.Lund;.

&Daniel.Naber; &Daniel.Naber.mail;

## Validazione &XML;

Questa estensione controlla che i file &XML; siano validi e scritti in forma corretta.

L'estensione controlla il file attuale. Sul fondo della finestra principale di &kate; apparirà un elenco di avvertimenti ed errori. Puoi fare clic su un messaggio d'errore per saltare al punto corrispondente nel file. Se il file ha un DOCTYPE, si userà il suo DTD per controllarne la validità. Ci si aspetta che il DTD sia in posizione relativa al file attuale: per esempio se il doctype si riferisce a `DTD/xhtml1-transitional.dtd` e il file è `/home/pippo/prova.xml`, ci si aspetta che il DTD sia a `/home/pippo/DTD/xhtml1-transitional.dtd`. Comunque, sono 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. Se questo comando non è correttamente installato sul sistema, l'estensione non funzionerà.

Deve essere scritto un file temporaneo nella stessa cartella del file che viene controllato, quindi avrai bisogno dell'accesso in scrittura a quella cartella.

Per caricare questa estensione apri la finestra di configurazione di &kate; sotto Impostazioni Configura Kate.... Seleziona quindi Validazione XML che apparirà nella sezione Estensioni, sotto Applicazione, e chiudi la finestra.

### Struttura dei menu

XML Convalida XML

  Questo avvierà il controllo, come sopra descritto.

### Ringraziamenti e riconoscimenti

Estensione di &kate; Validazione XML, copyright 2002 di &Daniel.Naber; &Daniel.Naber.mail;.

Copyright 2002 della documentazione di &Daniel.Naber;

&Daniel.Naber; &Daniel.Naber.mail;

## Completamento &XML;

Questa estensione suggerisce cosa è ammissibile in un certo punto di un file &XML;, secondo la DTD del file. Elencherà i possibili elementi, attributi, valori degli attributi o 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; sono installate in `$`KDEDIR`/share/apps/katexmltools/`, che è 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 sotto 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 nessun DOCTYPE o questo è ignoto, dovrai selezionare una meta-DTD dal filesystem. Altrimenti, la meta-DTD corrispondente al DOCTYPE del documento attuale sarà automaticamente caricata.

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)

  Inserire questi caratteri chiuderà l'elemento attuale (l'ultimo aperto a sinistra del cursore). Premi &Enter; per accettare il suggerimento. Al contrario dell'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 limiti

Puoi provare tutte le funzioni e i limiti caricando in &kate; `$`KDEDIR`/share/apps/katexmltools/testcases.xml` e seguendo le istruzioni.

### Struttura dei menu

&Ctrl;&Enter; XML Inserisci elemento

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

&Ctrl;< XML Chiudi elemento

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

XML Assegna meta-DTD

  Questo dirà all'estensione quale meta-DTD usare per il documento attuale. Nota che questa assegnazione non verrà salvata. La dovrai ripetere al prossimo riavvio di &kate;.

### Ringraziamenti e riconoscimenti

Estensione di &kate; Completamento XML, copyright 2001, 2002 di &Daniel.Naber; &Daniel.Naber.mail;.

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

Copyright 2001, 2002 della documentazione di &Daniel.Naber;

## Esportatore

### Struttura dei menu

File Esporta come HTML

  Esporta il file in formato &HTML; in modo che il documento possa essere visualizzato come una pagina Web.

Modifica Copia come HTML

  Copia il testo selezionato con l'evidenziazione della sintassi come testo &HTML;.

&TC.Hollingsworth; &TC.Hollingsworth.mail;

## Ricerca e sostituzione

### Introduzione

L'estensione di ricerca nei file di &kappname; permette di cercare testo o espressioni regolari in molti file alla volta. Puoi cercare in tutti i file aperti, o in tutti i file in una cartella, e a scelta nelle sue sottocartelle. Puoi anche filtrare secondo il nome del file, per 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:

Nuova scheda

  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, e apparirà una nuova scheda di risultati che permette di effettuare una nuova ricerca.

Interrogazione

  La lunga casella di testo in cima è dove scrivi cosa vuoi trovare. Puoi inserire del testo normale, o un'espressione regolare e le abiliti.

Cerca

  Quando hai finito di configurare tutto, premi il pulsante Cerca per effettuare la ricerca. Puoi anche premere &Enter; nella casella di testo per fare la stessa cosa.

Posizione

  Qui ci sono due opzioni. Seleziona nei file aperti per cercare tutti i file attualmente aperti &kappname;. Seleziona nella cartella per cercare in una cartella e a scelta nelle sue sottocartelle.

Opzioni

  Ci sono due opzioni disponibili. Se abilitata, Distingui le maiuscole limiterà i risultati della ricerca a quelli che hanno la stessa combinazione di lettere maiuscole e minuscole del testo di ricerca. L'opzione Espressioni regolari permette di usare le espressioni regolari invece del testo semplice nell'interrogazione di ricerca.

Commuta risultati

  La freccia in basso nell'angolo in alto a destra dello strumento di ricerca nei file scambierà metà della vista dello strumento tra la visualizzazione di opzioni aggiuntive per la modalità di ricerca nelle cartelle e i risultati della ricerca.

#### Opzioni della 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 Commuta risultati per mostrarle. Queste opzioni si applicano solo quando è abilitata la modalità di ricerca nelle cartelle. Se è selezionata la ricerca nei file aperti, saranno disattivate.

Cartella

  Puoi inserire il percorso della cartella in cui vuoi cercare. Per esempio, potresti inserire `~/sviluppo/kde/kate/` se volessi cercare nel codice sorgente di &kate;.

Apri selettore dei file

  Premi questo pulsante per localizzare la cartella nel selettore associato al tuo sistema.

Su

  Premi questo pulsante per cambiare la Cartella alla cartella madre di quella attualmente selezionata.

Ripristina cartella attuale

  Questo pulsante imposterà la voce della Cartella a quella in cui si trova il documento attuale.

Filtro

  Questo permette di cercare solo nomi di file che corrispondano a un certo schema. Per esempio, per cercare solo file scritti in C++, cambialo a `*.cpp`. Per cercare solo file che cominciano per `kate`, cambialo a `kate*`. Puoi inserire più filtri separandoli con virgole (`,`). Per invece escludere i file dalla ricerca, aggiungi un segno meno (`-`) all'elenco.

Ricorsivo

  Se questa opzione è abilitata, &kappname; cercherà anche tutte le sottocartelle della cartella selezionata.

Includi nascosti

  Se questa opzione è abilitata, &kappname; cercherà anche nei file o nelle cartelle che sono normalmente nascosti dal sistema operativo.

Segui i collegamenti simbolici

  L'estensione di ricerca nei file normalmente non segue i collegamenti simbolici. Quando questa opzione è abilitata, l'estensione invece li seguirà e cercherà nei file e nelle cartelle a cui riferiscono.

  È possibile che i collegamenti simbolici puntino alla cartella madre di quella attualmente in esame, o altre cartelle che portino ad essa. Se è presente un simile collegamento e l'opzione è abilitata, &kappname; seguirà ripetutamente il collegamento e la ricerca non si concluderà mai.

#### 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 Commuta risultati per mostrarli. Saranno inoltre automaticamente visualizzati non appena verrà effettuata una ricerca.

I risultati della ricerca mostrano tre colonne con informazioni su ogni risultato dell'interrogazione di ricerca. La colonna File mostra il nome del file. La colonna Riga indica il numero della riga in cui i contenuti dell'interrogazione sono stati rilevati. La colonna Testo mostra il testo completo di quella riga.

Per aprire il file in cui è stato trovato il risultato, basta farci doppio clic. &kappname; aprirà quindi il file, se necessario, e posizionerà il cursore all'inizio del testo nel file corrispondente all'interrogazione.

### Struttura dei menu

Visualizza Viste degli strumenti Mostra Cerca nei file

  Attiva o disattiva la visualizzazione dello strumento Cerca nei file di &kappname;.

## Invia file

### Struttura dei menu

File Spedisci

  Apri il programma di posta e allega il file nel messaggio.

## Browser del filesystem

Il browser del filesystem è un visore di cartelle che permette di aprire i file da una cartella aperta nella riquadro attuale.

### Struttura dei menu

Visualizza Viste degli strumenti Mostra Browser del filesystem

  Mostra o nasconde il browser del filesystem di &kate;.

### Interfaccia

Dall'alto al basso, il browser del filesystem è composto dai seguenti elementi:

Una barra degli strumenti

  Questa contiene pulsanti standard per la navigazione:

  Indietro

    Fa in modo che la vista delle cartelle si sposti a quella precedentemente visualizzata in ordine cronologico. Questo pulsante è disabilitato se non c'è un elemento precedente nella cronologia.

  Avanti

    Provoca lo spostamento della vista delle cartelle a quella successiva nella cronologia. Questo pulsante è disattivato se non esiste una cartella successiva nella cronologia.

  Segnalibri

    Apre un sottomenu per modificare o aggiungere segnalibri e per aggiungere una nuova cartella di segnalibri.

  Cartella del documento attuale

    Questo pulsante manda la vista delle cartelle a quella che contiene 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

      Mostra Nome, Data, Dimensione e Tipo dei file.

    Vista ad albero

      Come la vista breve, ma le cartelle possono essere espanse per vederne 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 normalmente nascosti dal sistema operativo.

    Sincronizza automaticamente con il documento attuale

      Quando questa opzione è abilitata, il browser del filesystem passerà automaticamente alla cartella del documento attualmente aperto nell'area di modifica ogni volta che cambia.

Un campo di posizione

  Questo mostra una navigazione a briciole della cartella attualmente aperta, come in &dolphin;. Puoi fare clic su qualsiasi cartella per sfogliarla, o fare clic su una delle frecce a sinistra di una cartella per selezionare qualsiasi cartella sottostante. Puoi anche selezionare dall'elenco delle tue Risorse facendo clic sull'icona in fondo a sinistra nella navigazione a briciole, che mostra un'icona che rappresenta la Risorsa attuale.

  Puoi anche fare clic a destra delle briciole per trasformarle in una casella di testo dove puoi digitare il percorso di una cartella da sfogliare. Il campo per &URL; mantiene una lista di tutti i percorsi precedentemente inseriti. Per sceglierne uno usa il pulsante con la freccia sulla destra del campo.

  Il campo &URL; ha il completamento automatico dei nomi delle cartelle. Il metodo di completamento può essere impostato utilizzando il menu contestuale del campo di inserimento.

Una vista delle cartelle

  Questa è una vista di cartelle standard di &kde;.

Un campo di filtro

  Il campo di filtro 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`.

  Per visualizzare tutti i file, inserisci un singolo asterisco `*`.

  Il campo 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 il filtro che desideri. Puoi disattivare il filtro premendo il pulsante Pulisci il testo a sinistra del pulsante a freccia di autocompletamento.

### Configurazione

Questa estensione può essere configurata nella pagina Navigatore del filesystem della configurazione di &kate;.

Barra degli strumenti

  Configura i pulsanti della barra del navigatore del filesystem spostando quelli desiderati nell'elenco Azioni selezionate, e ordinali con i pulsanti a freccia di fianco all'elenco.

Martin
Gergov
&TC.Hollingsworth; &TC.Hollingsworth.mail;

## Frammenti di Kate

### 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 QtScript.

### Struttura dei menu

Visualizza Viste degli strumenti Mostra frammenti

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

### Pannello dei frammenti

Pannello dei frammenti di Kate
Il pannello dei frammenti di Kate.

Il pannello dei frammenti di Kate.

Nel pannello dovresti vedere un elenco di depositi di frammenti, insieme alle opzioni per crearne di tuoi, recuperarli da Internet o caricarli da un file locale. Ogni deposito ha una casella per 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 fare clic su Prendi nuovi frammenti e apparirà una finestra con un elenco di depositi di frammenti. Dopo aver scaricato il frammento desiderato, assicurati di attivarlo.

Puoi anche caricare dei depositi di frammenti da un file locale con il navigatore dei file sul fondo del pannello. Fai clic su Copia al deposito quando hai finito.

#### Creare e modificare i frammenti

Editor di frammenti
L'editor di frammenti.

L'interfaccia dell'editor di frammenti.

Per creare un nuovo deposito di frammenti, fai clic su Nuovo file di frammenti. 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 Crea, e si aprirà l'editor dei frammenti.

L'editor dei frammenti contiene le seguenti opzioni:

Tipo di file

  Seleziona i tipi di file a cui vuoi si applichi il deposito. L'impostazione predefinita è `*`, in modo che il deposito si applichi a tutti i file. Puoi cambiarlo per esempio a qualcosa come `C++`, o selezionare da un elenco premendo Modifica. Puoi specificare più di un tipo di file separandoli con `;`.

Autori

  Inserisci i nomi degli autori nel file di frammenti.

Elenco di frammenti

  Contiene tutti i frammenti definiti nel file. Basta fare clic su un frammento qui elencato per modificarlo.

Aggiungi (+)

  Usato per aggiungere un nuovo frammento.

Elimina (-)

  Usato per eliminare un frammento.

Corrispondenza/Nome:

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

Mostra prefisso, Mostra postfisso, e Mostra argomenti

  Usato per mostrare informazioni utili quando si usa il completamento del codice. Il prefisso e il postfisso vengono mostrati prima e dopo il nome, mentre gli argomenti vengono mostrati in parentesi subito dopo il nome.

Contenuto del frammento

  Testo o codice riutilizzabile. Questo è quello che appare nel documento quando si usa il frammento.

Nel Contenuto del frammento puoi specificare delle variabili con `${nome}` o `%{nome}`. Queste possono essere riempite da QtScript o quando il frammento viene usato. C'è una variabile speciale, `${cursor}` o `%{cursor}`, che imposta automaticamente il cursore alla sua prima occorrenza.

### Usare i frammenti

I frammenti di Kate in azione
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 degli strumenti.

- Mentre scrivi, puoi premere &Ctrl;Spazio, che mostrerà tutti i frammenti in una comoda finestra da cui sceglierne uno. Puoi inserire l'inizio del nome del frammento prima o dopo aver premuto questa combinazione di tasti, essendoci una funzionalità simile al 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 molto di questa sezione.

Salma
Sultana
&TC.Hollingsworth; &TC.Hollingsworth.mail;

## Estensione di compilazione

### Introduzione

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

### Usare l'estensione di compilazione

L'estensione di compilazione aggiunge una vista degli strumenti Output compilazione in fondo e un menu Compila nella barra dei menu. La vista degli strumenti può essere usata per configurare le impostazioni delle destinazioni della compilazione, mentre il menu può essere usato per effettuare azioni di generazione, pulizia e compilazione.

La vista degli strumenti Output compilazione ha tre schede:

- Errori ed avvisi&

- Output

- Impostazioni destinazione

#### Scheda delle impostazioni delle destinazioni

La scheda delle impostazioni delle destinazioni può essere usata per configurare varie destinazioni di compilazione.

Ogni destinazione contiene quattro opzioni di compilazione:

Cartella di lavoro

  Qui puoi impostare il percorso del progetto. Lascialo vuoto per usare la cartella attuale in cui si trova il documento.

Compila

  Questa opzione permette di definire il comando di compilazione. L'impostazione predefinita è `make`.

Pulisci

  Questa opzione permette di definire il comando di pulizia. L'impostazione predefinita è `make clean`.

Compilazione rapida

  Questa opzione permette di definire il comando di compilazione rapida. L'impostazione predefinita è `gcc `-Wall` `-g` `%f``.

Si possono creare nuove destinazioni usando il pulsante Nuovo. Il pulsante Copia può essere usato per fare una copia di una destinazione preesistente. Per eliminare una destinazione, usa il pulsante Elimina.

#### Scheda dell'output

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

#### Errori ed avvisi

La scheda Errori ed avvisi elenca gli errori e gli avvisi generati dall'ultimo comando.

Ogni riga contiene un messaggio e, se disponibili, il nome del file e il numero di riga. Facendo clic sull'errore o sull'avviso porta al file appropriato e mette il cursore in corrispondenza del numero della riga.

Per andare all'errore precedente, premi &Ctrl;&Alt;←. Per andare all'errore successivo, premi &Ctrl;&Alt;→.

### Struttura dei menu

Compila Compila

  Esegue il comando di compilazione per la destinazione attualmente selezionata.

Compila Pulisci

  Esegue il comando di pulizia per la destinazione attualmente selezionata.

Compila Compilazione rapida

  Esegue il comando di compilazione rapida per la destinazione attualmente selezionata.

&Ctrl;&Alt;← Compila Errore precedente

  Sposta il cursore al luogo dell'errore precedente nel documento.

&Ctrl;&Alt;→ Compila Errore successivo

  Sposta il cursore al luogo dell'errore successivo nel documento.

Compila Destinazioni

  Seleziona da un elenco di destinazioni configurato dall'utente.

Compila Destinazione successiva

  Passa alla prossima destinazione configurata dall'utente.

### Ringraziamenti e riconoscimenti

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

Ringraziamenti speciali vanno al partecipante del Google Code-In 2011 Salma Sultana per aver scritto molto di questa sezione.

Ömer
Faruk
Oruç
&TC.Hollingsworth; &TC.Hollingsworth.mail;

## Estensione SQL

### Introduzione

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

L'estensione SQL per &kate; permette di:

- Creare una banca dati

- Connettersi a banche dati

- Inserire ed eliminare dati nelle banche dati

- Eseguire interrogazioni

- Visualizzare i risultati in una tabella

### Connettersi a una banca dati

Seleziona Aggiungi connessione dal menu o dalla barra SQL, e quindi seleziona il driver di banca dati di Qt che vuoi usare (tra cui QSQLITE, QMYSQL3, QMYSQL, QODBC3, QODBC, QPSQL7, e QPSQL). Se non trovi il driver desiderato, devi installarlo. Premi quindi Successivo.

Se la banca dati che hai selezionato usa un file, basta indicarne la posizione e premere il pulsante Successivo. Se richiede la connessione a un server, devi inserirne il nome host, i tuoi nome utente e password, e qualsiasi altra informazione che il singolo driver potrebbe richiederti. Premi quindi Successivo.

Infine, dai un nome alla connessione, e premi Successivo.

### Eseguire interrogazioni

#### INSERT/DELETE/UPDATE

Puoi inserire, eliminare e aggiornare i dati con l'estensione SQL esattamente come faresti dalla riga di comando o da un programma. Basta inserire un'interrogazione e premere Esegui interrogazione.

##### 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 che apparirà nella vista degli strumenti Risultato di dati SQL in fondo a &kappname;, o come testo in Risultato di testo SQL. Se c'è un errore, lo puoi vedere dal risultato.

##### Interrogazione `SELECT` d'esempio

    SELECT * FROM nome_tabella

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

Ridimensiona le colonne ai contenuti

  Cambia le dimensioni delle colonne per adattarsi ai loro contenuti.

Ridimensiona le righe ai contenuti

  Cambia le dimensioni delle righe per adattarsi ai loro contenuti.

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

  Toglie tutto dalla vista della tabella.

Puoi ora cambiare i colori visualizzati nella tabella nella sezione SQL di Impostazioni Configura Kate.

### Sfogliare

Puoi sfogliare la banca dati con la vista degli strumenti Browser di schemi SQL sulla sinistra. Le informazioni mostrate variano a seconda di quale driver di banca dati è in uso.

Per aggiornare questo elenco, fai clic con il &RMB; da qualsiasi parte nella vista degli strumenti e seleziona Aggiorna. Per generare un'interrogazione su qualsiasi voce dell'elenco, fai clic con il &RMB;, seleziona Genera, e seleziona il tipo di interrogazione (SELECT, UPDATE, INSERT, e DELETE) dal sottomenu che compare.

### Struttura dei menu

SQL Aggiungi connessione

  Aggiunge una nuova connessione usando qualsiasi driver per banche dati.

SQL Rimuovi connessione

  Rimuove la connessione selezionata.

SQL Modifica connessione

  Modifica le impostazioni della connessione attuale.

Connessioni

  Tutte le connessioni a banche dati che hai creato sono elencate tra gli elementi del menu Modifica connessione e Esegui interrogazione. Selezionane una per eseguire interrogazioni o per modificarla.

&Ctrl;E SQL Esegui interrogazione

  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 molto di questa sezione.

Martin
Gergov
&TC.Hollingsworth; &TC.Hollingsworth.mail;

## Estensione per &gdb;

### Introduzione

L'estensione &gdb; di &kappname; fornisce una semplice interfaccia al popolare debugger del progetto &GNU;.

Si raccomanda caldamente di avere esperienza con &gdb;. Per maggiori informazioni sull'uso di &gdb;, visita il sito Web di &gdb;.

Puoi abilitare l'estensione di &gdb; nella sezione delle estensioni della configurazione di &kappname;.

Affinché l'estensione funzioni correttamente, devi avere un file sorgente (di qualsiasi tipo supportato da &gdb;) e un eseguibile.

Se compili con &gcc; o `g++` potresti voler usare l'argomento da riga di comando ``-ggdb``.

Fatte queste preparazioni, apri il file sorgente in &kappname;, inserisci il percorso all'eseguibile nella scheda Impostazioni della vista dello strumento Vista di debug, e seleziona Debug Avvia il debug dal menu per cominciale.

### Menu e struttura delle barre degli strumenti

Tutte queste opzioni sono disponibili nei menu di &kappname;, e molte sono disponibili anche nella barra di debug.

Visualizza Viste degli strumenti Mostra Vista di debug

  Mostra una vista contenente l'uscita di &gdb;, la riga di comando di &gdb; usata, e altre impostazioni.

Visualizza Viste degli strumenti Mostra Locali

  Mostra un elenco di tutte le variabili attualmente in memoria e i loro valori.

Visualizza Viste degli strumenti Mostra Pila di chiamate

  Mostra un backtrace di &gdb;.

Debug Obbiettivi

  Un sottomenu contenente un elenco di obbiettivi (eseguibili).

Debug Elenchi di argomenti

  Un sottomenu contenente tutti gli elenchi degli argomenti.

Debug Avvia il debug

  Avvia &gdb; con un obbiettivo.

Debug Termina / interrompi il debug

  Interrompe &gdb;.

Debug Riavvia il debug

  Riavvia &gdb;.

Debug Commuta punto di interruzione / interrompi

  Imposta un punto di interruzione alla posizione attuale del cursore.

Debug Entra

  Esegui la dichiarazione attuale (sarà effettuato il debug della chiamata a funzione).

Debug Passa oltre

  Esegui la dichiarazione attuale (non sarà effettuato il debug della chiamata a funzione).

Debug Esci

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

Debug Sposta contatore dei programmi

  Sposta contatore dei programmi (prossima esecuzione).

Debug Esegui fino al cursore

  Esegue il programma fino a raggiungere la posizione attuale del cursore.

Debug Continua

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

Debug Stampa valore

  Stampa il valore della variabile attualmente indicata dal cursore.

Impostazioni Barre mostrate Estensione &gdb;

  Mostra la barra di debug.

### Vista di debug

La vista dello strumento Vista di debug consiste di diverse schede:

Output &gdb;

  Contiene l'uscita da &gdb; e una riga di comando di &gdb;.

  La scheda Uscita
  La scheda Uscita.

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

Impostazioni
  Obbiettivo

    Percorso all'obbiettivo (l'eseguibile) per il debug.

  Cartella di lavoro

    La cartella di lavoro attuale fornita dall'obbiettivo.

  Elenco di 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 e inserire ingressi al programma in esecuzione.

  La scheda Impostazioni
  La scheda Impostazioni.

  La scheda Impostazioni che mostra la configurazione di una sessione di debug.

I/O

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

  La scheda I/O
  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 di &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 e i loro valori corrispondenti.

La vista dello strumento Locali di &gdb;
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 molto di questa sezione.