<othercredit role="translator"><firstname>Marcello</firstname><surname>Anni</surname><affiliation><address><email>marcello.anni@alice.it</email></address></affiliation><contrib>Traduzione italiana della documentazione</contrib></othercredit>
<para>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 <application>Kommander</application> come interfaccia e <application>libxml2</application> e <application>libxslt</application> come interfaccia macchina. La loro combinazione costituisce degli strumenti veloci, efficienti, produttivi e completi. </para>
<para>Chiunque abbia lavorato con la documentazione di &kde; conosce <command>meinproc</command> 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! </para>
<para>Questa applicazione si aspetta che sia presente in una cartella un file <filename>index.docbook</filename>. Se <filename>index.docbook</filename> si trova nella cartella di lavoro corrente, allora lascia selezionato semplicemente <guilabel>Cartella Attuale di Lavoro</guilabel>. Altrimenti deseleziona <guilabel>Cartella Attuale di Lavoro</guilabel> ed inserisci la cartella che desideri processare nel campo <guilabel>Altra Cartella</guilabel>. </para>
<para>I file in output vengono messi nella stessa cartella dei file sorgenti. Tutti i file &HTML; vengono rimossi ogni volta che viene lanciato <command>meinproc</command>. </para>
<para>Ancora, chiunque abbia lavorato con la documentazione di &kde; conosce questa utile applicazione. In più, &quantaplus; ne fornisce una grande piccola interfaccia grafica. </para>
<para>Se il file correntemente aperto è <filename>index.docbook</filename>, allora lascia semplicemente selezionato <guilabel>Cartella Attuale di Lavoro</guilabel>. Se no, deseleziona <guilabel>Cartella Attuale di Lavoro</guilabel> ed inserisci la cartella dove può essere trovato <filename>index.docbook</filename>. </para>
<para>Se il file da verificare è correntemente selezionato in &quantaplus;, allora lascia semplicemente selezionato <guilabel>File corrente</guilabel>. Se no, deseleziona <guilabel>File corrente</guilabel> e seleziona il file da validare dal selettore di file Altro File. </para>
<para>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 <guilabel>Definizione dell'&URI;</guilabel>. </para>
<para>Sì, &quantaplus; ha anche uno strumento di elaborazione &XSL;! Questo utilizza lo strumento <command>xsltproc</command> fornito con <application>libxml2</application>. </para>
<para>Se il file dal elaborare è correntemente aperto e selezionato in &quantaplus;, allora lascia semplicemente selezionato <guilabel>File corrente</guilabel>. Se no, deseleziona <guilabel>File corrente</guilabel> e seleziona il file da elaborare dal selettore <guilabel>Altro File</guilabel>. </para>
<para>Inserisci il nome con cui vuoi chiamare il file del risultato. Il file viene creato in output nella tua cartella home per impostazione predefinita. </para>
<othercredit role="translator"><firstname>Marcello</firstname><surname>Anni</surname><affiliation><address><email>marcello.anni@alice.it</email></address></affiliation><contrib>Traduzione italiana della documentazione</contrib></othercredit>
<para>&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. </para>
<para>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. </para>
<title>Capire la Finestra di Dialogo Modifica i Plugin</title>
<para>Per installare un Plugin o KPart dovremo agire dal menu <menuchoice><guimenu>Plugin</guimenu> <guimenuitem>Modifica</guimenuitem> </menuchoice>. Si aprirà così la seguente finestra di dialogo: </para>
<para>Questa finestra di dialogo permette di gestire tutti i plugin predefiniti e di aggiungerne altri. Descriveremo qui ogni elemento della &GUI;: <variablelist>
<para>Qui puoi impostare un percorso di ricerca. Quando aggiungi un plugin senza una <guilabel>Posizione</guilabel>, &quantaplus; lo cercherà in questi percorsi. </para>
<para>È 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 <menuchoice> <shortcut> <keycombo action="simul">&Shift;<keycap>F7</keycap></keycombo> </shortcut> <guimenu>Progetto</guimenu> <guimenuitem>Proprietà del progetto</guimenuitem> </menuchoice>. </para>
<para>Le voci <guilabel>Nome</guilabel> e <guilabel>Posta elettronica</guilabel> si spiegano da sé. <guilabel>Nickname</guilabel> è il nick dell'utente e funziona come identificatore unico. </para>
<para><guilabel>Ruolo</guilabel> specifica il ruolo del membro nel progetto e può essere uno dei seguenti: <itemizedlist>
<para><guilabel>Attività</guilabel> è una descrizione dell'attività assegnata a questo membro.</para>
<para><guilabel>Sottoprogetto</guilabel>: puoi selezionare una lista di sottoprogetti. I sottoprogetti possono essere configurati e creati premendo il pulsante <guilabel>Modifica sottoprogetti</guilabel>. 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 <filename path="intranet">intranet</filename>.</para>
<para>Un membro può avere più di un ruolo nel progetto, ad esempio come responsabile gruppo e come responsabile sottoprogetto.</para>
<para>L'utente dovrebbe selezionare chi è dalla lista dei membri della squadra. Questo è possibile selezionando un membro dalla lista e premendo il pulsante <guilabel>Imposta manualmente</guilabel>. Il membro attualmente selezionato (la tua identità) appare in neretto dopo il testo <guilabel>Tu sei:</guilabel>.</para>
<para>I nick e le tue impostazioni sono importanti per quanto riguarda i messaggi e le annotazioni. Vedi <xref linkend="annotations"/> per imparare di più riguardo le annotazioni.</para>
<para>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 <xref linkend="event-actions"/> per sapere come fare.</para>
<para>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.</para>
<para>Sulla pagina <guilabel>Configurazione eventi</guilabel> della finestra di dialogo <menuchoice> <shortcut> <keycombo action="simul">&Shift;<keycap>F7</keycap></keycombo> </shortcut> <guimenu>Progetto</guimenu> <guimenuitem>Proprietà del progetto</guimenuitem> </menuchoice> puoi creare, modificare e cancellare le azioni ad eventi. </para>
<listitem><para>l'azione viene eseguita quando si presenta l'evento selezionato dalla lista. I nomi degli eventi si spiegano da soli.</para></listitem>
<term><guilabel>Azione non da script</guilabel></term>
<listitem><para>un azione che non consiste in uno script definito dall'utente. Guarda <xref linkend="user-actions"/> per le azioni dell'utente. </para>
<para><guilabel>Nome dell'azione</guilabel> specifica l'azione da eseguire quando si presenta l'evento.</para>
<term><guilabel>Invia messaggio di posta elettronica</guilabel></term>
<listitem><para>viene spedito un messaggio di posta elettronica quando si presenta l'azione al destinatario selezionato nella lista <guilabel>Destinatario</guilabel>. Il destinatario può essere un gruppo o il responsabile di un sottoprogetto. Guarda <xref linkend="team-members"/> per definire i responsabili. </para>
<para>Scrivere le annotazioni è semplice. Puoi usare sia la voce <guilabel>Annota</guilabel> dal menu di contesto editor o scrivere la parola chiave <emphasis>@annotation</emphasis> in un'area di commento seguita dal testo di annotazione. <example><title>Esempio di annotazione in XML</title><screen><!-- @annotation è possibile che questo codice sia sbagliato. --></screen>
<para>Le annotazioni possono essere inviate a un membro specifico della tua squadra. La sintassi in questo caso è <emphasis>@annotation(nick)</emphasis> o <emphasis>@annotation(ruolo)</emphasis>, dove <emphasis>nickname</emphasis> è il nick di un membro della squadra, mentre <emphasis>role</emphasis> è un ruolo nel progetto da questi elementi: <itemizedlist> <listitem><para> ruolo della squadra </para></listitem> <listitem><para> attività del responsabile </para></listitem> <listitem><para> responsabile del sottoprogetto </para></listitem> </itemizedlist> L'attività e i responsabili del sottoprogetto dovrebbero essere seguiti dalle attività corrispondenti e dal nome del sottoprogetto, come mostrato negli esempi in basso. </para>
<para>I nick e i nomi dei ruoli sono sensibili al maiuscolo, ma gli spazi intorno alle parentesi e il <emphasis>:</emphasis> rendono l'annotazione non valida.</para>
<para>Per sapere di più riguardo ai membri della squadra, i ruoli e i nick possono essere trovati in <xref linkend="team-members"/>.</para>
<para>Le annotazioni che si trovano nel progetto possono essere esaminate nella vista <guilabel>Annotazioni</guilabel>. Consiste in una linguetta: <variablelist> <varlistentry> <term><guilabel>File attuale</guilabel></term> <listitem><para> L'annotazione che si trova nel file attuale.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Per te</guilabel></term> <listitem><para> Le annotazioni nel progetto indirizzate a te. Le voci sono raggruppate per file. </para></listitem> </varlistentry> <varlistentry> <term><guilabel>Tutti i file</guilabel></term> <listitem><para> Le annotazioni che si trovano in tutti i file del progetto, file di gruppo dy </para></listitem> </varlistentry> </variablelist> 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. </para>
