&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, gli strumenti di dati, e l'esportazione di testo come &HTML;.

## Estensioni del componente editor

La scheda Estensioni della pagina omonima elenca tutte le estensioni disponibili, e puoi spuntare quelle che vuoi usare. Fai clic sul pulsante Informazioni per aprire la finestra Informazioni su... dell'estensione.

Una volta che un'estensione configurabile è spuntata, si attiva il pulsante Configura, e ci puoi fare clic per configurare l'estensione selezionata.

Graffe automatiche

  L'estensione per graffe automatiche sostituisce la funzionalità interna di &kate; per le parentesi automatiche. Inserisce automaticamente una graffa chiusa, }, in fondo alla riga successiva dopo aver concluso una riga con una aperta, {, e aver premuto il tasto &Enter;.

Strumenti per dati

  Abilita gli strumenti di dati come il dizionario dei sinonimi e il controllo ortografico (se installato). Gli strumenti di dati sono disponibili solo quando c'è del testo selezionato, o quando il &RMB; viene premuto su una parola. Se non sono presenti strumenti di dati, anche quando c'è del testo selezionato, devi installarli. Alcuni strumenti di dati fanno parte del pacchetto &koffice;. Se questa estensione è abilitata e gli strumenti di dati sono installati, appariranno degli altri elementi in fondo al menu contestuale.

Esportazione

  Questo comando permette di esportare il documento attuale con tutte le informazioni di evidenziazione in un documento HTML con File Esporta come HTML. Inoltre, puoi usare Modifica Copia come HTML per copiare il testo attualmente selezionato come HTML negli appunti di sistema.

Inserimento di icone

  L'estensione di inserimento delle icone è utile solo agli sviluppatori di &kde;: aggiunge un elemento Inserisci codice per KIcon nel menu contestuale dell'editor. Se attivo, si apre il menu di selezione delle icone di &kde; (mostrando le icone per le applicazioni, le azioni e così via). Se fai clic su una di esse, il suo nome del file senza estensione verrà inserito come testo. È utile solo per impostare le icone con l'infrastruttura di &kde; con la classe KIcon.

Redazione di HTML folle (non Zen, edizione leggera)

  Un'estensione che fa codice Zen come il completamento a selettori. Per maggiori informazioni vedi cos'è il codice Zen.

Inserisci file

  Questa estensione permette di inserire qualsiasi file leggibile alla posizione del cursore. Se abilitata, il menu Strumenti avrà l'ulteriore elemento Inserisci file.

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

- Strumento di ricerca nei file: vista che permette di cercare in tutti i file aperti o nel filesystem;

- GDB: una semplice interfaccia a GDB;

- Browser di backtrace: vista degli strumenti di navigazione di backtrace;

- Cambio rapido dei documenti: passa rapidamente a un altro documento già aperto;

- Estensione SQL: interroga banche dati SQL;

- Estensione di ricerca: trova un modello nei file;

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

- Filtro di testo: filtraggio facile del testo;

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

- Browser del filesystem: strumento di visualizzazione del filesystem;

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

- Estensione CTags: cerca definizioni e dichiarazioni con CTags;

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

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

- Strumenti esterni

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

- Invia file: invia file per posta elettronica;

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

- Frammenti di Kate: estensione per frammenti con supporto per il completamento del codice;

- Estensione di pronuncia Jovie: aggiunge una voce del menu per pronunciare il testo;

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

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

- Schedatura: aggiunge una barra delle linguette alla finestra principale di &kate;.

&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 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;

## Cambio rapido dei documenti

### Struttura dei menu

&Ctrl;1 Vai Cambio rapido

  Apre la finestra Cambio rapido dei documenti con un campo di ricerca e un elenco di file aperti. 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. Se si lascia la finestra premendo OK, l'estensione fa passare la vista al documento selezionato nella vista a elenco. Ciò facilita il passaggio tra i documenti, se ce ne sono molti aperti.

## Esportazione

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

## Trova nei file

### Struttura dei menu

Modifica Trova nei file

  Avvia la finestra Trova nei file per cercare del testo nei file di una cartella.

Visualizza Viste degli strumenti Mostra Trova nei file

  Attiva o disattiva la visualizzazione dello strumento Trova nei file di &kate;.

T.C.
Hollingsworth

    tchollingsworth@gmail.com

## Ricerca nei file

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

