Avancerede funktioner

Christopher Hornbaker

    chrishornbaker@earthlink.net

&erik.kjaer.pedersen.role;

# Avancerede funktioner

Dette kapitel giver en oversigt over de avancerede funktioner i &quantaplus;, og hvordan de bruges.

## &XML;-værktøjer

Udgave 3.2 af &quantaplus; har mange nye XML-værktøjer og funktioner med sig. Værktøjerne er unikke i deres integration med &quantaplus;. Alle værktøjer bruger Kommander som grænseflade, med libxml og lixslt til baggrundsbehandling. Denne kombination giver hurtige, effektive, produktive og komplette værktøjer.

### &kde;-dokumentationsværktøj

&quantaplus; understøtter &kde;'s to hoved-dokumentationsværktøjer: `meinproc` og `checkXML`.

#### `meinproc`

Alle som har arbejdet med dokumentation af &kde; kender til `meinproc`, og hvor fantastisk den er. Nu bliver det yderligere en smule bedre, med en udmærket grafisk grænseflade. Du behøver ikke længere bruge en terminal, klik blot på ikonen som ser ud som en processor, så er du klar!

Nuværende arbejdsmappe

  Dette program forventer at en fil med navnet `index.docbook` findes i en mappe. Hvis `index.docbook` findes i denne arbejdsmappe, så lad Nuværende arbejdsmappe forblive markeret. Hvis den ikke gør det, så afmarkér Nuværende arbejdsmappe og indskriv mappen som du vil behandle i feltet Anden mappe.

Uddatafiler placeres i samme mappe som kildekodefilerne. Alle &HTML;-filer fjernes hver gang `meinproc` køres.

#### `checkXML`

Igen, alle som har arbejdet med dokumentation af &kde; kender til dette hjælpsomme program. &quantaplus; tilbyder også her en udmærket lille grafisk grænseflade.

Nuværende arbejdsmappe

  Hvis den åbne fil er `index.docbook`, så lad Nuværende arbejdsmappe forblive markeret. Hvis den ikke er det, så afmarkér Nuværende arbejdsmappe og indskriv mappen hvor `index.docbook` kan findes.

Uddata

Hvis der bliver nogen udskrift er din fil ugyldig. Ret de rapporterede fejl og forsøg igen.

### &XML;-validering

&quantaplus; har et udmærket &XML;-valideringsværktøj, som bruger baggrundsprogrammet `xmllint`.

Denne fil

  Hvis filen som skal valideres for har fokus øjeblikket &quantaplus;, så lad helt enkelt Nuværende fil være markeret. Hvis den ikke er det, afmarkér Nuværende fil og vælg filen som skal valideres i filvælgeren Anden fil.

Kontrol af velformateret

  Hvis du kun vil vide at en fil er velformateret, så markér afkrydsningsfeltet Kontrollér kun velformateret.

Definition &URI;

  Hvis du bruger en &DTD;, og den specificeres i &XML;-filen, vælg &DTD; (intern), standardvalget, ellers vælg &DTD; (ekstern) og find &DTD;'en med filvælgeren for definitionens internet-adresse. Både til validering af &W3C; &XML; schema og RelaxNG kræves ekstern definition via filvælgeren for Definitionens internet-adresse.

### Behandling af &XSL;

Ja, &quantaplus; har også et &XSL;-behandlingsværktøj! Det bruger værktøjet `xsltproc` som kommer med libxml2.

Denne fil

  Hvis filen som skal behandles for øjeblikket har fokus i &quantaplus;, lad så helt enkelt Nuværende fil være markeret. Hvis den ikke er det, afmarkér Nuværende fil og vælg filen som skal behandles i filvælgeren Anden fil.

Stilskabelon

  Vælg &XSL;-filen som du vil skal bruges.

Uddatafilnavn

  Indtast navnet som du ønsker at resultatfilen skal kaldes. Filen skrives normalt i din hjemmemappe.

Dette program mangler fleksibilitet. Desværre, vi skal forsøge at gøre det bedre næste gang.

Brug af plugin

Mathieu Kooiman

    quanta@map-is.nl

&erik.kjaer.pedersen.role;

## Brug af plugin

