<?xml version="1.0" encoding="UTF-8" ?>

<chapter id="extending-quanta-3-2">
<chapterinfo>
<title
>Udvidelse af &quantaplus;</title>
<authorgroup>
<author
><firstname
>Christopher</firstname
> <surname
>Hornbaker</surname
> <affiliation
> <address
><email
>chrishornbaker@earthlink.net</email
></address>
</affiliation>
</author>

&erik.kjaer.pedersen.role; 

</authorgroup>
</chapterinfo>

<title
>Udvidelse af &quantaplus;</title>

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

<!--<sect1 id="kommander-3-2">
<title
>Using Kommander With &quantaplus;</title>

<para>
Kommander, by Marc Britton.
</para>
</sect1
> -->

<sect1 id="dtep-intro-3-2">
<title
>Dokumenttype-redigeringspakke (&DTEP;)</title>

<para
>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ø. </para>

<para
>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. </para>

<para
>Dette dokument beskriver hvordan XML-mærkefiler, filen description.rc og værktøjslinjer laves. I korthed, en &DTEP;. </para>

<para
>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. </para>

<sect2 id="dtep-packaging-3-2">
<title
>Indpakning</title>

<para
>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). </para>
</sect2>

<sect2 id="tagxml-3-2">
<title
>TagXML</title>

<para
>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. </para>

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


<sect3 id="dtep-element-descriptions-3-2">
<title
>Elementbeskrivelser for XML-mærker</title>

<para
>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. </para>

<sect4 id="TAGS-3-2">
<title
>TAGS</title>

<para
>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. </para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry
>Overliggende</entry>
<entry
>Underliggende</entry>
</row>
</thead>
<tbody>
<row>
<entry
><emphasis
>INGEN</emphasis
></entry>
<entry
>tag</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>

<sect4 id="tag-3-2">
<title
>tag</title>

<para
>Omgivelse for mærket som defineres. Dette er et typeelement kun med element. </para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry
>Overliggende</entry>
<entry
>Underliggende</entry>
</row>
</thead>
<tbody>
<row>
<entry
>TAGS</entry>
<entry
>label, attr, stoppingtags</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<informaltable>
<tgroup cols="6">
<thead>
<row>
<entry
>Egenskab</entry
><entry
>Type</entry
><entry
>Værdier</entry>
<entry
>Standard</entry
><entry
>Brug</entry
><entry
>Beskrivelse</entry>
</row>
</thead>
<tbody>
<row>
<entry
>navn</entry
><entry
>streng</entry
><entry
></entry
><entry
></entry>
<entry
>kræves</entry
><entry
>Angiver navnet på mærken som bliver defineret.</entry>
</row>
<row>
<entry
>single</entry
><entry
>boolean</entry
><entry
></entry
><entry
></entry>
<entry
>valgfri</entry
><entry
>Angiver om mærket kræver et afsluttende mærke &lt;/(mærkenavn)&gt;.</entry>
</row>
<row>
<entry
>type</entry
><entry
>streng</entry
><entry
></entry
><entry
>xmltag</entry>
<entry
>valgfri</entry
><entry
>Angiver typen af mærket som defineres.</entry>
</row>
<row>
<entry
></entry
><entry
></entry
><entry
>xmltag</entry
><entry
></entry>
<entry
></entry
><entry
>Typen for mærket er XML-baseret (kun familie 1).</entry>
</row>
<row>
<entry
></entry
><entry
></entry
><entry
>egenskab</entry
><entry
></entry>
<entry
></entry
><entry
>Typen for mærket er &CSS; (kun familie 2).</entry>
</row>
<row>
<entry
></entry
><entry
></entry
><entry
>funktion</entry
><entry
></entry>
<entry
></entry
><entry
>Typen for mærket er en scriptfunktion. Når dette bruges bliver &lt;attr&gt; funktionens argument (kun familie 2).</entry>
</row>
<row>
<entry
></entry
><entry
></entry
><entry
>klasse</entry
><entry
></entry>
<entry
></entry
><entry
>Typen for mærket er en scriptklasse (kun familie 2).</entry>
</row>
<row>
<entry
>returnType</entry
><entry
>streng</entry
><entry
></entry
><entry
>void </entry>
<entry
>valgfri</entry
><entry
>Angiver returtypen for mærket som defineres (kun familie 2).</entry>
</row>
<row>
<entry
></entry
><entry
></entry
><entry
>void</entry
><entry
></entry>
<entry
></entry
><entry
>Mærketypen returnerer ingenting.</entry>
</row>
<row>
<entry
></entry
><entry
></entry
><entry
>int</entry
><entry
></entry>
<entry
></entry
><entry
>Mærketypen returnerar et heltal.</entry>
</row>
<row>
<entry
></entry
><entry
></entry
><entry
>float</entry
><entry
></entry>
<entry
></entry
><entry
>Mærketypen returnerer et kommatal.</entry>
</row>
<row>
<entry
></entry
><entry
></entry
><entry
>long</entry
><entry
></entry>
<entry
></entry
><entry
>Mærketypen returnerer et langt heltal.</entry>
</row>
<row>
<entry
></entry
><entry
></entry
><entry
>streng</entry
><entry
></entry>
<entry
></entry
><entry
>Mærketypen returnerer en streng.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>