L'estensione di ricerca dei file non è abilitata inizialmente, essendo stata appena introdotta in &kappname; 3.7. Abilitala nel pannello Estensioni delle impostazioni di &kappname;. Sostituirà la vecchia estensione di ricerca nei file nella prossima versione di &kappname;.

### 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 dei nomi di file che corrispondono a un certo schema. Per esempio, per cercare solo i file scritti in C++, impostalo a `*.cpp`. Per cercare solo i file che cominciano per `kate`, impostalo a `kate*`.

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.

## Strumenti esterni

Nel menu Strumenti troverai un sottomenu chiamato Strumenti esterni, se li hai abilitati nelle impostazioni di &kate;. Questi strumenti richiamano applicazioni esterne con dati relativi al documento attuale, ad esempio l'&URL;, la cartella, il testo o la selezione.

Gli strumenti esterni sono definibili dall'utente: puoi aggiungerli, modificarli o rimuoverli con il pannello di configurazione degli strumenti esterni.

### Struttura dei menu

Strumenti Strumenti esterni

  Questo sottomenu contiene tutti gli strumenti esterni configurati.

### Configurazione

Gli strumenti esterni vengono configurati nella pagina Strumenti esterni della configurazione di &kate;. Questi strumenti richiamano applicazioni esterne con dei dati relativi al documento attuale, per esempio i suoi &URL;, cartella, testo o selezione. Questa pagina permette di gestire il menu e modificare, rimuovere o aggiungere strumenti.

Ogni strumento esterno è un comando di shell contenente delle macro che rappresentano i dati del documento. All'attivazione, le macro vengono sostituite dai dati del documento attivo.

#### Comandi disponibili

Nuovo

  Aggiungi un nuovo strumento esterno all'elenco. Questo avvierà il foglio delle proprietà sotto descritto, in cui puoi configurare uno strumento esterno.

Modifica

  Modifica lo strumento attualmente selezionato, con il foglio delle proprietà sotto descritto.

Inserisci separatore

  Aggiunge una linea di separazione che compare nel menu sotto l'elemento attualmente selezionato.

Freccia in su

  Sposta l'elemento attualmente selezionato sopra il precedente.

Freccia in giù

  Sposta l'elemento attualmente selezionato sotto il successivo.

#### Proprietà degli strumenti esterni

Etichetta

  Un'etichetta amichevole che apparirà nel menu Strumenti esterni.

Icona

  Permette di selezionare un'icona che apparirà di fianco all'etichetta nel menu Strumenti esterni.

Script

  Lo script da eseguire quando viene attivato lo strumento. Prima di passare lo script alla shell, vengono sostituite le seguenti macro:

  `%URL`

    L'&URL; completo del documento attuale, o una stringa vuota se il documento non è stato salvato.

  `%URLs`

    Una lista separata da spazi degli &URL; di tutti i documenti aperti (tranne quelli non salvati).

  `%directory`

    La parte della cartella dell'&URL; del documento attuale, o una stringa vuota se il documento attuale non è stato salvato.

  `%filename`

    Il nome del file del documento attuale senza il percorso, o una stringa vuota se il documento attuale non è stato salvato.

  `%line`

    Il numero della riga a cui si trova il cursore di inserimento nel documento attuale.

  `%column`

    Il numero della colonna a cui si trova il cursore di inserimento nel documento attuale.

  `%selection`

    Il testo selezionato nel documento attuale, o una stringa vuota se non c'è testo selezionato.

  `%text`

    Il testo completo del documento attuale. Fai attenzione, perché potrebbe eccedere la lunghezza massima dei comandi permessa sul tuo sistema. Va usato con prudenza.

Eseguibile

  L'eseguibile principale nello script. Questo è obbligatorio, ed è usato per verificare se il comando può essere eseguito. È ammesso un percorso completamente qualificato nel caso in cui l'eseguibile non sia nella variabile d'ambiente `PATH`.

Tipi di file

  Un elenco separato da punti e virgola dei tipi MIME per cui questo comando dovrebbe essere abilitato.

Salva

  Puoi scegliere di far salvare il documento attuale o tutti i documenti prima di eseguire lo script. Questo è utile se lo script legge il file dal disco.

Nome della riga di comando

  Se compili questo campo, lo strumento sarà disponibile dalla riga di comando dell'editor come `exttool-Nome della riga di comando` (cioè la stringa che hai immesso qui, preceduta da `exttool-`).