Udvidelse af &quantaplus;

Christopher Hornbaker

    chrishornbaker@earthlink.net

András Mantia

    amantia@kde.org

&rune.laursen.role;

# Udvidelse af &quantaplus;

Dette kapitel beskriver hvordan &quantaplus; kan tilpasses netop dine behov, og hvordan du kan hjælpe til med at gøre &quantaplus; bedre.

## Dokumenttype-redigeringspakke (&DTEP;)

Dokumenttype-redigeringspakken (&DTEP;) bruges i &quantaplus; til at tilføje understøttelse for mærker, scriptsprog og stilskabeloner. De tillader &quantaplus; at levere funktioner såsom automatisk komplettering og knudetræ. Deres enkelhed og fleksibilitet er det der gør &quantaplus; til et hurtig, udviklervenlig integreret udviklingsmiljø for internet-udviklere. De gør &quantaplus; til et letanvendeligt, produktivt miljø.

Der findes to varianter af &DTEP;, familie 1, som er opmarkeringer, og familie 2 som er scriptsprog og stilskabeloner. En &DTEP; består af to dele, mærkemappen og værktøjslinjerne. Mærkemapper består af to filtyper, filerne &descriptionrc; og XML-mærker, som har endelsen .tag. Værktøjslinjer er bekvemme, ikonorienterede linjer med knapper (ovenfor redigeringsvinduet), som tilføjer til tekst til et dokument hurtigere end brugeren kan skrive.

En &DTEP; kan laves manuelt (se nedenfor), downloades eller laves automatisk ud fra en eksisterende DTD. Se for information om konvertering.

Dette dokument beskriver hvordan XML-mærkefiler, filen &descriptionrc; og værktøjslinjer laves. I korthed, en &DTEP;.

XML-mærkefiler (.tag) definerer både egenskaber specifikke for et mærke, samt layout og indhold i egenskabsdialogen som &quantaplus; viser for mærket. Filen &descriptionrc; sørger for regler og information om en hel &DTEP;. Værktøjslinjer sørger for en hurtig måde at tilføje mærker til et dokument, uden at behøve bekymre sig om fejlstavninger eller lignende.

### Indpakning

Mærkemapper er netop det, mapper. De består kun af filerne &descriptionrc; og XML-mærkefiler. Mærkemapperne bærer mærkesprogets navn og version, hvis der findes en (for eksempel html-4.01-strict).

### TagXML

Tabellen nedenfor har en liste af elementer som defineres i XML-mærkefiler, og angiver om de kræves eller ej. Selv om ikke alle kræves, anbefales du at anvende så mange som du kan, så andre brugere får en bedre oplevelse og mere information at arbejde med.

Element | Normal brug | Speciel brug
--- | --- | ---
TAGS | kræves | altid
tag | kræves | altid
label | valgfri | kræves for at oprette en egenskabsdialog
attr | valgfri | kræves for at definere en egenskab
tooltip | valgfri | kræves for at lade egenskabsdialogen vis et værktøjstips
whatsthis | valgfri | kræves for at få egenskabsdialogen til at vise Hvad er dette
list | valgfri | kræves når en egenskab har typen list
item | valgfri | kræves når <list> bruges
textlocation | valgfri | altid
location | valgfri | kræves når label bruges
text | valgfri | kræves når label bruges
children | valgfri | liste over mærker som kan findes indeni mærket som defineres
child | kræves | en af indgangene i children
stoppingtags | valgfri | liste over mærker som fortæller et andet mærke at det har nået slutningen
stoppingtag | kræves | en af indgangene i stoppingtags

#### Elementbeskrivelser for XML-mærker

Følgende afsnit beskriver hvert element i detalje. Alt fra hvor de kan findes, til hvad som findes i dem præsenteres på en måde som er enkel at følge.

##### TAGS

Dette er XML-mærkedokumentets rodelement. Det må kun findes en gang i et dokument. Det kan indeholde definitionen af flere mærker. Dette er et typeelement med kun element.

Overliggende | Underliggende
--- | ---
INGEN | tag

##### tag

Omgivelse for mærket som defineres. Dette er et typeelement kun med element.

Overliggende | Underliggende
--- | ---
TAGS | label, attr, stoppingtags

