You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tde-i18n/tde-i18n-nl/docs/tdewebdev/quanta/extending-quanta.docbook

1347 lines
57 KiB

<?xml version="1.0" encoding="UTF-8" ?>
<chapter id="extending-quanta-3-2">
<chapterinfo>
<title>&quantaplus; uitbreiden</title>
<authorgroup>
<author><firstname>Christopher</firstname> <surname>Hornbaker</surname> <affiliation> <address><email>chrishornbaker@earthlink.net</email></address>
</affiliation>
</author>
<author><firstname>Andr&#225;s</firstname> <surname>Mantia</surname> <affiliation> <address><email>amantia@kde.org</email></address>
</affiliation>
</author>
&Sander.Koning;&Tom.Albers;
</authorgroup>
</chapterinfo>
<title>&quantaplus; uitbreiden</title>
<para>Dit hoofdstuk beschrijft hoe u &quantaplus; aan uw eigen wensen kunt aanpassen en hoe u kunt helpen &quantaplus; te verbeteren. </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>Document Type Editing Package (&DTEP;)</title>
<para>Document Type Editing Packages (&DTEP;'s) worden in &quantaplus; gebruikt om ondersteuning voor opmaak- en scripttalen en &CSS; te bieden. Ze zorgen ervoor dat &quantaplus; auto-aanvulling en 'node'-boomstructuren kan bieden. Omdat ze eenvoudig en flexibel zijn, is &quantaplus; een snelle en gebruiksvriendelijke &IDE; voor webontwikkelaars. Ze zorgen ervoor dat &quantaplus; een eenvoudig te gebruiken en productieve omgeving is. </para>
<para>Er zijn twee soorten &DTEP;'s. 'Family 1' voor opmaak en 'Family 2' voor scripting en &CSS;. &DTEP;'s bestaan uit twee delen: de Tagmap en de Werkbalken. Tagmappen bestaan op hun beurt uit twee soorten bestanden: het bestand &descriptionrc; en TagXML-bestanden met de extensie .tag. Werkbalken zijn de handige pictogrambalken (boven het editorvenster) die tekst in een document kunnen plaatsen sneller dan de gebruiker kan typen. </para>
<para>&DTEP;'s kunnen handmatig worden gemaakt (zie onder), <link linkend="download-resources">gedownload worden</link>, of automatisch worden aangemaakt vanuit een bestaande DTD. Zie <xref linkend="converting-dtd"/> voor details over deze omzetting. </para>
<para>Dit document beschrijft hoe u TagXML-bestanden, het bestand &descriptionrc; en werkbalken maakt. Kortweg een &DTEP;. </para>
<para>TagXML-bestanden (.tag) definiëren de attributen die specifiek voor een tag zijn en de opmaak en inhoud van het eigenschappenvenster dat &quantaplus; voor de tag opent. Het bestand bevat regels &descriptionrc;en informatie voor de &DTEP; zelf. Werkbalken bieden een snelle mogelijkheid om tags in een document in te voegen zonder angst voor typefouten en dergelijke. </para>
<sect2 id="dtep-packaging-3-2">
<title>Bundelen</title>
<para>Tagmappen zijn eigenlijk gewoon mappen. Ze bestaan echter alleen uit het bestand en de TagXML-&descriptionrc;bestanden. De naam van een tagmap geeft de opmaaktaal en de gebruikte versie daarvan aan. Bijvoorbeeld html-4.01-strict. </para>
</sect2>
<sect2 id="tagxml-3-2">
<title>TagXML</title>
<para>De onderstaande tabel geeft een overzicht van de elementen die in TagXML gedefinieerd zijn en of deze verplicht zijn of niet. Hoewel niet alle elementen verplicht zijn, wordt het aanbevolen dat u er zo veel mogelijk gebruikt, opdat andere gebruikers er beter mee kunnen werken. </para>
<informaltable>
<tgroup cols="3">
<thead>
<row>
<entry>Element</entry>
<entry>Standaardgebruik</entry>
<entry>Gebruik</entry>
</row>
</thead>
<tbody>
<row>
<entry>TAGS</entry>
<entry>verplicht</entry>
<entry>altijd</entry>
</row>
<row>
<entry>tag</entry>
<entry>verplicht</entry>
<entry>altijd</entry>
</row>
<row>
<entry>label</entry>
<entry>optioneel</entry>
<entry>verplicht voor het aanmaken van een eigenschappenvenster</entry>
</row>
<row>
<entry>attr</entry>
<entry>optioneel</entry>
<entry>verplicht voor het definiëren van een attribuut</entry>
</row>
<row>
<entry>tooltip</entry>
<entry>optioneel</entry>
<entry>verplicht als het eigenschappenvenster een hulpballon moet weergeven</entry>
</row>
<row>
<entry>whatsthis</entry>
<entry>optioneel</entry>
<entry>verplicht als het eigenschappenvenster een <quote>Wat is dit?</quote> moet weergeven</entry>
</row>
<row>
<entry>list</entry>
<entry>optioneel</entry>
<entry>verplicht als een attribuut van het type <quote>list</quote> is</entry>
</row>
<row>
<entry>item</entry>
<entry>optioneel</entry>
<entry>verplicht als &lt;list> gebruikt wordt</entry>
</row>
<row>
<entry>textlocation</entry>
<entry>optioneel</entry>
<entry>altijd</entry>
</row>
<row>
<entry>location</entry>
<entry>optioneel</entry>
<entry>verplicht als label gebruikt wordt</entry>
</row>
<row>
<entry>text</entry>
<entry>optioneel</entry>
<entry>verplicht als label gebruikt wordt</entry>
</row>
<row>
<entry>children</entry>
<entry>optioneel</entry>
<entry>lijst met tags die binnen de gedefinieerde tag gebruikt kunnen worden</entry>
</row>
<row>
<entry>child</entry>
<entry>verplicht</entry>
<entry>een children-item</entry>
</row>
<row>
<entry>stoppingtags</entry>
<entry>optioneel</entry>
<entry>lijst met tags waardoor een andere tag gesloten wordt</entry>
</row>
<row>
<entry>stoppingtag</entry>
<entry>verplicht</entry>
<entry>een stoppingtags-item</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<sect3 id="dtep-element-descriptions-3-2">
<title>Beschrijving van de TagXML-elementen</title>
<para>De volgende secties beschrijven elk element in detail. Alles, van waar ze gebruikt kunnen worden tot wat ze kunnen bevatten, wordt op een eenvoudige manier aangegeven. </para>
<sect4 id="TAGS-3-2">
<title>TAGS</title>
<para>Dit is het basiselement van een TagXML-document. Het mag slechts één keer in een document voorkomen. Het kan meerdere tagdefinities bevatten. Dit element kan alleen andere elementen bevatten. </para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Bovenliggende items</entry>
<entry>Subitems</entry>
</row>
</thead>
<tbody>
<row>
<entry><emphasis>GEEN</emphasis></entry>
<entry>tag</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>
<sect4 id="tag-3-2">
<title>tag</title>
<para>Omliggende definitie van de tag. Dit element kan alleen andere elementen bevatten. </para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Bovenliggende items</entry>
<entry>Subitems</entry>
</row>
</thead>
<tbody>
<row>
<entry>TAGS</entry>
<entry>label, attr, stoppingtags</entry>
</row>
</tbody>
</tgroup>
</informaltable>
<informaltable>
<tgroup cols="6">
<thead>
<row>
<entry>Attribuut</entry><entry>Type</entry><entry>Waarden</entry>
<entry>Standaard</entry><entry>Gebruik</entry><entry>Beschrijving</entry>
</row>
</thead>
<tbody>
<row>
<entry>name</entry><entry>string</entry><entry></entry><entry></entry>
<entry>verplicht</entry><entry>De naam van de tag.</entry>
</row>
<row>
<entry>single</entry><entry>boolean</entry><entry></entry><entry></entry>
<entry>optioneel</entry><entry>Geeft aan of de tag een sluittag (&lt;/tagnaam>) vereist.</entry>
</row>
<row>
<entry>type</entry><entry>string</entry><entry></entry><entry>xmltag</entry>
<entry>optioneel</entry><entry>Het type van de tag.</entry>
</row>
<row>
<entry></entry><entry></entry><entry>xmltag</entry><entry></entry>
<entry></entry><entry>Het type van de tag is XML-gebaseerd (alleen Family 1).</entry>
</row>
<row>
<entry></entry><entry></entry><entry>entiteit</entry><entry></entry>
<entry></entry><entry>De tag beschrijft een entiteit (alleen Family 1).</entry>
</row>
<row>
<entry></entry><entry></entry><entry>property</entry><entry></entry>
<entry></entry><entry>Het type van de tag is &CSS;-gerelateerd (alleen Family 2).</entry>
</row>
<row>
<entry></entry><entry></entry><entry>function</entry><entry></entry>
<entry></entry><entry>Het type van de tag is een scriptfunctie. In dit geval worden &lt;attr&gt; als argumenten van de functie gebruikt. (Alleen Family 2.)</entry>
</row>
<row>
<entry></entry><entry></entry><entry>class</entry><entry></entry>
<entry></entry><entry>Het type van de tag is een scriptklasse. (Alleen Family 2.)</entry>
</row>
<row>
<entry></entry><entry></entry><entry>method</entry><entry></entry>
<entry></entry><entry>Het type van de tag is een klassemethode. (Alleen Family 2.)</entry>
</row>
<row>
<entry>returnType</entry><entry>string</entry><entry></entry><entry>void </entry>
<entry>optioneel</entry><entry>Het 'returntype' van de tag.</entry>
</row>
<row>
<entry></entry><entry></entry><entry>void</entry><entry></entry>
<entry></entry><entry>Het type retourneert void.</entry>
</row>
<row>
<entry></entry><entry></entry><entry>int</entry><entry></entry>
<entry></entry><entry>Het type retourneert een int.</entry>
</row>
<row>
<entry></entry><entry></entry><entry>float</entry><entry></entry>
<entry></entry><entry>Het type retourneert een float.</entry>
</row>
<row>
<entry></entry><entry></entry><entry>long</entry><entry></entry>
<entry></entry><entry>Het type retourneert een long.</entry>
</row>
<row>
<entry></entry><entry></entry><entry>string</entry><entry></entry>
<entry></entry><entry>Het type retourneert een string.</entry>
</row>
<row>
<entry>version</entry><entry>string</entry><entry></entry><entry></entry>
<entry>optioneel</entry><entry>Geeft de versie van de taal aan waarvoor deze tag geldig is</entry>
</row>
<row>
<entry>extends</entry><entry>string</entry><entry></entry><entry></entry>
<entry>optioneel</entry><entry>Alleen geldig als het type van de tag "class" is. De naam van de basisklasse voor deze klasse. (Alleen Family 2).</entry>
</row>
<row>
<entry>class</entry><entry>string</entry><entry></entry><entry></entry>
<entry>optioneel</entry><entry>Alleen geldig als het type "method" is. De naam van de basisklasse voor deze methode. (Alleen Family 2).</entry>
</row>
<row>
<entry>common</entry><entry>boolean</entry><entry></entry><entry></entry>
<entry>optioneel</entry><entry>bij "ja" specificeert de tag een gemeenschappelijke attribuutgroep en kunnen de attributen in deze tag op elke andere tag toegepast worden. (Alleen Family 1.)</entry>
</row>
<row>
<entry>comment</entry><entry>string</entry><entry></entry><entry></entry>
<entry>optioneel</entry><entry>De commentaar-tekenreeks verschijnt bij de tagnaam in het aanvullingskader.</entry>
</row></tbody>
</tgroup>
</informaltable>
</sect4>
<sect4 id="label-3-2">
<title>label</title>
<para>Plaats een label in het dialoogvenster. De tekst wordt aangegeven in de tag &lt;text&gt;. Dit element kan alleen andere elementen bevatten. </para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Bovenliggende items</entry>
<entry>Subitems</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>Geeft een attribuut van de tag aan. Voor elk attribuut wordt dit element opgegeven, dat de naam en het type van het attribuut aangeeft. Het bevat tevens tags die bijvoorbeeld aangeven hoe het attribuut moet worden weergegeven. In dit element kunnen alleen andere elementen voorkomen. </para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Bovenliggende items</entry>
<entry>Subitems</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>Attribuut</entry><entry>Type</entry><entry>Waarden</entry>
<entry>Standaard</entry><entry>Gebruik</entry><entry>Beschrijving</entry>
</row>
</thead>
<tbody>
<row>
<entry>name</entry><entry>string</entry><entry></entry><entry></entry>
<entry>verplicht</entry><entry>Geeft de naam van het attribuut aan.</entry>
</row>
<row>
<entry>type</entry><entry>string</entry><entry></entry><entry>input</entry>
<entry>verplicht</entry><entry>Geeft het type van het attribuut aan.</entry>
</row>
<row>
<entry></entry><entry></entry><entry>input</entry><entry></entry>
<entry></entry><entry>Het veld ondersteunt willekeurige tekst (tekstveld).</entry>
</row>
<row>
<entry></entry><entry></entry><entry>check</entry><entry></entry>
<entry></entry><entry>De veldwaarde is een boolean (selectievakje).</entry>
</row>
<row>
<entry></entry><entry></entry><entry>color</entry><entry></entry>
<entry></entry><entry>De veldwaarde is een kleur.</entry>
</row>
<row>
<entry></entry><entry></entry><entry>url</entry><entry></entry>
<entry></entry><entry>De veldwaarde is een &URL; (lokaal bestand om naar te verwijzen).</entry>
</row>
<row>
<entry></entry><entry></entry><entry>list</entry><entry></entry>
<entry></entry><entry>De veldwaarde is een item van een opgegeven lijst.</entry>
</row>
<row>
<entry>status</entry><entry>string</entry><entry></entry><entry>optioneel</entry>
<entry>verplicht</entry><entry>Geeft aan of het argument wel of niet verplicht is (alleen Family 2).</entry>
</row>
<row>
<entry></entry><entry></entry><entry>optioneel</entry><entry></entry>
<entry></entry><entry>Het argument is optioneel.</entry>
</row>
<row>
<entry></entry><entry></entry><entry>verplicht</entry><entry></entry>
<entry></entry><entry>Het argument is verplicht.</entry>
</row>
<row>
<entry></entry><entry></entry><entry>implied</entry><entry></entry>
<entry></entry><entry>Het argument is impliciet.</entry>
</row>
<row>
<entry>bron</entry><entry>string</entry><entry></entry><entry></entry>
<entry>optioneel</entry><entry>Specificeert de bronnen die gebruikt worden om het attribuut in te vullen in het editor-dialoogvenster en de attributen-boomstructuur.</entry>
</row>
<row>
<entry></entry><entry></entry><entry>selection</entry><entry></entry>
<entry></entry><entry>De geselecteerde tekst wordt als bron gebruikt</entry>
</row>
<row>
<entry></entry><entry></entry><entry>dcop</entry><entry></entry>
<entry></entry><entry>Het resultaat van een DCOP-methode wordt als bron gebruikt.</entry>
</row>
<row>
<entry>interface</entry><entry>string</entry><entry></entry><entry></entry>
<entry>optioneel</entry><entry>Vereist source="dcop". De DCOP-interface vanuit &quantaplus; die gebruikt wordt om de brondata te verkrijgen.</entry>
</row>
<row>
<entry>method</entry><entry>string</entry><entry></entry><entry></entry>
<entry>optioneel</entry><entry>Vereist source="dcop" en een interfacenaam. De DCOP-methodenaam vanuit &quantaplus; die gebruikt wordt om de brondata te verkrijgen.</entry>
</row>
<row>
<entry>argumenten</entry><entry>string</entry><entry></entry><entry></entry>
<entry>optioneel</entry><entry>Vereist source="dcop", een interface en een methodenaam. De argumenten die aan de methode worden meegegeven. Dit kan leeg zijn of "%tagname%" voor de nam van de huidige tag.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>
<sect4 id="tooltip-3-2">
<title>tooltip</title>
<para>Definieert de tekstballon voor een veld in het dialoogvenster. Dit element kan alleen tekst bevatten. </para>
<note>
<para>Op het moment wordt alleen platte tekst ondersteund (u kunt geen opmaak gebruiken). </para>
</note>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Bovenliggende items</entry>
<entry>Subitems</entry>
</row>
</thead>
<tbody>
<row>
<entry>attr</entry>
<entry><emphasis>GEEN</emphasis></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>
<sect4 id="whatsthis-3-2">
<title>whatsthis</title>
<para>Definieert de 'Wat is dit'-hulptekst voor een veld in het dialoogvenster. Dit element kan alleen tekst bevatten. </para>
<note>
<para>Op het moment wordt alleen platte tekst ondersteund (u kunt geen opmaak gebruiken). </para>
</note>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Bovenliggende items</entry>
<entry>Subitems</entry>
</row>
</thead>
<tbody>
<row>
<entry>attr</entry>
<entry><emphasis>GEEN</emphasis></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>
<sect4 id="list-3-2">
<title>list</title>
<para>Een tag die de items samenvoegt in een lijst. Kan slechts één keer voorkomen per attribuutbeschrijving. Dit element kan alleen andere elementen bevatten. </para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Bovenliggende items</entry>
<entry>Subitems</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>Definieert een item in een lijst. In dit element kan alleen tekst voorkomen. </para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Bovenliggende items</entry>
<entry>Subitems</entry>
</row>
</thead>
<tbody>
<row>
<entry>list</entry>
<entry><emphasis>GEEN</emphasis></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>
<sect4 id="textlocation-3-2">
<title>textlocation</title>
<para>Geeft de positie van de attribuuttekst van de tekst aan in een dialoogvenster. Deze tag kan slechts één keer per attribuut in het dialoogvenster voorkomen (&ie; één keer per &lt;attr> tag). Dit element is leeg (kan niets bevatten). </para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Bovenliggende items</entry>
<entry>Subitems</entry>
</row>
</thead>
<tbody>
<row>
<entry>attr</entry>
<entry><emphasis>GEEN</emphasis></entry>
</row>
</tbody>
</tgroup>
</informaltable>
<informaltable>
<tgroup cols="4">
<thead>
<row>
<entry>Attribuut</entry><entry>Type</entry>
<entry>Gebruik</entry><entry>Beschrijving</entry>
</row>
</thead>
<tbody>
<row>
<entry>row</entry><entry>nonNegativeInteger</entry>
<entry>verplicht</entry><entry>Geeft de rij in de dialoogopmaak van een veld of label aan.</entry>
</row>
<row>
<entry>col</entry><entry>nonNegativeInteger</entry>
<entry>verplicht</entry><entry>Geeft de kolom in de dialoogopmaak van een veld of label aan.</entry>
</row>
<row>
<entry>rowspan</entry><entry>nonNegativeInteger</entry>
<entry>optioneel</entry><entry>Geeft het aantal rijen aan dat een veld moet overspannen.</entry>
</row>
<row>
<entry>colspan</entry><entry>nonNegativeInteger</entry>
<entry>optioneel</entry><entry>Geeft het aantal kolommen aan dat een veld moet overspannen.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>
<sect4 id="location-3-2">
<title>location</title>
<para>Geeft de positie en grootte van een veld in het dialoogvenster aan. Deze tag dient één keer per veld in het dialoogvenster voor te komen (één keer voor elke &lt;attr&gt; of &lt;label&gt; tag). Dit element is leeg (kan niets bevatten). </para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Bovenliggende items</entry><entry>Subitems</entry>
</row>
</thead>
<tbody>
<row>
<entry>label, attr</entry><entry><emphasis>GEEN</emphasis></entry>
</row>
</tbody>
</tgroup>
</informaltable>
<informaltable>
<tgroup cols="4">
<thead>
<row>
<entry>Attribuut</entry><entry>Type</entry>
<entry>Gebruik</entry><entry>Beschrijving</entry>
</row>
</thead>
<tbody>
<row>
<entry>row</entry><entry>nonNegativeInteger</entry>
<entry>verplicht</entry><entry>Geeft de rij in de dialoogopmaak van een veld of label aan.</entry>
</row>
<row>
<entry>col</entry><entry>nonNegativeInteger</entry>
<entry>verplicht</entry><entry>Geeft de kolom in de dialoogopmaak van een veld of label aan.</entry>
</row>
<row>
<entry>rowspan</entry><entry>nonNegativeInteger</entry>
<entry>optioneel</entry><entry>Geeft het aantal rijen aan dat een veld moet overspannen.</entry>
</row>
<row>
<entry>colspan</entry><entry>nonNegativeInteger</entry>
<entry>optioneel</entry><entry>Geeft het aantal kolommen aan dat een veld moet overspannen.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>
<sect4 id="text-3-2">
<title>text</title>
<para>Geeft de tekst voor een label of selectievakje aan. Dit element kan alleen tekst bevatten. </para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Bovenliggende items</entry><entry>Subitems</entry>
</row>
</thead>
<tbody>
<row>
<entry>label, attr</entry><entry><emphasis>GEEN</emphasis></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>
<sect4 id="children-3-2">
<title>children</title>
<para>Geeft een lijst van elementen aan die binnen de tag kunnen voorkomen. In dit element kunnen alleen andere elementen voorkomen. </para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Bovenliggende items</entry><entry>Subitems</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>Definieert een subtag. Dit element is leeg. </para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Bovenliggende items</entry><entry>Subitems</entry>
</row>
</thead>
<tbody>
<row>
<entry>children</entry><entry><emphasis>GEEN</emphasis></entry>
</row>
</tbody>
</tgroup>
</informaltable>
<informaltable>
<tgroup cols="4">
<thead>
<row>
<entry>Attribuut</entry><entry>Type</entry><entry>Waarden</entry>
<entry>Gebruik</entry><entry>Beschrijving</entry>
</row>
</thead>
<tbody>
<row>
<entry>name</entry><entry>string</entry><entry></entry>
<entry>verplicht</entry><entry>Geeft een tag aan die binnen een andere tag kan voorkomen.</entry>
</row>
<row>
<entry>gebruik</entry><entry>string</entry><entry></entry>
<entry>optioneel</entry><entry>Geeft de relatie met de bovenliggende tag aan.</entry>
</row>
<row>
<entry></entry><entry></entry><entry>verplicht</entry>
<entry></entry><entry>De bovenliggende tag moet minstens één kind met deze naam hebben.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>
<sect4 id="stoppingtags-3-2">
<title>stoppingtags</title>
<para>Geeft een lijst met elementen aan die het einde van een tag dwingen. In dit element kunnen alleen andere elementen voorkomen. </para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Bovenliggende items</entry><entry>Subitems</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>Geeft een beëindigende tag aan. Dit element is leeg. </para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>Bovenliggende items</entry><entry>Subitems</entry>
</row>
</thead>
<tbody>
<row>
<entry>stoppingtags</entry><entry><emphasis>GEEN</emphasis></entry>
</row>
</tbody>
</tgroup>
</informaltable>
<informaltable>
<tgroup cols="4">
<thead>
<row>
<entry>Attribuut</entry><entry>Type</entry>
<entry>Gebruik</entry><entry>Beschrijving</entry>
</row>
</thead>
<tbody>
<row>
<entry>name</entry><entry>string</entry>
<entry>verplicht</entry><entry>Geeft aan welke tags het einde van een andere tag afdwingen.</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</sect4>
</sect3>
<sect3 id="tagxml-usage-3-2">
<title>Het gebruik van TagXML</title>
<para>Alle TagXML-bestanden moeten beginnen met de &XML;-declaratie: &lt;?xml version="1.0" encoding="UTF-8"?> en moeten correct genest en gesloten zijn. </para>
<important>
<para>U kunt veilig witruimte gebruiken, maar let wel op de tekens &amp; en &lt;. Deze dient u te vervangen door &amp;amp; respectievelijk &amp;lt; in elementen als &lt;tooltip>, &lt;whatsthis> en &lt;text>. Als u dit niet doet zal er geen crash optreden, maar u zult wel delen van uw werk verliezen. </para>
</important>
</sect3>
<sect3 id="tagxml-validation-3-2">
<title>Validatie van TagXML</title>
<para>Om uw TagXML-bestanden te valideren kiest u <quote>Gereedschap</quote> bovenaan het venster van &quantaplus; en kiest u daar <quote>Valideren</quote>. Er verschijnt een dialoogvenster waarin u alleen maar de aanwijzingen hoeft op te volgen. </para>
<note>
<para>Op het moment is deze functie nog niet aanwezig. Validatie vindt nu plaats op het moment dat een TagXML-bestand in &quantaplus; wordt ingeladen. </para>
</note>
</sect3>
<sect3 id="tagxml-examples-3-2">
<title>Voorbeelden van TagXML</title>
<sect4 id="family-one-3-2">
<title>Family 1</title>
<para>Hieronder ziet u een geldig Family 1-TagXML-bestand. Dit bestand beschrijft &W3C; &XML; Schema's element &lt;schema>. De bestandsnaam van dit fragment zou schema.tag zijn. Simpel, nietwaar? </para>
<informalexample>
<literallayout><markup>
&lt;?xml version="1.0" encoding="UTF-8"?>
&lt;!DOCTYPE TAGS>
&lt;TAGS>
&lt;tag name="schema">
&lt;label>
&lt;text>id&lt;/text>
&lt;location col="0" row="0"/>
&lt;/label>
&lt;attr name="id" type="input">
&lt;tooltip>Een uniek ID-nummer voor het element.&lt;/tooltip>
&lt;whatsthis>Een uniek ID-nummer voor het element.&lt;/whatsthis>
&lt;location col="1" row="0"/>
&lt;/attr>
&lt;label>
&lt;text>version&lt;/text>
&lt;location col="0" row="1"/>
&lt;/label>
&lt;attr name="version" type="input">
&lt;tooltip>Versie van het schema.&lt;/tooltip>
&lt;whatsthis>Versie van het schema.&lt;/whatsthis>
&lt;location col="1" row="1"/>
&lt;/attr>
&lt;label>
&lt;text>targetNamespace&lt;/text>
&lt;location col="0" row="2"/>
&lt;/label>
&lt;attr name="targetNamespace" type="input">
&lt;tooltip>&URI;-verwijzing naar de namespace van dit schema.&lt;/tooltip>
&lt;whatsthis>&URI;-verwijzing naar de namespace van dit schema.&lt;/whatsthis>
&lt;location col="1" row="2"/>
&lt;/attr>
&lt;label>
&lt;text>xmlns&lt;/text>
&lt;location col="0" row="3"/>
&lt;/label>
&lt;attr name="xmlns" type="input">
&lt;tooltip>&URI;-verwijzing naar een of meerdere namespaces om in dit schema te gebruiken.
Als geen voorvoegsel is opgegeven, mogen componenten van de betreffende namespace ongekwalificeerd gebruikt worden.&lt;/tooltip>
&lt;whatsthis>&URI;-verwijzing naar een of meerdere namespaces om in dit schema te gebruiken.
Als geen voorvoegsel is opgegeven, mogen componenten van de betreffende namespace ongekwalificeerd gebruikt worden.&lt;/whatsthis>
&lt;location col="1" row="3"/>
&lt;/attr>
&lt;label>
&lt;text>attributeFormDefault&lt;/text>
&lt;location col="0" row="4"/>
&lt;/label>
&lt;attr name="attributeFormDefault" type="list">
&lt;items>
&lt;item>qualified&lt;/item>
&lt;item>unqualified&lt;/item>
&lt;/items>
&lt;tooltip>Standaardvorm voor alle atrributen in dit schema.&lt;/tooltip>
&lt;whatsthis>Standaardvorm voor alle attributen in dit schema.&lt;/whatsthis>
&lt;location col="1" row="4"/>
&lt;/attr>
&lt;label>
&lt;text>elementFormDefault&lt;/text>
&lt;location col="0" row="5"/>
&lt;/label>
&lt;attr name="elementFormDefault" type="list">
&lt;items>
&lt;item>qualified&lt;/item>
&lt;item>unqualified&lt;/item>
&lt;/items>
&lt;tooltip>Standaardvorm voor alle elementen in dit schema.&lt;/tooltip>
&lt;whatsthis>Standaardvorm voor alle elementen in dit schema.&lt;/whatsthis>
&lt;location col="1" row="5"/>
&lt;/attr>
&lt;label>
&lt;text>blockDefault&lt;/text>
&lt;location col="0" row="6"/>
&lt;/label>
&lt;attr name="blockDefault" type="input">
&lt;location col="1" row="6"/>
&lt;/attr>
&lt;label>
&lt;text>finalDefault&lt;/text>
&lt;location col="0" row="7"/>
&lt;/label>
&lt;attr name="finalDefault" type="input">
&lt;location col="1" row="7"/>
&lt;/attr>
&lt;/tag>
&lt;/TAGS>
</markup>
</literallayout>
</informalexample>
</sect4>
<sect4 id="family-two-3-2">
<title>Family 2</title>
<para>Hieronder vindt u een geldig Family 2-TagXML-bestand. Dit fragmentbeschrijft &PHP;'s functie overload. De bestandsnaam hiervoor zou overload.tag zijn. </para>
<informalexample>
<literallayout><markup>
&lt;?xml version="1.0" encoding="UTF-8"?>
&lt;!DOCTYPE tags>
&lt;tags>
&lt;tag name="overload" type="function" returnType="void">
&lt;attr name="class_name" type="string" status="optional"/>
&lt;/tag>
&lt;/tags>
</markup>
</literallayout>
</informalexample>
</sect4>
</sect3>
</sect2>
<sect2 id="descriptionrc-3-2">
<title>&descriptionrc;</title>
<para>Het bestand &descriptionrc; is ook redelijk eenvoudig en er is een editor voor beschikbaar vie <menuchoice><guimenu>DTD</guimenu><guimenuitem>DTD-instellingen bewerken</guimenuitem></menuchoice>. Hiermee bewerkt u de &descriptionrc; voor een &DTEP; die u uit een lijst kunt kiezen. Om de &descriptionrc; voor een nieuwe &DTEP; te bewerken is het handig om een eenvoudige &descriptionrc; te maken met het volgende: </para>
<para>
<informalexample>
<literallayout><markup>
[General]
Version = Gebruik 1 voor &quantaplus; versie &lt;=3.1.2 en 2 voor een nieuwere versie.
Name = DTD-definitie. (-//&W3C;//DTD HTML 4.01 Transitional//EN)
NickName = De mooier gemaakte naam van de DTD. (HTML 4.01 Transitional). Als dit niet opgegeven is wordt Name
gebruikt als NickName.
</markup>
</literallayout>
</informalexample>
</para>
<para>Als u deze aangemaakt hebt en naast de tagbestanden hebt geplaatst, laadt u de nieuw aangemaakte &DTEP; emt <menuchoice><guimenu>DTD</guimenu><guimenuitem>DTD-pakket (DTEP) laden</guimenuitem></menuchoice> en nadat deze ingeladen is kunt u doorgaan met het wijzigen van de instellingen van de &DTEP;. Kijk naar de ballonhulp en de "watisdit"-teksten in het editor-dialoogvenster om de betekenis van elk item te begrijpen. U kunt ook het bestand <filename>quanta/data/dtep/dtd-description.txt</filename> uit het bron-tar-archief lezen dat een beschrijving van het formaat bevat. </para>
</sect2>
</sect1>
<sect1 id="user-actions">
<title>Gebruiker-gedefinieerde acties</title>
<para>Acties komen veel in toepassingen vaak voor. U komt ze vaak tegen als u een toepassing gebruikt. Op een werkbalkpictogram klikken, een menu-item selecteren of een sneltoets gebruiken voert normaal gesproken een actie uit. In &quantaplus; worden acties op een hoger niveau geplaatst. In plaats van acties die door de programmeur van de applicatie vastgelegd zijn, kan de gewone gebruiker acties aanmaken en bewerken, en op deze manier nieuwe functionaliteit aan &quantaplus; toevoegen. Veel standaardacties binnen &quantaplus; zijn gebruiker-gedefinieerd en u kunt deze dan ook zelf bewerken. </para>
<para>Er zijn drie soorten gebruiker-gedefinieerde acties: <itemizedlist>
<listitem><para><link linkend="text-actions">Tekstacties</link></para></listitem>
<listitem><para><link linkend="tag-actions">Tagacties</link></para></listitem>
<listitem><para><link linkend="script-actions">Scriptacties</link></para></listitem>
</itemizedlist>
</para>
<sect2 id="creating-actions">
<title>Acties aanmaken</title>
<para>U kunt een actie aanmaken via <menuchoice><guimenu> Instellingen</guimenu><guimenuitem>Acties instellen</guimenuitem></menuchoice>. Klik op <guibutton>Nieuwe actie</guibutton> en u krijgt een vergelijkbaar dialoogvenster: <mediaobject> <imageobject>
<imagedata fileref="dtep_doc_img7.png" format="PNG"/>
</imageobject>
</mediaobject>
<variablelist>
<varlistentry>
<term><guilabel>Type</guilabel></term>
<listitem><para>Geeft het type aan (<link linkend="text-actions">tekst-</link>, <link linkend="tag-actions">tag-</link>, <link linkend="script-actions">script-</link>).</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Tekst</guilabel></term>
<listitem><para>De naam van de actie zoals de gebruiker die ziet.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>De knop naast het label <guilabel>Tekst</guilabel></term>
<listitem><para>Het pictogram voor deze actie. Klik op het pictogram om het te wijzigen.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Scherminfo</guilabel></term>
<listitem><para>Korte beschrijving van wat de actie doet.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Sneltoets</guilabel></term>
<listitem><para>De sneltoets die aan deze actie wordt toegewezen. Klik op <guilabel>Aangepast</guilabel> of de knop bij <guilabel>Aangepast</guilabel> om een sneltoets toe te wijzen, klik op <guilabel>Geen</guilabel> om de huidige sneltoets te verwijderen.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Containerbalken</guilabel></term>
<listitem><para>De gebruikergedefinieerde werkbalken waar deze actie voorkomt. Zie <xref linkend="creating-toolbars-3-2"/>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Gedetailleerde instellingen</guilabel></term>
<listitem><para>Specifieke instellingen voor de verschillende soorten acties. Zie hieronder. </para></listitem>
</varlistentry>
</variablelist>
</para>
</sect2>
<sect2 id="text-actions">
<title>Tekstacties</title>
<para>
<mediaobject><imageobject>
<imagedata fileref="text-action.png" format="PNG"/>
</imageobject></mediaobject> De eenvoudigste acties. U kunt tekst invoeren onder<guilabel>Gedetailleerde instellingen</guilabel> en als de actieuitgevoerd wordt, wordt die tekst in uw document op de huidigecursorpositie ingevoegd. Zie hieronder voor een voorbeeld. </para>
</sect2>
<sect2 id="tag-actions">
<title>Tagacties</title>
<para>Nuttig om XML-tags in te voegen, maar u kunt ze natuurlijk ook voor andere doelen gebruiken. <mediaobject><imageobject> <imagedata fileref="tag-actions.png" format="PNG"/> </imageobject></mediaobject> <variablelist> <varlistentry> <term><guilabel>&lt;tag&gt;</guilabel></term> <listitem><para>De naam van de tag.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>&lt;/tag&gt;</guilabel></term> <listitem><para>Als de actie wordt uitgevoerd, wordt deze tekst als sluittag ingevoegd. Als er een gebied in uw document geselecteerd is op het moment dat de actie wordt uitgevoerd, wordt &lt;tag&gt; voor, en &lt;/tag&gt; na het geselecteerde gebied geplaatst.</para></listitem> </varlistentry> <varlistentry> <term><guilabel>Dialoogvenster "Tag bewerken" starten indien beschikbaar</guilabel></term> <listitem><para>Als er een tagXML-bestand voor deze tag beschikbaar is, wordt er een dialoogvenster getoond waarin u de tag kunt bewerken, voordat de tag daadwerkelijk wordt ingevoegd.U kunt de attributen van de tag zo handmatig bewerken.</para></listitem> </varlistentry> </variablelist> &lt;tag&gt; en &lt;/tag&gt; worden ingevoegd zoals u hier opgeeft. &lt;, &gt; of / wordt niet automatisch toegevoegd. </para>
</sect2>
<sect2 id="script-actions">
<title>Scriptacties</title>
<para>
<mediaobject><imageobject>
<imagedata fileref="script-action.png" format="PNG"/>
</imageobject></mediaobject> Het krachtigste soort acties. Met behulp van deze acties kunt u externe toepassingen uitvoeren (normaliter scripts, maar andere applicaties zijn ook mogelijk), die (een deel van) uw document kunnen bewerken of gebruiken als invoer. Voorbeelden uit &quantaplus; zelf zijn het dialoogvenster <guibutton>Snelstarten</guibutton> en de diverse <guilabel>Tonen in...</guilabel> acties voor (X)HTML DTEP's. </para>
<para>Voer eerst de naam van uw script in, inclusief de interpreter. Bijvoorbeeld <command>sh /home/mijnmap/mijnscript.sh</command>. </para>
<para>Hoewel u volledige paden kunt gebruiken, wordt het aanbevolen om de variabele <command>%scriptdir</command> te gebruiken, zoals in <command>sh %scriptmap/mijnscript.sh</command>. &quantaplus; zal dan uw script op de volgende locaties zoeken: <itemizedlist> <listitem><para>globale scriptmap: <filename><envar>$TDEDIR</envar>/share/apps/quanta/scripts</filename></para></listitem> <listitem><para>lokale scriptmapr: <filename><envar>$TDEHOME</envar>/share/apps/quanta/scripts</filename></para></listitem> <listitem><para>uw pad: <envar>$PATH</envar></para></listitem> </itemizedlist> Verder kunt u de volgende speciale variabelen in de opdrachtregel gebruiken: <itemizedlist>
<listitem><para><command>%f</command>: wordt vervangen door de URL van het huidige document. Als u een lokaal document aan het bewerken bent zal het voorvoegsel file:/ weggehaald worden.</para></listitem>
<listitem><para><command>%input</command>: wordt vervangen door de geselecteerde invoer. Zie hieronder.</para></listitem>
<listitem><para><command>%projectbase</command>: wordt vervangen door de URL van het huidige project (is leeg als er geen project geladen is).</para></listitem>
<listitem><para><command>%pid</command>: wordt vervangen door het PID van het huidige&quantaplus;-proces. Als &quantaplus; in unieke modus wordt uitgevoerd, wordt de tekst "unique " voorgevoegd aan het PID-getal.Dit is nuttig als u DCOP gebruikt om &quantaplus; vanuit externe scripts aan te sturen.</para></listitem>
<listitem><para><command>%userarguments</command>: nuttig in het geval van gebeurtenissen. Dit wordt vervangen door de eigenschappen van de gebeurtenis, in deze volgorde: <variablelist>
<varlistentry>
<term>Eerste argument</term>
<listitem><para>Het unieke id van het script</para></listitem>
</varlistentry>
<varlistentry>
<term>Tweede argument</term>
<listitem><para>de gebeurtenisnaam</para></listitem>
</varlistentry>
<varlistentry>
<term>Derde argument</term>
<listitem><para>de parameters voor de gebeurtenis, normaal de bestandsnaam van het huidige document of het pad naar het projectbestand.</para></listitem>
</varlistentry>
</variablelist>
</para></listitem>
</itemizedlist>
</para>
<para>Naast de bovenstaande methodes kan het script ook invoer van &quantaplus; ontvangen via standaardinvoer. In de keuzelijst <guilabel>Invoer</guilabel> kunt u kiezen wat er via standaardinvoer aan het script verzonden moet worden. U kunt kiezen uit: <itemizedlist>
<listitem><para><guilabel>Geen</guilabel>: er wordt niets verzonden.</para></listitem>
<listitem><para><guilabel>Huidig document</guilabel>: het gehele document wordt verzonden.</para></listitem>
<listitem><para><guilabel>Geselecteerde tekst</guilabel>: het geselecteerde gebied in het doucment wordt naar het script verzonden. De variabele <command>%input</command> is meestal alleen nuttig als u deze optie kiest.</para></listitem>
</itemizedlist>
</para>
<para>Analoog aan het sturen van <guilabel>Invoer</guilabel> kunt u ook de uitvoer van de uitgevoerde applicatie ontvangen. Er zijn twee soorten uitvoer: <itemizedlist> <listitem><para>normale uitvoer (via standaarduitvoer);</para> </listitem> <listitem><para>foutmeldingen (via standaardfoutuitvoer).</para> </listitem> </itemizedlist> U kunt opgeven wat er met de teruggegeven uitvoer moet gebeuren. Dit doet u door de waarde van de keuzelijst <guilabel>Uitvoer</guilabel> aan te passen: <itemizedlist>
<listitem><para><guilabel>Geen</guilabel>: de uitvoer wordt genegeerd.</para></listitem>
<listitem><para><guilabel>Bij cursorpositie invoegen</guilabel>: de uitvoer wordt op de huidige cursorpositie in het document ingevoegd.</para></listitem>
<listitem><para><guilabel>Selectie vervangen</guilabel>: het geselecteerde gebied in hetdocument wordt vervangen door de uitvoer.</para></listitem>
<listitem><para><guilabel>Selectie vervangen</guilabel>: het geselecteerde gebied in hetdocument wordt vervangen door de uitvoer.</para></listitem>
<listitem><para><guilabel>Nieuw document aanmaken</guilabel>: een nieuw document wordt aangemaakt dat de uitvoer van het script bevat.</para></listitem>
<listitem><para><guilabel>Huidig document vervangen</guilabel>: de volledige inhoud van het huidige document wordt vervangen door de uitvoer.</para></listitem>
<listitem><para><guilabel>Berichtenvenster</guilabel>: de uitvoer verschijnt in het venster <guilabel>Berichten</guilabel>.</para></listitem>
</itemizedlist>
</para>
<para>Voor de standaardfoutuitvoer (<guilabel>Fout</guilabel>) kunt u dezelfde keuzes maken als voor de gewone uitvoer.</para>
</sect2>
</sect1>
<sect1 id="creating-toolbars-3-2">
<title>Werkbalken aanmaken</title>
<para>Het volgende deel laat u zien hoe u werkbalken voor een &DTEP; aanmaakt. Werkbalken zijn grafische elementen die aan acties worden toegewezen.In &quantaplus; vormen acties de basis voor bijna alle uitbreidingendie in &quantaplus; beschikbaar zijn of zullen worden. Hetzelfdemechanisme dat een actie in &quantaplus; definieert, maakt ook autoaanvulling en tagdialoogvensters mogelijk. U kunt met acties bijna alles doen wat u wilt. Als voorbeeld gebruiken we <ulink url="http://tidy.sf.net">&HTML; tidy</ulink> op onze webpagina's. </para>
<sect2 id="from-scratch-to-complete-3-2">
<title>Van niets tot een geheel</title>
<para>Als eerste hebt u een gebruiker-werkbalk nodig. Kies<menuchoice> <guimenu>Werkbalken</guimenu> <guimenuitem>Gebruiker-werkbalk toevoegen</guimenuitem> </menuchoice>. </para>
<para>Als er veel tags in de opmaaktaal zitten, wordt het aanbevolen dat u de tags in logische groepen verdeelt. Voor elke groep is dan een nieuwe gebruiker-werkbalk benodigd. In dit geval zijn er niet veel tags, dus maken we één werkbalk en geven die de naam van de opmaaktaal. </para>
<para>Nadat uw werkbalken aangemaakt zijn, moeten er acties worden toegevoegd en ingesteld. Kies hiervoor <menuchoice> <guimenu>Instellingen</guimenu> <guimenuitem>Acties instellen</guimenuitem> </menuchoice> <emphasis> </emphasis>. </para>
<para>Dit venster is redelijk zelfverklarend. Kies <guibutton>Nieuwe actie</guibutton> onderaan het venster om over te schakelen naar de bewerkmodus. </para>
<para>Vul alle verplichte velden in en voeg de tag toe aan de gewenste werkbalk(en). </para>
<para>Vul de overige velden in, en als de tag attributen bevat die u telkens wilt gebruiken, activeert u <guilabel>Dialoogvenster "Tag bewerken" starten indien beschikbaar</guilabel>. </para>
<para>U zou nu iets moeten hebben dat erg op het volgende lijkt. </para>
<mediaobject>
<imageobject>
<imagedata fileref="dtep_doc_img7.png" format="PNG"/>
</imageobject>
</mediaobject>
<para>Klik op de knop <guibutton>Toepassen</guibutton> en u zult de actietoegevoegd zien aan de werkbalk(en) die u gekozen had. </para>
<mediaobject>
<imageobject>
<imagedata fileref="dtep_doc_img8.png" format="PNG"/>
</imageobject>
</mediaobject>
<para>Hmmm... dat is een afschuwelijk pictogram. Hoe kunnen u en anderen onthouden welke actie er bij welk pictogram hoort? Laten we het vervangen voordat er problemen ontstaan. </para>
<para>Om een pictogram te maken dat de actie nauwkeuriger weergeeft, maken we gebruik van &tdeiconedit;. Start dit via het &kmenu;, <menuchoice> <guisubmenu>Grafisch</guisubmenu> <guisubmenu>Meer programma's</guisubmenu> </menuchoice> (of waar uw distributie het ook geplaatst heeft). </para>
<para>&tdeiconedit; maakt standaard pictogrammen van 32x32 pixels, maar wij hebben 22x22 nodig. Verander dit met <menuchoice> <guimenu>Bewerken</guimenu> <guimenuitem>Grootte wijzigen</guimenuitem> </menuchoice>. </para>
<para>Onthoud dat u een pictogram maakt dat niet alleen uzelf eraanherinnert welke actie erbij hoort, maar ook andere gebruikers van de &DTEP;. </para>
<para>Omdat de tag waar ik een pictogram voor nodig heb <quote>start</quote> heet, heb ik besloten om een <quote>start-teken</quote> te maken. Met de kleur groen (die veel gebruikt wordt voor <quote>gaan</quote>, <quote>starten</quote> of <quote>doorgaan</quote>) zal de gebruiker snel zien dat dit de tag &lt;start&gt; in het huidige document plaatst. (Althans, dat is de bedoeling.) </para>
<mediaobject>
<imageobject>
<imagedata fileref="dtep_doc_img15.png" format="PNG"/>
</imageobject>
</mediaobject>
<para>Nu het pictogram klaar is, sla ik het op. </para>
<para>Als u klaar bent met het aanmaken van uw pictogram(men), moet het pictogram nog aan de actie gekoppeld worden. Kies hiervoor <menuchoice><guimenu>Instellingen</guimenu><guimenuitem>Acties instellen</guimenuitem></menuchoice> (in &quantaplus;) en selecteer de actie waarvoor het pictogram bedoeld is. Naast het veld <guilabel>Tekst</guilabel> bevindt zich een knop. Klik daarop. </para>
<para>Kies <guilabel>Andere pictogrammen</guilabel> en vervolgens <guibutton>Bladeren</guibutton>. </para>
<para>Ga naar de map waarin u het pictogram hebt opgeslagen, selecteer het pictogram en klik <guibutton>OK</guibutton>. </para>
<para>Kies <guibutton>Toepassen</guibutton> en doe hetzelfde voor de andere tags (voorzover die er zijn), of kies <guibutton>OK</guibutton> om af te sluiten. </para>
<mediaobject>
<imageobject>
<imagedata fileref="dtep_doc_img18.png" format="PNG"/>
</imageobject>
</mediaobject>
<para>Laten we zeggen dat u een aantal veelgebruikte functies uit &quantaplus; aan uw werkbalk wilt toevoegen, of misschien wilt u de werkbalk op een andere manier indelen, met een paar scheidingen om de acties te groeperen. Open het dialoogvenster <guilabel>Werkbalken instellen</guilabel> via<menuchoice> <guimenu>Instellingen</guimenu> <guimenuitem>Werkbalken instellen</guimenuitem> </menuchoice>. Zorg ervoor dat uw werkbalk geselecteerd is. </para>
<para>Ik voeg een scheiding (bovenaan de linkerkolom) toe aan mijn werkbalk. Als u het item hebt geselecteerd dat u aan uw werkbalk wilt toevoegen, klikt u op de pijl naar rechts. Hiermee voegt u het toe. </para>
<mediaobject>
<imageobject>
<imagedata fileref="dtep_doc_img21.png" format="PNG"/>
</imageobject>
</mediaobject>
<para>Ik wil graag een snelle manier om het <guilabel>voorbeeld in Konqueror</guilabel> te bereiken. Ik voeg het daarom aan de werkbalk toe. </para>
<mediaobject>
<imageobject>
<imagedata fileref="dtep_doc_img22.png" format="PNG"/>
</imageobject>
</mediaobject>
<para>Merk op hoe de scheiding de groepen aangeeft. Iemand die mijn werkbalk niet kent, zou misschien kunnen denken dat de &konqueror;-knop iets te maken had met de startknop. </para>
<mediaobject>
<imageobject>
<imagedata fileref="dtep_doc_img23.png" format="PNG"/>
</imageobject>
</mediaobject>
<para>Pas de wijzigingen toe, en klik als u klaar bent op <guibutton>OK</guibutton> om af te sluiten. </para>
<para>Ah, kijk eens naar die werkbalk. Zo is hij een stuk handiger. </para>
<mediaobject>
<imageobject>
<imagedata fileref="dtep_doc_img24.png" format="PNG"/>
</imageobject>
</mediaobject>
<para>Vergeet niet uw werkbalk te testen door alle knoppen een keer uit te proberen, zodat u weet dat de uitvoer correct is. </para>
<mediaobject>
<imageobject>
<imagedata fileref="dtep_doc_img25.png" format="PNG"/>
</imageobject>
</mediaobject>
<para>Om de werkbalk op te slaan kiest u <menuchoice> <guimenu>Werkbalken</guimenu> <guisubmenu>Werkbalken opslaan</guisubmenu> <guimenuitem>Als lokale werkbalk opslaan</guimenuitem> </menuchoice>. </para>
<para>Sla in de juiste map op. Omdat NeXML niet bestaat, sla ik het maar in de hoofdmap op, maar uw werkbalk(en) moet(en) in de goede map opgeslagen worden. Zorg ervoor dat u uw &descriptionrc; aanpast zodat uw werkbalken geladen worden als een nieuw bijbehorend bestand aangemaakt wordt. </para>
</sect2>
</sect1>
<sect1 id="creating-quanta-docs-3-2">
<sect1info>
<title>Uw eigen documentatie maken</title>
<authorgroup>
<author><firstname>Robert</firstname> <surname>Nickel</surname> <affiliation> <address><email>robert@artnickel.com</email></address>
</affiliation>
</author>
&Sander.Koning;&Tom.Albers;
</authorgroup>
</sect1info>
<title>Uw eigen documentatie maken</title>
<para>Waarschijnlijk is de meest opvallende toevoeging aan &quantaplus; voor de gewone gebruiker, het toevoegen van documentatie voor de opmaak- of scripttaal die u het beste bevalt. Hiertoe laat dit hoofdstuk zien hoe ik de &PHP;-documentatieboom voor mijn eigen gebruik aanmaak. </para>
<para>Voordat u uw eigen documentatie maakt, is het wellicht handig om op de<ulink url="http://quanta.sf.net/main1.php?contfile=resource"> &quantaplus; repository</ulink> te kijken of iemand anders dit set misschien al gedaan heeft. </para>
<para>Dit proces bestaat uit twee delen. Eerst moet u de bestaande documentatie voor de opmaak-/script-/&etc; taal ophalen. Daarna moet het bestand <filename>docrc</filename> aangemaakt worden. We beschrijven hier alleen het tweede deel. </para>
<para>Het bestand docrc ziet er als volgt uit: </para>
<informalexample>
<literallayout>#KDE Config File
[Tree]
Doc dir=<replaceable>pad, relatief aan dit bestand, naar de html-bestanden van de documentatie</replaceable> &eg; php42/
#top level elements
Top Element=<replaceable>Uw beschrijving van deze documentatie</replaceable> &eg; &PHP; 4.2 documentation
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>Het bestand <filename>docrc</filename> is verdeeld in twee secties: Tree en Context. </para>
<para>De sectie Tree bepaalt het uiterlijke aspect van de documentatie in de documentatie-tab. Bijvoorbeeld, in de documentatie van &PHP; zult u iets als dit hebben: </para>
<mediaobject>
<imageobject>
<imagedata fileref="doc-view1.png" format="PNG"/>
</imageobject>
</mediaobject>
<para>We combineren dit met het bovenstaande: mijn &PHP; <filename>docrc</filename> ziet er als volgt uit: </para>
<informalexample>
<literallayout>#KDE Config File
[Tree]
Doc dir=php42/
#top level elements
Top Element=PHP 4.2 documentation
PHP 4.2 documentation=Table of Contents,#Getting Started,#Language Reference
Table of Contents=index.html
Getting Started=Introduction, ...
Introduction=introduction.html
...
Language Reference=Basic syntax, ...
Basic syntax=language.basic-syntax.html
...
</literallayout>
</informalexample>
<para>Let op de <literal>#</literal> voor <quote>Getting Started</quote> en <quote>Language Reference</quote>. Dit geeft aan dat deze subcontainers zijn die zelf inhoud hebben. Er is geen vastgesteldemaximale diepte &mdash; gebruik uw gezond verstand. </para>
<para>U zult merken dat naar de inhoudsopgave direct als bestand wordtverwezen en dus onderaan de boomstructuurweergave verschijnt (mappen eerst!). </para>
<important>
<para>Spaties vormen geen probleem, maar kijk uit voor de tekens &amp; en &lt;. Vervang deze door &amp;amp; respectievelijk &amp;lt; in alle &XML;-gebaseerde bestanden in &quantaplus;. </para>
</important>
<para>De sectie Context is het deel van het bestand docrc dat context-gevoelige hulp biedt. Bijvoorbeeld: u schrijft een &PHP;-script en wilt de documentatie voor de functie<function>mysql_fetch_array</function> zien. U selecteert defunctie en drukt dan <keycombo action="simul">&Ctrl;<keycap>H</keycap> </keycombo> voor contexthulp. De documentatie voor <function>mysql_fetch_array</function> verschijnt direct. Er zijn hier maar twee soorten items: ContextList en de regels met bestandsassociaties. </para>
<variablelist>
<varlistentry>
<term>ContextList</term>
<listitem>
<para>Dit is slechts een door komma's gescheiden lijst van de contextitems die u ter beschikking wilt hebben (voor &PHP; zijn dit de &PHP;-functies). </para>
</listitem>
</varlistentry>
<varlistentry>
<term>Regels met bestandsassociaties</term>
<listitem>
<para>Deze zijn opgebouwd als context-item=html-bestand. &eg; acos=function.acos.html </para>
</listitem>
</varlistentry>
</variablelist>
<para>Een verkleinde versie van de sectie Context in mijn bestand <filename>docrc</filename> ziet er als volgt uit: </para>
<informalexample>
<literallayout>#Keywords for context help
[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>Sla nu uw bestand <filename>docrc</filename> op in de directory<filename class="directory">$<envar>HOME</envar>/.trinity/share/apps/quanta/doc</filename> of <filename class="directory">$<envar>TDEDIR</envar>/share/apps/quanta/doc</filename> voor lokaal respectievelijk globaal gebruik. Maak dan een map aan zoals u die in hetbestand <filename>docrc</filename> hebt opgegeven, in dezelfde map als waar het bestand <filename>docrc</filename> zich bevindt, en kopieer daar uw &HTML;-pagina's heen. </para>
<para>U dient &quantaplus; opnieuw op te starten om uw documentatie te kunnen lezen. </para>
<para>Als u er zeker van bent dat ze goed zijn en de moeite van het delen waard,stuur dan uw bestand <filename>docrc</filename> samen met wat informatie over de documentatie die u gebruikt heeft, naar het <ulink url="http://quanta.sf.net/main1.php?contfile=resource">&quantaplus; repository</ulink> opdat de rest van de &quantaplus; gemeenschap er ook gebruik van kan maken. U zult niet rijk worden, maar wel een goed gevoel krijgen in de wetenschap dat u heeft bijgedragen aan het beste webontwikkelingsplatform dat er is. </para>
</sect1>
<sect1 id="sharing-resources">
<title>Bronnen delen</title>
<para>Met &quantaplus; bent u niet alleen. Het is mogelijk om de diverse bronnen (DTEP-pakketten, werkbalken met acties, scripts, sjablonen) te delen met anderen. Hier zijn twee manieren voor: </para>
<variablelist>
<varlistentry>
<term>Per e-mail verzenden</term>
<listitem><para>U kunt de bronnen per e-mail naar uw vrienden, partners, of wie u ook wilt, verzenden. U komt het menu-item <guilabel>Via e-mail verzenden</guilabel> op diverse plaatsen tgen, zoasl <menuchoice><guimenu>DTD</guimenu><guimenuitem>DTD-pakket (DTEP) via e-mail zenden</guimenuitem></menuchoice>, <menuchoice><guimenu>Werkbalken</guimenu><guimenuitem>Werkbalk via e-mail verzenden</guimenuitem></menuchoice>, in het contextmenu van de bestanden en mappen in de boomstructuren <guilabel>Werkbalken</guilabel> en <guilabel>Scripts</guilabel>. </para></listitem>
</varlistentry>
<varlistentry>
<term>Naar de hoofdserver uploaden</term>
<listitem><para>De bronnen kunnen naar onze hoofd-repository worden verzonden, waarvandaan alle andere gebruikers van &quantaplus; ze kunnen downloaden. De inzendingen worden gecontroleerd en alleen beschikbaar gesteld als ons team ze correct en bruikbaar vindt. Om een geldige inzending te hebben, wordt het aanbevolen om de bronnen te ondertekenen, waarvoor u een GPG/PGP-sleutel nodig hebt. Deze informatie wordt door ons team en de downloaders gebruikt om de oorsprong van de bronnen te controleren.</para>
<para>Zie <xref linkend="download-resources"/> over het verkrijgen van bronnen van de hoofdserver.</para>
<para>Als u bestanden verzendt, wordt u gevraagd het wachtwoord voor uw geheime GPG-sleutel in te voeren (het wachtwoord wordt niet opgeslagen), of als u meer dan één sleutel hebt, kunt u degene kiezen die u wilt gebruiken. In het dialoogvenster <guilabel>Leuk nieuw spul delen</guilabel> vult u de invoervelden in (<guilabel>Voorbeeld-URL</guilabel> mag leeg blijven) en u start het verzenden door op <guilabel>OK</guilabel> te klikken.</para>
<para>Verzenden kan worden gestart met <menuchoice><guimenu>DTD</guimenu><guimenuitem>DTD-pakket (DTEP) uploaden</guimenuitem></menuchoice>, <menuchoice><guimenu>Werkbalken</guimenu><guimenuitem>Werkbalk uploaden</guimenuitem></menuchoice>, in het contextmenu van bestanden en mappen in de boomstructuren voor <guilabel>Sjablonen</guilabel> en <guilabel>Scripts</guilabel>. </para>
</listitem>
</varlistentry>
</variablelist>
</sect1>
<sect1 id="download-resources">
<title>Bronnen verkijgen</title>
<para>U kunt &quantaplus; bijwerken zonder een nieuwe versie te hoeven installeren, door nieuwe bronnen als DTEP-pakketten, werkbalken met acties, sjablonen, scripts en documentatie te verkrijgen. Een mogelijkheid is dat u de bronnen per e-mail hebt ontvangen of dat u ze hebt gedownload vanaf een webserver, in welke gevallen u ze normaal gesproken handmatig moet installeren. In een enkel geval krijgt u er ook een installatiescript bij, als u geluk hebt. Maar &quantaplus; biedt een toegewijde server die bronnen bevat die ofwel niet werden meegeleverd vanwege de grootte of infrequent gebruik, of doordat ze later door gebruikers zijn aangeboden, en deze worden automatisch geïnstalleerd. Download zulke bronnen via de diverse menu-items <guilabel>downloaden...</guilabel>. U vindt deze in <menuchoice><guimenu>DTD</guimenu><guimenuitem>DTD-pakket (DTEP) downloaden</guimenuitem></menuchoice>, <menuchoice><guimenu>Werkbalken</guimenu><guimenuitem>Werkbalk downloaden</guimenuitem></menuchoice>, in het contextmenu van een leeg gebied of bovenste item in de structuurbomen van <guilabel>Sjablonen</guilabel>, <guilabel>Scripts</guilabel> en <guilabel>Documentatie</guilabel>. </para>
<para>Nadat een bron gedownload is, maar voordat deze geïnstalleerd wordt, verifieert &quantaplus; of de bron geldig is, door de integriteit en handtekening te controleren. Bij problemen wordt u gewaarschuwd en kunt u beslissen om al dan niet door te gaan. Lees de waarschuwingsdialogen zorgvuldig. Als de integriteit correct is en de bron goed ondertekend is, krijgt u een informatievenster, waarin u kunt zien wie de bron gemaakt heeft. </para>
<para>
<caution><para>Installeer bronnen, met name werkbalken en scripts, alleen vanaf vertrouwde locaties!</para></caution>
</para>
</sect1>
<sect1 id="converting-dtd">
<title>Een DTD naar een &DTEP; omzetten</title>
<para>Het is mogelijk om met XML-talen te werken die momenteel niet door &quantaplus; worden ondersteund door een DTEP-pakket te maken. Maar het aanmaken hiervan kan veel tijd kosten, omdat u wellicht honderden tagbestanden in <link linkend="tagxml-3-2">tagXML</link>-formaat moet schrijven. Er is hier een betere manier voor, namelijk het automatisch omzetten van de DTD in een DTEP-pakket. </para>
<para>U kunt de omzetting starten met <menuchoice><guimenu>DTD</guimenu><guimenuitem>DTD laden &amp; converteren</guimenuitem></menuchoice>. Kies het <filename>.dtd</filename>-bestand waarin de te gebruiken DTD staat, u ziet daarna het volgende dialoogvenster: <mediaobject> <imageobject>
<imagedata fileref="dtd-conversion.png" format="PNG"/>
</imageobject>
</mediaobject>
</para>
<para>De items zijn:</para>
<itemizedlist>
<listitem><para><guilabel>Naam doelmap:</guilabel> de nieuwe &DTEP; wordt onder deze naam in de map <filename><envar>$TDEHOME</envar>/share/apps/quanta/dtep</filename> opgeslagen. </para>
</listitem>
<listitem><para><guilabel>Naam</guilabel>: de naam (definitie-tekenreeks) van de DTD</para></listitem>
<listitem><para><guilabel>Nickname</guilabel>: de voor de gebruiker zichtbare naam van de &DTEP;</para></listitem>
<listitem><para><guilabel>!DOCTYPE definitieregel:</guilabel> de tekenreeks die in de tag !DOCTYPE moet verschijnen, zoals HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"</para></listitem>
<listitem><para><guilabel>DTD URL:</guilabel>: het URL-adres van het DTD-bestand</para></listitem>
<listitem><para><guilabel>Standaard extensie:</guilabel> de extensie die normaal gebruikt wordt voor bestanden met deze DTD</para></listitem>
<listitem><para><guilabel>Hoofdlettergevoelige tags en attributen:</guilabel> zelfverklarend, over het algemeen geldig voor XML-taalvarianten</para></listitem>
<listitem><para><guilabel>DTEP fijn aanpassen na conversie:</guilabel> als dit is aangevinkt, opent &quantaplus; de &descriptionrc;-editor nadat de conversie gedaan is, zodat u de nieuwe &DTEP; kunt aanpassen. Dit wordt aanbevolen.</para></listitem>
</itemizedlist>
</sect1>
</chapter>