# Funzionalità Avanzate

Christopher
Hornbaker

    chrishornbaker@earthlink.net

Marcello
Anni

    marcello.anni@alice.it

Traduzione italiana della documentazione

# Funzionalità Avanzate

Questo capitolo mette in evidenza le funzioni avanzate di &quantaplus; e come usarle.

## Strumenti &XML;

Il rilascio 3.2 di &quantaplus; è accompagnato da molti strumenti e funzionalità &XML;. Gli strumenti sono unici nella loro integrazione con &quantaplus;. Tutti questi strumenti utilizzano Kommander come interfaccia e libxml2 e libxslt come interfaccia macchina. La loro combinazione costituisce degli strumenti veloci, efficienti, produttivi e completi.

### Strumenti di documentazione di &kde;

&quantaplus; supporta i due strumenti della documentazione di &kde;: `meinproc` e `checkXML`.

#### `meinproc`

Chiunque abbia lavorato con la documentazione di &kde; conosce `meinproc` e quanto sia avanzato. Bene, fate un salto di qualità con una grande interfaccia grafica! Non dovrete più passare ad una shell; basterà fare clic sull'icona che assomiglia ad un processore e sarete a cavallo!

Cartella attuale di lavoro

  Questa applicazione si aspetta che sia presente in una cartella un file `index.docbook`. Se `index.docbook` si trova nella cartella di lavoro corrente, allora lascia selezionato semplicemente Cartella Attuale di Lavoro. Altrimenti deseleziona Cartella Attuale di Lavoro ed inserisci la cartella che desideri processare nel campo Altra Cartella.

I file in output vengono messi nella stessa cartella dei file sorgenti. Tutti i file &HTML; vengono rimossi ogni volta che viene lanciato `meinproc`.

#### `checkXML`

Ancora, chiunque abbia lavorato con la documentazione di &kde; conosce questa utile applicazione. In più, &quantaplus; ne fornisce una grande piccola interfaccia grafica.

Cartella attuale di lavoro

  Se il file correntemente aperto è `index.docbook`, allora lascia semplicemente selezionato Cartella Attuale di Lavoro. Se no, deseleziona Cartella Attuale di Lavoro ed inserisci la cartella dove può essere trovato `index.docbook`.

##### Output

Se c'è output, allora il tuo file non è valido. Per favore correggi gli errori segnalati e prova di nuovo.

### Validazione &XML;

&quantaplus; ha un grandioso strumento di validazione &XML;, che usa come back-end `xmllint`.

File corrente

  Se il file da verificare è correntemente selezionato in &quantaplus;, allora lascia semplicemente selezionato File corrente. Se no, deseleziona File corrente e seleziona il file da validare dal selettore di file Altro File.

Controllo della buona definizione

  Se desideri solo conoscere se il file è ben definito, fai clic sulla casella Controllo della Buona Definizione.

Definizione dell'&URI;

  Se stai usando una &DTD; che è specificata all'interno del file &XML; allora seleziona &DTD; (Interna) (impostazione predefinita), altrimenti seleziona &DTD; (Esterna) e localizza la &DTD; con il selettore file Definizione dell'&URI;. Entrambe le validazioni &W3C; &XML; Schema e RelaxNG devono essere definite esternamente attraverso il selettore file Definizione dell'&URI;.

### Elaborazione &XSL;

Sì, &quantaplus; ha anche uno strumento di elaborazione &XSL;! Questo utilizza lo strumento `xsltproc` fornito con libxml2.

File corrente

  Se il file dal elaborare è correntemente aperto e selezionato in &quantaplus;, allora lascia semplicemente selezionato File corrente. Se no, deseleziona File corrente e seleziona il file da elaborare dal selettore Altro File.

Foglio di stile

  Seleziona il file &XSL; che desideri utilizzare.

Nome del file di output

  Inserisci il nome con cui vuoi chiamare il file del risultato. Il file viene creato in output nella tua cartella home per impostazione predefinita.

Questa applicazione manca di flessibilità. Ci dispiace, faremo meglio la prossima volta.

## Usare i Plugin

Mathieu
Kooiman

    quanta@map-is.nl

Marcello
Anni

    marcello.anni@alice.it

Traduzione italiana della documentazione

## Usare i Plugin

### Cos'è un plugin?