Egenskab | Type | Værdier | Standard | Brug | Beskrivelse
--- | --- | --- | --- | --- | ---
navn | streng |  |  | kræves | Angiver navnet på mærken som bliver defineret.
single | boolean |  |  | valgfri | Angiver om mærket kræver et afsluttende mærke </(mærkenavn)>.
type | streng |  | xmltag | valgfri | Angiver typen af mærket som defineres.
|  | xmltag |  |  | Typen for mærket er XML-baseret (kun familie 1).
|  | entitet |  |  | Mærket beskriver en entitet (kun familie 1).
|  | egenskab |  |  | Typen for mærket er &CSS; (kun familie 2).
|  | funktion |  |  | Typen for mærket er en scriptfunktion. Når dette bruges bliver <attr> funktionens argument (kun familie 2).
|  | klasse |  |  | Typen for mærket er en scriptklasse (kun familie 2).
|  | method |  |  | Typen for mærket er en klassemetode (kun familie 2).
returnType | streng |  | void | valgfri | Angiver returtypen for mærket som defineres (kun familie 2).
|  | void |  |  | Mærketypen returnerer ingenting.
|  | int |  |  | Mærketypen returnerar et heltal.
|  | float |  |  | Mærketypen returnerer et decimaltal.
|  | long |  |  | Mærketypen returnerer et langt heltal.
|  | streng |  |  | Mærketypen returnerer en streng.
version | streng |  |  | valgfri | Angiver sprogets version som mærket er gyldig for
extends | streng |  |  | valgfri | Kun gyldig hvis typen for mærket er "klasse". Navnet på basisklassen for denne klasse (kun familie 2).
klasse | streng |  |  | valgfri | Kun gyldig hvis typen er "method". Angiver navnet på klassen som denne metoden tilhører (kun familie 2).
common | boolean |  |  | valgfri | Hvis "yes", angiver mærket en fælles egenskabsgruppe, og egenskaberne inde i mærket kan kobles til et hvilket som helst andet mærke (kun familie 1).
comment | streng |  |  | valgfri | kommentarstrengen vises ved siden af mærke taggnavnet i kompletteringsfeltet

##### label

Placér en rubrik i dialogen. Teksten angives af mærket <text>. Dette er et typeelement kun med element.

Overliggende | Underliggende
--- | ---
tag | text, location

##### attr

Definerer en egenskab for mærket. Elementet forekommer en gang for hver egenskab. Det definerer egenskabens navn og type. Det indeholder også yderligere mærker som angiver hvordan egenskaben skal vises, osv. Dette er et typeelement med kun element.

Overliggende | Underliggende
--- | ---
tag | location, list, tooltip, whatsthis, textlocation

Egenskab | Type | Værdier | Standard | Brug | Beskrivelse
--- | --- | --- | --- | --- | ---
navn | streng |  |  | kræves | Angiver navnet på egenskaben som er ved at blive defineres.
type | streng |  | input | kræves | Angiver typen for egenskaben som er ved at blive defineres.
|  | input |  |  | Feltet understøtter frie tekstindgange (tekstfelt).
|  | check |  |  | Feltets værdi er boolesk (afkrydsningsfelt).
|  | farve |  |  | Feltets værdi er en farve.
|  | url |  |  | Feltets værdi er en &URL; (Lokal fil at henvise til).
|  | list |  |  | Feltets værdi kommer fra en given liste.
status | streng |  | valgfri | kræves | Angiver om argumentet kræves eller ej (Kun familie 2).
|  | valgfri |  |  | Argumentet kræves ikke.
|  | kræves |  |  | Argumentet kræves.
|  | underforstået |  |  | Argumentet er underforstået.
source | streng |  |  | valgfri | Angiver kilden som bruges til at udfylde egenskabens indgang i mærkeeditorens dialog og i egenskabstræet
|  | selection |  |  | Den markerede tekst bruges som kilde
|  | dcop |  |  | Resultatet af DCOP-metoden bruges som kilde
interface | streng |  |  | valgfri | Kræver source="dcop". DCOP-grænsefladen inde i &quantaplus; bruges til at hente kildedata.
method | streng |  |  | valgfri | Kræver source="dcop" og et grænsefladenavn. DCOP-metodenavnet inde i &quantaplus; bruges til at hente kildedata.
arguments | streng |  |  | valgfri | Kræver source="dcop", et grænsefladenavn og et metodenavn. Argumenterne sendes til metoden. Den kan være tom eller "%tagname%", hvilket betyder det nuværende mærkes navn.

##### tooltip

Definerer værktøjsvinket for et felt i dialogen. Dette element er kun tekst.

For nuværende understøttes kun almindelig tekst (du kan ikke bruge opmarkering).

Overliggende | Underliggende
--- | ---
attr | INGEN

##### whatsthis

Definerer 'Hvad er dette'-hjælp for et felt i dialogen. Elementet er kun tekst.

For nuværende understøttes kun almindelig tekst (du kan ikke bruge opmarkering).

Overliggende | Underliggende
--- | ---
attr | INGEN

##### list

Et omgivelsesmærke som grupperer punkterne i en liste sammen. Det kan kun findes én gang for hver beskrivelse af en egenskab. Dette er et typeelement kun med element.

Overliggende | Underliggende
--- | ---
attr | item

##### item

Definerer et objekt i en liste. Elementet er kun tekst.

Overliggende | Underliggende
--- | ---
list | INGEN

##### textlocation

Angiver positionen for et mærkes egenskabstekst inde i en dialog. Dette mærke kan kun findes én gang for hver egenskab i dialogen (&ie; en gang for hver <attr>-mærke). Dette element er tomt.

Overliggende | Underliggende
--- | ---
attr | INGEN