<sect4 id="label-3-2">
<title
>label</title>

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

<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry
>Overliggende</entry>
<entry
>Underliggende</entry>
</row>
</thead>
<tbody>
<row>
<entry
>tag</entry>
<entry
>text, location</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>

<sect4 id="attr-3-2">
<title
>attr</title>

<para
>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. </para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry
>Overliggende</entry>
<entry
>Underliggende</entry>
</row>
</thead>
<tbody>
<row>
<entry
>tag</entry>
<entry
>location, list, tooltip, whatsthis, textlocation</entry>
</row>
</tbody>
</tgroup>
</informaltable>

<informaltable>
<tgroup cols="6">
<thead>
<row>
<entry
>Egenskab</entry
><entry
>Type</entry
><entry
>Værdier</entry>
<entry
>Standard</entry
><entry
>Brug</entry
><entry
>Beskrivelse</entry>
</row>
</thead>
<tbody>
<row>
<entry
>navn</entry
><entry
>streng</entry
><entry
></entry
><entry
></entry>
<entry
>kræves</entry
><entry
>Angiver navnet på egenskaben som er  ved at blive defineres.</entry>
</row>
<row>
<entry
>type</entry
><entry
>streng</entry
><entry
></entry
><entry
>input</entry>
<entry
>kræves</entry
><entry
>Angiver typen for egenskaben som er ved at blive defineres.</entry>
</row>
<row>
<entry
></entry
><entry
></entry
><entry
>input</entry
><entry
></entry>
<entry
></entry
><entry
>Feltet understøtter frie tekstindgange (tekstfelt).</entry>
</row>
<row>
<entry
></entry
><entry
></entry
><entry
>check</entry
><entry
></entry>
<entry
></entry
><entry
>Feltets værdi er boolesk (afkrydsningsboks).</entry>
</row>
<row>
<entry
></entry
><entry
></entry
><entry
>farve</entry
><entry
></entry>
<entry
></entry
><entry
>Feltets værdi er en farve.</entry>
</row>
<row>
<entry
></entry
><entry
></entry
><entry
>url</entry
><entry
></entry>
<entry
></entry
><entry
>Feltets værdi er en &URL; (Lokal fil at henvise til).</entry>
</row>
<row>
<entry
></entry
><entry
></entry
><entry
>list</entry
><entry
></entry>
<entry
></entry
><entry
>Feltets værdi kommer fra en given liste.</entry>
</row>
<row>
<entry
>status</entry
><entry
>streng</entry
><entry
></entry
><entry
>valgfri</entry>
<entry
>kræves</entry
><entry
>Angiver om argumentet kræves eller ej (Kun familie 2).</entry>
</row>
<row>
<entry
></entry
><entry
></entry
><entry
>valgfri</entry
><entry
></entry>
<entry
></entry
><entry
>Argumentet kræves ikke.</entry>
</row>
<row>
<entry
></entry
><entry
></entry
><entry
>kræves</entry
><entry
></entry>
<entry
></entry
><entry
>Argumentet kræves.</entry>
</row>
<row>
<entry
></entry
><entry
></entry
><entry
>underforstået</entry
><entry
></entry>
<entry
></entry
><entry
>Argumentet er underforstået.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>

<sect4 id="tooltip-3-2">
<title
>tooltip</title>

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

<note>
<para
>For nuværende understøttes kun almindelig tekst (du kan ikke bruge opmarkering). </para>
</note>

<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry
>Overliggende</entry>
<entry
>Underliggende</entry>
</row>
</thead>
<tbody>
<row>
<entry
>attr</entry>
<entry
><emphasis
>INGEN</emphasis
></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>