### Hvad er et plugin?

&quantaplus; kan indlæse plugin, som er KParter. Mekanismen med KParter, er en meget kraftfuld funktion i &kde;. En KPart er et relativt lille, genbrugbar beholder for en funktion. Den gør det muligt for &kde;-udviklere at bygge videre på andre programmørers arbejde på en enkel måde. Et eksempel på dette er &quantaplus; selv. Editoren som &quantaplus; bruger er &kate;'s KPart. &kate;'s KPart har allerede en mængde funktioner som &quantaplus; behøver, såsom syntaksfremhævning. Ved at integrere den i &quantaplus;, blev det muligt for &quantaplus;' udviklere at fokusere på hvad &quantaplus; skulle kunne gøre, i stedet for at håndtere de mange problemer der ville opstå ved at udvikle en ny editorkomponent fra begyndelsen.

Plugin som &quantaplus; indlæser, har måske ikke noget overhovedet at gøre med &quantaplus; selv. Det gør det til et meget kraftfuldt system. Du kan drage nytte af ekstra funktioner, og behøver ikke vente på at nogen integrerer dem i &quantaplus;. Plugin kan indlæses til et antal forskellige grafiske elementer. Mere om dette nedenfor.

### Forstå dialogen til at redigere plugin

For at installere et plugin eller et delprogram, bruges menuen Plugin Redigér. Det får følgende dialog frem:

Dialogen til at redigere plugin.

Denne dialog lader dig håndtere alle de definerede plugin, og lader dig tilføje nye. Vi beskriver hvert element i grænsefladen her.

Søgestier

  Her kan du udfylde en søgesti. Når du tilføjer en plugin uden en Plads, søger &quantaplus; i denne søgesti for at finde dit plugin.

Tilføj

  Dette viser en dialog som lader dig tilføje et nyt plugin.

Indstil

  Dette lader dig ændre indstillinger for et bestemt plugin.

Fjern

  Fjerner det markerede plugin.

Opdatér

  Opdaterer dialogens indhold.

Læs for at lære mere om plugin.

## Teamudvikling

Ofte arbejder flere personer på et enkelt projekt og der er et eller andet hierakisk forhold mellem disse personer. &quantaplus; understøtter begrebet team-medlemmer og de kan indstilles i dialogen for &Shift;F7 Projekt Projektegenskaber .

Dialogen Team-medlem-editor

Indgangene Navn, E-mail er selvforklarende. Alias er brugerens alias og fungerer som en entydig identifikator.

Rolle angiver medlemmets rolle i projektet og kan være en af følgende:

- Team-leder

- Delprojekt-leder

- Opgave-leder

- Almindeligt medlem

Opgave er en beskrivelse af en opgave tildelt dette medlem.

Del-projekt: du kan vælge en liste af del-projekter. Del-projekter kan indstilles og oprettes ved at trykke på knappen Redigér del-projekter. Hvert del-projekt har et synligt brugernavn og placering. Placeringen er en relativ sti til mappen under projekt-træet. Det betyder at del-projektet er en mappe under hovedprojektet. F.eks. kan hovedprojektet være dit firmas websted, hvor et del-projekt kan være webstedet for firmaets intranet, placeret i mappen `intranet` i hovedprojektets mappe.

Et medlem kan have mere end en rolle i projektet, som f.eks. både team-leder og del-projektleder.

En bruger bør vælge hvem i listen med gruppemedlemmer han selv er. Dette er muligt ved at markere et gruppemedlem i listen og trykke på knappen Angiv som dig selv. Medlemmet som for øjeblikket er markeret (din identitet) vises med fede typer efter teksten Du er:.

Aliasser og at indstille dig selv er vigtigt angående meddelelser og noteringer. Se for at lære dig mere om noteringer.

Udover at holde styr på dit team, er der flere fordele ved at indstille team-medlemmer: du kan sætte en begivenhed til at informere team-ledere om hvornår noget skal ske. Se i hvordan man gør.

## Begivenhedshandlinger