&quantaplus; è in grado di caricare plugin sotto forma di KPart. KPart è una delle infrastrutture molto potenti di &kde;. Un KPart è un contenitore di funzionalità relativamente piccolo e riutilizzabile. Permette agli sviluppatori di &kde; di costruire facilmente sul lavoro di altri programmatori. Un esempio è quello di &quantaplus; stesso. L'editor che utilizza &quantaplus; è il KPart &kate;. Il KPart &kate; aveva già un insieme di funzionalità di cui &quantaplus; aveva bisogno, come l'evidenziazione della sintassi. Integrarlo in &quantaplus; ha permesso ai suoi sviluppatori di concentrarsi su quello che &quantaplus; doveva essere in grado di fare, piuttosto che affrontare i tanti problemi che lo sviluppare da zero un nuovo editor componente/KPart avrebbe portato.

I plugin che &quantaplus; carica potrebbero non avere nulla a che fare con &quantaplus; stesso. Ciò lo rende un sistema a plugin molto potente. Puoi beneficiare dalle funzionalità aggiuntive e non hai bisogno di aspettare che qualcuno le integri in &quantaplus;! I plugin possono essere caricati in diversi elementi della &GUI;. Di più al riguardo qui sotto.

### Capire la Finestra di Dialogo Modifica i Plugin

Per installare un Plugin o KPart dovremo agire dal menu Plugin Modifica . Si aprirà così la seguente finestra di dialogo:

La Finestra di dialogo Modifica Plugin.

Questa finestra di dialogo permette di gestire tutti i plugin predefiniti e di aggiungerne altri. Descriveremo qui ogni elemento della &GUI;:

Percorso di ricerca

  Qui puoi impostare un percorso di ricerca. Quando aggiungi un plugin senza una Posizione, &quantaplus; lo cercherà in questi percorsi.

Aggiungi

  Questo aprirà una finestra di dialogo che permette di aggiungere un nuovo plugin.

Configura

  Questo permette di cambiare le impostazioni di un particolare plugin.

Rimuovi

  Rimuove il plugin correntemente selezionato.

Aggiorna

  Aggiorna il contenuto della finestra di dialogo.

Leggi per imparare di più riguardo ai plugin.

## Sviluppo di squadra

È necessario, spesso, che più persone lavorino su di un progetto ed esiste una specie di relazione gerarchica tra loro. &quantaplus; supporta la nozione di membri di un gruppo ed è possibile configurarli nella finestra di dialogo &Shift;F7 Progetto Proprietà del progetto .

La finestra di dialogo configurazione gruppo

Le voci Nome e Posta elettronica si spiegano da sé. Nickname è il nick dell'utente e funziona come identificatore unico.

Ruolo specifica il ruolo del membro nel progetto e può essere uno dei seguenti:

- Responsabile gruppo

- Responsabile sottoprogetto

- Responsabile attività

- Membro semplice

Attività è una descrizione dell'attività assegnata a questo membro.

Sottoprogetto: puoi selezionare una lista di sottoprogetti. I sottoprogetti possono essere configurati e creati premendo il pulsante Modifica sottoprogetti. Ogni sottoprogetto ha un nome visibile all'utente ed una posizione che specifica un percorso relativo verso una cartella all'interno della cartella del progetto. Ciò significa che un sottoprogetto è una cartella all'interno del progetto principale. Ad esempio il progetto principale può essere il sito web della tua compagnia, mentre un sottoprogetto può essere il sito web di intranet, posizionato nel progetto all'interno della cartella `intranet`.

Un membro può avere più di un ruolo nel progetto, ad esempio come responsabile gruppo e come responsabile sottoprogetto.

L'utente dovrebbe selezionare chi è dalla lista dei membri della squadra. Questo è possibile selezionando un membro dalla lista e premendo il pulsante Imposta manualmente. Il membro attualmente selezionato (la tua identità) appare in neretto dopo il testo Tu sei:.

I nick e le tue impostazioni sono importanti per quanto riguarda i messaggi e le annotazioni. Vedi per imparare di più riguardo le annotazioni.

Al di là di tenere traccia della tuo gruppo, c'è un ulteriore vantaggio nell'impostare i membri del gruppo: puoi configurare un evento per informare i responsabili della squadra che è avvenuta qualche azione. Guarda per sapere come fare.

## Azioni ad eventi

La azioni ad eventi sono delle azioni eseguite quando accade qualche evento nel progetto. Un esempio potrebbe essere registrare quando il progetto viene aperto o chiuso, così che si possa, in un secondo tempo, controllare quanto uno vi abbia lavorato, o inviare una mail quando un file viene salvato, o aggiungere il file al CVS con l'aiuto di uno script quando il file viene aggiunto al progetto, e l'elenco potrebbe continuare.