Egenskab | Type | Brug | Beskrivelse
--- | --- | --- | ---
row | positivt heltal | kræves | Angiver linjen i dialogens layout for et felt eller en etiket.
col | positivt heltal | kræves | Angiver søjlen i dialogens layout for et felt eller en etiket.
rowspan | positivt heltal | valgfri | Angiver antal linjer som et felt skal optage.
colspan | positivt heltal | valgfri | Angiver antal søjler som et felt skal optage.

##### location

Angiver position og størrelse på et felt i dialogen. Dette mærke skal findes én gang for hvert felt i dialogen (&ie; én gang for hvert <attr>- og <label>-mærke). Dette element er tomt.

Overliggende | Underliggende
--- | ---
label, attr | INGEN

Egenskab | Type | Brug | Beskrivelse
--- | --- | --- | ---
row | positivt heltal | kræves | Angiver linjen i dialogens layout for et felt eller en etiket.
col | positivt heltal | kræves | Angiver søjlen i dialogens layout for et felt eller en etiket.
rowspan | positivt heltal | valgfri | Angiver antal linjer som et felt skal optage.
colspan | positivt heltal | valgfri | Angiver antal søjler som et felt skal optage.

##### text

Definerer teksten for en etiket eller et afkrydsningsfelt. Dette element er kun tekst.

Overliggende | Underliggende
--- | ---
label, attr | INGEN

##### children

Definerer en liste med elementer som kan findes i mærket som angives. Dette er et typeelement kun med element.

Overliggende | Underliggende
--- | ---
tag | child

##### child

Definerer et underliggende mærke. Dette element er tomt.

Overliggende | Underliggende
--- | ---
children | INGEN

Egenskab | Type | Værdier | Brug | Beskrivelse
--- | --- | --- | --- | ---
navn | streng |  | kræves | Angiver et mærke som kan findes indeni et vist mærke.
usage | streng |  | valgfri | Angiver forholdet til det overliggende objekt.
|  | kræves |  | Det overliggende objekt skal have mindst et underliggende objekt med dette navn.

##### stoppingtags

Definerer en liste med elementer som tvinger et mærke til at slutte. Dette er et typeelement kun med element.

Overliggende | Underliggende
--- | ---
tag | stoppingtag

##### stoppingtag

Definerer et slutmærke. Dette element er tomt.

Overliggende | Underliggende
--- | ---
stoppingtags | INGEN

Egenskab | Type | Brug | Beskrivelse
--- | --- | --- | ---
navn | streng | kræves | Angiver hvilke mærker som tvinger et andet mærke til at slutte.

#### Brug af XML-mærker

Alle XML-mærkefiler skal begynde med &XML;-deklarationen: <?xml version="1.0" encoding="UTF-8"?> og skal være hierarkisk indlejrede og afsluttede.

Mellemrum påvirker ingenting negativt, men pas på med tegnene & og <. Disse skal formodentlig erstattes med henholdsvis &amp; og &lt; i elementer såsom <tooltip>, <whatsthis>, og <text>. Hvis dette ikke gøres forårsager det ikke noget sammenbrud, men du vil få dele af dit arbejde til at forsvinde hvis du ikke gør det.

#### Validering af XML-mærker

For at validere XML-mærkefiler, klik helt enkelt på dialogen Værktøj længst oppe i &quantaplus; og vælg Validér XML-mærker. En dialog vises, og du behøver kun at følge de enkle anvisninger.

Denne funktion findes ikke for øjeblikket. For øjeblikket sker valideringen når XML-mærkefilerne indlæses i &quantaplus;.

#### Eksempel på XML-mærker

##### Familie 1