Begivenhedshandlinger er handlinger der udføres når der sker en eller anden begivenhed i projektet. Et eksempel kunne være at gemme oplysninger om hvornår projektet blev åbnet og lukket, så der senere kan foretages en granskning af hvor meget hvert medlem arbejdede på det, eller afsendelse af en e-mail når en fil bliver gemt eller tilføjet til CVS vha. et script når filen tilføjes projektet og denne liste kan fortsættes.

På siden Begivenheds-indstillinger i &Shift;F7 Projekt Projektegenskaber -dialogen, kan du oprette, redigere og slette begivenhedshandlinger.

Begivenhedseditor-dialogen

Indgangene i dialogen er:

Begivenhed

  handlingen udføres når begivenheden fra listen sker. Navnene er selvforklarende.

Handling

  den udførte handlings-type. Mulighederne er:

  Non-script-handling

    en handling der ikke er en brugerdefineret scripthandling. Se for brugerhandling.

    Handlingsnavn specificerer handlingen der skal udføres nå begivenheden sker.

  Send e-mail

    en e-mail bliver sendt til modtageren valgt i Modtager-listen, når handlingen sker. Modtageren kan være et team eller en del-projektleder. Se for definering af sådanne ledere.

  Log begivenhed

    begivenheden gemmes i en fil. Argumenterne til denne handling er:

    Logfil

      filnavnet med den fulde sti

    Detaljer

      Hvor meget information loggen skal indeholde

    Opførsel

      Om der i eksisterende filer skal oprettes/overskrives eller tilføjes en nye log-begivenhed.

  Script-handling

    en brugerdefineret script-handling. Se for brugerhandling.

    Handlingsnavn specificerer handlingen der skal udføres nå begivenheden sker.

De andre indgange afhænger af Handlingstypen som beskrevet før.

## Noteringer

Noteringer er specielle kommentarer i dokumenterne. De adskiller sig fra almindelige kommentarer i følgende henseender:

- informationen samles ind af Quanta og vises i værktøjsvisningen Noteringer.

- informationen kan adresseres til et gruppemedlem

At indtaste noteringer er simpelt. Du kan enten bruge tilvalget Notering i editorens sammenhængsafhængige menu, eller skrive nøgleordet @annotation i et kommentarområde fulgt af noteringens tekst.

Noteringseksempel i XML

    <!-- @annotation Det er muligt at denne koden er forkert. -->

    <!-- @annotation
     Flerlinje
     notering.
    -->

Noteringseksempel i PHP

    /* @annotation
    Brug PHP-kommentarer ved noteringer i et PHP-område
    */

Noteringer kan adresseres til et særligt medlem i gruppen. Syntaksen i dette tilfælde er @annotation(alias) eller @annotation(rolle), hvor alias er gruppemedlemmets alias, mens rolle er en projektrolle fra følgende liste:

- gruppeleder

- opgaveleder

- delprojektleder

Opgave- og delprojektledere skal følges af tilsvarende opgave- eller delprojektnavn, som vist i eksemplet nedenfor.

Lav en note til et gruppemedlem med alias erik

    <-- @annotation(eric) Erik, kig lige på dette. Andreas -->

Informér gruppelederen

    <-- @annotation(gruppeleder) Dette er meget vigtigt for gruppen -->

Informér PHP-delprojektlederen

    // @annotation(delprojektleder:PHP) Hvad mener du om det?

Aliasser og rollenavne er ikke versalfølsomme, men mellemrum omkring parenteser og : gør noteringen ugyldig.

Mere om gruppemedlemmer, roller og aliasser findes under .

Noteringerne som findes i projektet kan inspekteres i visningen Noteringer. Den består af tre fanebalde:

Nuværende fil

  Noteringerne som findes i den nuværende fil.

Til dig

  Noteringer i projektet adresserede til dig. Indgangene grupperes pr fil.

Alle filer

  Noteringerne som findes i alle projektfiler, grupperede ifølge fil.

Noteringerne gennemsøges efter eksterne ændringer ved indlæsning af projekt og filer. På den måde genkendes til og med en notering som nogen lægger til udenfor &quantaplus; . Eftersom søgningen kan tage en vis tid, kan informationsdialogen om nye noteringer adresserede til dig dukke op nogle sekunder efter at projektet er indlæst.
&debugging-quanta;