Sulla pagina Configurazione eventi della finestra di dialogo &Shift;F7 Progetto Proprietà del progetto puoi creare, modificare e cancellare le azioni ad eventi.

La finestra di dialogo Modifica evento

Le voci nella finestra sono:

Evento

  l'azione viene eseguita quando si presenta l'evento selezionato dalla lista. I nomi degli eventi si spiegano da soli.

Azione

  il tipo di azione eseguita. Le possibili scelte sono

  Azione non da script

    un azione che non consiste in uno script definito dall'utente. Guarda per le azioni dell'utente.

    Nome dell'azione specifica l'azione da eseguire quando si presenta l'evento.

  Invia messaggio di posta elettronica

    viene spedito un messaggio di posta elettronica quando si presenta l'azione al destinatario selezionato nella lista Destinatario. Il destinatario può essere un gruppo o il responsabile di un sottoprogetto. Guarda per definire i responsabili.

  Registra evento

    l'evento viene registrato in un file. Gli argomenti per questa azione sono:

    File di log

      il nome del file con il percorso completo

    Dettaglio

      Quanta informazione deve contenere il log

    Comportamento

      Se creare/sovrascrivere il file di log esistente o aggiungere in coda il nuovo evento da registrare.

  Azione da script

    un'azione da script definita dall'utente. Guarda per le azioni utente.

    Nome dell'azione specifica l'azione da eseguire quando si presenta l'evento.

Le altre voci dipendono dal tipo di Azione, come è stato descritto.

## Annotazioni

Le annotazioni sono commenti speciali nei documenti. Si differenziano dai commenti regolari per quanto segue:

- L'informazione è collezionata da Quanta e mostrata nella vista strumenti Annotazioni.

- L'informazione può essere indirizzata a un membro della squadra

Scrivere le annotazioni è semplice. Puoi usare sia la voce Annota dal menu di contesto editor o scrivere la parola chiave @annotation in un'area di commento seguita dal testo di annotazione.

### Esempio di annotazione in XML

    <!-- @annotation è possibile che questo codice  sia sbagliato. -->

    <!-- @annotation
     annotazione
     in più righe.
    -->

### Esempio di annotazione in PHP

    /* @annotation
    Usa i commenti PHP quando annoti un'area PHP
    */

Le annotazioni possono essere inviate a un membro specifico della tua squadra. La sintassi in questo caso è @annotation(nick) o @annotation(ruolo), dove nickname è il nick di un membro della squadra, mentre role è un ruolo nel progetto da questi elementi:

- ruolo della squadra

- attività del responsabile

- responsabile del sottoprogetto

L'attività e i responsabili del sottoprogetto dovrebbero essere seguiti dalle attività corrispondenti e dal nome del sottoprogetto, come mostrato negli esempi in basso.

### Crea una nota a un membro della squadra con il nick pippo

    <-- @annotation(pippo) Pippo, per favore guarda questo. Andrea -->

### Informa il responsabile del gruppo

    <-- @annotation(responsabile della squadra) Questo è molto importante per la squadra -->

### Informa il responsabile del sottoprogetto PHP

    // @annotation(responsabile sottoprogetto:PHP) Cosa ne pensi?

I nick e i nomi dei ruoli sono sensibili al maiuscolo, ma gli spazi intorno alle parentesi e il : rendono l'annotazione non valida.

Per sapere di più riguardo ai membri della squadra, i ruoli e i nick possono essere trovati in .

Le annotazioni che si trovano nel progetto possono essere esaminate nella vista Annotazioni. Consiste in una linguetta:

File attuale

  L'annotazione che si trova nel file attuale.

Per te

  Le annotazioni nel progetto indirizzate a te. Le voci sono raggruppate per file.

Tutti i file

  Le annotazioni che si trovano in tutti i file del progetto, file di gruppo dy

Le annotazioni sono scansionate su un progetto e caricate nel file per modifiche esterne. In questo modo anche se qualcuno aggiunge una annotazione dall'esterno di &quantaplus;, sarà riconosciuta. Mentre la scansione può impiegare un po' di tempo, la finestra di dialogo delle informazioni circa le nuove annotazioni indirizzate a te potrebbe apparire dopo qualche secondo dal caricamento del progetto.
&debugging-quanta;