<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>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>
<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>
<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>
<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>
<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>
<entry></entry><entry>Het type van de tag is een scriptfunctie. In dit geval worden <attr> als argumenten van de functie gebruikt. (Alleen Family 2.)</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>
<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>
<para>Plaats een label in het dialoogvenster. De tekst wordt aangegeven in de tag <text>. Dit element kan alleen andere elementen bevatten. </para>
<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>
<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>
<entry>optioneel</entry><entry>Vereist source="dcop" en een interfacenaam. De DCOP-methodenaam vanuit &quantaplus; die gebruikt wordt om de brondata te verkrijgen.</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>
<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>
<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 <attr> tag). Dit element is leeg (kan niets bevatten). </para>
<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 <attr> of <label> tag). Dit element is leeg (kan niets bevatten). </para>
<para>Alle TagXML-bestanden moeten beginnen met de &XML;-declaratie: <?xml version="1.0" encoding="UTF-8"?> en moeten correct genest en gesloten zijn. </para>
<para>U kunt veilig witruimte gebruiken, maar let wel op de tekens & en <. Deze dient u te vervangen door &amp; respectievelijk &lt; in elementen als <tooltip>, <whatsthis> en <text>. Als u dit niet doet zal er geen crash optreden, maar u zult wel delen van uw werk verliezen. </para>
<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>
<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>
<para>Hieronder ziet u een geldig Family 1-TagXML-bestand. Dit bestand beschrijft &W3C; &XML; Schema's element <schema>. De bestandsnaam van dit fragment zou schema.tag zijn. Simpel, nietwaar? </para>
<para>Hieronder vindt u een geldig Family 2-TagXML-bestand. Dit fragmentbeschrijft &PHP;'s functie overload. De bestandsnaam hiervoor zou overload.tag zijn. </para>
<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>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>
<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>
<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>
<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><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>
</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>
<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><tag></guilabel></term> <listitem><para>De naam van de tag.</para></listitem> </varlistentry> <varlistentry> <term><guilabel></tag></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 <tag> voor, en </tag> 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> <tag> en </tag> worden ingevoegd zoals u hier opgeeft. <, > of / wordt niet automatisch toegevoegd. </para>
</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>
<listitem><para>de parameters voor de gebeurtenis, normaal de bestandsnaam van het huidige document of het pad naar het projectbestand.</para></listitem>
<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>
<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>
<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>
<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>
<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 &kiconedit;. 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>&kiconedit; 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 <start> in het huidige document plaatst. (Althans, dat is de bedoeling.) </para>
<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>
<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>
<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>
<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>
<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>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>
<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 — 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>
<para>Spaties vormen geen probleem, maar kijk uit voor de tekens & en <. Vervang deze door &amp; respectievelijk &lt; in alle &XML;-gebaseerde bestanden in &quantaplus;. </para>
<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>
<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>
<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>
<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>
<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>
<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>
<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>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 & converteren</guimenuitem></menuchoice>. Kies het <filename>.dtd</filename>-bestand waarin de te gebruiken DTD staat, u ziet daarna het volgende dialoogvenster: <mediaobject> <imageobject>
<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><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>