<sect4 id="whatsthis-3-2">
<title
>whatsthis</title>

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

<note>
<para
>For nuværende understøttes kun almindelig tekst (du kan ikke bruge opmarkering). </para>
</note>

<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry
>Overliggende</entry>
<entry
>Underliggende</entry>
</row>
</thead>
<tbody>
<row>
<entry
>attr</entry>
<entry
><emphasis
>INGEN</emphasis
></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>

<sect4 id="list-3-2">
<title
>list</title>

<para
>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. </para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry
>Overliggende</entry>
<entry
>Underliggende</entry>
</row>
</thead>
<tbody>
<row>
<entry
>attr</entry>
<entry
>item</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>

<sect4 id="item-3-2">
<title
>item</title>

<para
>Definerer et objekt i en liste. Elementet er kun tekst. </para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry
>Overliggende</entry>
<entry
>Underliggende</entry>
</row>
</thead>
<tbody>
<row>
<entry
>list</entry>
<entry
><emphasis
>INGEN</emphasis
></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>

<sect4 id="textlocation-3-2">
<title
>textlocation</title>

<para
>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 &lt;attr&gt;-mærke). Dette element er tomt. </para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry
>Overliggende</entry>
<entry
>Underliggende</entry>
</row>
</thead>
<tbody>
<row>
<entry
>attr</entry>
<entry
><emphasis
>INGEN</emphasis
></entry>
</row>
</tbody>
</tgroup>
</informaltable>

<informaltable>
<tgroup cols="4">
<thead>
<row>
<entry
>Egenskab</entry
><entry
>Type</entry>
<entry
>Brug</entry
><entry
>Beskrivelse</entry>
</row>
</thead>
<tbody>
<row>
<entry
>row</entry
><entry
>positivt heltal</entry>
<entry
>kræves</entry
><entry
>Angiver linjen i dialogens layout for et felt eller en etiket.</entry>
</row>
<row>
<entry
>col</entry
><entry
>positivt heltal</entry>
<entry
>kræves</entry
><entry
>Angiver søjlen i dialogens layout for et felt eller en etiket.</entry>
</row>
<row>
<entry
>rowspan</entry
><entry
>positivt heltal</entry>
<entry
>valgfri</entry
><entry
>Angiver antal linjer som et felt skal optage.</entry>
</row>
<row>
<entry
>colspan</entry
><entry
>positivt heltal</entry>
<entry
>valgfri</entry
><entry
>Angiver antal søjler som et felt skal optage.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>

<sect4 id="location-3-2">
<title
>location</title>

<para
>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 &lt;attr&gt;- og &lt;label&gt;-mærke). Dette element er tomt. </para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry
>Overliggende</entry
><entry
>Underliggende</entry>
</row>
</thead>
<tbody>
<row>
<entry
>label, attr</entry
><entry
><emphasis
>INGEN</emphasis
></entry>
</row>
</tbody>
</tgroup>
</informaltable>

<informaltable>
<tgroup cols="4">
<thead>
<row>
<entry
>Egenskab</entry
><entry
>Type</entry>
<entry
>Brug</entry
><entry
>Beskrivelse</entry>
</row>
</thead>
<tbody>
<row>
<entry
>row</entry
><entry
>positivt heltal</entry>
<entry
>kræves</entry
><entry
>Angiver linjen i dialogens layout for et felt eller en etiket.</entry>
</row>
<row>
<entry
>col</entry
><entry
>positivt heltal</entry>
<entry
>kræves</entry
><entry
>Angiver søjlen i dialogens layout for et felt eller en etiket.</entry>
</row>
<row>
<entry
>rowspan</entry
><entry
>positivt heltal</entry>
<entry
>valgfri</entry
><entry
>Angiver antal linjer som et felt skal optage.</entry>
</row>
<row>
<entry
>colspan</entry
><entry
>positivt heltal</entry>
<entry
>valgfri</entry
><entry
>Angiver antal søjler som et felt skal optage.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>

<sect4 id="text-3-2">
<title
>text</title>

<para
>Definerer teksten for en etiket eller afkrydsningsboks. Dette element er kun text. </para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry
>Overliggende</entry
><entry
>Underliggende</entry>
</row>
</thead>
<tbody>
<row>
<entry
>label, attr</entry
><entry
><emphasis
>INGEN</emphasis
></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>

<sect4 id="children-3-2">
<title
>children</title>

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

