Udvidelse af &quantaplus;

Christopher Hornbaker

    chrishornbaker@earthlink.net

&erik.kjaer.pedersen.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 description.rc 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.

Dette dokument beskriver hvordan XML-mærkefiler, filen description.rc 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 description.rc 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 description.rc 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).
|  | 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).
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 kommatal.
|  | long |  |  | Mærketypen returnerer et langt heltal.
|  | streng |  |  | Mærketypen returnerer en streng.

##### 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 (afkrydsningsboks).
|  | 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.

##### 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 afkrydsningsboks. Dette element er kun text.

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 | Brug | Beskrivelse
--- | --- | --- | ---
navn | streng | kræves | Angiver et mærke som kan findes indeni et vist mærke.

##### 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>

### description.rc

Beskrivelsesfilen description.rc er også ganske enkel. Ikke alt det følgende skal anvendes. Grundstrukturen i filen description.rc er følgende:

#### Struktur for familie 1

    [General] - Generel information.
    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 læsbare navn på DTD'en. (HTML 4.01 Transitional).
    Hvis ikke definered, bruges Name som NickName.
    URL = Webbadresse som peger på DTD-definitionen. (http://www.w3.org/TR/html4/loose.dtd)
    DoctypeString = Streng der anvendes i !DOCTYPE-deklarationen.
    (HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd")
    Inherits = Navnet på DTD'en hvor denne DTD arver sine mærker. (-//W3C//DTD HTML 4.01//EN)
    DefaultExtension = Nye filer oprettes med denne filendelse. (html)
    Groups = Listen med fælles egenskabsgrupper, som kan findes i mere end et mærke.
    (Core, I18n, Script) Se nedenfor. (Group1, Group2...)
    NumOfPages = Hvor mange sider har en mærkedialog, udover siden med egenskaberne
    som defineres i mærkefilen? Se nedenfor. (Page1,...)
    CaseSensitive = Hvis DTD'en er versalfølsom. (true|false)
    Family = 1, Denne slags DTEP er af familie 1, eftersom den beskriver mærker.

    [Toolbars] - Information om DTEP-værktøjslinjer.
    Location = Katalognavnet inde i $KDEDIR($KDEHOME)/share/apps/quanta/toolbars
    hvor værktøjslinjerne for denne DTEP findes.
    Names = Listen med navne på værktøjslinjefiler, undtagen filendelsen .toolbar.tgz, som
    indlæses for denne DTEP fra ovengivne mappe.

    [Group1] - Erstat med en af grupperne på listen nedenfor.
    Attributes = Listen med egenskaber for gruppen. For øjeblikket behandles alle
    egenskaber på listen som strenge.
    Eksempel:
    [Core]
    Attributes = id, class, style, title

    [Page1] - Beskrivelse af en mærkeeditorside.
    Title = Etiketten på siden i dialogen for mærkeeditering.
    Groups = Liste med grupper som ses på siden. (Core, I18n)

    [Extra rules] - Nogle regler som ikke passer noget andet sted.
    BooleanAttributes = (enkelt|komplekst)
    Eksempel på enkelt: <tag booleanAttr>.
    Eksempel på komplekst: <tag booleanAttr="1"> eller <tag booleanAttr="true">
    Single Tag Style = (html|XML)
    Eksempel på html: <single_tag>
    Eksempel på XML:  <single_tag />
    StructGroupsCount = Antal strukturgrupper. Se nedenfor.
    MinusAllowedInWords = Hvis sandt behandles "det-her-er-et-ord" som et ord. Ellers
    behandles det som fem ord.
    TagAutoCompleteAfter = CHAR. Boksen til automatisk komplettering vises
    så snart dette tegn indskrives, eller mellemrum trykkes efter tegnet.
    For DTEP familie 1, er det oftest "<". Teksten "none" i stedet for
    et tegn angiver at kompletteringsboksen ikke skal vises automatisk,
    med mindre brugeren beder om det.
    AttributeSeparator = CHAR. Dette tegn betyder at egenskabsnavnet
    har sluttet. Det er " for en XML DTEP.
    TagSeparator = CHAR. På tilsvarende måde som ovenfor.

    [StructGroup_1] - Definition af strukturgruppe 1.
    Name = Teksten som vises hvis der findes mærker som matcher gruppen.
    No_Name = Teksten som vises hvis der IKKE findes mærker som matcher gruppen.
    Icon = Navnet på ikonen som vises inden ovenstående tekster.
    Tag = mærkenavn(egenskab1, egenskab2, ...). Mærker med navn mærkenavn
    vises under denne gruppe. Objektets tekst er "egenskab1_værdi | egenskab2_værdi | ..."
    For øjeblikket må kun et mærke angives her.
    HasFileName = (true|false) Sandt hvis objektets tekst (egenskabsværdier ovenfor) indeholder et filnavn.
    FileNameRx = Regulært udtryk som bruges til at fjerne unødige tegn fra objektets tekst.

    [Parsing rules] - Regler som bruges når dokumentet tolkes.
    SpecialAreas = Indledende og afsluttende streng for bestemte områder, adskilte med kommategn.
    Adskilte områder tolkes ikke ifølge denne DTEP's regler, men med sine egne regler.
    Et adskilt område kan være en DTEP fra en anden familie, en kommentar eller noget lignende.
    T.ex. <!-- -->
    SpecialAreaNames = Liste med ovenstående bestemte områdenavne, adskilt med kommategn. F. eks.: comment
    SpecialTags = mærkenavn(egenskabsnavn) - Angiver et mærke som definerer begyndelsen på et specielt område.
    MayContain = Liste med alle familie 2 DTEP som kan findes i dokumentet, adskilt med kommategn.
    (php, css)

#### Struktur for familie 2

    [General] - Generel information.
    Version = Brug 1 for &quantaplus; version <= 3.1.2 og 2 for alle senere versioner.
    Name = Egentligt navn
    NickName = Hvad de fleste kalder den. Hvis ikke er definerer, bruges Name som NickName.
    Inherits = Navnet på den DTEP hvorfra denne DTEP arver mærker. (Name, ikke NickName)
    DefaultExtension = Nye filer oprettes med denne filendelse. (php)
    NumOfPages = 0, Altid nul, eftersom der ikke findes en dialog for mærkeredigering for en familie 2 DTEP.
    CaseSensitive = Hvis DTEP'en er versalfølsom. (true|false)
    Family = 2, Denne slags DTEP er af familie 2, eftersom den ikke beskriver mærker.
    [Toolbars] - Information om DTEP værktøjslinjer.
    Location = Katalognavnet inde i $KDEDIR($KDEHOME)/share/apps/quanta/toolbars
    hvor værktøjslinjerne for denne DTEP findes.
    Names = Listen med navne på værktøjslinjesfiler, foruden filendelsen .toolbar.tgz, som
    indlæses for denne DTEP fra ovengivne mappe.

    [Extra rules] - Nogle regler som ikke passer noget andet sted.
    BooleanAttributes = (enkelt|komplekst)
    Eksempel på enkelt: <tag booleanAttr>.
    Eksempel på komplekst: <tag booleanAttr="1"> eller <tag booleanAttr="true">
    StructGroupsCount = Antal strukturgrupper. Se nedenfor.
    MinusAllowedInWords = Hvis sandt behandles "det-her-er-et-ord" som et ord. Ellers
    behandles det som fem ord.
    TagAutoCompleteAfter = CHAR. Boksen for automatisk komplettering vises
    så snart dette tegn indskrives, eller mellemrum trykkes efter tegnet.
    For DTEP familie 1, er det oftest "<". Teksten "none" i stedet for et
    tegn der angiver at kompletteringsboksen ikke skal vises automatisk, med mindre
    brugeren beder om det.
    AttributeSeparator = CHAR. Dette tegn betyder at egenskabsnavne er færdige.
    Det er " for en XML DTEP.
    TagSeparator = CHAR. På tilsvarende måde som ovenfor.
    AttributeAutoCompletionAfter = CHAR. På tilsvarende måde som TagAutoCompletionAfter, men
    for mærkegenskaber. Det er normalt "(" og ":" for CSS.

    [StructGroup_1] - Definition af strukturgruppe 1.
    Name = Teksten som vises hvis der findes mærker som matcher gruppen.
    No_Name = Teksten som vises hvis det IKKE findes mærker som matcher gruppen.
    Icon = Navnet på ikonen som vises inden ovenstående tekster.
    Tag = mærkenavn(egenskab1, egenskab2, ...). Mærker med navn mærkenavn vises
    under denne gruppe. Objektets tekst er "egenskab1_værdi | egenskab2_værdi | ..."
    For øjeblikket må kun et mærke angives her.
    HasFileName = (true|false) Sandt hvis objektets tekst (egenskabsværdier ovenfor) indeholder et filnavn.
    FileNameRx = Regulært udtryk som bruges til at fjerne unødige tegn fra objektets tekst.
    SearchRx = Regulært udtryk som bruges til at finde tekstområder i en familie 2 DTEP,
    som skal tillhøre denne gruppe
    ClearRx = Regulært udtryk som bruges til at fjerne unødig text eller unødige tegn fra
    ovenstående søgeresultat. Den rensede streng vises i strukturtræet.

    [Parsing rules] - Regler som bruges når dokumentet tolkes.
    SpecialAreas = Indledende og afsluttende streng for bestemte områder, adskilt med et kommategn.
    Bestemte områder tolkes ikke ifølge denne DTEP's regler, men med sine egne regler.
    Et bestemt område kan være en DTEP fra en anden familie, en kommentar eller nogenting lignende.
    T.ex. <!-- -->
    SpecialAreaNames = Liste med ovenstående bestemte områdenavne, adskilte med kommategn. F. eks.: comment
    SpecialTags = mærkenavn(egenskabsnavn) - Angiver et mærke som definerer begyndelsen på et specielt område.
    AreaBorders = Liste med områdesgrænser som indeslutter denne familie 2 DTEP, adskilte med kommategn
    I tilfældet PHP, er det: <? ?>, <* *>, <% %>
    Tags = mærkenavn(egenskab). Hvis den ovenstående (rigtige) DTD har et mærke med mærkenavn
    og mærkets egenskabsværdi er det samme som DTD-navnet, tolkes mærkeområdet ifølge reglerne
    for denne DTD.
    Comments = Liste med områdesgrænser for kommentarer, adskilte med kommategn. EOL betyder linjeslut.
    T.ex.: // EOL, /* */
    StructKeywords = Liste med strukturnøgleord, adskilte med semikolon. Strukturer behandles
    som nye knuder i strukturtræet.
    StructBeginStr = En streng som angiver begyndelsen på en struktur (som {)
    StructEndStr = En streng som angiver begyndelsen på en struktur (som })
    StructRx = Regulært udtryk som indeholder begyndelsen eller slutningen på strukturområdet.
    T.ex. \\{ | \\} (strukturens områdesgrænse kan være { eller })

## 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 dokumentet.

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 description.rc så værktøjslinjerne indlæses når en ny fil af denne type laves.

Opret din egen dokumentation

Robert Nickel

    robert@artnickel.com

&erik.kjaer.pedersen.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.

Når du er 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.