Følgende viser dig en korrekt familie 1 XML-mærkefil. Filen beskriver tilfældigvis &W3C; &XML; farvesammensætningselement <schema>. Filnavnet på denne XML-mærkefil ville være schema.tag. Enkelt, ikke sandt?

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE TAGS>
    <TAGS>
     <tag name="schema">
      <label>
       <text>id</text>
       <location col="0" row="0"/>
      </label>
      <attr name="id" type="input">
       <tooltip>En entydig identifikation for elementet </tooltip>
       <whatsthis>En entydig identifikation for elementet </whatsthis>
       <location col="1" row="0"/>
      </attr>

      <label>
       <text>version</text>
       <location col="0" row="1"/>
      </label>
      <attr name="version" type="input">
       <tooltip>Version for schema.</tooltip>
       <whatsthis>Version for schema.</whatsthis>
       <location col="1" row="1"/>
      </attr>

      <label>
       <text>targetNamespace</text>
       <location col="0" row="2"/>
      </label>
      <attr name="targetNamespace" type="input">
       <tooltip>Internet-adressereference for navnerummet for dette schema.</tooltip>
       <whatsthis>Interneta-dressreference for navnerummet for dette schema.</whatsthis>
       <location col="1" row="2"/>
      </attr>

      <label>
       <text>xmlns</text>
       <location col="0" row="3"/>
      </label>
      <attr name="xmlns" type="input">
       <tooltip>Internet-adressereference for et eller flere navnerum for anvendelse i dette schema.
       Hvis intet præfiks bruges, kan komponenterne i navnerummet anvendes uden kvalifikation </tooltip>
       <whatsthis>Internet-adressereference for et eller flere navnerum for anvendelse i dette schema.
       Hvis intet præfiks bruges, kan komponenterne i navnerummet anvendes uden kvalifikation </whatsthis>
       <location col="1" row="3"/>
      </attr>

      <label>
       <text>attributeFormDefault</text>
       <location col="0" row="4"/>
      </label>
      <attr name="attributeFormDefault" type="list">
       <items>
        <item>qualified</item>
        <item>unqualified</item>
       </items>
       <tooltip>Standardformular for alle egenskaber i schema.</tooltip>
       <whatsthis>Standardformular for alle egenskaber i schema.</whatsthis>
       <location col="1" row="4"/>
      </attr>

      <label>
       <text>elementFormDefault</text>
       <location col="0" row="5"/>
      </label>
      <attr name="elementFormDefault" type="list">
       <items>
        <item>qualified</item>
        <item>unqualified</item>
       </items>
       <tooltip>Standardformular for alle elementer i schema.</tooltip>
       <whatsthis>Standardformular for alle elementer i schema.</whatsthis>
       <location col="1" row="5"/>
      </attr>

      <label>
       <text>blockDefault</text>
       <location col="0" row="6"/>
      </label>
      <attr name="blockDefault" type="input">
       <location col="1" row="6"/>
      </attr>

      <label>
       <text>finalDefault</text>
       <location col="0" row="7"/>
      </label>
      <attr name="finalDefault" type="input">
       <location col="1" row="7"/>
      </attr>
     </tag>
    </TAGS>

##### Familie 2

Følgende viser dig en korrekt familie 2 XML-mærkefil. Filen beskriver tilfældigvis &PHP;s overbelastningsfunktion. Filnavnet på denne XML-mærkefil ville være overload.tag.

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE tags>
    <tags>
      <tag name="overload" type="function" returnType="void">
        <attr name="class_name" type="string" status="optional"/>
      </tag>
    </tags>

### &descriptionrc;