<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry
>Overliggende</entry
><entry
>Underliggende</entry>
</row>
</thead>
<tbody>
<row>
<entry
>tag</entry
><entry
>child</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>

<sect4 id="child-3-2">
<title
>child</title>

<para
>Definerer et underliggende mærke. Dette element er tomt. </para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry
>Overliggende</entry
><entry
>Underliggende</entry>
</row>
</thead>
<tbody>
<row>
<entry
>children</entry
><entry
><emphasis
>INGEN</emphasis
></entry>
</row>
</tbody>
</tgroup>
</informaltable>

<informaltable>
<tgroup cols="4">
<thead>
<row>
<entry
>Egenskab</entry
><entry
>Type</entry>
<entry
>Brug</entry
><entry
>Beskrivelse</entry>
</row>
</thead>
<tbody>
<row>
<entry
>navn</entry
><entry
>streng</entry>
<entry
>kræves</entry
><entry
>Angiver et mærke som kan findes indeni et vist mærke.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>

<sect4 id="stoppingtags-3-2">
<title
>stoppingtags</title>

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

<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry
>Overliggende</entry
><entry
>Underliggende</entry>
</row>
</thead>
<tbody>
<row>
<entry
>tag</entry
><entry
>stoppingtag</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>

<sect4 id="stoppingtag-3-2">
<title
>stoppingtag</title>

<para
>Definerer et slutmærke. Dette element er tomt. </para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry
>Overliggende</entry
><entry
>Underliggende</entry>
</row>
</thead>
<tbody>
<row>
<entry
>stoppingtags</entry
><entry
><emphasis
>INGEN</emphasis
></entry>
</row>
</tbody>
</tgroup>
</informaltable>

<informaltable>
<tgroup cols="4">
<thead>
<row>
<entry
>Egenskab</entry
><entry
>Type</entry>
<entry
>Brug</entry
><entry
>Beskrivelse</entry>
</row>
</thead>
<tbody>
<row>
<entry
>navn</entry
><entry
>streng</entry>
<entry
>kræves</entry
><entry
>Angiver hvilke mærker som tvinger et andet mærke til at slutte.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>
</sect3>

<sect3 id="tagxml-usage-3-2">
<title
>Brug af XML-mærker</title>

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

<important>
<para
>Mellemrum påvirker ingenting negativt, men pas på med tegnene &amp; og &lt;. Disse skal formodentlig erstattes med henholdsvis &amp;amp; og &amp;lt; i elementer såsom &lt;tooltip&gt;, &lt;whatsthis&gt;, og &lt;text&gt;. 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. </para>
</important>
</sect3>

<sect3 id="tagxml-validation-3-2">
<title
>Validering af XML-mærker</title>

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

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

<sect3 id="tagxml-examples-3-2">
<title
>Eksempel på XML-mærker</title>

<sect4 id="family-one-3-2">
<title
>Familie 1</title>

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

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

  &lt;label&gt;
   &lt;text&gt;version&lt;/text&gt;
   &lt;location col="0" row="1"/&gt;
  &lt;/label&gt;
  &lt;attr name="version" type="input"&gt;
   &lt;tooltip&gt;Version for schema.&lt;/tooltip&gt;
   &lt;whatsthis&gt;Version for schema.&lt;/whatsthis&gt;
   &lt;location col="1" row="1"/&gt;
  &lt;/attr&gt;

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

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

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

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

  &lt;label&gt;
   &lt;text&gt;blockDefault&lt;/text&gt;
   &lt;location col="0" row="6"/&gt;
  &lt;/label&gt;
  &lt;attr name="blockDefault" type="input"&gt;
   &lt;location col="1" row="6"/&gt;
  &lt;/attr&gt;

  &lt;label&gt;
   &lt;text&gt;finalDefault&lt;/text&gt;
   &lt;location col="0" row="7"/&gt;
  &lt;/label&gt;
  &lt;attr name="finalDefault" type="input"&gt;
   &lt;location col="1" row="7"/&gt;
  &lt;/attr&gt;
 &lt;/tag&gt;
&lt;/TAGS&gt;
</markup
>
</literallayout>
</informalexample>
</sect4>

<sect4 id="family-two-3-2">
<title
>Familie 2</title>

<para
>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. </para>

<informalexample>
<literallayout
><markup>
&lt;?xml version="1.0" encoding="UTF-8"?&gt;
&lt;!DOCTYPE tags&gt;
&lt;tags&gt;
  &lt;tag name="overload" type="function" returnType="void"&gt;
    &lt;attr name="class_name" type="string" status="optional"/&gt;
  &lt;/tag&gt;
