Udvidelse af &quantaplus;

Udvidelse af &quantaplus; Christopher Hornbaker

chrishornbaker@earthlink.net

András Mantia

amantia@kde.org

&rune.laursen.role; Udvidelse af &quantaplus; Dette kapitel beskriver hvordan &quantaplus; kan tilpasses netop dine behov, og hvordan du kan hjælpe til med at gøre &quantaplus; bedre. Dokumenttype-redigeringspakke (&DTEP;) Dokumenttype-redigeringspakken (&DTEP;) bruges i &quantaplus; til at tilføje understøttelse for mærker, scriptsprog og stilskabeloner. De tillader &quantaplus; at levere funktioner såsom automatisk komplettering og knudetræ. Deres enkelhed og fleksibilitet er det der gør &quantaplus; til et hurtig, udviklervenlig integreret udviklingsmiljø for internet-udviklere. De gør &quantaplus; til et letanvendeligt, produktivt miljø. Der findes to varianter af &DTEP;, familie 1, som er opmarkeringer, og familie 2 som er scriptsprog og stilskabeloner. En &DTEP; består af to dele, mærkemappen og værktøjslinjerne. Mærkemapper består af to filtyper, filerne &descriptionrc; og XML-mærker, som har endelsen .tag. Værktøjslinjer er bekvemme, ikonorienterede linjer med knapper (ovenfor redigeringsvinduet), som tilføjer til tekst til et dokument hurtigere end brugeren kan skrive. En &DTEP; kan laves manuelt (se nedenfor), downloades eller laves automatisk ud fra en eksisterende DTD. Se for information om konvertering. Dette dokument beskriver hvordan XML-mærkefiler, filen &descriptionrc; og værktøjslinjer laves. I korthed, en &DTEP;. XML-mærkefiler (.tag) definerer både egenskaber specifikke for et mærke, samt layout og indhold i egenskabsdialogen som &quantaplus; viser for mærket. Filen &descriptionrc; sørger for regler og information om en hel &DTEP;. Værktøjslinjer sørger for en hurtig måde at tilføje mærker til et dokument, uden at behøve bekymre sig om fejlstavninger eller lignende. Indpakning Mærkemapper er netop det, mapper. De består kun af filerne &descriptionrc; og XML-mærkefiler. Mærkemapperne bærer mærkesprogets navn og version, hvis der findes en (for eksempel html-4.01-strict). TagXML Tabellen nedenfor har en liste af elementer som defineres i XML-mærkefiler, og angiver om de kræves eller ej. Selv om ikke alle kræves, anbefales du at anvende så mange som du kan, så andre brugere får en bedre oplevelse og mere information at arbejde med. Element Normal brug Speciel brug TAGS kræves altid tag kræves altid label valgfri kræves for at oprette en egenskabsdialog attr valgfri kræves for at definere en egenskab tooltip valgfri kræves for at lade egenskabsdialogen vis et værktøjstips whatsthis valgfri kræves for at få egenskabsdialogen til at vise Hvad er dette list valgfri kræves når en egenskab har typen list item valgfri kræves når <list> bruges textlocation valgfri altid location valgfri kræves når label bruges text valgfri kræves når label bruges children valgfri liste over mærker som kan findes indeni mærket som defineres child kræves en af indgangene i children stoppingtags valgfri liste over mærker som fortæller et andet mærke at det har nået slutningen stoppingtag kræves en af indgangene i stoppingtags Elementbeskrivelser for XML-mærker Følgende afsnit beskriver hvert element i detalje. Alt fra hvor de kan findes, til hvad som findes i dem præsenteres på en måde som er enkel at følge. TAGS Dette er XML-mærkedokumentets rodelement. Det må kun findes en gang i et dokument. Det kan indeholde definitionen af flere mærker. Dette er et typeelement med kun element. Overliggende Underliggende INGEN tag tag Omgivelse for mærket som defineres. Dette er et typeelement kun med element. Overliggende Underliggende TAGS label, attr, stoppingtags EgenskabTypeVærdier StandardBrugBeskrivelse navnstreng krævesAngiver navnet på mærken som bliver defineret. singleboolean valgfriAngiver om mærket kræver et afsluttende mærke </(mærkenavn)>. typestrengxmltag valgfriAngiver typen af mærket som defineres. xmltag Typen for mærket er XML-baseret (kun familie 1). entitet Mærket beskriver en entitet (kun familie 1). egenskab Typen for mærket er &CSS; (kun familie 2). funktion Typen for mærket er en scriptfunktion. Når dette bruges bliver <attr> funktionens argument (kun familie 2). klasse Typen for mærket er en scriptklasse (kun familie 2). method Typen for mærket er en klassemetode (kun familie 2). returnTypestrengvoid valgfriAngiver returtypen for mærket som defineres (kun familie 2). void Mærketypen returnerer ingenting. int Mærketypen returnerar et heltal. float Mærketypen returnerer et decimaltal. long Mærketypen returnerer et langt heltal. streng Mærketypen returnerer en streng. versionstreng valgfriAngiver sprogets version som mærket er gyldig for extendsstreng valgfriKun gyldig hvis typen for mærket er "klasse". Navnet på basisklassen for denne klasse (kun familie 2). klassestreng valgfriKun gyldig hvis typen er "method". Angiver navnet på klassen som denne metoden tilhører (kun familie 2). commonboolean valgfriHvis "yes", angiver mærket en fælles egenskabsgruppe, og egenskaberne inde i mærket kan kobles til et hvilket som helst andet mærke (kun familie 1). commentstreng valgfrikommentarstrengen vises ved siden af mærke taggnavnet i kompletteringsfeltet label Placér en rubrik i dialogen. Teksten angives af mærket <text>. Dette er et typeelement kun med element. Overliggende Underliggende tag text, location attr Definerer en egenskab for mærket. Elementet forekommer en gang for hver egenskab. Det definerer egenskabens navn og type. Det indeholder også yderligere mærker som angiver hvordan egenskaben skal vises, osv. Dette er et typeelement med kun element. Overliggende Underliggende tag location, list, tooltip, whatsthis, textlocation EgenskabTypeVærdier StandardBrugBeskrivelse navnstreng krævesAngiver navnet på egenskaben som er ved at blive defineres. typestrenginput krævesAngiver typen for egenskaben som er ved at blive defineres. input Feltet understøtter frie tekstindgange (tekstfelt). check Feltets værdi er boolesk (afkrydsningsfelt). farve Feltets værdi er en farve. url Feltets værdi er en &URL; (Lokal fil at henvise til). list Feltets værdi kommer fra en given liste. statusstrengvalgfri krævesAngiver om argumentet kræves eller ej (Kun familie 2). valgfri Argumentet kræves ikke. kræves Argumentet kræves. underforstået Argumentet er underforstået. sourcestreng valgfriAngiver kilden som bruges til at udfylde egenskabens indgang i mærkeeditorens dialog og i egenskabstræet selection Den markerede tekst bruges som kilde dcop Resultatet af DCOP-metoden bruges som kilde interfacestreng valgfriKræver source="dcop". DCOP-grænsefladen inde i &quantaplus; bruges til at hente kildedata. methodstreng valgfriKræver source="dcop" og et grænsefladenavn. DCOP-metodenavnet inde i &quantaplus; bruges til at hente kildedata. argumentsstreng valgfriKræver source="dcop", et grænsefladenavn og et metodenavn. Argumenterne sendes til metoden. Den kan være tom eller "%tagname%", hvilket betyder det nuværende mærkes navn. whatsthis Definerer 'Hvad er dette'-hjælp for et felt i dialogen. Elementet er kun tekst. For nuværende understøttes kun almindelig tekst (du kan ikke bruge opmarkering). Overliggende Underliggende attr INGEN list Et omgivelsesmærke som grupperer punkterne i en liste sammen. Det kan kun findes én gang for hver beskrivelse af en egenskab. Dette er et typeelement kun med element. Overliggende Underliggende attr item item Definerer et objekt i en liste. Elementet er kun tekst. Overliggende Underliggende list INGEN textlocation Angiver positionen for et mærkes egenskabstekst inde i en dialog. Dette mærke kan kun findes én gang for hver egenskab i dialogen (&ie; en gang for hver <attr>-mærke). Dette element er tomt. Overliggende Underliggende attr INGEN EgenskabType BrugBeskrivelse rowpositivt heltal krævesAngiver linjen i dialogens layout for et felt eller en etiket. colpositivt heltal krævesAngiver søjlen i dialogens layout for et felt eller en etiket. rowspanpositivt heltal valgfriAngiver antal linjer som et felt skal optage. colspanpositivt heltal valgfriAngiver antal søjler som et felt skal optage. location Angiver position og størrelse på et felt i dialogen. Dette mærke skal findes én gang for hvert felt i dialogen (&ie; én gang for hvert <attr>- og <label>-mærke). Dette element er tomt. OverliggendeUnderliggende label, attrINGEN EgenskabType BrugBeskrivelse rowpositivt heltal krævesAngiver linjen i dialogens layout for et felt eller en etiket. colpositivt heltal krævesAngiver søjlen i dialogens layout for et felt eller en etiket. rowspanpositivt heltal valgfriAngiver antal linjer som et felt skal optage. colspanpositivt heltal valgfriAngiver antal søjler som et felt skal optage. text Definerer teksten for en etiket eller et afkrydsningsfelt. Dette element er kun tekst. OverliggendeUnderliggende label, attrINGEN children Definerer en liste med elementer som kan findes i mærket som angives. Dette er et typeelement kun med element. OverliggendeUnderliggende tagchild child Definerer et underliggende mærke. Dette element er tomt. OverliggendeUnderliggende childrenINGEN EgenskabTypeVærdier BrugBeskrivelse navnstreng krævesAngiver et mærke som kan findes indeni et vist mærke. usagestreng valgfriAngiver forholdet til det overliggende objekt. kræves Det overliggende objekt skal have mindst et underliggende objekt med dette navn. stoppingtags Definerer en liste med elementer som tvinger et mærke til at slutte. Dette er et typeelement kun med element. OverliggendeUnderliggende tagstoppingtag stoppingtag Definerer et slutmærke. Dette element er tomt. OverliggendeUnderliggende stoppingtagsINGEN EgenskabType BrugBeskrivelse navnstreng krævesAngiver hvilke mærker som tvinger et andet mærke til at slutte. Brug af XML-mærker Alle XML-mærkefiler skal begynde med &XML;-deklarationen: <?xml version="1.0" encoding="UTF-8"?> og skal være hierarkisk indlejrede og afsluttede. Mellemrum påvirker ingenting negativt, men pas på med tegnene & og <. Disse skal formodentlig erstattes med henholdsvis & og < i elementer såsom <tooltip>, <whatsthis>, og <text>. Hvis dette ikke gøres forårsager det ikke noget sammenbrud, men du vil få dele af dit arbejde til at forsvinde hvis du ikke gør det. Validering af XML-mærker For at validere XML-mærkefiler, klik helt enkelt på dialogen Værktøj længst oppe i &quantaplus; og vælg Validér XML-mærker. En dialog vises, og du behøver kun at følge de enkle anvisninger. Denne funktion findes ikke for øjeblikket. For øjeblikket sker valideringen når XML-mærkefilerne indlæses i &quantaplus;. Eksempel på XML-mærker Familie 1 Følgende viser dig en korrekt familie 1 XML-mærkefil. Filen beskriver tilfældigvis &W3C; &XML; farvesammensætningselement <schema>. Filnavnet på denne XML-mærkefil ville være schema.tag. Enkelt, ikke sandt? <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE TAGS> <TAGS> <tag name="schema"> <label> <text>id</text> <location col="0" row="0"/> </label> <attr name="id" type="input"> <tooltip>En entydig identifikation for elementet </tooltip> <whatsthis>En entydig identifikation for elementet </whatsthis> <location col="1" row="0"/> </attr> <label> <text>version</text> <location col="0" row="1"/> </label> <attr name="version" type="input"> <tooltip>Version for schema.</tooltip> <whatsthis>Version for schema.</whatsthis> <location col="1" row="1"/> </attr> <label> <text>targetNamespace</text> <location col="0" row="2"/> </label> <attr name="targetNamespace" type="input"> <tooltip>Internet-adressereference for navnerummet for dette schema.</tooltip> <whatsthis>Interneta-dressreference for navnerummet for dette schema.</whatsthis> <location col="1" row="2"/> </attr> <label> <text>xmlns</text> <location col="0" row="3"/> </label> <attr name="xmlns" type="input"> <tooltip>Internet-adressereference for et eller flere navnerum for anvendelse i dette schema. Hvis intet præfiks bruges, kan komponenterne i navnerummet anvendes uden kvalifikation </tooltip> <whatsthis>Internet-adressereference for et eller flere navnerum for anvendelse i dette schema. Hvis intet præfiks bruges, kan komponenterne i navnerummet anvendes uden kvalifikation </whatsthis> <location col="1" row="3"/> </attr> <label> <text>attributeFormDefault</text> <location col="0" row="4"/> </label> <attr name="attributeFormDefault" type="list"> <items> <item>qualified</item> <item>unqualified</item> </items> <tooltip>Standardformular for alle egenskaber i schema.</tooltip> <whatsthis>Standardformular for alle egenskaber i schema.</whatsthis> <location col="1" row="4"/> </attr> <label> <text>elementFormDefault</text> <location col="0" row="5"/> </label> <attr name="elementFormDefault" type="list"> <items> <item>qualified</item> <item>unqualified</item> </items> <tooltip>Standardformular for alle elementer i schema.</tooltip> <whatsthis>Standardformular for alle elementer i schema.</whatsthis> <location col="1" row="5"/> </attr> <label> <text>blockDefault</text> <location col="0" row="6"/> </label> <attr name="blockDefault" type="input"> <location col="1" row="6"/> </attr> <label> <text>finalDefault</text> <location col="0" row="7"/> </label> <attr name="finalDefault" type="input"> <location col="1" row="7"/> </attr> </tag> </TAGS> Familie 2 Følgende viser dig en korrekt familie 2 XML-mærkefil. Filen beskriver tilfældigvis &PHP;s overbelastningsfunktion. Filnavnet på denne XML-mærkefil ville være overload.tag. <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE tags> <tags> <tag name="overload" type="function" returnType="void"> <attr name="class_name" type="string" status="optional"/> </tag> </tags> &descriptionrc; Filen &descriptionrc; er også meget enkel, og en editor for den er tilgængelig med DTD Redigér DTD-indstillinger. Det redigerer &descriptionrc; for en &DTEP; som du kan vælge i en liste. For at redigere &descriptionrc; for en nyoprettet &DTEP;, skal du oprette en enkel &descriptionrc; med følgende indgange: [General] Version = Anvend 1 for &quantaplus; version <=3.1.2 og 2 for alle senere versioner. Name = DTD-definitionsstreng. (-//&W3C;//DTD HTML 4.01 Transitional//EN) NickName = Det forskønade navnet på en DTD. (HTML 4.01 Transitional). Hvis ikke defineret bruges Name som NickName. Når du har oprettet den og lagt den ved siden af mærkefilerne, indlæses din nyoprettete &DTEP; med DTD Indlæs DTD-pakke (DTEP). Efter det er indlæst kan du fortsætte med at redigere indstillingerne i din &DTEP;. Tjek indgangenes værktøjsvink og Hvad er dette-tekster i redigeringsdialogen for at forstå betydningen af hver post. Som et alternativ kan du læse quanta/data/dtep/dtd-description.txt i det komprimerede kildekodearkiv, som indeholder en beskrivelse af formatet. Opret værktøjslinjer Det følgende viser dig hvordan man opretter værktøjslinjer for en &DTEP;. Værktøjslinjer er grafiske elementer, som tildeles handlinger. I &quantaplus; er handlinger grunden til næsten alle udvidelser som &quantaplus; har, og vil få i fremtiden. &quantaplus; tilbyder også automatisk komplettering og mærkedialoger. Grænserne for hvad du kan gøre med handlinger er næsten ubegrænsede. Som eksempel, anvender vi &HTML; Tidy på vore netsider. Fra begyndelsen til en færdig værktøjslinje Til at begynde med, skal du oprette en brugerværktøjslinje. Vælg Værktøjslinjer Tilføj brugerværktøjslinje . Hvis der findes mange mærker i sproget, anbefales du at opdele mærkerne i logiske grupper. Du skal oprette en ny brugerværktøjslinje for hver gruppe. I dette tilfælde findes der ikke mange, så vi opretter en værktøjslinje og navngiver den efter mærkesproget. Så snart alle værktøjslinjer er oprettet, skal du tilføje og tilrette handlingerne. For at gøre det, vælges Opsætning Indstil handlinger . Delene i vinduet er ganske ligetil. Tryk på knappen Ny handling længst nede i vinduet for at komme til redigeringstilstand. Udfyld i alle nødvendige felter, og tilføj mærkerne i passende værktøjslinjer. Kompletér resten, og hvis mærkeerne har egenskaber som du altid vil anvende, så markér dialogen Kør dialogen for "Redigér mærke" hvis den findes, så du bliver spurgt hver gang handlingen bruges. Du bør nu have noget som ligner følgende: Tryk på knappen Anvend, så ser du at handlingen er blevet tilføjet i de værktøjslinjer du har markeret. Åh nej! Sikke en grim ikon. Hvordan skal du selv og andre huske at den ikon hører sammen med handlingen. Lad os erstatte den inden der opstår problemer. For at oprette en ikon som bedre beskriver handlingen, anvender vi &kiconedit;.. Vælg den i &kmenu;, Grafik Flere programmer (eller hvor din distribution end har placeret den). &kiconedit; har standardstørrelsen 32 x 32 billedpunkter, men vi har brug for 22 x 22. For at ændre det, vælges Redigér Ændr størrelse . Husk at du laver en ikon som ikke kun skal hjælpe dig selv med at huske hvilken handling som gør hvad, men også andre brugere af denne &DTEP;. Eftersom mærket vi laver ikonen til, hedder start, bestemmer vi os for at oprette et start-tegn. Ved at bruge grøn farve (grønt tolkes ofte som kør, start eller fortsæt) formidler vi, eller burde i det mindste formidle, brugeren informationen om at ved et klik på denne handling placeres mærket <start> i dette dokument. Nu når ikonen er færdigoprettet, gemmer vi den. Når vi er færdige med at laver ikoner, skal ikonerne associeres med handlingen. For at gøre dette, åbnes vinduet Opsætning Indstil handlinger igen (i &quantaplus;) og handlingen som ikonen oprettedes for vælges. Ved siden af feltet Tekst, findes en knap. Klik på den. Vælg Øvrige ikoner og klik derefter på knappen Gennemsøg.... Gå til mappen hvor du gemte ikonen, vælg den og klik på O.k.. Tryk på knappen Anvend, og fortsæt enten med at gøre det samme med de øvrige mærker, eller klikke på O.k. for at afslutte. Antag at vi vil tilføje nogle almindelige &quantaplus; funktioner i værktøjslinjen, eller måske skulle værktøjslinjen være bedre hvis den blev organiseret på et anden måde, med nogen adskillere for at gruppere handlingerne. Åbn dialogen Indstil værktøjslinjer ved at vælge Opsætning Indstil værktøjslinjer . Sørg for at vores værktøjslinje er valgt. Vi vælger adskilleren (længst oppe i venstre søjle) for værktøjslinjen. Når man har valgt objektet som skal tilføjes i værktøjslinjen, trykker man på højrepilen. Dette vil tilføje den til værktøjslinjen. Vi vil have en hurtig måde at komme til Vis med Konqueror. Vælg den og tilføj de i værktøjslinjen. Bemærk hvordan adskilleren hjælper med gruppering. Nogen som ikke har set vor værktøjslinje tidligere, ville kunne have troet at knappen &konqueror; lignede eller det modsatte af start-knappen. Anvend dine ændringer, og tryk på O.k. når du er klar til at afslutte. Kig på den fantastiske nye værktøjslinje! Meget bekvemmere nu. Husk at teste værktøjslinjen, ved at klikke på knapperne, så du véd at udskriften er rigtig. For nu at gemme værktøjslinjen, vælger vi Værktøjslinjer Gem værktøjslinjer Gem som lokal værktøjslinje . Gem den i den rigtige mappe. Eftersom NeXML ikke findes, lægger vi den kun i topniveaumappen, men værktøjslinjer skal gemmes i den rigtige mappe. Sørg for at du justerer &descriptionrc; så værktøjslinjerne indlæses når en ny fil af denne type laves. Opret din egen dokumentation Robert Nickel

robert@artnickel.com

&rune.laursen.role; Opret din egen dokumentation Formodentlig de mest bemærkelsesværdige tilføjelser til &quantaplus; for den almindelige bruger, tilføjelse af dokumentation for de mærke- eller scriptsprog som er mest populære. Med dette formål, forklarer dette kapitel hvordan jeg laver &PHP;-dokumentationstræet til min egen personlige brug. Inden du begynder på at oprette din egen dokumentation, vil du måske kigge på &quantaplus;s arkiv for at se om nogen allerede har lavet denne opsætning. Der findes to dele i processen. Først skal du skaffe eksisterende dokumentation for mærkesproget, scriptsproget eller et andet sprog som du er ude efter. Derefter skal du oprette docrc-filen. Det første må du klare selv, det andet er hvad vi dækker her. Den almindelige form for docrc-filen er følgende: #KDE konfigurationsfil [Tree] Doc dir=søgesti, relativt til denne fil, for dokumentationens HTML-filer t.ex. php42/ #toppniveauelement Top Element=Din beskrivelse af disse dokumenter t.ex. PHP 4.2 dokumentation Section 1=Section1.html Section 2=#Sec2.1,#Sec2.2,#Sec2.3 Sec2.1=Sec2.1.html Sec2.2=Sec2.2.html Sec2.3=Sec2.3.html ... [Context] ContextList=func1,func2,tag1,tag2,tag3 func1=func1.html func2=func2.html tag1=tag1.html tag2=tag2.html tag3=tag3.html Filen docrc er opdelt i to afdelinger: Tree (træ) og Context (Sammenhæng). Afdelingen Tree definerer præsentationsaspekter for dokumentet under dokumentationsfanebladet. Du ser for eksempel at i &PHP;-dokumentationen, har du noget som ligner dette: Med reference til ovenstående, ser min &PHP; docrc sådan her ud: #KDE indstillingsfil [Tree] Doc dir=php42/ #toppniveauelement Top Element=PHP 4.2 dokumentation PHP 4.2 dokumentation=Indholdsfortegnelse,#Kom i gang,#Sprogreference Indholdsfortegnelse=index.html Kom i gang=Indledning, ... Indledning=introduction.html ... Sprogreference=Grundlæggende syntaks, ... Grundlæggende syntaks=language.basic-syntax.html ... Bemærk # foran Kom i gang og Sprogreference. Det angiver at disse er delindhold i træet og har deres eget indhold. Jeg tror ikke der findes en angiven grænse for dybde (bortset fra det som dikteres af sund fornuft) — brug din egen dømmekraft. For indholdsfortegnelsen, ser du at den direkte refererer til en fil (og som en konsekvens, vises den længst ned i trævisningen, mapper kommer først). Mellemrum påvirker ingenting negativt, men pas på med tegnene & og <. Disse skal formodentlig erstattes med & og < i alle &quantaplus; &XML;-baserede ressourcefiler. Sammenhængsafsnittet er afsnittet i docrc-filen som bruges til at muliggøre sammenhængsafhængig hjælp. Hvis du for eksempel skriver et &PHP;-script og vil se dokumentationen for funktionen mysql_fetch_array, markerer du helt enkelt funktionen og trykker derefter på &Ctrl;H for sammenhængsafhængig hjælp. Dokumentationen om mysql_fetch_array vises umiddelbart. Der findes kun to typer af indgange her: sammenhængslisten og filassociationslinjerne. Sammenhængsliste Meget enkel. Dette er kun en liste af sammenhængsindgange adskilte af kommategn, som du vil have tilgængelige (for &PHP; er det funktionerne i &PHP;). Filassociationslinjer De er på formen sammenhængspunkt = HTML-dokumentside. F.eks. acos=function.acos.html. En renset version af mit docrc sammenhængsafsnit ser ud som følger: #Nøgleord for sammenhængsafhængig hjælp [Context] ContextList=abs,acos,acosh,addcslashes,addslashes,... abs=function.abs.html acos=function.acos.html acosh=function.acosh.html addcslashes=function.addcslashes.html addslashes=function.addslashes.html ... Nu skal du blot gemme din docrc-fil. Gem den i $HOME/.kde/share/apps/quanta/doc eller $TDEDIR/share/apps/quanta/doc for henholdsvis lokal eller global brug. Opret derefter en mappe (den som angives i docrc-filen) i samme mappe som docrc-filen findes, og kopiér &HTML;-dokumentationssiderne derhen. Du skal genstarte &quantaplus;, for at se din dokumentation. decimaltalr sikker på at de er gode, og værd at dele, send så docrc-filen sammen med med en beskrivelse af passende information om hvilket dokument du brugte til &quantaplus;s arkiv til brug for &quantaplus;' brugere. Du bliver ikke rig, men du føler dig godt tilpas ved at vide at du bidraget til det bedste internetudviklingsmiljø som findes. Hent ressourcer Det er muligt at opgradere &quantaplus; uden at skaffe en ny version, ved at hente nye ressourcer såsom DTEP-pakker, værktøjslinjer med handlinger, skabeloner, scripter og dokumentation. En mulighed er at du fik ressourcer med e-mail, eller har hentet dem fra en URL. Så skal du oftest installere dem manuelt. Hvis du er heldig får du også et installationsscript når du henter ressourcen. Men &quantaplus; har en dedikeret server som opbevarer ressourcer som enten ikke er med i hoveddistributionen på grund af deres størrelse eller at de sjældent bruges, eller var senere bidrag af brugere. Disse ressourcer installeres automatisk. Hent sådanne ressourcer i de forskellige menupunkter Download. Du finder dem under DTD Hent DTD-pakke (DTEP), Værktøjslinjer Hent værktøjslinje, og i den sammenhængsafhængige menuen i et tomt område eller topniveauobjekt i træet Skabeloner, Script og Dokumentation. Efter en ressource er hentet ned, men inden den installeres, verificerer &quantaplus; om ressourcen er gyldig ved at kontrollere integriteten og underskriften. I tilfælde af problemer advares du, og kan bestemme om du vil fortsætte eller ej. Læs advarselsdialogerne nøjagtigt. Hvis integriteten er rigtig og ressourcen er rigtigt underskrevet, vises stadigvæk en informationsdialog så at du kan se hvem der oprettete ressourcen. Sørg for at du kun installerer ressourcer fra pålidelige kilder, særligt værktøjslinjer og scripter! Konvertér en DTD til en &DTEP; Det er muligt at arbejde med XML-sprog som for øjeblikket ikke understøttes af &quantaplus; ved at oprette en DTEP-pakke. Men det kan tage tid at oprette den, eftersom du kan behøve at skrive hundredvis af mærkefiler med tagXML-format. Der er naturligvis en behageligere måde at gøre det på, ved automatisk at konvertere en DTD til en DTEP-pakke. Konverteringen kan startes fra menuen DTD Hent og konvertér DTD. Vælg .dtd-filen som definerer den DTD du vil bruge, og derefter vises følgende dialog: Indgangene er: Målmappenavn: Den nyoprettede &DTEP; vil få dette navn i mappen $TDEHOME/share/apps/quanta/dtep. Navn: Navnet (definitionsstrengen) på DTD'en Alias: Navnet på en &DTEP; synligt for brugeren !DOCTYPE-definitionsrad: Strengen som skal ses i mærket !DOCTYPE, såsom HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd" DTD-webbadress: URL'en som peger på DTD-filen Standardendelse: Filendelsen som oftest bruges for filer som blev skrevet med denne DTD Versalfølsomme mærker og egenskaber: Selvforklarende. Oftest sandt for XML-sprogsvarianter Finjustér DTEP efter konvertering: Hvis markeret, åbner &quantaplus; editoren for &descriptionrc; når konverteringen er klar, så du kan finjustere din nyoprettete &DTEP;. Det anbefales at dette tilvalg er markeret.