Filen &descriptionrc; er også meget enkel, og en editor for den er tilgængelig med DTD Redigér DTD-indstillinger. Det redigerer &descriptionrc; for en &DTEP; som du kan vælge i en liste. For at redigere &descriptionrc; for en nyoprettet &DTEP;, skal du oprette en enkel &descriptionrc; med følgende indgange:

            [General]
            Version = Anvend 1 for &quantaplus; version <=3.1.2 og 2 for alle senere versioner.
            Name = DTD-definitionsstreng. (-//&W3C;//DTD HTML 4.01 Transitional//EN)
            NickName = Det forskønade navnet på en DTD. (HTML 4.01 Transitional). Hvis ikke defineret bruges Name
            som NickName.

Når du har oprettet den og lagt den ved siden af mærkefilerne, indlæses din nyoprettete &DTEP; med DTD Indlæs DTD-pakke (DTEP). Efter det er indlæst kan du fortsætte med at redigere indstillingerne i din &DTEP;. Tjek indgangenes værktøjsvink og Hvad er dette-tekster i redigeringsdialogen for at forstå betydningen af hver post. Som et alternativ kan du læse `quanta/data/dtep/dtd-description.txt` i det komprimerede kildekodearkiv, som indeholder en beskrivelse af formatet.

## Brugerdefinerede handlinger

Handlinger er meget hyppige i alle programmer. Du møder dem ofte når du bruger enhver applikation. Et klik på en værktøjslinjeikon, valg af en menuindgang eller brug af en genvejstast udfører normalt en handling. I &quantaplus; er handlinger videreført til næste niveau. Istedet for fastlagte handlinger (som er defineret af forfatteren af programmet på kildekodeniveau), er det muligt for den almindelige bruger at oprette og modificere handlinger og på den måde indføre ny funktionalitet i &quantaplus;. Det er de brugerdefinerede handlinger og mange af standardhandlingerne i &quantaplus; er brugerdefinerede (og mulige at ændre af brugeren) handlinger også.

Der er tre slags brugerdefinérbare handlinger:

- Teksthandlinger

- Mærkehandlinger

- Scripthandlinger

### At oprette handlinger

Du kan oprette en handling ved at vælge Opsætning Indstil handlinger . Klik på Ny handling og du får en ny dialog at se:

Type

  Angiver handlingens type (Tekst, Mærke, Script).

Tekst

  Den del af handlingens navn som er synlig for brugeren

Knappen nær ved Tekst etiketten.

  Ikonen der tildeles til denne handling. Klik på den for at ændre den aktuelle ikon.

Værktøjsvink

  Kort beskrivelse af hvad handlingen gør.

Genvejstast

  Genvejstasten der tildeles denne handling. Klik på Brugerdefineret eller knappen tæt på Brugerdefineret for at tildele en genvejstst til handlingen. Klik på Ingen for at fjerne den aktuelle tildelte genvejstast.

Værktøjslinjebeholdere

  De brugerdefinerede værktøjslinjer, hvor handlingen foregår. Se .

Detaljerede indstillinger

  Specifikke indstillinger for en anden type handlinger. Se herunder

### Teksthandlinger

De simpleste handlinger. Du kan indtaste noget tekst i Detaljerede indstillinger-feltet og så snart handlingen udføres, bliver denne tekst indsat i dit dokument ved den aktuelle markørposition. Se herunder for et eksempel.

### Mærkehandlinger

Brugbar til at indsætte XML-mærker, men selvfølgelig kan du også indsætte dem til andre formål.

<mærke>

  Navnet på mærket.

</mærke>

  Hvis afkrydset når handlingen udføres bliver denne tekst indsat som et lukke-mærke. Hvis der er markeret et område i dokumentet før du udfører handlingen, bliver <mærket> indsat før det markerede område og </mærke> efter.

Kør "Redigér mærke"-dialogen hvis den er til rådighed

  Hvis afkrydset og der er en mærkeXML-fil til dette mærke, vises der en mærkeredigeringsdialog før mærket indsættes i dokumentet så du kan finjustere mærkeegenskaberne først.

<Mærke> og </mærke> bliver indsat som du har skrevet det her. <, > eller /-tegnet bliver ikke automatisk vedhæftet.

### Scripthandlinger

Den mest kraftfulde handlingstype. Ved hjælp af denne handling kan du køre eksterne programmer (normalt scripter, men ikke begrænset til dette), som kan ændre dit dokument eller bruge dit dokument (eller en del af det) som inddata. Eksempler fra &quantaplus; selv er Hurtigstart-dialogen, de forskellige Vis i... handlinger til (X)HTML DTEP'er.

Først skal du indtaste navnet på dit script og også fortolkeren. Eksempel: `sh /home/minhjemmemappe/mitscript.sh`.

Selvom du kan bruge fuldstændige stier, er den anbefalede måde at bruge `%scriptdir` variablen på kommandolinjen således `sh %scriptdir/mitScript.sh`. På den måde vil &quantaplus; forsøge at lokalisere dit script de følgende steder:

- global scriptmappe: ``$KDEDIR`/share/apps/quanta/scripts`

- local scriptmappe: ``$KDEHOME`/share/apps/quanta/scripts`

- din sti: `$PATH`

Der er andre specielle variable du kan bruge på kommandolinjen:

- `%f`: erstattes af adressen på det aktuelle dokument. I fald det er lokale dokumenter bilver file:/ fjernet fra dokumentet.

- `%input`: bliver erstattet med den valgte inddata. Se herunder.

- `%projectbase`:bliver erstattet med adressen på det aktuelle projekt. Er den tom bliver intet projekt indlæst.

- `%pid`: bliver erstattet med PID af den kørende &quantaplus;-proces. Hvis &quantaplus; kører i unik-tilstand, mode, the "unique " teksten foranstillet PID-nummeret. Brugbart når du bruger DCOP til at kontrollere &quantaplus; fra det eksterne script.

- `%userarguments`: Nyttigt i tilfældet med begivenheder. Indgangen erstattes af begivenhedens egenskaber i følgende rækkefølge:

  Første argument

    Scriptets entydige identifikation

  Andet argument

    begivenhedsnavnet

  Tredje argument

    begivenhedens parameter, oftest det nuværende dokuments filnavn eller søgestien til projektfilen.

Udover de ovennævnte metoder, kan scriptet modtage inddata fra &quantaplus; via stdin. I Indata kombinationsfeltet kan du vælge hvad der skal sendes til stdin. Valgene er:

- Ingen: intet sendes til scriptet.

- Aktuelt dokument: hele dokumentet sendes til scriptet.

- Markeret tekst: det markerede tekstområde i dokumentet sendes til scriptet. At bruge `%input` variablen giver nomalt kun mening når man bruger denne indstilling.

I samme stil som Inddata kan du fange uddata fra den udførte applikation. Der er to slags uddata:

- normal uddata, udskrevet til stdout;

- fejlmeddelelser, udskrevet til stderr.

Du kan specificere hvad der skal ske med teksten udskrevet til stdout. Dette kan gøres ved at ændre værdien i Uddata kombinationsfeltet:

- Ingen: applikationens uddata ignoreres.

- Indsæt ved markørposition: uddata indsættes i det aktuelle dokument ved markørpositionen.

- Erstat markering: det markerede område i dokumentet erstattes med uddata.

- Erstat markering: det markerede område i dokumentet erstattes med uddata.

- Opret et nyt dokument: et nyt dokument bliver oprettet og indeholder scriptets uddata.

- Erstat aktuelt dokument: hele dokumentet erstattes med uddata.

- Beskedvindue: uddata vises i Beskeder værktøjsvisningen.

Valgene for stderr uddata (Fejl) er det samme som for normal uddata.

## Opret værktøjslinjer

Det følgende viser dig hvordan man opretter værktøjslinjer for en &DTEP;. Værktøjslinjer er grafiske elementer, som tildeles handlinger. I &quantaplus; er handlinger grunden til næsten alle udvidelser som &quantaplus; har, og vil få i fremtiden. &quantaplus; tilbyder også automatisk komplettering og mærkedialoger. Grænserne for hvad du kan gøre med handlinger er næsten ubegrænsede. Som eksempel, anvender vi &HTML; Tidy på vore netsider.

### Fra begyndelsen til en færdig værktøjslinje

Til at begynde med, skal du oprette en brugerværktøjslinje. Vælg Værktøjslinjer Tilføj brugerværktøjslinje .

Hvis der findes mange mærker i sproget, anbefales du at opdele mærkerne i logiske grupper. Du skal oprette en ny brugerværktøjslinje for hver gruppe. I dette tilfælde findes der ikke mange, så vi opretter en værktøjslinje og navngiver den efter mærkesproget.

Så snart alle værktøjslinjer er oprettet, skal du tilføje og tilrette handlingerne. For at gøre det, vælges Opsætning Indstil handlinger .

Delene i vinduet er ganske ligetil. Tryk på knappen Ny handling længst nede i vinduet for at komme til redigeringstilstand.

Udfyld i alle nødvendige felter, og tilføj mærkerne i passende værktøjslinjer.

Kompletér resten, og hvis mærkeerne har egenskaber som du altid vil anvende, så markér dialogen Kør dialogen for "Redigér mærke" hvis den findes, så du bliver spurgt hver gang handlingen bruges.

Du bør nu have noget som ligner følgende:

Tryk på knappen Anvend, så ser du at handlingen er blevet tilføjet i de værktøjslinjer du har markeret.

Åh nej! Sikke en grim ikon. Hvordan skal du selv og andre huske at den ikon hører sammen med handlingen. Lad os erstatte den inden der opstår problemer.

For at oprette en ikon som bedre beskriver handlingen, anvender vi &kiconedit;.. Vælg den i &kmenu;, Grafik Flere programmer (eller hvor din distribution end har placeret den).

&kiconedit; har standardstørrelsen 32 x 32 billedpunkter, men vi har brug for 22 x 22. For at ændre det, vælges Redigér Ændr størrelse .

Husk at du laver en ikon som ikke kun skal hjælpe dig selv med at huske hvilken handling som gør hvad, men også andre brugere af denne &DTEP;.

Eftersom mærket vi laver ikonen til, hedder start, bestemmer vi os for at oprette et start-tegn. Ved at bruge grøn farve (grønt tolkes ofte som kør, start eller fortsæt) formidler vi, eller burde i det mindste formidle, brugeren informationen om at ved et klik på denne handling placeres mærket <start> i dette dokument.

Nu når ikonen er færdigoprettet, gemmer vi den.

Når vi er færdige med at laver ikoner, skal ikonerne associeres med handlingen. For at gøre dette, åbnes vinduet Opsætning Indstil handlinger igen (i &quantaplus;) og handlingen som ikonen oprettedes for vælges. Ved siden af feltet Tekst, findes en knap. Klik på den.

Vælg Øvrige ikoner og klik derefter på knappen Gennemsøg....

Gå til mappen hvor du gemte ikonen, vælg den og klik på O.k..

Tryk på knappen Anvend, og fortsæt enten med at gøre det samme med de øvrige mærker, eller klikke på O.k. for at afslutte.

Antag at vi vil tilføje nogle almindelige &quantaplus; funktioner i værktøjslinjen, eller måske skulle værktøjslinjen være bedre hvis den blev organiseret på et anden måde, med nogen adskillere for at gruppere handlingerne. Åbn dialogen Indstil værktøjslinjer ved at vælge Opsætning Indstil værktøjslinjer . Sørg for at vores værktøjslinje er valgt.

Vi vælger adskilleren (længst oppe i venstre søjle) for værktøjslinjen. Når man har valgt objektet som skal tilføjes i værktøjslinjen, trykker man på højrepilen. Dette vil tilføje den til værktøjslinjen.

Vi vil have en hurtig måde at komme til Vis med Konqueror. Vælg den og tilføj de i værktøjslinjen.

Bemærk hvordan adskilleren hjælper med gruppering. Nogen som ikke har set vor værktøjslinje tidligere, ville kunne have troet at knappen &konqueror; lignede eller det modsatte af start-knappen.

Anvend dine ændringer, og tryk på O.k. når du er klar til at afslutte.

Kig på den fantastiske nye værktøjslinje! Meget bekvemmere nu.

Husk at teste værktøjslinjen, ved at klikke på knapperne, så du véd at udskriften er rigtig.

For nu at gemme værktøjslinjen, vælger vi Værktøjslinjer Gem værktøjslinjer Gem som lokal værktøjslinje .

Gem den i den rigtige mappe. Eftersom NeXML ikke findes, lægger vi den kun i topniveaumappen, men værktøjslinjer skal gemmes i den rigtige mappe. Sørg for at du justerer &descriptionrc; så værktøjslinjerne indlæses når en ny fil af denne type laves.

Opret din egen dokumentation

Robert Nickel

    robert@artnickel.com

&rune.laursen.role;

## Opret din egen dokumentation

Formodentlig de mest bemærkelsesværdige tilføjelser til &quantaplus; for den almindelige bruger, tilføjelse af dokumentation for de mærke- eller scriptsprog som er mest populære. Med dette formål, forklarer dette kapitel hvordan jeg laver &PHP;-dokumentationstræet til min egen personlige brug.

Inden du begynder på at oprette din egen dokumentation, vil du måske kigge på &quantaplus;s arkiv for at se om nogen allerede har lavet denne opsætning.

Der findes to dele i processen. Først skal du skaffe eksisterende dokumentation for mærkesproget, scriptsproget eller et andet sprog som du er ude efter. Derefter skal du oprette `docrc`-filen. Det første må du klare selv, det andet er hvad vi dækker her.

Den almindelige form for docrc-filen er følgende:

    #KDE konfigurationsfil
    [Tree]
    Doc dir=søgesti, relativt til denne fil, for dokumentationens HTML-filer t.ex. php42/
    #toppniveauelement
    Top Element=Din beskrivelse af disse dokumenter t.ex. PHP 4.2 dokumentation

    Section 1=Section1.html
    Section 2=#Sec2.1,#Sec2.2,#Sec2.3
    Sec2.1=Sec2.1.html
    Sec2.2=Sec2.2.html
    Sec2.3=Sec2.3.html
    ...

    [Context]
    ContextList=func1,func2,tag1,tag2,tag3
    func1=func1.html
    func2=func2.html
    tag1=tag1.html
    tag2=tag2.html
    tag3=tag3.html

Filen `docrc` er opdelt i to afdelinger: Tree (træ) og Context (Sammenhæng).

Afdelingen Tree definerer præsentationsaspekter for dokumentet under dokumentationsfanebladet. Du ser for eksempel at i &PHP;-dokumentationen, har du noget som ligner dette:

Med reference til ovenstående, ser min &PHP; `docrc` sådan her ud:

    #KDE indstillingsfil

    [Tree]

    Doc dir=php42/

    #toppniveauelement
    Top Element=PHP 4.2 dokumentation

    PHP 4.2 dokumentation=Indholdsfortegnelse,#Kom i gang,#Sprogreference

    Indholdsfortegnelse=index.html

    Kom i gang=Indledning, ...
    Indledning=introduction.html
    ...

    Sprogreference=Grundlæggende syntaks, ...
    Grundlæggende syntaks=language.basic-syntax.html
    ...

Bemærk `#` foran Kom i gang og Sprogreference. Det angiver at disse er delindhold i træet og har deres eget indhold. Jeg tror ikke der findes en angiven grænse for dybde (bortset fra det som dikteres af sund fornuft) — brug din egen dømmekraft.

For indholdsfortegnelsen, ser du at den direkte refererer til en fil (og som en konsekvens, vises den længst ned i trævisningen, mapper kommer først).

Mellemrum påvirker ingenting negativt, men pas på med tegnene & og <. Disse skal formodentlig erstattes med &amp; og &lt; i alle &quantaplus; &XML;-baserede ressourcefiler.

Sammenhængsafsnittet er afsnittet i docrc-filen som bruges til at muliggøre sammenhængsafhængig hjælp. Hvis du for eksempel skriver et &PHP;-script og vil se dokumentationen for funktionen `mysql_fetch_array`, markerer du helt enkelt funktionen og trykker derefter på &Ctrl;H for sammenhængsafhængig hjælp. Dokumentationen om `mysql_fetch_array` vises umiddelbart. Der findes kun to typer af indgange her: sammenhængslisten og filassociationslinjerne.

Sammenhængsliste

  Meget enkel. Dette er kun en liste af sammenhængsindgange adskilte af kommategn, som du vil have tilgængelige (for &PHP; er det funktionerne i &PHP;).

Filassociationslinjer

  De er på formen sammenhængspunkt = HTML-dokumentside. F.eks. acos=function.acos.html.

En renset version af mit `docrc` sammenhængsafsnit ser ud som følger:

    #Nøgleord for sammenhængsafhængig hjælp
    [Context]
    ContextList=abs,acos,acosh,addcslashes,addslashes,...

    abs=function.abs.html
    acos=function.acos.html
    acosh=function.acosh.html
    addcslashes=function.addcslashes.html
    addslashes=function.addslashes.html
    ...

Nu skal du blot gemme din `docrc`-fil. Gem den i `$`HOME`/.kde/share/apps/quanta/doc` eller `$`KDEDIR`/share/apps/quanta/doc` for henholdsvis lokal eller global brug. Opret derefter en mappe (den som angives i `docrc`-filen) i samme mappe som `docrc`-filen findes, og kopiér &HTML;-dokumentationssiderne derhen.

Du skal genstarte &quantaplus;, for at se din dokumentation.

decimaltalr sikker på at de er gode, og værd at dele, send så `docrc`-filen sammen med med en beskrivelse af passende information om hvilket dokument du brugte til &quantaplus;s arkiv til brug for &quantaplus;' brugere. Du bliver ikke rig, men du føler dig godt tilpas ved at vide at du bidraget til det bedste internetudviklingsmiljø som findes.

## Del ressourcer

Du er ikke alene med &quantaplus;. Det er muligt at dele forskellige ressourcer (DTEP-pakker, værktøjslinjer med handlinger, scripter, skabeloner) med andre. Der er to måder at gøre det:

Send med e-mail

  Ressourcer kan sendes med e-mail til venner, kolleger eller til hvem du vil. Du ser menupunktet Send med e-mail på forskellige steder, såsom DTD Send DTD-pakke (DTEP) med e-mail, Værktøjslinjer Send værktøjslinje med e-mail, og i den sammenhængsafhængige menu for filer og mapper i træet Skabeloner og Scripter.

Overfør til hovedserveren

  Ressourcer kan overføres til vort hovedarkiv, hvor alle andre brugere af &quantaplus; kan hente dem. Bidragene gennemses nøje og gøres kun tilgængelige hvis vores gruppe anser dem for rigtige og nyttige. For at oprette et gyldigt bidrag, foreslår vi at du underskriver ressourcen. Derfor behøver du en GPG/PGP-nøgle. Informationen bruges til at verificere ressourcens oprindelse, både af vor gruppe og af de som henter den.

  Om hvordan ressourcer hentes fra hovedserveren, se .

  Når du overfører bliver du bedt om at angive løsen for din hemmelige GPG-nøgle (løsenet opbevares ikke), og i tilfældet med flere hemmelige nøgler, skal du vælge den du vil bruge. Udfyld inddatafelterne i dialogen Del smarte nye ting (URL for forhåndsvisning kan forblive tom) og starte overførslen ved at klikke på O.k..

  Overførslen kan startes fra DTD Overfør DTD-pakke (DTEP), Værktøjslinjer Overfør værktøjslinje, og i den sammenhængsafhængige menu for filer og mapper i træet Skabeloner og Skripter.

## Hent ressourcer

Det er muligt at opgradere &quantaplus; uden at skaffe en ny version, ved at hente nye ressourcer såsom DTEP-pakker, værktøjslinjer med handlinger, skabeloner, scripter og dokumentation. En mulighed er at du fik ressourcer med e-mail, eller har hentet dem fra en URL. Så skal du oftest installere dem manuelt. Hvis du er heldig får du også et installationsscript når du henter ressourcen. Men &quantaplus; har en dedikeret server som opbevarer ressourcer som enten ikke er med i hoveddistributionen på grund af deres størrelse eller at de sjældent bruges, eller var senere bidrag af brugere. Disse ressourcer installeres automatisk. Hent sådanne ressourcer i de forskellige menupunkter Download. Du finder dem under DTD Hent DTD-pakke (DTEP), Værktøjslinjer Hent værktøjslinje, og i den sammenhængsafhængige menuen i et tomt område eller topniveauobjekt i træet Skabeloner, Script og Dokumentation.

Efter en ressource er hentet ned, men inden den installeres, verificerer &quantaplus; om ressourcen er gyldig ved at kontrollere integriteten og underskriften. I tilfælde af problemer advares du, og kan bestemme om du vil fortsætte eller ej. Læs advarselsdialogerne nøjagtigt. Hvis integriteten er rigtig og ressourcen er rigtigt underskrevet, vises stadigvæk en informationsdialog så at du kan se hvem der oprettete ressourcen.

Sørg for at du kun installerer ressourcer fra pålidelige kilder, særligt værktøjslinjer og scripter!

## Konvertér en DTD til en &DTEP;

Det er muligt at arbejde med XML-sprog som for øjeblikket ikke understøttes af &quantaplus; ved at oprette en DTEP-pakke. Men det kan tage tid at oprette den, eftersom du kan behøve at skrive hundredvis af mærkefiler med tagXML-format. Der er naturligvis en behageligere måde at gøre det på, ved automatisk at konvertere en DTD til en DTEP-pakke.

Konverteringen kan startes fra menuen DTD Hent og konvertér DTD. Vælg `.dtd`-filen som definerer den DTD du vil bruge, og derefter vises følgende dialog:

Indgangene er:

- Målmappenavn: Den nyoprettede &DTEP; vil få dette navn i mappen `$`KDEHOME`/share/apps/quanta/dtep`.

- Navn: Navnet (definitionsstrengen) på DTD'en

- Alias: Navnet på en &DTEP; synligt for brugeren

- !DOCTYPE-definitionsrad: Strengen som skal ses i mærket !DOCTYPE, såsom HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"

- DTD-webbadress: URL'en som peger på DTD-filen

- Standardendelse: Filendelsen som oftest bruges for filer som blev skrevet med denne DTD

- Versalfølsomme mærker og egenskaber: Selvforklarende. Oftest sandt for XML-sprogsvarianter

- Finjustér DTEP efter konvertering: Hvis markeret, åbner &quantaplus; editoren for &descriptionrc; når konverteringen er klar, så du kan finjustere din nyoprettete &DTEP;. Det anbefales at dette tilvalg er markeret.