&lt;/tags&gt;
</markup
>
</literallayout>
</informalexample>
</sect4>
</sect3>
</sect2>

<sect2 id="descriptionrc-3-2">
<title
>description.rc</title>

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

<sect3 id="family-one-structure-3-2">
<title
>Struktur for familie 1</title>

<informalexample>
<literallayout
><markup>
[General] - Generel information.
Version = Anvend 1 for &quantaplus; version &lt;= 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: &lt;tag booleanAttr&gt;.
Eksempel på komplekst: &lt;tag booleanAttr="1"&gt; eller &lt;tag booleanAttr="true"&gt;
Single Tag Style = (html|XML)
Eksempel på html: &lt;single_tag&gt;
Eksempel på XML:  &lt;single_tag /&gt;
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 "&lt;". 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. &lt;!-- --&gt;
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)
</markup
>
</literallayout>
</informalexample>
</sect3>

<sect3 id="family-two-structure-3-2">
<title
>Struktur for familie 2</title>

<informalexample>
<literallayout
><markup>
[General] - Generel information.
Version = Brug 1 for &quantaplus; version &lt;= 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: &lt;tag booleanAttr&gt;.
Eksempel på komplekst: &lt;tag booleanAttr="1"&gt; eller &lt;tag booleanAttr="true"&gt;
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 "&lt;". 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. &lt;!-- --&gt;
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: &lt;? ?&gt;, &lt;* *&gt;, &lt;% %&gt;
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 })
</markup
>
</literallayout>
</informalexample>
</sect3>
</sect2>
</sect1>

<sect1 id="creating-toolbars-3-2">
<title
>Opret værktøjslinjer</title>

<para
>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 <ulink url="http://tidy.sf.net"
>&HTML; Tidy</ulink
> på vore netsider. </para>

<sect2 id="from-scratch-to-complete-3-2">
<title
>Fra begyndelsen til en færdig værktøjslinje</title>

<para
>Til at begynde med, skal du oprette en brugerværktøjslinje. Vælg <menuchoice
> <guimenu
>Værktøjslinjer </guimenu
> <guimenuitem
>Tilføj brugerværktøjslinje</guimenuitem
> </menuchoice
>. </para>

<para
>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. </para>

<para
>Så snart alle værktøjslinjer er oprettet, skal du tilføje og tilrette handlingerne. For at gøre det, vælges <menuchoice
> <guimenu
>Opsætning</guimenu
> <guimenuitem
>Indstil handlinger</guimenuitem
> </menuchoice
> <emphasis
> </emphasis
>. </para>

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

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

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

<para
>Du bør nu have noget som ligner følgende: </para>

<mediaobject>
<imageobject>
<imagedata fileref="dtep_doc_img7.png" format="PNG"/>
</imageobject>
</mediaobject>

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

<mediaobject>
<imageobject>
<imagedata fileref="dtep_doc_img8.png" format="PNG"/>
</imageobject>
</mediaobject>

<para
>Å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. </para>

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

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

<para
>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;. </para>

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

<mediaobject>
<imageobject>
<imagedata fileref="dtep_doc_img15.png" format="PNG"/>
</imageobject>
</mediaobject>

<para
>Nu når ikonen er færdigoprettet, gemmer vi den. </para>

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

<para
>Vælg <guilabel
>Øvrige ikoner</guilabel
> og klik derefter på knappen <guibutton
>Gennemsøg...</guibutton
>. </para>

<para
>Gå til mappen hvor du gemte ikonen, vælg den og klik på <guibutton
>O.k.</guibutton
>. </para>

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

<mediaobject>
<imageobject>
<imagedata fileref="dtep_doc_img18.png" format="PNG"/>
</imageobject>
</mediaobject>

<para
>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 <guilabel
>Indstil værktøjslinjer</guilabel
> ved at vælge <menuchoice
> <guimenu
>Opsætning</guimenu
> <guimenuitem
>Indstil værktøjslinjer</guimenuitem
> </menuchoice
>. Sørg for at vores værktøjslinje er valgt. </para>

<para
>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. </para>

<mediaobject>
<imageobject>
<imagedata fileref="dtep_doc_img21.png" format="PNG"/>
</imageobject>
</mediaobject>

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

<mediaobject>
<imageobject>
<imagedata fileref="dtep_doc_img22.png" format="PNG"/>
</imageobject>
</mediaobject>

