Brugermanual for Quanta Plus
Ophavsret © 2002, 2003, 2004, 2005 Quanta Plus udviklingsgruppe
Tilladelse er hermed givet til at kopiere, videregive og/eller ændre dette dokument under betingelserne i GNU's Fri Dokumentation License, Version 1.1 eller en vilkårlig senere version publiceret af Free Software Foundation; uden invariante afsnit, uden tekster før omslaget, og uden tekster efter omslaget. En kopi af licensen er inkluderet i afsnittet ved navn " Medvirkende og licens".
Quanta Plus er en grafisk internet-grænseflade, som forsøger at være neutral og transparent overfor alle mærke-baserede sprog, og samtidig at understøtte populære scriptsprog for internettet, CSS, og andre fremvoksende W3C®-anbefalinger.
Indholdsfortegnelse
Eksempelliste
Quanta Plus er et webudviklingsværktøj til K Desktop Environment. Quanta Plus er designet til hurtig webudvikling og er hastigt på vej til at blive en moden editor med et stort antal storartede funktioner. Vores mål forbliver at skabe det bedste webudviklingværktøj overhovedet. Vi indser at vi har brug for mange flere aktive folk for at nå dette mål så vi er i gang med at udvikle forbedringer der skal gøre det let for webudviklere at tilpasse, udvide og forbedre Quanta Plus. Så beder vi så jer, webudviklerne, om at bidrage med jeres forbedringer. Vi vil så organisere dem så Quanta Plus-webudviklerne kan finde lige de ressourcer, udvidelser og tilpassede plugin de har brug for, til at være de bedste udviklere der kan opdrives. | ||
| --Eric Laffoon at http://quanta.sourceforge.net | ||
Mens vi bestræbte os på at blive den bedste HTML-editor, begyndte Quanta Plus-udviklerne at fundere på en ret fascinerende idé: “Hvorfor ikke gøre Quanta Plus til en generel, udvidelig editor for mærke-baserede sprog?” Ja, det ville kun gøre det til det bedste internet-udviklingsmiljø for KDE. Så det gjorde vi!
Quanta Plus er nu kommet så langt på vejen til at blive et generelt internetudviklingsmiljø at det ikke længere er begrænset til HTML. I alt væsentligt, hvis du kan definere noget med XML, skal Quanta Plus kunne fungere som et IDE for det.
Når ovenstående er sagt, skal det noteres at Quanta Plus er et resultat af de enestående anstrengelser som er gjort af hele KDE-udviklingsholdet. Quanta Plus bruger idéen “hvorfor skrive noget som en anden allerede har skrevet?”, til at lovprise åben kildekode. Takket være KDE's konstruktion, er dette ikke kun muligt, men tillader også brugere og udviklere at udvide Quanta Plus for at passe med deres egne specielle behov.
Quanta Plus tilbyder internet-udviklere en intuitiv og kraftfuld grænseflade for flere dokumenter (MDI). Den kan øge din produktivitet dramatisk. Ved at anvende egne handlinger, scripter og værktøjslinjer, kan du automatisere næsten alle opgaver. Ved anvendelse af Kommander, kan du udvide Quanta Plus så du aldrig behøver huske syntaks for scriptkommandoerne igen. (Mere om dette findes under Kapitel 7, Udvidelse af Quanta Plus.)
Der findes flere nøglebegreber i Quanta Plus. For at forstå og drage fordel af Quanta Plus, bør du lære dig disse begreber. Dette kapitel forklarer og viser dig begreberne, uden hvilke Quanta Plus ville være primitiv.
Quanta Plus deler arbejdet op i tre områder: global, lokal og projekt. Denne opdeling påvirker forskellige komponenter i Quanta Plus.
Globale objekter er tilgængelige for alle som anvender Quanta Plus. Fra værktøjslinjer til handlinger, alt som markeres som globalt opbevares i den fælles Quanta Plus mappestruktur. Det giver mulighed for en gruppe af administratorer at gemme visse værktøjslinjer, handlinger og skabeloner i det globale træ, som siden kan anvendes for at holde en flerbrugerinstallation af Quanta Plus ens for alle i systemet.
Lokale objekter udgør en enkelt brugers personlige samling af ressourcer for internet-udvikling. Objekterne består af brugerens skabeloner og værktøjslinjer. Lokale objekter opbevares i brugerens hjemmemappe. Det gør at alle brugerens lokale objekter altid er tilgængelige til personlig brug.
Projektobjekter er kun tilgængelige i et vist projekt. De kan være alt fra en stilskabelon til en værktøjslinje med egne handlinger som udfører noget specielt med projektets filer. I al enkelhed er dette det mest begrænsede område. Alle objekter som gemmes i projektets arbejdsområde, havner i projektets mappetræ, hvilket gør det muligt at dele specialværktøj og skabeloner med alle som indgår i projektet.
Quanta Plus som redigerer den engelske version af dokumentet du nu læser.
Quanta Plus grænseflade for flere dokumenter er opdelt i tre hoveddele: redigeringsvinduet, fanebladene med hurtiginformation og værktøjslinjerne. Se “Redigeringsvinduet”, “Værktøjsvisningerne”, “Informationsgivende faneblade”, and “Værktøjslinjerne” for mere information om disse dele.
Quanta Plus redigeringsvindue.
Quanta Plus editorvinduet tillader at flere filer åbnet på samme tid. Når kun én fil er åben, fylder dokumentet hele redigeringsvinduet. Så snart et andet dokument åbnes, tages en lille del af pladsen længst nede i redigeringsvinduet til at vise faneblade med filnavn og en statusikon. Billedet ovenfor viser en ikon for en diskette ved siden af filnavnet, hvilket indikerer at filen er ændret og skal gemmes.
Du kan højreklikke på fanebladene med musen for at se en sammenhængsmenu med indgange der er relateret til det aktuelle dokument, som at lukke dokumentet eller andre faneblade, at skifte til andre faneblade, at genindlæse, slette eller overføre dokumenter, at skifte til en linje med et bogmærke, at udføre CVS-operationer på det aktuelle dokument.
Højreklikker du i editor-området får du en anden sammenhængsmenu der er relateret til indholdet i det dokumentet du redigerer, så som basale redigeringsfunktioner (klip, kopiér, indsæt), redigering af tagget under markøren, markering af området der indesluttes af tagget under markøren, få hjælp om ordet under markøren eller åbne en fil hvis strengen under markøren peget på en fil.
Længst oppe i redigeringsvinduet er redigeringsværktøjslinjerne. For øjeblikket er standard i Quanta Plus HTML 4.0.1 Transitional, som har en standardopsætning med værktøjslinjer som indlæses. Alt eftersom Quanta Plus udvikles, kommer værktøjslinjerne til at opdateres for at opfylde brugernes behov, og udnytte nyere funktioner.
Brug af værktøjslinjer er ganske enkelt. Hvis du vil indsætte et grundlæggende mærke, som <p>, i dokumentet, kan du klikke på ikonen som representerer mærket. Nu kan du indsætte data for mærket som du netop har indsat. Hvis du vil indsætte et mærke som kræver visse egenskaber (såsom et anker), får du en dialog hvor du kan udfylde de forskellige felter.
Ankerdialogen (<a>)
Værktøjsvisningerne.
Værktøjsvisningerne eller hurtig-info-træerne (QIT) lader dig navigere, åbne og indsamle information i Quanta Plus. Fanebladsformatet viser dig filer, projekter, skabeloner, dokumentstruktur, scripter, attributter og dokumenttræer.
Forklaring af hurtiginformationstræ
Her kan du bladre i hele filsystemet. Du ser to topniveauer i filsystemet. Den første er din hjemmemappe, og den anden er /. Brug dem for at finde eksisterende filer på maskinen, som du vil redigere eller tilføje til et aktivt projekt. Ved at højreklikke på en fil i visningen, vil du få flere valgmulighed til at håndtere den markerede fil og lader dig desuden indsætte filen i et aktivt projekt, eller skifte mellem trævisning og listevisning.
Projekthåndtering er et af de mange kraftfulde værktøjer som Quanta Plus tilbyder. Dette faneblad viser alle filer i et projekt og lader dig håndtere projektfilerne med et højreklik. Handlinger, som at tilføje, fjerne fra projektet, hente eller fjerne filerne i det hele taget fra disken, kan udføres via menuen.
En anden funktion i Quanta Plus er skabeloner. Skabeloner kan være hvad du ønsker. Billeder, kodestumper, en hel netside, osv. Det er helt og holdent dit valg.
Skabeloner sorteres i tre kategorier, baseret på deres område og sammenhængen hvor de anvendes. Områderne kommer fra Quanta Plus arbejdsområder. Globale skabeloner kan altid anvendes, lokale skabeloner er anvendelige for den nuværende bruger, og projektskabeloner er kun anvendelige inde i et tilsvarende projekt. Du finder mere om skabeloner under “Skabeloner”.
Her finder du information om de forskellige scripter som er tilgængelige for dig. Begreberne lokal-, global- og projekt tillades også her. Med museknap klikker du på indgangene og får adgang til al den tilgængelige information om scriptet. museknap lader dig udføre nogle få handlinger, som for eksempel at køre, redigere eller sende scriptet.
Dette faneblad viser fortolkerens interne repræsentation af dokumentet. Ved at museknap på et element, flyttes markøren til elementets position i dokumentet. Ved at museknap på et element, vises et antal handlinger som har at gøre med navigering og opdatering af træet.
Dette træ vises under alle andre hurtiginformationstræer. Du kan hurtigt redigere egenskaber og navnerum inde i det. Det indholdsbaserede indgangssystem lader dig ændre alle tilgængelige egenskaber med nogle få klik med musen.
Egenskabstræ
Her finder du fuldstændig dokumentation om internet-teknologier til at hjælpe dig med udviklingen. Du kan hente færdigpakket dokumentation for Quanta Plus fra Quanta Plus dokumentationsside, du kan oprette din egen dokumentation, og ved at tilføje en mappe som hedder "doc" til et projekt, kan du tilføje, redigere og vise projektspecifik dokumentation.
Quanta Plus informationsgivende faneblade.
Som standard har Quanta Plus to faneblade placeret i bunden af vinduet, hvorfra brugbar information kan hentes. De er beskedvinduet og problemvinduet.
Dette faneblad viser information fra scripter der kører i quanta. F.eks. vises det benyttede DTD i det aktuelle dokument og ændringer der laves i DTD.
Dette faneblad viser alle fejl i opmærkningen i det aktuelle dokument. Quanta Plus-scripter som udføres, udskriver eventuelle fejlmeddelelser i dette faneblad.
Quanta Plus HTML-værktøjslinjer.
Quanta Plus værktøjslinjer er blevet stærkt udvidet, og er lette at forstå. Du klikker på knappen, og udfører handlingen som hører sammen med knappen. Det vidunderlige ved værktøjslinjer er at du kan definere dine egne handlinger grafisk inde i Quanta Plus.
Håndtering af værktøjslinjer i Quanta Plus er enkelt. Ved at vælge menuen , får du mulighed for at indlæse, gemme, tilføje og sende værktøjslinjer som e-mail. Når du vælger at indlæse en værktøjslinje, kan du vælge fra de tre arbejdsområder som findes i Quanta Plus. Når du gemmer en nyoprettet værktøjslinje, kan du gemme den lokalt eller i projektets område. Hvis du vil gøre en ny værktøjslinje tilgængelig globalt, så bed din administrator om at placere den i Quanta Plus globale værktøjslinje-mappe.
En anden funktion i Quanta Plus er muligheden for at sende værktøjslinjer som e-mail. Quanta Plus sender værktøjslinjen som et komprimerat tar-arkiv via KMail. Hvis du modtager en værktøjslinje via e-mail, kan du gemme (og indlæse) den i Quanta Plus, præcis som en hvilken som helst anden værktøjslinje.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Dette kapitel beskriver de dele af Quanta Plus som du oftest benytter dig af. De gør dig ikke kun mere produktiv, men lader dig også tilrette Quanta Plus til din måde at arbejde på.
Som tidligere nævnt, håndteres værktøjslinjer i Quanta Plus hovedsageligt via menuen . Anvendelse og oprettelse er anderledes. At oprette værktøjslinjer beskrives i et senere afsnit der hedder “Oprettelse af værktøjslinjer.”
Brug af værktøjslinjer er ret enkelt. Når du klikker på en ikon for et ønsket element eller en ønsket handling, sker der en af tre ting: elementet indsættes (valgfrit med et afsluttende element); en elementdialog aktiveres, som lader dig udfylde egenskaber i dialogen; eller endelig, en handling aktiveres og udfører noget smart med nuværende fil eller projekt. Hvis du mærker at du bliver træt af hele tiden at indtaste et vist element som ikke findes i Quanta Plus, kan du tilføje det. Se “Dokumenttype-redigeringspakke (DTEP)” for mere information.
Indstilling af værktøjslinjer og elementerne på den, kan gøres ved at bruge sammenhængsmenuen (højreklik på værktøjslinjen), hvor du kan oprette en Ny handling, en Ny værktøjslinje, du kan udføre andre handlinger som Fjern værktøjslinje, Omdøb værktøjslinje eller Indstil værktøjslinjer som giver dig dialogen hvori du kan angive hvilke handlinger der skal vises på denne eller andre værktøjslinjer.
Ved at frembringe sammenhængsmenuen i en handling (ikon) placeret på værktøjslinjen, bortset fra ovenstående handlinger, kan du se indgangene Fjern handling og Redigér handling som taler for sig selv.
Værktøjslinjerne og handlingerne på dem kan indstilles ved at bruge -> og -> menuindgangene.
Du kan læse om brugerdefinerede handlinger i “Brugerdefinerede handlinger”.
En mærke-dialog ser præcis ud som det følgende:
Et eksempel på en mærke-dialog.
Ovenstående billede viser dialogen for anker-tagget. Hvis du kender til XHTML, bør du have bemærket at alle egenskaber som du kan anvende i et ankerelement er tilgængelige. Bemærk fanebladene ovenfor for Hoved, Kerne og i18n, Begivenheder og Fokus, som indeholder alle andre egenskaber, ifølge deres formål, tilgængelige for ankerelementet. Alt du behøver at gøre er at udfylde tomrummene for egenskaberne du vil have i anker-tagget, udelade dem du ikke vil have og klikke på O.k. Nu har du et velformet ankermærke på markørens nuværende position.
Quanta Plus projektguiden (->) gør det nemt at oprette et projekt.
Projektguiden.
Felterne er ganske selvforklarende og udfyldes bedst oppefra og nedad. Når du indtaster et projektnavn, vil fuldstændiggøre alle mappestrukturer til resten af projektet. Alle stier og forfatterinformations-felter kan indstilles senere ved at trykke på -> (Shift+F7).
Generelle projektindstillinger
Her udfylder du navnet på projektet. Vi kalder for eksempel vores for “test.” Når du udfylder Navn, udfyldes Fil automatisk for dig.
Dette er navnet på Quanta Plus' projektfil. Normalt er det navnet på projektet, men med små bogstaver og uden blanke tegn, med filendelsen webprj (f.eks. eksempel.webprj). Filen opbevares længst oppe i projektets hovedmappe.
Her vælger du den protokol som du skal anvende for at komme til projektet. Hvis projektet findes på samme maskine som den hvor du bruger Quanta Plus, så lad værdien være Lokal. Listen over protokoller er afhængig af din systemopsætning. Tilgængelige protokoller omfatter SSH, FTP, NFS, SMB, WebDAV og mange andre. Denne protokolliste drives af KDE's kraftfulde KIOslave-arkitektur. Denne arkitektur lader alle KDE-programmet tilgå informationer på andre maskiner, som om de fandtes på den lokale maskine.
Her kan du udfylde serveradressen på den maskine som du vil komme til, hvis du ikke arbejder med den lokale protokol. Enten et værtsmaskinenavn (vaertsmaskine.eksempel.dk) eller en IP-adresse (127.0.0.1) kan angives her.
Brugernavn for at logge på den anden maskine. Dette er versalfølsomt.
Kodeord til at logge på fjernmaskinen. Dette er versalfølsomt.
Lad dette felt være tomt for at bruge standardporten for protokollen som du anvender. Du vil måske behøve at ændre det afhængig af serverens indstillinger.
Dette er rodmappen hvor alle projektets filer og mapper opbevares.
Dette er stedet hvor projektets skabeloner opbevares. Det er en relativ søgesti i forhold til projektet, og normalt peger det på templates. Hvis du har et fælles sæt filer som du bruger til flere projekt, kan det være passende at lade feltet pege der i stedet for at bruge standardværdien.
Dette er stedet hvor projektets værktøjslinjer opbevares. Det er en relativ søgesti til projektet og normalt peger det på toolbars. Hvis du har et fælles sæt værktøjslinjer som du bruger til flere projekter, kan det være passende at lade feltet pege der i stedet for at bruge standardværdien.
Dette lader dig hente filer fra det lokale filsystemet. Du kan vælge flere filer eller hele mapper.
Denne valgmulighed er meget god hvis du har statisk net-indhold som du vil hente ned og ændre. For scripter på serversiden (såsom PHP, Python, etc.) skal du hente filerne på en anden måde.
Indsæt filer i projekt
Markér dette hvis du vil tilføje filer som findes i hovedmappens søgesti. Lad det være umarkeret når du starter et nyt projekt fra begyndelsen.
Ved at vælge dette indsættes kun opmarkering, script og billedfiler i projektet.
Ved denne valgmulighed vises alle filer og mapper i hovedmappen, og lader dig være mere specifik angående hvad du vælger.
Dette viser en liste med filerne i hovedmappen. Du kan vælge filer som du ønsker at inkludere eller udelade i projektet, ved at markere eller afmarkere dem.
Flere projektindstillinger
Indsæt dit navn (eller alias) her.
Den e-mail-adresse du ønsker at e-mail som berører dette projekt skal gå til.
Vælg opmarkeringssproget som du i hovedsagelig vil arbejde med i dette projekt.
Vælg det tegnsæt som du ønsker at filerne i projektet skal åbnes og gemmes med.
Markér dette for at bruge en præfiks for dine forhåndsvisninger. Dette tillader dig at indstill søgestiens præfiks til noget andet end det lokale filsystem. Det er mest anvendeligt for sider som har dynamisk indhold, og afhænger af serverbehandling (såsom PHP, JSS, Python, etc.). Indskriv helt enkelt den første del af adressen som den ser ud på serveren og søgestien indtil filen udfyldes af Quanta Plus. Hvis du for eksempel har domænet domaen.com, og redigerer siden index.html, kan du redigere den på værtsmaskinen (mit.domaene.com), ved at lægge den op på serveren og trykke på F6 for at se resultatet fra www.domaen.com i stedet for det lokale filsystemet.
Indtast præfikset som du vil bruge her.
Dette skaber en kopi af de globale skabeloner i projektets mappetræ.
Dette skaber en kopi af de lokale skabeloner i projektets mappetræ.
Den sidste skærm i guiden til nyt projekt, har tre indstillinger som kan gøre livet lettere. Indstillingerne kan ændres fra menuen ->menuen i fanebladet Læg projekter op, eller med genvejstasten Shift+F7.
Dialogen for projektegenskaber ser sådan her ud:
Siden med generelle tilvalg
Nogle af valgmulighederne er de samme som i projektguiden og beskrives i “Nye projekter”. De ekstra valgmuligheder beskrives nedenfor.
Generelle projektindstillinger
En liste med filnavne (jokertegn kan bruges) som ignoreres når du udfører projektrelaterede handlinger såsom .
Et komplementerende tilvalg til det ovenstående, også filer på listen i filen .cvsignore undtages fra projektet.
Projektvisningen som indlæses når projektet åbnes. Du kan læse mere om projektvisninger i “Projektvisninger”.
Vælg fejlsøgeren du vil bruge. For øjeblikket understøttes kun Gubed. Du finder mere information om Gubed på http://gubed.sourceforge.net. Fejlsøgningspluginnet kan indstilles med knappen Tilvalgv. Læs “Fejlsøgning i Quanta Plus” for at få rede på mere om fejlsøgning.
Projektvisningen som indlæses når projektet åbnes. Du kan læse mere om projektvisninger i “Projektvisninger”.
På siden Overførselsprofiler kan du indstille overførselsprofilerne (se “Oplægningsprofiler”), samt aktivere visning af en trævisning med indholdet på serveren for hver profil, ved at markere afkrydsningsfeltet Vis en trævisning for hver profil.
På siden Gruppeindstilling kan du tilføje, redigere og fjerne medlemmer i projektet samt definere en e-mail-liste. Læs “Teamudvikling” for detaljer.
På siden Begivenhedindstilling kan du Aktivere begivenhedshandlinger, tilføje, ændre og fjerne disse handlinger. Begivenhedshandlinger udføres når visse fordefinerede begivenheder indtræffer, såsom at en fil gemmes. Se “Begivenhedshandlinger” for detaljer.
Normalt åbner Quanta Plus det seneste projekt som er blevet brugt ved start. Denne opførsel kan for øjeblikket ikke indstilles.
For at åbne et andet projekt, vælges i menuen , eller ikonen Åbn projekt på værktøjslinjen. Dialogen for at åbne projekter dukker op, og lader dig vælge det projekt du ønsker at åbne. Projekter har filendelsen webprj.
Når du afslutter Quanta Plus, gemmes projektfilen automatisk. Du bliver bedt om at gemme alle ændringer inden Quanta Plus afsluttes, hvis der findes nogen ændrede filer. Samme opførsel gælder hvis du indlæser et nyt projekt.
Projekttrævisningen gør at du enkelt kan komme til filer i projektet. Det er her du håndter filerne i det nuværende projekt.
For filer, vises følgende menu ved et højreklik med musen:
Disse valgmuligheder er ret selvforklarende, og overlades til læserens egen udforskning.
Mapper er lignende, men mangler museknap-menuvalgmulighederne og .
Disse valgmuligheder overlades også til læserens udforskning.
Dialogen til at lægge projekt op:
Dialogen til at lægge projekter op:
Her kan vælges forskellige profiler. Profilen indeholder information om hvor oplagte filer skal placeres. Læs “Oplægningsprofiler”.
Denne knap gør det muligt at oprette nye profiler til oplægning af filer.
Dette tillader dig at redigere den valgte oplægninsprofil.
Dette tillader dig at fjerne den valgte profil. Hvis kun en profil er til rådighed, er knapperne nedtonet for at forhindre profilen fjernes.
Kodeordet, der er gemt i hukommelsen, går tabt så snart programmet lukkes. Denne indstilling er brugbar hvis hyppig oplægning af filer er nødvendig og du ikke vil bruge den mere usikre “Gem kodeord på disk”-indstilling.
Markér alle filer i projektet til blive lagt op.
Markér alle ændrede filer til at blive lagt op.
Afmarkerer alle filer på listen.
Markerer eller afmarkerer alle filer på listen.
Ekspanderer alle mapper.
Lukker for alle mapper.
Opdaterer listen.
Start oplægningen
Dette afbryder overførslen som er i gang, eller afslutter dialogen hvis du ændrer mening inden du starter oplægningen.
Med Quanta Plus kan du definere flere oplægninsprofiler og på den måde lægge dit projekt (eller dele af dit projekt) op på forskellige servere. Når du redigerer eller opretter en profil vil du få følgende dialog at se:
Indtast navnet på den profil du vil bruge.
Dette er værtsmaskinenavnet på serveren som du kopierer filer til. Enten et fuldstændigt domænenavn, eller en IP-adresse, vil virke.
Overførselsprotokol som skal anvendes til oplægningen. Afhængig af din version af KDE, varierer denne listen. Du bør i det mindste kunne vælge blandt FTP, fil (dvs. lokal) og NFS.
Port til overførslen. Oftest behøver du ikke bekymre dig om den, hvis netværksadministratoren ikke har flyttet en tjeneste til en port som adskiller sig fra den normale velkendte port.
Brugernavn som anvendes til godkendelse.
Kodeord som anvendes til godkendelse.
Afhængig af hvor paranoid du er, er dette en god og tidsbesparende funktion eller en direkte fare. Brug den ifølge egen dømmekraft. Kodeordet opbevares på disken i tilsløret form så det ikke bare uden videre kan læses, men alle med kendskab til programmering kan let fjerne denne sløring.
Dette er grundsøgestien på værtsmaskinen hvortil du vil kopiere filer.
Tillader dig at markere den aktuelle profil som standardprofilen.
En projektvisning er blot et sæt filer og værktøjslinjer. Du kan have flere visninger i et projekt, hvilket betyder at blot at ændre visning kan du indlæse flere filer og værktøjslinjer som erstatter filer og værktøjslinjer som for øjeblikket er åbne.
Visninger kan gemmes, åbnes eller fjernes ved at bruge menuen eller projektværktøjslinjen, som der er adgang til med ->->.
Du kan have en standardvisning (som indlæses når projektet åbnes). Se “Indstil projekter”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Skabeloner er i grunden dokumentskeletter, kodefragmenter og filer at linke til. Quanta Plus anvender hovedsageligt skabeloner som et almindeligt filsystem med udvidet organisation og en udvidet grænseflade. Du kan kopiere, flytte eller linke alle arkiver som findes på systemet til skabelontræet. Tænk på Quanta Plus's skabeloner som om de har cirka samme begrænsninger for din fantasi som filsystemet har.
Skabeloner findes i mappehierarkier. Der er ingen grænse for hvor dybe hierarkierne kan være, men i en given mappe forventer Quanta Plus en konsistent handling for basisskabelontypen som beskrevet nedenfor. Desuden tillader skabeloner at indledende og efterfølgende tekst sammensættes med skabeloner som ikke har nogen dokumenttype. Denne funktion letter oprettelsen af tag. I næste udgave efter introduktionen planlægges det at tilføje mulighed for at videregive variable til teksten, som information om billedstørrelse, som en hjælp til oprettelse af tag.
Formålet med skabeloner er at udvide dem så de omfatter “begrebs”-skabeloner med flere filer, som er anvendelige til ting som at bestille noget eller oprette et afsnit om et program. Ideelt bliver dette et værktøj som gør dit arbejde mere produktivt og dynamisk. Slutmålet er at have et design med strukturskabeloner der kan bruges til at design og interaktiv opdatering af dine websteder. Hvis du gerne vil involveres, så kig på vor side på under hjælp søges.
Visse af skabelonerne som levereres med Quanta Plus har betingelser for at kunne anvendes. Læs beskrivelsen af betingelser for anvendelse højst oppe i hver skabelon omhyggeligt, inden du anvender den.
Quanta Plus understøtter forskellige skabelontyper. De er:
| Binære skabeloner |
| Dokumentskabeloner |
| Tekststumper |
| Websiteskabeloner |
Binære er hvad som helst der ikke identificeres som ren tekst. Det kan være en hvilken som helst fil, inklusive billeder, PDF-filer, flash-filer osv. Binære skabeloner inkluderes typisk i dit dokument gennem link (dvs. billeder som en<img src=/src/url>. Nogle eksempler kan findes under Se venligst “Værktøjsvisningerne” for mere information om Skabelon træet.
Dokumenter kan være en hvilken som helst slags tekstdokument. Du kan oprette nye dokumenter baseret på disse skabeloner. I almindelighed bør du placere mere specifikke eller forskellige dokumenter i undermapper. Her kan du oprette et grundlæggende skelet for hvad du gør og udføre arbejdet på en organiseret måde, for at opnå meget højere effektivitet. Eksempler kan findes under Globale skabeloner. Se venligst “Værktøjsvisningerne” for mere information om Skabelon træet.
Denne skabelontype er brugbar når du ikke vil oprette et nyt dokument baseret på en skabelon, men i stedet indsætte det samme tekstområde igen og igen i dine dokumenter. De kan indeholde alt, lige fra en kommentar og til en komplet JavaScript-baseret menuhåndtering eller et Perl-script. Se eksemplerne i Skabelon-træet under Globale skabeloner. Se venligst “Værktøjsvisningerne” for mere information omSkabelon-træet.
Som navnet antyder er disse skabeloner nyttige når man skal bygge et helt websted fra en skabelon. De er en samling af forskellige dokumenter som kan organiseres i en katalogstruktur, alt samlet i en komprimeret tar-fil. Aktuelt er der ingen eksempler på sådanne skabeloner i Quanta Plus.
Adgang til skabeloner er via deres angivne arbejdsområde i Quanta Plus.
Opret en dokumentstruktur som du godt kan lide (XML, HTML Docbook, osv..) og klik på ->->.
Når dette valg er udført, bemærker du at skabelonen ikke vises i projektfanebladet (selv om den gemmes som en projektskabelon). Kig under skabelonvisningen for at finde skabelonen i projektskabelonernes faneblad.
Markér noget tekst i dit dokument og klik på ->->. Alternativt kan du bare bruge træk og slip og trække markeringen hen til Skabeloner-trævisningen.
At oprette en binær skabelon er simpelt. Bare kopiér filen ind i en skabelonmappe. Du kan bruge standard filhåndteringsfunktioner, som træk og slip eller kopiér og indsæt fra Konqueror eller filtræet.
Projektskabeloner lader dig være mere fokuseret. Du kan oprette et sidehoved eller en sidefod, eller være dynamisk med PHP include-filer og linke dem. Der findes desuden nogen rigtigt lækre ting som vi tog med i betragtning til når skabeloner anvendes i projekter.
Når du opretter et projekt kan du vælge at kopiere alle eksisterende globale- og bruger-skabeloner. Gamle projekter får grundlæggende skabelonfunktioner, så ingenting går tabt. Du kan vælge hvor skabelonfilerne skal placeres, så de kan findes i serverens rodmappe for enkel overførsel, eller du kan gøre dem sikre at linke til under serverens rodmappe, hvilket er et meget smart trick. Når du linker til en fil som ikke findes i projektskabelonerne bliver du bedt om at kopiere filen til projektskabelonerne inden linkning. Det forhindrer forkerte link ved oplægning. Du kan altid styre hvor du placerer dine skabeloner, så du kan vælge at flytte dem. Dog overvåger Quanta Plus ikke dette, så du skal ændre link.
Skabelonstrukturen i skabelonfanebladet er baseret på filerne som findes i $ og KDEDIR/share/apps/quanta/templates $. Hver af disse mapper specificeres som en af fire slags beholdere som forklaret:herover. HOME/.kde/share/apps/quanta/templates
For at indstille opførslen for hver mappe, højreklikkes på mappen i skabelonvisningen og vælges. Følgende dialog vises:
Egenskabsdialog.
Dropned-menu med de tre typer som tidligere blev diskuteret: filer, tekst og skabeloner. Feltet er inaktivt hvis du ikke har Arv overliggende egenskab markeret.
<foo>)Dette er normalt markeret, og er udmærket for alt undtagen topniveaumapperne i skabelontræet. Hvis topniveaumappen har dette markeret, inaktiveres de egentlige skabeloner i mappen og alt som ikke udtrykkelig sat under den. Hvis der ikke er en topniveaumappe, så vil <blah> sige noget i retning af text/all. Hvis den er tom, er der en god chance for at du er i en topniveaumappe.
Aktiverer indledende og efterfølgende tekst for skabeloner i mappen. Det kan være et fælles sidehoved eller en fælles sidefod for alle skabeloner i et givet projekt, og så kopierer du indholdsskabeloner til mappen for at få en fuldstændig side med eget sidhoved/sidefod som udgangspunkt.
Selve teksten som indsættes før skabelonens indhold.
Selve teksten som indsættes efter skabelonens indhold.
Hvis du desuden kigger på valgmulighederne som vises med højre museknap, ser du fuldstændige filhåndteringsværktøjer til at oprette mapper eller kopiere og indsætte skabeloner fra et sted til en anden.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Visual Page Layout (VPL) editor (også kendt som WYSIWYG (Det du ser er det du får)) tillader dig at redigere et HTML- eller XHTML-dokument mens du ser ændringerne uden-videre. Nøjagtig ligesom din foretrukne tekstbehandling, kan du klikke på dit dokument så vil markøren blive vist, og gøre det muligt at skrive tekst, indsætte billeder, anvende tekstdekorationer, osv.. VPL's mål er at tillade dig at lave storartede, gyldige netsider uden noget kendskab til Internet-opmarkeringssprog.
Quanta Plus har to tilstande: VPL-editor og VPL & Kildeeditorer, som der er adgang til fra -menuen. Den første erstatter Kildeeditoren med VPL-editoren, og den anden opdeler editorvinduer i to dele: Kildeeditoren og VPL-editoren.
VPL-editoren virker sådan her: Den indlæser et dokument såsom en normal HTML- eller XHTML-side og så viser en markør sig. Så kan du ændre den, og når du skifter tilbage til Kildeeditoren, ser du at de ændringer du lavede i VPL-editoren er blevet indflettet i Kildeeditoren.
Når du arbejder med VPL-editoren med et dokument der indeholder PHP, vil du se en lille grøn ikon der repræsenterer PHP-kode. Du kan ikke direkte redigere denne med VPL-editoren. For at redigere PHP, vil du stadig skulle bruge Kildeeditoren. Der er ingen planer om at ændre denne funktionalitet.
Den anden tilstand opfører sig nøjagtigt som den første, undtagen at du med det samme ser effekten af dine ændringer, enten i Kildeeditoren eller i VPL-editoren og markørerne i kildeeditoren og VPL-editoren er synkroniserede. Et tryk på F9 indlæser denne tilstand, men hvis den allerede er indlæst så vil den flytte fokus fra en visning til en anden, mens den holder dig på samme sted i dokumenter.
Gemopfriskningsintervallerne mellem VPL-editoren og Kildeeditoren kan indstilles. Gå til ->. Vælg -fanebladet. Du kan nu vælge om du kun ønsker at genopfriske en visning når du klikker på den eller automatisk. Hvis du vælger automatisk, så kan du vælge et genopfriskningsinterval. Den generelle anbefaling er: Et mindre tal for hurtige computere og et større tal for langsommere.
VPL & Kildeeditor-tilstand.
Lad os nu sige at du ønsker at redigere overskriften på din netside. Hvordan gør du det? Du starter blot ->. Dette værktøj tillader at redigere “usynlige” tag når VPL-editoren bruges. Dokumentegenskaber-dialogen startes også når du laver et nyt dokument i VPL-editor-tilstanden. Dette er for at mindske mængden af kode du skal skrive i hånden. Med den kan du redigere:
Titlen på dokumentet
Metatag tillader dig at opbevare informationer om selve dokumentet f.eks. nøgleord til søgemaskiner på internettet. Du kan tilføje eller fjerne Meta-punkter ved at trykke på de to knapper nedenfor, og redigere dem ved at klikke på listen f.eks. put “nøgleord” på “navne”-søjlen og “nøgleord1 nøgleord2” på “indhold”-søjlen.
CSS-regler er den nye måde at fortælle din browser hvordan en side skal præsenteres. Du kan tilføje eller slette CSS-regler ved at trykke på knapperne nedenfor. Du kan også udfylde felter såsom Meta-punkter. Redigering af CSS-regler er endnu ikke understøttet.
Du kan også linke til et eksternt CSS-stilark. Klik blot på Gennemsøg-knappen og vælg din fil.
Du kan bruge markøren ligesom du gør i en tekstbehandling, og flytte med pilene. Det kan ske at markøren ikke ønsker at gå derhen hvor du ønsker den skal gå hen (en irriterende fejl). Markering virker også som sædvanligt. Du kan indsætte tekst ved at skrive og fjerne tekst ved at trykke på Backspace eller Del-tasten.
Nu kommer vi til at indsætte mærker. Du kan indsætte billeder, appletter, tekstdekorationer såsom fed type og så videre ved at bruge de samme værktøjslinjer du bruger i kildeeditoren. Bemærk at indsættelse af mærker ikke fjerner tidligere identiske mærker, f.eks. hvis du indsætter et ankermærke omkring noget tekst, så skal du fjerne ethvert andet anker omkring teksten.
Nogle punkter på værktøjslinjen vil blive deaktiverede, såsom Tabel-guide eller Hurtig liste-guide. De vil senere komme til at virke i VPL, men i denne udgave, må du bruge Tabeller eller Lister værktøjslinjerne.
For at redigere et tag (det kunne være et billede, en applet, eller hvad som helst), skifter du til Attributtræet, via ->. Klik på det mærke du ønsker at ændre, eller hvis du ikke kan få adgang til det, klik på et objekt indeholdt i det. Attributtræet vil vise de nuværende mærkenavne, så vel som en liste af alt de er afledt fra og attributter. For øjeblikket understøtter VPL ikke, for eksempel, XHTML + MathML, men du vil se at du kan redigere navnerum via denne visning. Du kan blot klikke på Værdi-feltet og ændre hvad du ønsker. Hvis du vil have adgang til et mærke det nuværende er afledt fra, så vælg det i og så vil Attributtræet indlæse det.
For at slette et mærke, vil vi bruge Attributtræet. Har du bemærket de to små røde kryds foroven til højre? Den første sletter kun det mærke der er valgt nu og hvis HTML/XHTML-specifikationen ikke tillader afledte af det slettede mærke kan være afledt af et mærke længere tilbage, så slettes disse også, og så videre. Det andet kryds vil slette det valgte mærke så vel som alle dets afledte. så vær påpasselig.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Dette kapitel forklarer de forskellige funktioner som findes i menulinjen.
Opret en ny, tom fil.
Søg i filsystemet for at åbne en eksisterende fil.
Hurtigliste med nogle af de seneste filerne som du åbnede. Listen ændres hver gang du åbner en fil som ikke findes i den, og de ældste filer fjernes først.
Gem ændringerne i den aktive fil.
Gem den aktive fil under et andet navn.
Dette lader dig gemme kodestumper og hele filer som en skabelon til senere brug. Se afsnittet om skabeloner. Hvis du forsøger at gemme valgt tekst eller fil udenfor den lokale mappe eller projektets skabelonmappe, får du en fejl.
Lader dig gemme en fil som en skabelon i det lokale område.
Lader dig gemme en fil som en skabelon i projektområdet.
Lader dig gemme markeret tekst (dvs. et kodeafsnit) i en lokal skabelonfil.
Lader dig gemme markeret tekst (dvs. et kodeafsnit) i en projektskabelonfil.
Gem alle filer som er ændret i editoren.
Genindlæser det dokument som har fokus.
Du kan rent faktisk udskrive dine dokumenter. Bruger Kprinter-grænsefladen.
Afslut Quanta Plus.
Fortryd den seneste handling som udførtes.
Gør den sidste fortrudte handling om.
Klip den markerede tekstblok ud og læg dens indhold på klippebordet.
Kopiér den markerede tekstblok til klippebordet.
Indsæt klippebordets indhold ved nuværende markørposition.
Konverterer klippebordstekstens HTML-specialtegn til HTML-objekter, inden de indsættes i teksten, så de vises på rigtig måde, og ikke håndteres som mærker af browser-klienten.
Konverterer klippebordets tekst til en kodet netadresse, som er den rigtige måde at indsætte specialtegn og mellemrum i netadresser. Anvendes hovedsageligt når en netadresse indsættes i et anker-mærke.
Markér al tekst i dokumentet.
Afmarkér al tekst i dokumentet.
Slå blokmarkering til eller fra. Lader dig vælge tekstblokke med tastaturet uden at holde shift-tasten nede.
Sætter Insert-tasten ud af kraft.
Søg efter streng eller regulært udtryk i dette dokument.
Gentag søgningen nedad i dokumentet fra den nuværende position.
Gentag søgningen opad i dokumentet fra den nuværende position.
Erstat streng eller regulært udtryk med tekst i denne fil.
Gå direkte til et angivet linjenummer. Dette er virkelig anvendeligt når et PHP-script laver uventede fejl!
Søg efter en streng eller et udtryk i filer i den valgte mappe. En slags grafisk grep eller sed, med nogle fordefinerede mønstre som hjælp.
Ekspanderer forkortelserne. Forkortelser kan defineres i dialogen ->.
Reformaterer kildekoden efter samme regler som sidelayouteditoren indsætter mærkerne.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Vis eller skjul filtræet.
Vis eller skjul projekttræet.
Vis eller skjul skabelontræet.
Vis eller skjul scripttræet.
Vis eller skjul dokumentstrukturtræet.
Vis eller skjul egenskabstræet.
Vis eller skjul dokumentationstræet.
Vis eller skjul meddelelsevinduet. Dette er vinduet hvor du ser udskrift fra scripthandlinger og fejlsøgeren.
Slår visning af Fejlrapporteringfor neden i Quanta Plus hovedvindue til og fra. Fejlrapportering aktiveres når du skifter til Strukturtræet.
Viser noteringsvisningen. Læs “Noteringer” for detaljeret information.
Viser filerne på serveren for en overførselsprofil.
Vis eller skjul ikonkanten til venstre for hovedredigeringsvinduet. Denne kant tillader at bogmærker håndteres med et klik.
Vis eller skjul linjenummer langs venstrekanten på hovedredigeringsvinduet.
Vælger omformatering af tekst til en bestemt bredde mens du skriver.
Skift til kilden for et dokument der skal redigeres.
Skift til VPL-editor for at redigere et dokument.
Skift til opdelt skærmtilstand for at redigere et dokument.
Forhåndsviser dette dokument.
Navigér tilbage et skridt i forhåndsvisningen.
Navigér fremad et skridt i forhåndsvisningen, efter at være gået tilbage i den.
Indlæs forhåndsvisningen fra disk.
Vis denne fil med Konqueror.
Vis nuværende fil med Mozilla Firefox browseren.
Vis denne fil med Mozilla®.
Vis denne fil med Netscape®.
Vis denne fil med Opera.
Vis denne fil med Lynx (en tekstbaseret browser.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Tilføjer et bogmærke på den aktuelle linje i denne fil.
Rydder alle bogmærker sat i dette dokument.
Hvis du har bogmærker i nuværende fil, ses de i menuen sammen med punktet Foregående eller Næste afhængig af markørens position i dokumentet.
Hvis du har bogmærker i andre åbne dokumenter, ses de i menuen grupperede ifølge de andre dokumenters filnavne.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Hvordan projekter bruges i Quanta Plus beskrives under “Projekter”.
Start guiden for at oprette projekt.
Åbn et eksisterede projekt fra disk. Quanta Plus-projekter gemmes med filendelsen .webprj.
Vis en liste med projekter som nyligst brugtes, for hurtig adgang.
Luk dette projekt.
Åbner en “visning”, en specifik kombination af åbne filer som du tidligere gemte.
Gem det nuværende sæt af åbne filer som en “visning”.
Gem det nuværende sæt åbne filer som en “visning” under et andet navn.
Slet en “Visning”.
Viser en dialog som lader dig vælge filer at tilføje til dette projekt. Filerne kopieres senere til projektmappen for redigering.
Indsætter en mappe og hele dens indhold i dette projekt.
Søg i projektmappen efter eventuelle nye filer som kunne findes der. Dette lader dig kopiere grafik til projektmappen eller en undermappe i den, og siden tilføje dem til projektet.
Læg filerne i projektet op til værtsmaskineserveren. Listen over tilgængelige overføringsformater afhænger af hvilken version af KDE du kører, og om du har hentet ekstra I/O-slaver eller ej.
Indstillinger som påvirker hvordan Quanta Plus håndterer projektet. Se afsnittet om Quanta Plus projekt for detaljeret information.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Indlæser en globalt definered værktøjslinje. Disse findes normalt i $. KDEDIR/share/apps/quanta/toolbars
Indlæser en lokalt definered værktøjslinje. Disse findes normalt i $. HOME/.kde/share/apps/quanta/toolbars
Indlæs en projektværktøjslinje. Disse findes i projektmappe/toolbars
Dialog til at gemme værktøjslinjer. Lader dig angive type af værktøjslinje, lokal eller projekt.
Gem som en lokal værktøjslinje i $. HOME/.kde/share/apps/quanta/toolbars
Gem som en projektværktøjslinje i projektmappe/toolbars
Viser en dialog til at oprette en ny værktøjslinje. Dette laver kun navnet. Handlinger skal tilføjes med menupunktet ->. Værktøjslinjer gemmes med menuen ->, eller når du afslutter bliver du bedt om at gemme værktøjslinjer som ikke er gemt.
Fjern en værktøjslinje fra brug. Dette tager den ikke væk fra disken. Hvis du ikke har gemt værktøjslinjen du fjerner, bliver du bedt om at gemme den.
Lader dig skifte navn på en værktøjslinje.
Dette er en handling for at sende din egen værktøjslinje som e-mail til en (måske til Quanta Plus-gruppen for at tilføje den i næste udgave!), så at de kan bruge den. Et e-mail-vindue startes, og din værktøjslinje tilføjes automatisk.
Dette lader dig overføre en værktøjslinje til hovedressourceserveren. Se “Del ressourcer”.
Dette lader dig overføre værktøjslinjer til hovedserveren, hvor andre kan hente den. Se “Del ressourcer”.
Dette lader dig hente værktøjslinjer fra internettet Se “Hent ressourcer”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Viser en dialog som lader dig ændre DTD for det nuværende dokument.
Gør det muligt at ændre indstillingsfilen description.rc for en DTEP.
Indlæs en DTD som du eller en anden lavede og konvertér den til Quanta Plus' indfødte beskrivelsesformat.
Indlæser eller opdaterer instanser fra en DTD. Det er nyttigt hvis du vil opdatere instanserne i en DTEP uden at genoprette hele. I tilfældet hvor den er global og du ikke har skriverettigheder til den globale KDE-mappe, mislykkes indlæsning af instanser.
Indlæs din egen DTEP.
Send din DTEP til en ven via KMail.
Dette lader hente en DTEP fra internettet. Se “Del ressourcer”.
Dette lader dig hente DTEP fra internettet. Se “Hent ressourcer”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Denne menu indeholder en liste med mærker som findes i værktøjslinjerne som for er indlæste for øjeblikket. Hvis du f.eks. har Standard (HTML) værktøjslinjen indlæst, så indeholder menuen undermenuen , som indeholder listen med mærker/handlinger i værktøjslinjen.
Lader dig komme til indstillingsdialogen for dette mærke, hvis der findes en sådan. Denne handling er ALTID TIL STEDE, fulgt af DTD-specifikke undermenuer.
Dette fremhæver det nuværende tag-område. Tag-området begynder hvor musemarkøren er placeret.
Aktiverer eller deaktiverer smart indsætning af mærker. For øjeblikket virker det kun med (X)HTML DTD'er. Smart indsætning betyder at Quanta Plus nægter at indsætte et mærke fra værktøjslinjen hvis mærket ikke kan være til stde på nuværende sted.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Menuen indeholder tilgængelige plugin under ovenstående menupunkt. Ved at klikke på dem, aktiveres de. Ved at klikke på et aktiveret plugin, inaktiveres det.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Vælg syntaksfremhævningstilstand for denne fil. Listen med tilgængelige fremhævningssystemer varierer afhængig af hvilken version af Kate du har.
Vælg kodningstype for linjeslut. Nyttigt hvisman bruger andre operativsystemer til udvikling. Vælg , eller .
Flyt den markerede tekstblok en tabulatorbredde til højre.
Flyt den markerede tekstblok en tabulatorbredde til venstre.
Fjern al indrykning.
Kommenter markeret tekst.
Afkommenterer markeret tekst.
Bryd teksten om i dette vindue til forud defineret bredde.
Kontrollér stavning i dette dokument.
Redigér betemte egenskbaer for et indlæst dokument ved brug af VPL-editor.
Konvertér alle mærker og/eller attribut tegntyper til et andet.
Kontrollerer syntaksen for dette dokument mod den valgte DTD ved brug af det eksterne tidy-program.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Lukker nuværende faneblad (dokument, plugin, forhåndsvisning eller dokumentation).
Lukker alle åbne faneblade.
Skifter mellem forskellige tilstande for brugergrænsefladen i farten. På grund af visse begrænsninger i KDE-bibliotekerne kan skiftet tage tid og forårsage grimme rester. Den tilstand det anbefales at bruge er IDEA-tilstand, som er standard, eller Fanebladssidetilstand, som er samme tilstand som fandtes i Quanta Plus 3.2 og tidligere versioner.
Desuden indeholder menuen en indgang for hvert åbent faneblad. Ved at vælge en sådan indgang, bliver det valgte faneblad det aktive.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Vis eller skjul værktøjslinjer som ikke er brugerdefinerede.
Vis eller skjul den DTD-specifikke værktøjslinje.
Vis eller skjul statuslinjen længst nede i Quanta Plus' hovedvindue.
Indstil in Quanta Plus' opførsel.
Indstil opførslen af den integrerede forhåndsvisning.
Ændringerne som laves i dialogen påvirker alle programmer som bruger KHTML-delprogrammet inklusive browseren Konqueror.
Her defineres handlinger til brug i værktøjslinjer. Se “Brugerdefinerede handlinger”.
Det er her du kan definere og ændre plugin.
Indstil opførslen i redigeringsvinduet. Se Kate's dokumentation for detaljeret information.
Dialog som lader dig tilføje eller fjerne ikoner i værktøjslinjer og ændre rækkefølgen som ikonerne vises.
Lader dig indstille de mange genvejstaster for redigering som er tilgængelige i Quanta Plus.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Quanta Plus indeholder KDE's s-menu med følgende punkter tilføjet:
Dette skal give hjælp baseret på de nuværende omgivelser for pegeren. Denne funktion er endnu ikke realiseret mens dette skrives.
Quanta Plus er et højkvalitetsprodukt som er frit tilgængelig, og har fri licens, men som alle projekter med åben kildekode, behøver udviklerne altid hjælp. Hvis du vil støtte udviklingen af Quanta Plus finansielt, kan du finde ud af hvordan det går til her.
KDE's standardmenu med hjælpemenupunkter ser ud som følger:
Starter KDE's Hjælpesystem startende med hjælpesiderne for dette program (dette dokument).
Ændrer musemarkøren til en kombination af en pil og et spørgsmålstegn. Klik på punkter indenfor dette program vil åbne et hjælpevindue (hvis der findes et for dette punkt) der forklarer punktets funktion.
Åbner problemrapport dialogen hvor du kan rapportere en fejl eller bede om en “ønskeseddel” egenskab.
Dette vil vise version og forfatterinformation.
Dette viser KDE versionen og anden basal information.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Dette kapitel beskriver hvordan du kontrollerer Quanta Plus' opførsel.
Indstillingsdialogerne er tilgængelige fra menuen Opsætning. Her vil vi kun diskutere nogle få af dem, resten er ikke specifikke for Quanta Plus og en kort beskrivelse kan findes på “menuen”.
Indstillingsdialogen kan startes ved at bruge +. Dialogen har flere sider og vi diskuterer dem her en efter en.
Du kan ændre Quanta Plus' opførsel mht. tag, inklusiv fuldstændiggørelse. Indgangene er:
Tag versaler: versaler for de automatisk indsattes tag. Standard versaltype betyder at tag indsættes som beskrevet i tagXML-filerne.
Attribut versaler: versaler for de automatisk indsatte attributter. Standard versaltype betyder at attributter indsættes som beskrevet i tagXML-filerne.
Attribut-citering med hvilke anførselstegn attributter indsættes af Quanta Plus.
Auto-luk valgfri tag: hvis aktiveret, lukkes tag hvor afslutningstag er valgfrit automatisk, så snart afslutningstagget indtastes >.
Auto-luk ikke-enkelte og ikke-valgfri tag: som før for resten af tag, med undtagelse af enkelt-tag.
Brug fuldstændiggørelse: slår fuldstændiggørelse af tag, attributter og funktioner osv. til og fra.
Opdatér åbnings/afslutningstag automatisk hvis aktiveret vil et korresponderende tag ændres så snart du ændrer åbningstagget eller afslutningstagget.
Automatisk erstatning af bogstaver med accent: hvis aktiveret, erstattes bogstaver med accent med deres koder mens du skriver.
En side hvori miljøet og nogle standardindstillinger kan kontrolleres.
Mimetyper: mimetyper der bruges til at genkende forskellige filtyper. Brug knappen Nulstil til standard til at udfylde indgangene med standardværdierne.
Standardtegnsæt: tegnsættet der bruges til de oprettede filer eller filer der indlæses på en anden måde end gennem -> (hvor du kan overskrive tegnsættet). Denne indstilling tilsidesættes af de samme indstillinger i Projektegenskaber hvis et projekt indlæses.
Standard-DTD:DTD'en der bruges til oprettede filer eller filer hvis DTD ikke blev genkendt. Denne indstilling tilsidesættes af den samme indstilling i Projektegenskaber hvis et projekt indlæses.
Opret sikkerhedskopier: Quanta Plus foretager sikkerhedskopiering af filer med intervaller, så hvis der sker strømafbrydelse eller programmet bryder sammen, kan dokumentet genskabes næste gang programmet startes. Dette er ikke det samme som sikkerhedskopien der oprettes når en fil gemmes. Selv for endnu ikke gemte dokumenter, oprettes der en sikkerhedskopi.
Opstarts-indstillinger: selvforklarende opsætning der kontrollerer hvad der sker ved opstart.
Her indstiller du Quanta Plus' udseende.
Forhåndsvisningen og dokumentationen kan vises i editor-området eller i en separat værktøjsvisning, hvor det også er muligt at se på dokumentation og forhåndsvisningen.
Det er også muligt at indstille værktøjslinjen og dokument-fanebladenes udseende.
Nulstil vinduelayout til standard ved næste opstart er brugbart når du har rodet rundt i brugergrænsefladen ved at ændre MDI-tilstand og dokket/afdokket værktøjsvisninger. Det er det samme som --resetlayout kommandolinje-flaget
Her kontrolleres også filtræernes opførsel.
Advarselbeskeder-sektionen er nyttig til at aktivere/deaktivere advarselsbeskeder der kan ses bort fra, ved at aktivere Vis ikke igen-feltet i dem.
Stedet hvor man ændrer VPL-opførsel. Du kan aktivere visningen af en ikon for scripter så vel som indstille synkroniseringen af VPL og kildekodevisningen, når du har aktiveret opdelt tilstanden. Se “-menuen” for at lære hvordan du aktiverer de forskellige tilstande.
Her kan du finindstille fortolkeren og strukturtræet, som er den visuelle repræsentation af fortolkerknudepunkter i dokumentet.
I Klik på strukturtræ-punkter er det muligt at ændre handlingerne der er tildelt museknapperne, når du klikker på strukturtræet.
I Strukturtræets udseende er det muligt at indstille hvilken slags knudepunkter der er synlige i træet, hvor ofte træet skal opdateres når der redigeres og ved en opdatering hvor dybt strukturtræet automatisk skal åbnes. Tomme knudepunkter er mellemrummene, mens tomme grupper er grupper for hvilke der ikke blev fundet noget element i det aktuelle dokument.
Stedet hvor forkortelser defineres (en slags skabeloner), som kan udvides til større tekst, mens der redigeres. Forkortelser er organiseret i grupper, hver gruppe kan være gyldig for mere end en DTEP. Det betyder at du kan have en gruppe der er gyldig for PHP, hvor "ifbetingelse"-forkortelsesskabelonen betyder noget andet end i en gruppe der gælder for JavaScript.
Brugerdefinérbare handlingsoprettelse og redigering er beskrevet i “Brugerdefinerede handlinger”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Her kan du håndtere dine plugin. Plugin er KPart-programmer der er skrevet af en trediepart og som kan genbruges i et hvilken som helst program der kan håndtere KParter. Den mest kendte er Konqueror. Når du opretter et plugin skal du angive:
Navn brugersynligt navn
Uddatavindue: plugin kan optræde i et faneblad i editoren eller i en separat værktøjsvisning i bunden.
Sted: stien til plugin, hvis den ikke er placeret på standardplaceringer som $.KDEDIR/lib
Filnavn: den relative søgesti og filnavn til den libtool-fil der hører til det respektive plugin.kde3/libcervisiapart.la
Inddata:denne information gives til plugin ved opstart, så det kan åbne den Nuværende fil mappen for den aktuelle fil (Nuværende filsti) eller Projektmappen.
Læs kun-part: tjekker om plugin nægter at indlæse. Læs kun-KParter nægter normalt at indlæse, med mindre denne indstilling er aktiveret.
Validér plugin hvis aktiveret vil Quanta Plus teste om den indtastede information er korrekt eller ej. Deaktivér hvis plugin ikke er tilgængelig og du installerer den senere så du kan lukke dialogen.
Se “-menuen” og “Brug af plugin”for information om brug af plugin.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Dette kapitel giver en oversigt over de avancerede funktioner i Quanta Plus, og hvordan de bruges.
Udgave 3.2 af Quanta Plus har mange nye XML-værktøjer og funktioner med sig. Værktøjerne er unikke i deres integration med Quanta Plus. Alle værktøjer bruger Kommander som grænseflade, med libxml og lixslt til baggrundsbehandling. Denne kombination giver hurtige, effektive, produktive og komplette værktøjer.
Quanta Plus understøtter KDE's to hoved-dokumentationsværktøjer: meinproc og checkXML.
Alle som har arbejdet med dokumentation af KDE kender til meinproc, og hvor fantastisk den er. Nu bliver det yderligere en smule bedre, med en udmærket grafisk grænseflade. Du behøver ikke længere bruge en terminal, klik blot på ikonen som ser ud som en processor, så er du klar!
Dette program forventer at en fil med navnet index.docbook findes i en mappe. Hvis index.docbook findes i denne arbejdsmappe, så lad Nuværende arbejdsmappe forblive markeret. Hvis den ikke gør det, så afmarkér Nuværende arbejdsmappe og indskriv mappen som du vil behandle i feltet Anden mappe.
Uddatafiler placeres i samme mappe som kildekodefilerne. Alle HTML-filer fjernes hver gang meinproc køres.
Igen, alle som har arbejdet med dokumentation af KDE kender til dette hjælpsomme program. Quanta Plus tilbyder også her en udmærket lille grafisk grænseflade.
Hvis den åbne fil er index.docbook, så lad Nuværende arbejdsmappe forblive markeret. Hvis den ikke er det, så afmarkér Nuværende arbejdsmappe og indskriv mappen hvor index.docbook kan findes.
Hvis der bliver nogen udskrift er din fil ugyldig. Ret de rapporterede fejl og forsøg igen.
Quanta Plus har et udmærket XML-valideringsværktøj, som bruger baggrundsprogrammet xmllint.
Hvis filen som skal valideres for har fokus øjeblikket Quanta Plus, så lad helt enkelt Nuværende fil være markeret. Hvis den ikke er det, afmarkér Nuværende fil og vælg filen som skal valideres i filvælgeren Anden fil.
Hvis du kun vil vide at en fil er velformateret, så markér afkrydsningsfeltet Kontrollér kun velformateret.
Hvis du bruger en DTD, og den specificeres i XML-filen, vælg DTD (intern), standardvalget, ellers vælg DTD (ekstern) og find DTD'en med filvælgeren for definitionens internet-adresse. Både til validering af W3C® XML schema og RelaxNG kræves ekstern definition via filvælgeren for Definitionens internet-adresse.
Ja, Quanta Plus har også et XSL-behandlingsværktøj! Det bruger værktøjet xsltproc som kommer med libxml2.
Hvis filen som skal behandles for øjeblikket har fokus i Quanta Plus, lad så helt enkelt Nuværende fil være markeret. Hvis den ikke er det, afmarkér Nuværende fil og vælg filen som skal behandles i filvælgeren Anden fil.
Vælg XSL-filen som du vil skal bruges.
Indtast navnet som du ønsker at resultatfilen skal kaldes. Filen skrives normalt i din hjemmemappe.
Dette program mangler fleksibilitet. Desværre, vi skal forsøge at gøre det bedre næste gang.
Quanta Plus kan indlæse plugin, som er KParter. Mekanismen med KParter, er en meget kraftfuld funktion i KDE. En KPart er et relativt lille, genbrugbar beholder for en funktion. Den gør det muligt for KDE-udviklere at bygge videre på andre programmørers arbejde på en enkel måde. Et eksempel på dette er Quanta Plus selv. Editoren som Quanta Plus bruger er Kate's KPart. Kate's KPart har allerede en mængde funktioner som Quanta Plus behøver, såsom syntaksfremhævning. Ved at integrere den i Quanta Plus, blev det muligt for Quanta Plus' udviklere at fokusere på hvad Quanta Plus skulle kunne gøre, i stedet for at håndtere de mange problemer der ville opstå ved at udvikle en ny editorkomponent fra begyndelsen.
Plugin som Quanta Plus indlæser, har måske ikke noget overhovedet at gøre med Quanta Plus selv. Det gør det til et meget kraftfuldt system. Du kan drage nytte af ekstra funktioner, og behøver ikke vente på at nogen integrerer dem i Quanta Plus. Plugin kan indlæses til et antal forskellige grafiske elementer. Mere om dette nedenfor.
For at installere et plugin eller et delprogram, bruges menuen ->. Det får følgende dialog frem:
Dialogen til at redigere plugin.
Denne dialog lader dig håndtere alle de definerede plugin, og lader dig tilføje nye. Vi beskriver hvert element i grænsefladen her.
Her kan du udfylde en søgesti. Når du tilføjer en plugin uden en Plads, søger Quanta Plus i denne søgesti for at finde dit plugin.
Dette viser en dialog som lader dig tilføje et nyt plugin.
Dette lader dig ændre indstillinger for et bestemt plugin.
Fjerner det markerede plugin.
Opdaterer dialogens indhold.
Læs “Indstilling af plugin” for at lære mere om plugin.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Ofte arbejder flere personer på et enkelt projekt og der er et eller andet hierakisk forhold mellem disse personer. Quanta Plus understøtter begrebet team-medlemmer og de kan indstilles i dialogen for -> (Shift+F7).
Dialogen Team-medlem-editor
Indgangene Navn, E-mail er selvforklarende. Alias er brugerens alias og fungerer som en entydig identifikator.
Rolle angiver medlemmets rolle i projektet og kan være en af følgende:
Team-leder
Delprojekt-leder
Opgave-leder
Almindeligt medlem
Opgave er en beskrivelse af en opgave tildelt dette medlem.
Del-projekt: du kan vælge en liste af del-projekter. Del-projekter kan indstilles og oprettes ved at trykke på knappen Redigér del-projekter. Hvert del-projekt har et synligt brugernavn og placering. Placeringen er en relativ sti til mappen under projekt-træet. Det betyder at del-projektet er en mappe under hovedprojektet. F.eks. kan hovedprojektet være dit firmas websted, hvor et del-projekt kan være webstedet for firmaets intranet, placeret i mappen intranet i hovedprojektets mappe.
Et medlem kan have mere end en rolle i projektet, som f.eks. både team-leder og del-projektleder.
En bruger bør vælge hvem i listen med gruppemedlemmer han selv er. Dette er muligt ved at markere et gruppemedlem i listen og trykke på knappen Angiv som dig selv. Medlemmet som for øjeblikket er markeret (din identitet) vises med fede typer efter teksten Du er:.
Aliasser og at indstille dig selv er vigtigt angående meddelelser og noteringer. Se “Noteringer” for at lære dig mere om noteringer.
Udover at holde styr på dit team, er der flere fordele ved at indstille team-medlemmer: du kan sætte en begivenhed til at informere team-ledere om hvornår noget skal ske. Se i “Begivenhedshandlinger” hvordan man gør.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Begivenhedshandlinger er handlinger der udføres når der sker en eller anden begivenhed i projektet. Et eksempel kunne være at gemme oplysninger om hvornår projektet blev åbnet og lukket, så der senere kan foretages en granskning af hvor meget hvert medlem arbejdede på det, eller afsendelse af en e-mail når en fil bliver gemt eller tilføjet til CVS vha. et script når filen tilføjes projektet og denne liste kan fortsættes.
På siden Begivenheds-indstillinger i -> (Shift+F7)-dialogen, kan du oprette, redigere og slette begivenhedshandlinger.
Begivenhedseditor-dialogen
Indgangene i dialogen er:
handlingen udføres når begivenheden fra listen sker. Navnene er selvforklarende.
den udførte handlings-type. Mulighederne er:
en handling der ikke er en brugerdefineret scripthandling. Se “Brugerdefinerede handlinger” for brugerhandling.
Handlingsnavn specificerer handlingen der skal udføres nå begivenheden sker.
en e-mail bliver sendt til modtageren valgt i Modtager-listen, når handlingen sker. Modtageren kan være et team eller en del-projektleder. Se “Teamudvikling” for definering af sådanne ledere.
begivenheden gemmes i en fil. Argumenterne til denne handling er:
filnavnet med den fulde sti
Hvor meget information loggen skal indeholde
Om der i eksisterende filer skal oprettes/overskrives eller tilføjes en nye log-begivenhed.
en brugerdefineret script-handling. Se “Brugerdefinerede handlinger” for brugerhandling.
Handlingsnavn specificerer handlingen der skal udføres nå begivenheden sker.
De andre indgange afhænger af Handlingstypen som beskrevet før.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Noteringer er specielle kommentarer i dokumenterne. De adskiller sig fra almindelige kommentarer i følgende henseender:
informationen samles ind af Quanta og vises i værktøjsvisningen Noteringer.
informationen kan adresseres til et gruppemedlem
At indtaste noteringer er simpelt. Du kan enten bruge tilvalget Notering i editorens sammenhængsafhængige menu, eller skrive nøgleordet @annotation i et kommentarområde fulgt af noteringens tekst.
Eksempel 6.1. Noteringseksempel i XML
<!-- @annotation Det er muligt at denne koden er forkert. -->
<!-- @annotation Flerlinje notering. -->
Eksempel 6.2. Noteringseksempel i PHP
/* @annotation Brug PHP-kommentarer ved noteringer i et PHP-område */
Noteringer kan adresseres til et særligt medlem i gruppen. Syntaksen i dette tilfælde er @annotation(alias) eller @annotation(rolle), hvor alias er gruppemedlemmets alias, mens rolle er en projektrolle fra følgende liste:
gruppeleder
opgaveleder
delprojektleder
Eksempel 6.3. Lav en note til et gruppemedlem med alias erik
<-- @annotation(eric) Erik, kig lige på dette. Andreas -->
Eksempel 6.4. Informér gruppelederen
<-- @annotation(gruppeleder) Dette er meget vigtigt for gruppen -->
Eksempel 6.5. Informér PHP-delprojektlederen
// @annotation(delprojektleder:PHP) Hvad mener du om det?
Aliasser og rollenavne er ikke versalfølsomme, men mellemrum omkring parenteser og : gør noteringen ugyldig.
Mere om gruppemedlemmer, roller og aliasser findes under “Teamudvikling”.
Noteringerne som findes i projektet kan inspekteres i visningen Noteringer. Den består af tre fanebalde:
Noteringerne som findes i den nuværende fil.
Noteringer i projektet adresserede til dig. Indgangene grupperes pr fil.
Noteringerne som findes i alle projektfiler, grupperede ifølge fil.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Med Quanta Plus version 3.3 blev fejlsøgningshåndteringen genimplementeret. Understøttelsen af den nu forældede indbyggede PHP (3)-fejlsøger blev fjernet, det samme blev understøttelsen af dbg-fejlsøgeren. I stedet blev der udviklet et generelt fejlsøgnings-system så der kan laves forskellige implementeringer via plugin.
Aktuelt er der kun et plugin til rådighed, som understøtter Gubed PHP Debugger i Quanta Plus
For at bruge fejlsøgeren i dit projekt, åbner du projektindstillingerne og vælger et passende fejlsøger-plugin. For at ændre fejlsøger-specifikke indstillinger, trykker du op knappen 'Opsætning' ved siden af fejlsøgerens plugin drop-ned-felt.
Så snart er projekt har en aktiveret fejlsøger, vil yderligere et par elementer optræde i Quanta Plus' brugergrænseflade:
En ny menu vil optræde hvor du har adgang til de fleste af fejlsøgerens funktioner.
En værktøjslinje med adgang til de mest almindelige fejlsøgerkommandoer.
En værktøjsvisning hvor indholdet af de overvågede variabler vises. Optræder som standard i den venstre dok.
En værktøjsvisning hvor alle stoppunkter, linje og betinget, er listet. Optræder som standard i dokken i bunden.
En værktøjsvisning hvor der vises uddata (som i HTML) fra fejlsøgeren. Optræder som standard i dokken i bunden.
Afhængigt af hvad fejlsøgerplugin understøtter, bliver alle, eller kun nogle af de følgende funktionaliteter tilgængelige.
Denne handling bruges til at forbinde til fejlsøgeren hvis det er nødvendigt, eller fortælle plugin at begynde at lytte efter fejlsøgningsforespørgsler. Denne handling aktiveres som standard når et projekt der brugere fejlsøgeren åbnes, så normalt behøver du ikke bekymre dig om den.
Det modsatte af ->->. Lukker en forbindelse til fejlsøgeren eller stopper med at lytte efter forespørgsler.
Sender en HTTP-forespørgsel til serveren for at initiere en fejlsøgningsforespørgsel. At bruge denne handling er det samme som at bruge en browser til at vise de aktuelle dokument. Uddata fra forespørgslen ender i fejlsøgninsuddata-dokken.
Pauserer et kørende script
Fortæller fejlsøgeren den skal eksekvere scriptet og sende information om overvågede variable og den aktuelle eksekveringsrækkefølge, mens den arbejder sig fremad. Hvis dette gøres men et script er pauseret, vil eksekveringen fortsætte. Gøres det før en fejlsøgningsforespørgsel initieres, vil scriptet køres så snart forespørgslen initieres.
Fortæller fejlsøgeren den skal eksekvere scriptet uden at sende information om overvågede variable og eksekveringsrækkefølgen. Gøres dette mens et script er pauseret, vil eksekveringen fortsætte. Gøres det før en fejlsøgnings-forespørgsel, begynder scriptet at springe så snart forespørgslen er initieret.
Fortæller fejlsøgeren at eksekvere den næste instruktion i scriptet, uden at træde ind i funktioner eller inkluderinger.
Fortæller fejlsøgeren at udføre næste instruktion i scriptet og træde ind i funktioner eller inkluderinger, hvis det er muligt.
Fortæller fejlsøgeren at udføre indtil der trædes ud af den aktuelle funktion.
Fortæller fejlsøgeren at springe over næste instruktion og fortsætte til den næste, som om den aktuelle ikke eksisterede.
Fortæller fejlsøgeren den skal dræbe det kørende script.
Åbner en dialog hvor du kan angive betingede stoppunkter.
Slår et stoppunkt til/fra på den linje markøren er i den aktuelle fil.
Rydder alle stoppunkterne.
Åbner en dialog hvor du kan indtaste en variabel eller et udtryk du ønsker at overvåge. Værdien af overvågningen vil optræde i variabel-værktøjsvisningen.
Åbner en dialog hvor du kan indtaste en variabel og en ny værdi til den.
KXsldbg er lavet af Keith Isdale, ligesom dette afsnit af dokumentationen. KXsldbg er en KDE-grænseflade og en Kpart for xsldbg, som du finder på http://xsldbg.sf.net sammen med meget andet af Keiths arbejde.
For at starte KXsldbg, vælges ->.
Se dokumentationen for KXsldbg for yderligere information om dets brug.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Dette kapitel beskriver hvordan Quanta Plus kan tilpasses netop dine behov, og hvordan du kan hjælpe til med at gøre Quanta Plus bedre.
Dokumenttype-redigeringspakken (DTEP) bruges i Quanta Plus til at tilføje understøttelse for mærker, scriptsprog og stilskabeloner. De tillader Quanta Plus at levere funktioner såsom automatisk komplettering og knudetræ. Deres enkelhed og fleksibilitet er det der gør Quanta Plus til et hurtig, udviklervenlig integreret udviklingsmiljø for internet-udviklere. De gør Quanta Plus til et letanvendeligt, produktivt miljø.
Der findes to varianter af DTEP, familie 1, som er opmarkeringer, og familie 2 som er scriptsprog og stilskabeloner. En DTEP består af to dele, mærkemappen og værktøjslinjerne. Mærkemapper består af to filtyper, filerne description.rc og XML-mærker, som har endelsen .tag. Værktøjslinjer er bekvemme, ikonorienterede linjer med knapper (ovenfor redigeringsvinduet), som tilføjer til tekst til et dokument hurtigere end brugeren kan skrive.
En DTEP kan laves manuelt (se nedenfor), downloades eller laves automatisk ud fra en eksisterende DTD. Se “Konvertér en DTD til en DTEP” for information om konvertering.
Dette dokument beskriver hvordan XML-mærkefiler, filen description.rc og værktøjslinjer laves. I korthed, en DTEP.
XML-mærkefiler (.tag) definerer både egenskaber specifikke for et mærke, samt layout og indhold i egenskabsdialogen som Quanta Plus viser for mærket. Filen description.rc sørger for regler og information om en hel DTEP. Værktøjslinjer sørger for en hurtig måde at tilføje mærker til et dokument, uden at behøve bekymre sig om fejlstavninger eller lignende.
Mærkemapper er netop det, mapper. De består kun af filerne description.rc og XML-mærkefiler. Mærkemapperne bærer mærkesprogets navn og version, hvis der findes en (for eksempel html-4.01-strict).
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 |
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.
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 |
Omgivelse for mærket som defineres. Dette er et typeelement kun med element.
| Overliggende | Underliggende |
|---|---|
| TAGS | label, attr, stoppingtags |
| Egenskab | Type | Værdier | Standard | Brug | Beskrivelse |
|---|---|---|---|---|---|
| navn | streng | kræves | Angiver navnet på mærken som bliver defineret. | ||
| single | boolean | valgfri | Angiver om mærket kræver et afsluttende mærke </(mærkenavn)>. | ||
| type | streng | xmltag | valgfri | Angiver typen af mærket som defineres. | |
| xmltag | Typen for mærket er XML-baseret (kun familie 1). | ||||
| 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). | ||||
| returnType | streng | void | valgfri | Angiver returtypen for mærket som defineres (kun familie 2). | |
| void | Mærketypen returnerer ingenting. | ||||
| int | Mærketypen returnerar et heltal. | ||||
| float | Mærketypen returnerer et decimaltal. | ||||
| long | Mærketypen returnerer et langt heltal. | ||||
| streng | Mærketypen returnerer en streng. | ||||
| version | streng | valgfri | Angiver sprogets version som mærket er gyldig for | ||
| extends | streng | valgfri | Kun gyldig hvis typen for mærket er "klasse". Navnet på basisklassen for denne klasse (kun familie 2). | ||
| klasse | streng | valgfri | Kun gyldig hvis typen er "method". Angiver navnet på klassen som denne metoden tilhører (kun familie 2). | ||
| common | boolean | valgfri | Hvis "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). | ||
| comment | streng | valgfri | kommentarstrengen vises ved siden af mærke taggnavnet i kompletteringsfeltet |
Placér en rubrik i dialogen. Teksten angives af mærket <text>. Dette er et typeelement kun med element.
| Overliggende | Underliggende |
|---|---|
| tag | text, location |
Definerer en egenskab for mærket. Elementet forekommer en gang for hver egenskab. Det definerer egenskabens navn og type. Det indeholder også yderligere mærker som angiver hvordan egenskaben skal vises, osv. Dette er et typeelement med kun element.
| Overliggende | Underliggende |
|---|---|
| tag | location, list, tooltip, whatsthis, textlocation |
| Egenskab | Type | Værdier | Standard | Brug | Beskrivelse |
|---|---|---|---|---|---|
| navn | streng | kræves | Angiver navnet på egenskaben som er ved at blive defineres. | ||
| type | streng | input | kræves | Angiver typen for egenskaben som er ved at blive defineres. | |
| input | Feltet understøtter frie tekstindgange (tekstfelt). | ||||
| check | Feltets værdi er boolesk (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. | ||||
| status | streng | valgfri | kræves | Angiver om argumentet kræves eller ej (Kun familie 2). | |
| valgfri | Argumentet kræves ikke. | ||||
| kræves | Argumentet kræves. | ||||
| underforstået | Argumentet er underforstået. | ||||
| source | streng | valgfri | Angiver 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 | ||||
| interface | streng | valgfri | Kræver source="dcop". DCOP-grænsefladen inde i Quanta Plus bruges til at hente kildedata. | ||
| method | streng | valgfri | Kræver source="dcop" og et grænsefladenavn. DCOP-metodenavnet inde i Quanta Plus bruges til at hente kildedata. | ||
| arguments | streng | valgfri | Kræ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. |
Definerer værktøjsvinket for et felt i dialogen. Dette element er kun tekst.
For nuværende understøttes kun almindelig tekst (du kan ikke bruge opmarkering).
| Overliggende | Underliggende |
|---|---|
| attr | INGEN |
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 |
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 |
Angiver positionen for et mærkes egenskabstekst inde i en dialog. Dette mærke kan kun findes én gang for hver egenskab i dialogen (dvs. en gang for hver <attr>-mærke). Dette element er tomt.
| Overliggende | Underliggende |
|---|---|
| attr | INGEN |
| Egenskab | Type | Brug | Beskrivelse |
|---|---|---|---|
| row | positivt heltal | kræves | Angiver linjen i dialogens layout for et felt eller en etiket. |
| col | positivt heltal | kræves | Angiver søjlen i dialogens layout for et felt eller en etiket. |
| rowspan | positivt heltal | valgfri | Angiver antal linjer som et felt skal optage. |
| colspan | positivt heltal | valgfri | Angiver antal søjler som et felt skal optage. |
Angiver position og størrelse på et felt i dialogen. Dette mærke skal findes én gang for hvert felt i dialogen (dvs. én gang for hvert <attr>- og <label>-mærke). Dette element er tomt.
| Overliggende | Underliggende |
|---|---|
| label, attr | INGEN |
| Egenskab | Type | Brug | Beskrivelse |
|---|---|---|---|
| row | positivt heltal | kræves | Angiver linjen i dialogens layout for et felt eller en etiket. |
| col | positivt heltal | kræves | Angiver søjlen i dialogens layout for et felt eller en etiket. |
| rowspan | positivt heltal | valgfri | Angiver antal linjer som et felt skal optage. |
| colspan | positivt heltal | valgfri | Angiver antal søjler som et felt skal optage. |
Definerer teksten for en etiket eller et afkrydsningsfelt. Dette element er kun tekst.
| Overliggende | Underliggende |
|---|---|
| label, attr | INGEN |
Definerer en liste med elementer som kan findes i mærket som angives. Dette er et typeelement kun med element.
| Overliggende | Underliggende |
|---|---|
| tag | child |
Definerer et underliggende mærke. Dette element er tomt.
| Overliggende | Underliggende |
|---|---|
| children | INGEN |
| Egenskab | Type | Værdier | Brug | Beskrivelse |
|---|---|---|---|---|
| navn | streng | kræves | Angiver et mærke som kan findes indeni et vist mærke. | |
| usage | streng | valgfri | Angiver forholdet til det overliggende objekt. | |
| kræves | Det overliggende objekt skal have mindst et underliggende objekt med dette navn. |
Definerer en liste med elementer som tvinger et mærke til at slutte. Dette er et typeelement kun med element.
| Overliggende | Underliggende |
|---|---|
| tag | stoppingtag |
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.
For at validere XML-mærkefiler, klik helt enkelt på dialogen “Værktøj” længst oppe i Quanta Plus 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 Quanta Plus.
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>
Følgende viser dig en korrekt familie 2 XML-mærkefil. Filen beskriver tilfældigvis PHPs 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>
Filen description.rc er også meget enkel, og en editor for den er tilgængelig med ->. Det redigerer description.rc for en DTEP som du kan vælge i en liste. For at redigere description.rc for en nyoprettet DTEP, skal du oprette en enkel description.rc med følgende indgange:
[General] Version = Anvend 1 for Quanta Plus 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 ->. 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.
Handlinger er meget hyppige i alle programmer. Du møder dem ofte når du bruger enhver applikation. Et klik på en værktøjslinjeikon, valg af en menuindgang eller brug af en genvejstast udfører normalt en handling. I Quanta Plus er handlinger videreført til næste niveau. Istedet for fastlagte handlinger (som er defineret af forfatteren af programmet på kildekodeniveau), er det muligt for den almindelige bruger at oprette og modificere handlinger og på den måde indføre ny funktionalitet i Quanta Plus. Det er de brugerdefinerede handlinger og mange af standardhandlingerne i Quanta Plus er brugerdefinerede (og mulige at ændre af brugeren) handlinger også.
Der er tre slags brugerdefinérbare handlinger:
Du kan oprette en handling ved at vælge -> . Klik på og du får en ny dialog at se:
Den del af handlingens navn som er synlig for brugeren
Ikonen der tildeles til denne handling. Klik på den for at ændre den aktuelle ikon.
Kort beskrivelse af hvad handlingen gør.
Genvejstasten der tildeles denne handling. Klik på Brugerdefineret eller knappen tæt på Brugerdefineret for at tildele en genvejstst til handlingen. Klik på Ingen for at fjerne den aktuelle tildelte genvejstast.
De brugerdefinerede værktøjslinjer, hvor handlingen foregår. Se “Opret værktøjslinjer”.
Specifikke indstillinger for en anden type handlinger. Se herunder
Brugbar til at indsætte XML-mærker, men selvfølgelig kan du også indsætte dem til andre formål.
Navnet på mærket.
Hvis afkrydset når handlingen udføres bliver denne tekst indsat som et lukke-mærke. Hvis der er markeret et område i dokumentet før du udfører handlingen, bliver <mærket> indsat før det markerede område og </mærke> efter.
Hvis afkrydset og der er en mærkeXML-fil til dette mærke, vises der en mærkeredigeringsdialog før mærket indsættes i dokumentet så du kan finjustere mærkeegenskaberne først.
Først skal du indtaste navnet på dit script og også fortolkeren. Eksempel: sh /home/minhjemmemappe/mitscript.sh.
Selvom du kan bruge fuldstændige stier, er den anbefalede måde at bruge %scriptdir variablen på kommandolinjen således sh %scriptdir/mitScript.sh. På den måde vil Quanta Plus forsøge at lokalisere dit script de følgende steder:
global scriptmappe: $KDEDIR/share/apps/quanta/scripts
local scriptmappe: $KDEHOME/share/apps/quanta/scripts
din sti: $PATH
%f: erstattes af adressen på det aktuelle dokument. I fald det er lokale dokumenter bilver file:/ fjernet fra dokumentet.
%input: bliver erstattet med den valgte inddata. Se herunder.
%projectbase:bliver erstattet med adressen på det aktuelle projekt. Er den tom bliver intet projekt indlæst.
%pid: bliver erstattet med PID af den kørende Quanta Plus-proces. Hvis Quanta Plus kører i unik-tilstand, mode, the "unique " teksten foranstillet PID-nummeret. Brugbart når du bruger DCOP til at kontrollere Quanta Plus fra det eksterne script.
%userarguments: Nyttigt i tilfældet med begivenheder. Indgangen erstattes af begivenhedens egenskaber i følgende rækkefølge:
Scriptets entydige identifikation
begivenhedsnavnet
begivenhedens parameter, oftest det nuværende dokuments filnavn eller søgestien til projektfilen.
Udover de ovennævnte metoder, kan scriptet modtage inddata fra Quanta Plus via stdin. I Indata kombinationsfeltet kan du vælge hvad der skal sendes til stdin. Valgene er:
Ingen: intet sendes til scriptet.
Aktuelt dokument: hele dokumentet sendes til scriptet.
Markeret tekst: det markerede tekstområde i dokumentet sendes til scriptet. At bruge %input variablen giver nomalt kun mening når man bruger denne indstilling.
I samme stil som Inddata kan du fange uddata fra den udførte applikation. Der er to slags uddata:
normal uddata, udskrevet til stdout;
fejlmeddelelser, udskrevet til stderr.
Ingen: applikationens uddata ignoreres.
Indsæt ved markørposition: uddata indsættes i det aktuelle dokument ved markørpositionen.
Erstat markering: det markerede område i dokumentet erstattes med uddata.
Erstat markering: det markerede område i dokumentet erstattes med uddata.
Opret et nyt dokument: et nyt dokument bliver oprettet og indeholder scriptets uddata.
Erstat aktuelt dokument: hele dokumentet erstattes med uddata.
Beskedvindue: uddata vises i Beskeder værktøjsvisningen.
Valgene for stderr uddata (Fejl) er det samme som for normal uddata.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Det følgende viser dig hvordan man opretter værktøjslinjer for en DTEP. Værktøjslinjer er grafiske elementer, som tildeles handlinger. I Quanta Plus er handlinger grunden til næsten alle udvidelser som Quanta Plus har, og vil få i fremtiden. Quanta Plus 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.
Til at begynde med, skal du oprette en brugerværktøjslinje. Vælg ->.
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 -> .
Delene i vinduet er ganske ligetil. Tryk på knappen 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 , 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 -menu, -> (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 ->.
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 ->igen (i Quanta Plus) 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 .
Gå til mappen hvor du gemte ikonen, vælg den og klik på .
Tryk på knappen , og fortsæt enten med at gøre det samme med de øvrige mærker, eller klikke på for at afslutte.
Antag at vi vil tilføje nogle almindelige Quanta Plus 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 ->. 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å 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 ->->.
Gem den i den rigtige mappe. Eftersom NeXML ikke findes, lægger vi den kun i topniveaumappen, men værktøjslinjer skal gemmes i den rigtige mappe. Sørg for at du justerer description.rc så værktøjslinjerne indlæses når en ny fil af denne type laves.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Formodentlig de mest bemærkelsesværdige tilføjelser til Quanta Plus 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å Quanta Pluss 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 Quanta Plus 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.
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).
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 $ eller HOME/.kde/share/apps/quanta/doc$ for henholdsvis lokal eller global brug. Opret derefter en mappe (den som angives i KDEDIR/share/apps/quanta/docdocrc-filen) i samme mappe som docrc-filen findes, og kopiér HTML-dokumentationssiderne derhen.
Du skal genstarte Quanta Plus, 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 Quanta Pluss arkiv til brug for Quanta Plus' brugere. Du bliver ikke rig, men du føler dig godt tilpas ved at vide at du bidraget til det bedste internetudviklingsmiljø som findes.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Du er ikke alene med Quanta Plus. Det er muligt at dele forskellige ressourcer (DTEP-pakker, værktøjslinjer med handlinger, scripter, skabeloner) med andre. Der er to måder at gøre det:
Ressourcer kan sendes med e-mail til venner, kolleger eller til hvem du vil. Du ser menupunktet Send med e-mail på forskellige steder, såsom ->, ->, og i den sammenhængsafhængige menu for filer og mapper i træet Skabeloner og Scripter.
Ressourcer kan overføres til vort hovedarkiv, hvor alle andre brugere af Quanta Plus kan hente dem. Bidragene gennemses nøje og gøres kun tilgængelige hvis vores gruppe anser dem for rigtige og nyttige. For at oprette et gyldigt bidrag, foreslår vi at du underskriver ressourcen. Derfor behøver du en GPG/PGP-nøgle. Informationen bruges til at verificere ressourcens oprindelse, både af vor gruppe og af de som henter den.
Om hvordan ressourcer hentes fra hovedserveren, se “Hent ressourcer”.
Når du overfører bliver du bedt om at angive løsen for din hemmelige GPG-nøgle (løsenet opbevares ikke), og i tilfældet med flere hemmelige nøgler, skal du vælge den du vil bruge. Udfyld inddatafelterne i dialogen Del smarte nye ting (URL for forhåndsvisning kan forblive tom) og starte overførslen ved at klikke på O.k..
Overførslen kan startes fra ->, ->, og i den sammenhængsafhængige menu for filer og mapper i træet Skabeloner og Skripter.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Det er muligt at opgradere Quanta Plus 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 Quanta Plus 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 ->, ->, 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 Quanta Plus 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!
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Det er muligt at arbejde med XML-sprog som for øjeblikket ikke understøttes af Quanta Plus 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 ->. 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 $. KDEHOME/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 Quanta Plus editoren for description.rc når konverteringen er klar, så du kan finjustere din nyoprettete DTEP. Det anbefales at dette tilvalg er markeret.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Undskyld hvis jeg glemte nogen eller stavede dit nvan forkert!
Mange tak til alle som har taget sig tid til at bidrage!
Quanta Plus-udviklingsgruppe:
Oprindelig CSS-editor.
Kommander, diverse funktioner og fejlretninger.
Startskærm for mange udgaver
Sidelayout-modul & fortryde/annullér fortryd-system
PHP4-fejlsøger
Ramme-guide
Diverse rettelser, grundlæggende kode for DTD-tolkning og andet DTD-relateret arbejde
Dansk oversættelse
Pedantisk XML-fyr og dokumentation
XSL 1.0 DTEP, KXsldbg
Dokumentation, fejlrettelser, og PHP fejlretteropsætning.
Projektets manager og administrator af netsiden
Kerneudvikler
Kodning, oprindeligt TagXML-dokument, med mere
Dokumentation
Dokumentation
Tilføjelser til og vedligeholdelse af DTD'er
Tidligere hovedudvikler — flyttede til kommerciel version
Træbaseret overførselsdialog
Tidligere hovedudvikler — flyttede til kommerciel version
Især tak til:
Ophavsmændene til libxml2 og libxslt.
Quanta Plus © 2000, 2001, 2002, 2003 Quanta Plus-udviklingsgruppen.
Quanta Plus håndbog © 2002, 2003 Quanta Plus-udviklingsgruppe.
Dokumentation er udgivet under betingelserne i GNU Free Documentation License.
Dette program er udgivet under betingelserne i GNU General Public License.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Indholdsfortegnelse
dette program er en del af KDE-projektet http://www.kde.org/.
dette program findes i kdewebdev-pakken på ftp://ftp.kde.org/pub/kde/, hoved FTP-stedet for KDE-projektet.
For at kompilere og installere dette program på dit system, skal du skrive følgende i basismappen for distributionen for dette program :
%./configure%make%make install
Idet dette program bruger autoconf og automake skulle du ikke få problemer med at kompilere den. Hvis du skulle løbe ind i problemer så rapportér dem til KDE's e-post-lister.
Det er rimeligt at du vil tilrette stedet for Quanta Plus' filer på systemet. For at gøre dette, har autoconf et antal valgmulighed som kan sendes til configure-scriptet for at styre indstillingen. For at få en fuldstændig liste af disse valgmuligheder, skriv ./configure --help. De er ligetil og dækkes ikke her.
Hvis du har problemer med at få Quanta Plus til at køre som den skal, bør du kontrollere din søgesti for at forsikre dig om at mappen bin for KDE 3 findes. Sørg også for at du ikke har nogen ældre versioner af KDE tilbage, som findes i PATH inden mappen bin for KDE 3. Det samme gælder for Qt™.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Et gyldigt udtryk som definerer hvilke data som kræves. Se W3C®'s hemside.
Et fuldstændigt kvalificeret navn, for eksempel xsl:min_variabel. Se W3C®'s hemside.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team