Christopher Hornbaker

chrishornbaker@earthlink.net

MarcelloAnni

marcello.anni@alice.it

Traduzione italiana della documentazione Questo capitolo mette in evidenza le funzioni avanzate di &quantaplus; e come usarle. 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. &quantaplus; supporta i due strumenti della documentazione di &kde;: meinproc e checkXML. 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. 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. Se c'è output, allora il tuo file non è valido. Per favore correggi gli errori segnalati e prova di nuovo. &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;. 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. Mathieu Kooiman

quanta@map-is.nl

MarcelloAnni

marcello.anni@alice.it

Traduzione italiana della documentazione &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. 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. È 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. 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. 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. <!-- @annotation è possibile che questo codice sia sbagliato. --> <!-- @annotation annotazione in più righe. --> /* @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. <-- @annotation(pippo) Pippo, per favore guarda questo. Andrea --> <-- @annotation(responsabile della squadra) Questo è molto importante per la squadra --> // @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;