<para
>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. </para>

<mediaobject>
<imageobject>
<imagedata fileref="dtep_doc_img23.png" format="PNG"/>
</imageobject>
</mediaobject>

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

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

<mediaobject>
<imageobject>
<imagedata fileref="dtep_doc_img24.png" format="PNG"/>
</imageobject>
</mediaobject>

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

<mediaobject>
<imageobject>
<imagedata fileref="dtep_doc_img25.png" format="PNG"/>
</imageobject>
</mediaobject>

<para
>For nu at gemme værktøjslinjen, vælger vi <menuchoice
> <guimenu
>Værktøjslinjer</guimenu
> <guisubmenu
>Gem værktøjslinjer</guisubmenu
> <guimenuitem
>Gem som lokal værktøjslinje</guimenuitem
> </menuchoice
>. </para>

<para
>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. </para>
</sect2>
</sect1>


<sect1 id="creating-quanta-docs-3-2">
<sect1info>
<title
>Opret din egen dokumentation</title>
<authorgroup>
<author
><firstname
>Robert</firstname
> <surname
>Nickel</surname
> <affiliation
> <address
><email
>robert@artnickel.com</email
></address>
</affiliation>
</author>

&erik.kjaer.pedersen.role; 

</authorgroup>
</sect1info>

<title
>Opret din egen dokumentation</title>

<para
>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. </para>

<para
>Inden du begynder på at oprette din egen dokumentation, vil du måske kigge på <ulink url="http://quanta.sf.net/main1.php?contfile=resource"
>&quantaplus;s arkiv</ulink
> for at se om nogen allerede har lavet denne opsætning. </para>

<para
>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 <filename
>docrc</filename
>-filen. Det første må du klare selv, det andet er hvad vi dækker her. </para>

<para
>Den almindelige form for docrc-filen er følgende: </para>

<informalexample>
<literallayout
>#KDE konfigurationsfil
[Tree]
Doc dir=<replaceable
>søgesti, relativt til denne fil, for dokumentationens HTML-filer</replaceable
> t.ex. php42/
#toppniveauelement
Top Element=<replaceable
>Din beskrivelse af disse dokumenter</replaceable
> t.ex. <acronym
>PHP</acronym
> 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
</literallayout>
</informalexample>

<para
>Filen <filename
>docrc</filename
> er opdelt i to afdelinger: Tree (træ) og Context (Sammenhæng). </para>

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

<mediaobject>
<imageobject>
<imagedata fileref="doc-view1.png" format="PNG"/>
</imageobject>
</mediaobject>

<para
>Med reference til ovenstående, ser min &PHP; <filename
>docrc</filename
> sådan her ud: </para>

<informalexample>
<literallayout
>#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
...

</literallayout>
</informalexample>

<para
>Bemærk <literal
>#</literal
> foran <quote
>Kom i gang</quote
> og <quote
>Sprogreference</quote
>. 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) &mdash; brug din egen dømmekraft. </para>

<para
>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). </para>

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

<para
>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 <function
>mysql_fetch_array</function
>, markerer du helt enkelt funktionen og trykker derefter på <keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
> for sammenhængsafhængig hjælp. Dokumentationen om <function
>mysql_fetch_array</function
> vises umiddelbart. Der findes kun to typer af indgange her: sammenhængslisten og filassociationslinjerne. </para>

<variablelist>
<varlistentry>
<term
>Sammenhængsliste</term>
<listitem>
<para
>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;). </para>
</listitem>
</varlistentry>
<varlistentry>
<term
>Filassociationslinjer</term>
<listitem>
<para
>De er på formen sammenhængspunkt = HTML-dokumentside. F.eks. acos=function.acos.html. </para>
</listitem>
</varlistentry>
</variablelist>

<para
>En renset version af mit <filename
>docrc</filename
> sammenhængsafsnit ser ud som følger: </para>

<informalexample>
<literallayout
>#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
...
</literallayout>
</informalexample>

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

<para
>Du skal genstarte &quantaplus;, for at se din dokumentation. </para>

<para
>Når du er sikker på at de er gode, og værd at dele, send så <filename
>docrc</filename
>-filen sammen med med en beskrivelse af passende information om hvilket dokument du brugte til <ulink url="http://quanta.sf.net/main1.php?contfile=resource"
>&quantaplus;s arkiv</ulink
> 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. </para>

</sect1>
</chapter>
