Användarhandbok Quanta Plus
Copyright © 2002, 2003, 2004, 2005 Quanta Plus utvecklingsgrupp
Härmed ges tillåtelse att kopiera, distribuera och/eller ändra detta dokument under villkoren i GNU Free Documentation License, Version 1.1 eller någon senare version publicerad av Free Software Foundation; utan invarianta avsnitt, utan framsidestexter och utan baksidestexter. En kopia av licensen inkluderas i avsnittet som heter "GNU Free Documentation License".
Quanta Plus är ett grafiskt webbgränssnitt, som försöker vara neutralt och transparent för alla taggbaserade språk, och samtidigt stödja populära skriptspråk för webben, CSS, och andra framväxande W3C®-rekommendationer.
Innehållsförteckning
Exempelförteckning
Quanta Plus är ett webbutvecklingsverktyg för K-skrivbordsmiljön. Quanta Plus är konstruerat för snabb webbutveckling och är snabbt på väg att bli en mogen editor med ett antal storartade funktioner. Vårt mål är fortfarande att skapa det bästa webbutvecklingsverktyget över huvud taget. Vi inser att vi behöver många fler aktiva för att åstadkomma detta, så vi håller på att utveckla förbättringar som siktar mot att göra det lätt för webbutvecklare att anpassa, utöka och förbättra Quanta Plus. Därefter kommer vi att be dig, webbutvecklaren, att bidra med dina funktionsförbättringar. Vi kommer att organisera detta så att webbutvecklare som använder Quanta Plus hittar precis de resurser, utökningar och speciella insticksprogram som de behöver för att bli de häftigaste utvecklarna någonsin. | ||
| --Eric Laffoon på http://quanta.sourceforge.net | ||
Medan strävan att bli den bästa HTML-editorn pågick, började Quanta Plus utvecklare fundera på en rätt fascinerande idé: “Varför inte göra Quanta Plus till en generell, utökningsbar editor för taggbaserade språk?” Ja, det skulle bara göra det till den bästa webbutvecklingsmiljön för KDE. Så det gjordes!
Quanta Plus har nu kommit långt på vägen att bli en generell webbutvecklingsmiljö, nu när den inte längre är begränsat till HTML. I allt väsentligt, om du kan definiera något med XML, ska Quanta Plus kunna fungera som en integrerad utvecklingsmiljö för det.
Med det ovanstående sagt, måste det noteras att Quanta Plus är ett resultat av de enastående ansträngningar som har gjorts av hela KDE-utvecklingsgemenskapen. Quanta Plus, använder idén att “varför skriva något som någon annan redan har skrivit?”, för att lovprisa öppen källkod. Tack vare KDE:s konstruktion, är detta inte bara möjligt, dessutom medges att användare och utvecklare utökar Quanta Plus för att passa egna speciella behov.
Quanta Plus erbjuder webbutvecklare ett intuitivt och kraftfullt gränssnitt med flera dokument (MDI). Det kan öka din produktivitet dramatiskt. Genom att använda egna åtgärder, skript och verktygsrader, kan du automatisera nästan alla uppgifter. Med användning av Kommander, kan du utöka Quanta Plus så att du aldrig behöver komma ihåg syntax för skriptkommandon igen. (Mer om detta hittar du under Kapitel 7, Utöka Quanta Plus.)
Det finns flera nyckelkoncept i Quanta Plus. För att förstå och dra fördel av Quanta Plus, måste du först lära dig dessa koncept, de grundläggande funktionerna. Det här kapitlet förklarar och visar dig koncepten, som om de saknades i Quanta Plus skulle göra det primitivt.
Quanta Plus delar upp arbetet i tre områden: globala, lokala och projekt. Denna uppdelning påverkar olika komponenter i Quanta Plus.
Globala objekt är tillgängliga för alla som använder Quanta Plus. Från verktygsrader till åtgärder, allt som markeras som globalt lagras i den gemensamma Quanta Plus katalogstrukturen. Det ger möjlighet för en grupp administratörer att spara vissa verktygsrader, åtgärder och mallar i det globala trädet, som sedan kan användas för att hålla en fleranvändarinstallation av Quanta Plus likadan för alla i systemet.
Lokala objekt utgör en ensam användares personliga samling resurser för webbutveckling. Objekten består av användarens mallar och verktygsrader. Lokala objekt lagras i användarens hemkatalog. Det gör att alla användarens lokala objekt alltid är tillgängliga för personlig användning.
Projektobjekt är bara tillgängliga i ett visst projekt. De kan vara allt från en stilmall till en verktygsrad med egna åtgärder som utför något speciellt med projektets filer. I enkelhet är detta det mest begränsade området. Alla objekt som sparas i projektets arbetsområde, hamnar i projektets katalogträd, vilket gör det möjligt att dela specialverktyg och mallar med alla som ingår i projektet.
Quanta Plus som redigerar den engelska versionen av dokumentet du nu läser.
Quanta Plus gränssnitt för flera dokument är uppdelat i diverse delar: redigeringsfönstret, träden med snabbinformation, informationsflikarna och verktygsraderna. Se “Redigeringsfönstret”, “Verktygvyerna”, och “Informationsflikarna” och “Verktygsraderna” för mer information om dessa delar.
Quanta Plus redigeringsfönster.
Quanta Plus redigeringsfönster tillåter att flera filer öppnas på samma gång. När bara en fil är öppen, fyller dokumentet upp hela redigeringsfönstret. Så snart ett andra dokument öppnas, tas en liten del av utrymmet längst ner i redigeringsfönstret för att visa flikar med filnamn och en statusikon. Bilden ovanför visar en ikon av en diskett intill filnamnet, vilket indikerar att filen har ändrats och måste sparas.
Du kan högerklicka på flikarna med musen för att visa en sammanhangsberoende meny med alternativ som hör ihop med nuvarande dokument, som att stänga den nuvarande, övriga eller alla flikar; uppdatera, ta bort eller ladda upp dokumentet; gå till en rad med bokmärke; och utföra CVS-åtgärder för nuvarande dokument.
Att högerklicka i redigeringsområdet visar en annan sammanhangsberoende meny, som hör ihop med innehållet i det redigerade dokumentet, som grundläggande redigeringsalternativ (klipp ut, kopiera, klistra in), redigering av taggen under markören, markera området som täcks av taggen under markören, få sammanhangsberoende hjälp om ordet under markören eller öppna en fil om strängen under markören pekar på en fil.
Längst upp i redigeringsfönstret är redigeringsverktygsraderna. För närvarande är standard i Quanta Plus HTML 4.0.1 Transitional, som har en standarduppsättning med verktygsrader som laddas. Allteftersom Quanta Plus utvecklas, kommer verktygsraderna att uppdateras för att uppfylla användarnas behov, och utnyttja nyare funktioner.
Användning av verktygsrader är ganska enkelt. Om du vill infoga en grundläggande tagg, som <p>, i dokumentet, kan du klicka på ikonen som representerar taggen. Nu kan du infoga data för taggen som du just har infogat. Om du vill infoga en tagg som kräver vissa egenskaper (som ett ankare), får du en dialogruta där du kan fylla i de olika fälten.
Ankardialogrutan (<a>).
Verktygsvyerna.
Verktygsvyerna eller snabbinformationsträden låter dig navigera, öppna och samla information i Quanta Plus. Flikformatet visar dig filer, projekt, mallar, dokumentstruktur, skript, egenskaper och dokumentationsträd.
Förklaring av snabbinformationsträd
Här kan du bläddra i hela filsystemet. Du ser två toppnivåer i filsystemet. Den första är din hemkatalog, och den andra är filsystemets rotkatalog - /. Använd dem för att hitta befintliga filer på datorn, som du vill redigera eller lägga till i ett aktivt projekt. Genom att högerklicka på en fil i vyn, får du flera alternativ för att hantera den markerade filen och du får dessutom möjlighet att infoga filen i ett aktivt projekt, om det finns något, eller byta mellan träd- och listvy.
Projekthantering är ett av de många kraftfulla verktygen som Quanta Plus erbjuder. Den här fliken visar alla filer i ett projekt och låter dig hantera projektfilerna med ett högerklick. Åtgärder, som att lägga till, ta bort från projektet, ladda upp eller ta bort filerna helt och hållet från disk, kan utföras via menyn.
En annan funktion i Quanta Plus är mallar. Mallar kan vara vad du önskar. Bilder, kodfragment, en hel webbsida, etc. Det är helt och hållet ditt val.
Mallar sorteras i tre kategorier, baserat på deras område och sammanhanget där de används. Områden kommer från Quanta Plus arbetsområden. Globala mallar kan alltid användas, lokala mallar är användbara för aktuell användare, och projektmallar är bara användbara inne i motsvarande projekt. Mer om mallar hittar du under “Mallar”.
Här hittar du information om de olika skript som är tillgängliga för din användning. Konceptet med lokala-, globala- och projektskript används också här. Genom att vänsterklicka på objekten, får du tillgång till all tillgänglig information om skriptet. Att högerklicka låter dig utföra vissa åtgärder, som till exempel att köra skriptet, redigera det och e-posta det.
Den här fliken visar tolkens interna representation av dokumentet. Genom att vänsterklicka på ett element, flyttas markören till elementets plats i dokumentet. Genom att högerklicka på ett element, visas ett antal åtgärder som har att göra med navigering och uppdatering av trädet.
Det här trädet visas under alla andra snabbinformationsträd. Du kan snabbt redigera egenskaper och namnrymder inne i det. Det innehållsbaserade inmatningssystemet låter dig ändra alla tillgängliga egenskaper med några få klick med musen.
Egenskapsträd
Här hittar du fullständig dokumentation om webbteknologier för att hjälpa dig med utvecklingen. Du kan ladda ner färdigpaketerad dokumentation för Quanta Plus från Quanta Plus dokumentationssida, du kan skapa din egen dokumentation, och genom att lägga till en katalog som heter "doc" i ett projekt, kan du lägga till, redigera och visa projektspecifik dokumentation.
Informationsflikarna i Quanta Plus.
Normalt har Quanta Plus två flikar som finns längst ner i fönstret, där användbar information kan erhållas. De är Meddelandefönstret och Problemfönstret.
Den här fliken visar information från alla skript som körs i Quanta. Till exempel visas vilken DTD som används för aktuellt dokument, och eventuella ändringar som görs av DTD:n.
Den här fliken visar eventuella fel i det nuvarande dokumentets taggar. Quanta Plus-skript som körs skriver också ut felmeddelanden (om det blir några) under den här fliken.
Quanta Plus HTML-verktygsrader.
Quanta Plus verktygsrader har utökats ordentligt, och är lätta att förstå. Du klickar på knappen, och utför åtgärden som hör ihop med knappen. Det underbara med verktygsrader är att du kan definiera dina egna åtgärder grafiskt inne i Quanta Plus.
Att hantera verktygsrader i Quanta Plus är enkelt. Genom att välja menyn , får du möjlighet att ladda, spara, lägga till, ta bort och e-posta verktygsrader. När du väljer att ladda en verktygsrad, kan du välja från de tre arbetsområden som finns i Quanta Plus. När du sparar en nyskapad verktygsrad, kan du spara den lokalt eller i projektets område. Om du vill göra en ny verktygsrad tillgänglig globalt, be din administratör att placera den i Quanta Plus globala verktygsradskatalog.
En annan funktion i Quanta Plus är möjligheten att e-posta verktygsrader. Quanta Plus skickar verktygsraden som ett komprimerat tar-arkiv via KMail. Om du tar emot en verktygsrad via e-post, kan du spara (och ladda) den i Quanta Plus, precis som vilken annan verktygsrad som helst.
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
Det här kapitlet beskriver de delar av Quanta Plus som du oftast använder dig av. De gör dig inte bara mer produktiv, utan låter dig också anpassa Quanta Plus till ditt arbetssätt.
Som tidigare nämnts, hanteras verktygsrader i Quanta Plus i huvudsak via menyn . Användning och skapade är något olika. Att skapa verktygsrader beskrivs i ett senare avsnitt som heter “Skapa verktygsrader.”
Att använda verktygsrader är ganska enkelt. När du klickar på en ikon för önskat element eller önskad åtgärd, sker en av tre saker: elementet infogas (valfritt med ett avslutande element); en elementdialogruta aktiveras, som låter dig fylla i egenskaper i dialogrutan; eller, till sist, en åtgärd aktiveras och utför något smart med aktuell fil eller aktuellt projekt. Om du märker att du tröttnar på att upprepade gånger skriva in ett visst element som inte finns i Quanta Plus, kan du lägga till det. Se “Dokumenttyp-redigeringspaket (DTEP)” för mer information.
Att anpassa verktygsraderna och elementen på dem kan antingen göras genom att använda den sammanhangsberoende menyn (högerklicka på en verktygsrad), där du kan skapa en Ny åtgärd, en Ny verktygsrad, och utföra åtgärder som Ta bort verktygsrad, Byt namn på verktygsrad eller Anpassa verktygsrader som visar en dialogruta där du kan ange vilka åtgärder som ska vara synliga på denna och andra verktygsrader.
Genom att använda den sammanhangsberoende menyn för en åtgärd (ikon) placerad i en verktygsrad, ser du förutom ovanstående alternativ också alternativen Ta bort åtgärd och Redigera åtgärd, som talar för sig själva.
Verktygsraderna och deras åtgärder kan anpassas genom att använda menyalternativen -> och ->.
Du kan läsa om de användardefinierade åtgärderna i “Användardefinierade åtgärder”.
En taggdialogruta ser precis ut som den följande:
Ett exempel på en taggdialogruta.
Ovanstående bild visar dialogrutan för ankartaggen. Om du känner till HTML eller XHTML, bör du ha märkt att alla egenskaper som du kan använda i ett ankarelement är tillgängliga. Observera flikarna ovanför för Huvud, Core & i18n, Händelser och Fokus, som innehåller alla andra egenskaper, enligt syfte, tillgängliga för ankarelementet. Allt du behöver göra är att fylla i tomrummen för egenskaperna du vill ha i ankartaggen, utelämna de du inte vill ha, och klicka på Ok. Nu har du en välformad ankartagg på markörens nuvarande position.
Quanta Plus projektguide (->) gör det enkelt att skapa ett projekt.
Projektguiden.
Fälten är ganska självklara. Det är bäst att fylla i dem uppifrån och ner. När ett projektnamn fylls i kompletteras hela katalogstrukturen för resten av projektet automatiskt. Alla sökvägar och information om upphovsman kan anpassas senare genom att klicka på -> (Skift+F7).
Allmänna projektinställningar
Här fyller du i namnet på projektet. Vi kallar till exempel vårt för “test.” När du fyller i Namn, fylls Fil automatiskt i åt dig.
Det här är namnet på Quanta Pluss projektfil. Normalt är det namnet på projektet, men med små bokstäver utan blanktecken, med filändelsen webprj (t.ex. exempel.webprj). Filen lagras längst upp i projektets huvudkatalog.
Här väljer du protokoll som du ska använda för att komma åt projektet. Om projektet finns på samma dator som du använder Quanta Plus, lämna värdet Lokal. Listan över protokoll som visas här beror på dina systeminställningar. Tillgängliga protokoll omfattar SSH, FTP, NFS, SMN, WebDAV med flera. Listan över protokoll kommer från KDE:s kraftfulla I/O-slavarkitektur. Den här arkitekturen låter alla KDE-program enkelt komma åt information på andra datorer, som om den fanns på den lokala datorn.
Här kan du fylla i serveradressen till datorn som du vill komma åt, om du inte arbetar med det lokala protokollet. Antingen ett värddatornamn (värddator.exempel.se) eller en IP-adress (127.0.0.1) kan anges här.
Användarnamn för att logga in på den andra datorn. Detta är skiftlägeskänsligt.
Lösenord för att logga in på den andra datorn. Detta är skiftlägeskänsligt.
Lämna fältet tomt för att använda standardporten för protokollet som du använder. Du kan behöva ändra det beroende på serverns inställningar.
Det här är rotkatalogen där alla projektets filer och kataloger lagras.
Det här är platsen där projektets mallar lagras. Det är en relativ sökväg i förhållande till projektet, och normalt pekar den på templates. Om du har en gemensam uppsättning filer som du använder för flera projekt, kan det vara lämpligt att låta fältet peka dit istället för att använda normalvärdet.
Det här är platsen där projektets verktygsrader lagras. Det är en relativ sökväg till projektet och normalt pekar den på toolbars. Om du har en gemensam uppsättning verktygsrader som du använder för flera projekt, kan det vara lämpligt att låta fältet peka dit istället för att använda normalvärdet.
Det här låter dig hämta filer från det lokala filsystemet. Du kan välja flera filer eller hela kataloger.
Det här alternativet är mycket bra om du har statiskt webbinnehåll som du vill ladda ner och ändra. För skript på serversidan (som PHP, Python, etc.) måste du hämta filerna på ett annat sätt.
Infoga filer i projekt
Markera det här om du vill lägga till filer som finns i huvudkatalogens sökväg. Lämna det omarkerat när du startar ett nytt projekt från början.
Genom att välja alternativet läggs bara webbfiler, skript och bildfiler till i projektet.
Genom att välja alternativet visas alla filer och kataloger i huvudkatalogen, och låter dig vara mer specifik angående vad du väljer.
Detta visar en lista med filerna i huvudkatalogen. Du kan välja filer som du önskar inkludera eller utesluta i projektet, genom att markera eller avmarkera dem.
Fler projektinställningar
Mata in ditt namn (eller alias) här.
E-postadress dit du vill att saker som rör det här projektet ska gå.
Välj taggspråket som du i huvudsak kommer att arbete med i projektet.
Välj teckenkodningen som du vill att filerna i projektet ska öppnas och sparas med.
Markera det här för att använda ett prefix för dina förhandsgranskningar. Det här låter dig ställa in sökvägsprefix till något annat än det lokala filsystemet. Det är mest användbart för sidor som har dynamiskt innehåll, och beror på serverbehandling (som PHP, JSS, Python, etc.). Skriv helt enkelt in första delen av adressen som den ser ut på servern och sökvägen till filen fylls i av Quanta Plus. Om du till exempel har domänen domän.com, och redigerar sidan index.html, kan du redigera den på värddatorn (min.domän.com), ladda upp den till servern och trycka på F6 för att se resultatet från www.domän.com istället för det lokala filsystemet.
Skriv in prefixet som du vill använda här.
Det här skapar en kopia av globala mallar i projektets katalogträd.
Det här skapar en kopia av lokala mallar i projektets katalogträd.
Den sista skärmen i guiden för nytt projekt, har tre inställningar som kan göra livet enklare. Inställningarna är tillgängliga att ändras från menyn -> under fliken Uppladdningsprofiler, eller med snabbtangenten Skift+F7.
Dialogrutan för projektegenskaper ser ut så här:
Sidan med allmänna alternativ
Vissa av alternativen är samma som i projektguiden och beskrivs i “Nya projekt”. De extra alternativen beskrivs nedan.
Allmänna projektinställningar
En lista med filnamn (jokertecken kan användas) som ignoreras när du utför projektrelaterade åtgärder som .
En kompletterande alternativ till det ovanstående, också filer som listas i filen .cvsignore undantas från projektet.
Projektvyn som laddas när projektet öppnas. Du kan läsa mer om projektvyer i “Projektvyer”.
Välj felsökaren du vill använda. För närvarande stöds bara Gubed. Du hittar mer information om Gubed på http://gubed.sourceforge.net. Felsökningsinsticksprogrammet kan anpassas med knappen Alternativ. Läs “Felsökning i Quanta Plus” för att ta reda på mer om felsökning.
Projektvyn som laddas när projektet öppnas. Du kan läsa mer om projektvyer i “Projektvyer”.
På sidan Uppladdningsprofiler kan du anpassa uppladdningsprofilerna (se “Uppladdningsprofiler”), samt aktivera visning av en trädvy med innehållet på servern för varje profil, genom att markera kryssrutan Visa en trädvy för varje profil.
På sidan Gruppinställning kan du lägga till, redigera och ta bort medlemmar i projektet samt definiera en e-postlista. Läs “Utveckling i grupp” för detaljinformation.
På sidan Händelseinställning kan du Aktivera händelseåtgärder, lägga till, ändra och ta bort dessa åtgärder. Händelseåtgärder utförs när vissa fördefinierade händelser inträffar, som att en fil sparas. Se “Händelseåtgärder” för detaljinformation.
Normalt öppnar Quanta Plus det senaste projektet som användes vid start. Detta beteende kan för närvarande inte anpassas.
För att öppna ett annat projekt, välj i menyn , eller ikonen Öppna Projekt i verktygsraden. Dialogrutan för att öppna projekt dyker upp, och låter dig välja projektet som du vill ha. Projekt har filändelsen webprj.
När du avslutar Quanta Plus, sparas projektfilen automatiskt. Du blir tillfrågad om att spara alla ändringar innan Quanta Plus avslutas, om några ändrade filer finns. Samma beteende gäller om du laddar ett nytt projekt.
Projektträdvyn gör att du enkelt kan komma åt filer i projektet. Här hanterar du filerna i det aktuella projektet.
För filer, visas följande meny vid ett högerklick med musen:
De här alternativen är rätt självklara, och lämnas till läsaren att utforska.
Kataloger är liknande, men innehåller inte och i den sammanhangsberoende menyns menyalternativ.
De här alternativen lämnas också till läsaren att utforska.
Dialogrutan för att ladda upp projekt:
Dialogrutan för att ladda upp projekt:
Det är här som olika profiler kan väljas. Profilen innehåller information om var de uppladdade filerna ska placeras. Läs “Uppladdningsprofiler”.
Den här knappen låter dig skapa nya uppladdningsprofiler.
Det här låter dig redigera uppladdningsprofilen som för närvarande är markerad.
Det här låter dig ta bort den nuvarande profilen. Om bara en profil är tillgänglig är knappen inaktiverad för att förhindra att den tas bort.
Lösenordet lagras i minnet och går förlorat så fort programmet stängs. Alternativet är användbart om uppladdning av filer behövs göras ofta, och du inte vill använda det osäkrare alternativet “Lagra lösenord på disk”.
Markera alla filer i projektet för att ladda upp.
Markera alla ändrade filer för att ladda upp.
Avmarkerar alla filer i listan.
Markerar eller avmarkerar alla filer i listan.
Expanderar alla kataloger.
Stänger all kataloger.
Uppdaterar listan.
Starta uppladdningen
Det här avbryter överföringen som pågår, eller avslutar bara dialogrutan om du ändrar dig innan du startar uppladdningen.
I Quanta Plus kan du definiera flera uppladdningsprofiler och på så sätt ladda upp ditt projekt (eller delar av projektet) till olika servrar. När du redigerar eller skapar en profil möts du av följande dialogruta:
Skriv in namnet du vill ge profilen här.
Det här är värddatornamnet på servern som du kopierar filerna till. Antingen ett fullständigt domännamn, eller en IP-adress, behövs.
Överföringsprotokoll som ska användas för uppladdningen. Beroende på din version av KDE, varierar den här listan. Du bör åtminstone kunna välja bland FTP, file (dvs. lokal) och NFS.
Port för överföringen. Oftast behöver du inte bekymra dig om den, om inte nätverksadministratören tillhandahåller en tjänst på en port som skiljer sig från dess normala välkända port.
Användarnamn som används för behörighetskontroll.
Lösenord som används för behörighetskontroll.
Beroende på hur paranoid du är, är detta en tidsbesparande funktion eller en fara. Använd enligt eget omdöme. Lösenordet behålls på disk som text med förvrängd form, så det är inte enkelt att läsa, men vem som helst med kunskap om programmering kan enkelt återställa det från den förvrängda formen.
Det här är grundsökvägen på värddatorn dit du kommer att kopiera filer.
Låter dig markera profilen som för närvarande visas som standardprofil.
En projektvy är bara en uppsättning filer och verktygsrader. Du kan ha flera vyer i ett projekt, vilket betyder att genom att helt enkelt ändra vy kan du ladda flera filer och verktygsrader som ersätter filerna som för närvarande är öppna och verktygsraderna.
Vyer kan sparas, öppnas eller tas bort genom att använda menyn eller projektverktygsraden, som kan kommas åt med ->->.
Du kan ha en förvald vy (som laddas när projektet öppnas). Se “Anpassa projekt”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Mallar är i grunden dokumentskelett, kodfragment och filer att länka till. Quanta Plus använder mallar huvudsakligen som ett vanligt filsystem med utökad organisation och ett utökat gränssnitt. Du kan kopiera, flytta eller länka alla arkiv som finns på systemet till mallträdet. Tänk på Quanta Plus mallar som om de har ungefär samma begränsningar för din fantasi som filsystemet har.
Mallar finns i kataloghierarkier. Det finns ingen gräns för hur djup hierarkin kan vara, men i en given katalog förväntar sig Quanta Plus en konsekvent åtgärd för basmalltypen som beskrivs nedan. Dessutom tillåter mallar att inledande och efterföljande text sammanfogas med mallar som inte är av dokumenttyp. Den här funktionen underlättar att skapa taggar. Nästa utgåva efter introduktionen planeras att lägga till möjligheten att skicka variabler till texten, som information om bildstorlek, för att hjälpa till att skapa taggar.
Målet med mallar är att utöka dem så att de omfattar “konceptmallar” med flera filer, som är användbara för saker som att beställa någonting eller skapa ett avsnitt om ett program. Idealt blir detta ett verktyg som gör ditt arbete mer produktivt och dynamiskt. Ett slutmål är att ha ett designläge med strukturmallar för att hantera layout och struktur av webbplatser, som du kan använda för att designa och interaktivt uppdatera dina webbplatser. Om du vill bli inblandad, titta på vår sida där hjälp sökes.
Vissa av mallarna som levereras med Quanta Plus har villkor för att få användas. Läs noga beskrivningen av villkor för användning längst upp i varje mall, innan du använder den.
Det finns diverse typer av mallar som stöds av Quanta Plus. De är:
| Binärmallar |
| Dokumentmallar |
| Textsnuttar |
| Platsmallar |
Binärfiler är vad som helst som inte identifieras enbart med text. De kan egentligen vara vilken fil som helst utom text, inklusive bilder, PDF, FLASH-filer, etc. Binärmallar inkluderas oftast i dokument via länkar (dvs. bilder som en <img src=/src/url>). Några exempel finns i mallträdet under Globala mallar. Se “Verktygvyerna” för mer information om mallträdet.
Dokument kan vara vilken sorts textdokument som helst. Du kan skapa nya dokument baserat på mallarna. I allmänhet bör du placera mer specifika eller skilda dokument i underkataloger. Här kan du skapa en grundläggande struktur för vad du gör, och leverera arbetet på ett organiserat sätt, för att få mycket högre effektivitet. Några exempel finns i mallträdet under Globala mallar. Se “Verktygvyerna” för mer information om mallträdet.
Den här malltypen är användbar när du inte vill skapa ett nytt dokument baserat på en mall, utan vill infoga samma textområde gång på gång i dokumenten. De kan innehålla vad som helst, från en kommentar till en fullständig Javaskript-metod eller ett Perl-skript som hanterar menyer. Några exempel finns i mallträdet under Globala mallar. Se “Verktygvyerna” för mer information om mallträdet.
Som namnet anger är dessa mallar användbara för att bygga en fullständig plats från en mall. De är en samling av diverse dokument som kan organiseras i en katalogstruktur, allting samlat i ett komprimerat tar-arkiv. För närvarande finns det inga exempel på sådana mallar i Quanta Plus.
Mallar kan kommas åt baserat på deras angivna arbetsområde i Quanta Plus.
Skapa en dokumentstruktur som du tycker bra om (XML, HTML Docbook, etc.) och klicka på ->->.
När detta väl är gjort, märker du att mallen inte visas under projektfliken (även om den sparas som en projektmall). Titta under mallvyn för att hitta mallen under projektmallar.
Markera någon text i dokumentet och klicka på ->->. Som ett alternativ kan du helt enkelt använda drag och släpp för att dra markeringen till trädvyn Mallar.
Att skapa en binärmall är enkelt: Kopiera bara filen till en mallkatalog. Du kan använda vanliga filhanteringsfunktioner för att göra det, som drag och släpp, kopiera och klistra in från Konqueror eller via filträdet.
Projektmallar låter dig vara hårdare fokuserad. Du kan skapa ett sidhuvud eller en sidfot, eller vara dynamisk genom att låta PHP inkludera filer och länka dem. Det finns dessutom några riktigt häftiga saker som vi tog hänsyn till när mallar används i projekt.
När du skapar ett projekt kan du välja att kopiera alla befintliga globala- och användarmallar till ditt lokala projekt. Gamla projekt får grundläggande mallfunktioner, så ingenting går förlorat. Du kan välja var mallfilerna ska placeras, så att de kan finnas i serverns rotkatalog för enkel uppladdning, eller du kan göra dem säkra att länka till under serverns rotkatalog, vilket är ett mycket häftigt trick. När du länkar till en fil som inte finns i projektmallarna blir du tillfrågad om att kopiera filen till projektmallarna innan länkning. Det förhindrar felaktiga länkar vid uppladdning. Du kan alltid styra var du placerar dina mallar, så att du kan välja att flytta dem. Dock följer inte Quanta Plus detta, så du måste ändra länkar.
Mallstrukturen i mallfliken är baserad på filerna som hittas i $ och KDEDIR/share/apps/quanta/templates $. Var och en av katalogerna specificeras som en av fyra sorters behållare som förklaras ovan. HOME/.kde/share/apps/quanta/templates
För att ställa in beteendet hos varje katalog, högerklicka på katalogen i mallvyn och välj . Följande dialogruta visas:
Egenskapsdialogruta.
Kombinationsruta med de tre typer som tidigare beskrivits: filer, text och mallar. Rutan är inaktiverad om du har markerat kryssrutan Ärv överliggande egenskap.
<starttagg>)Det här är normalt markerat, och är utmärkt för allt utom toppnivåkatalogerna i mallträdet. Om toppnivåkatalogen har det här markerat, inaktiverar det egentligen mallarna i den katalogen och allt som inte uttryckligen ställs in under den. Om det inte är en toppnivåkatalog, lyder <starttaggen> något som liknar Textsnutt. Om den är tom, är det en god chans att du är i en toppnivåkatalog.
Aktiverar inledande och efterföljande text för mallar i katalogen. Det kan vara ett gemensamt sidhuvud eller en gemensam sidfot för alla mallar i ett givet projekt, när du kopierar innehållsmallar till katalogen för att få en fullständig sida med eget sidhuvud/sidfot som utgångspunkt.
Själva texten som infogas före mallens innehåll.
Själva texten som infogas efter mallens innehåll.
Om du dessutom titta på alternativen som visas med höger musknapp, ser du fullständiga filhanteringsverktyg för att skapa kataloger eller kopiera och klistra in mallar från en plats till en annan.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Sidlayouteditorn (också betecknad WYSIWYG, vad du ser är vad du får) låter dig redigera ett HTML- eller XHTML-dokument och se ändringarna i farten. Precis som i din vanliga ordbehandlare kan du klicka på dokumentet för att visa en markör, som låter dig skriva in text, infoga bilder, ändra textens utseende, etc. Målet med sidlayouteditorn är att låta dig skapa utmärkta, riktiga webbsidor utan någon kunskap om Internet taggspråk.
Quanta Plus erbjuder två lägen: Sidlayouteditor och Sidlayout- och källkodseditorer, som du kan komma åt i menyn . Det första ersätter källkodseditorn med sidlayouteditorn, och det andra delar editorfönstret i två delar: källkodseditorn och sidlayouteditorn.
Sidlayouteditorn fungerar på följande vis: Den laddar ett dokument som en normal HTML- eller XHTML-sida, och en markör visas. Därefter kan du redigera sidan, och om du byter tillbaka till källkodseditorn ser du att ändringarna du gjort i sidlayouteditorn har införts i källkodseditorn.
När du arbetar med ett dokument som innehåller PHP i sidlayouteditorn, ser du en liten ikon som representerar PHP-koden. Du kan inte redigera den direkt i sidlayouteditorn. För att redigera PHP, måste du fortfarande använda källkodseditorn. Det finns inga planer att ändra det här funktionssättet.
Det andra läget beter sig exakt som det första, utom att du omedelbart ser följden av dina ändringar, antingen i källkodseditorn eller i sidlayouteditorn, och markörerna i källkodseditorn och sidlayouteditorn är synkroniserade. Genom att trycka på F9 aktiveras läget, men om det redan är aktiverat, byts fokus från en vy till den andra, medan du stannar kvar på samma plats i dokumentet.
Uppdateringsintervall mellan sidlayouteditorn och källkodseditorn kan ställas in. Gå till ->. Välj fliken . Du kan välja om du bara vill uppdatera en vy när du klickar på den, eller automatiskt. Om du väljer automatiskt, kan du välja uppdateringsintervall. Den allmänna rekommendationen är: Ett mindre värde för snabba datorer och ett större värde för långsammare datorer.
Läget Sidlayout- och källkodseditor.
Låt oss säga att du vill redigera webbsidans titel. Hur gör du det? Starta helt enkelt ->. Det här verktyget låter dig redigera “osynliga” taggar, när du använder sidlayouteditorn. Dialogrutan Dokumentegenskaper startas också när du skapar ett nytt dokument inne i sidlayouteditorn. Det görs för att minska mängden manuell kodning som du måste göra. Du kan redigera följande i den:
Dokumentets titel
Metataggar låter dig lagra information om själva dokumentet, t.ex. nyckelord för söktjänster på Internet. Du kan lägga till eller ta bort Metaobjekt genom att trycka på de två knapparna nedanför, och redigera dem genom att klicka på listan, t.ex. placera “nyckelord” i kolumnen “name” och “nyckelord1 nyckelord2” i kolumnen “content”.
CSS-regler är det nya sättet att tala om för webbläsaren hur sidan ska presenteras. Du kan lägga till eller ta bort CSS-regler genom att trycka på knapparna nedanför. Du kan också fylla i fälten som för Metaobjekt. Redigering av CSS-regler stöds inte ännu.
Du kan också länka till en extern CSS-stilmall. Klicka helt enkelt på knappen Bläddra och välj filen.
Du kan använda markören som du gör i en ordbehandlare, och flytta med piltangenterna. Det kan hända att markören inte vill flyttas dit du vill (ett irriterade fel). Markering fungerar också som vanligt. Du kan infoga text genom att skriva, och ta bort text genom att trycka på backsteg eller Delete-tangenten.
Nu kommer vi till att infoga taggar. Du kan infoga bilder, miniprogram, textdekorationer som fetstil och så vidare, genom att använda samma verktygsrader som du använder i källkodseditorn. Observera att infoga taggar tar inte bort tidigare identiska taggar. Om du till exempel infogar en ankartagg omkring en viss text, måste du ta bort alla andra ankartaggar som omger den.
Vissa ikoner i verktygsrader är inaktiverade, som Tabelleditor eller Snabblista. De kommer senare att fungera också i sidlayouteditorn, men i den här utgåvan måste du använda verktygsraderna Tabeller eller Listor.
För att redigera en tagg (vare sig det är en bild, ett miniprogram eller något annat), byt till egenskapsträdet, som du kan komma åt via ->. Klicka på taggen som du vill redigera, eller om du inte kan komma åt den, klicka på ett objekt som omger den. Egenskapsträdet visar nuvarande taggnamn, samt en lista på alla dess överliggande taggar och egenskaper. För närvarande stöder inte sidlayouteditorn till exempel XHTML+MathML, men du ser att du kan redigera namnrymder via den här vyn. Du kan helt enkelt klicka på fältet Värde och ändra vad du vill. Om du vill komma åt en överliggande tagg, markera den så laddas den i egenskapsträdet.
För att ta bort en tagg, används Egenskapsträdet. Har du observerat de två små röda kryssen längst upp till höger? Det första tar bara bort taggen som för närvarande är markerad, och om HTML- eller XHTML-specifikationen inte tillåter att någon underliggande tagg till den borttagna taggen att bli underliggande tagg till taggens överliggande tagg, tas den också bort, och så vidare. Det andra krysset tar bort den markerade taggen, och alla dess underliggande taggar, så var försiktig!
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
Det här kapitlet förklarar det olika funktionerna som finns i menyraden.
Skapa en ny, tom fil.
Sök i filsystemet för att öppna en befintlig fil.
Snabblista med några av de senaste filerna som du öppnat. Listan ändras varje gång du öppnar en fil som inte finns i den, och de äldsta filerna tas bort först.
Spara ändringarna i den aktiva filen.
Spara den aktiva filen med ett annat namn.
Det här låter dig spara kodfragment och hela filer som en mall för senare användning. Se avsnittet om mallar. Om du försöker spara vald text eller fil utanför den lokala eller projektets mallkatalog, får du ett fel.
Låter dig spara en fil som en mall i det lokala området.
Låter dig spara en fil som en mall i projektområdet.
Låter dig spara markerad text (dvs. ett kodavsnitt) i en lokal mallfil.
Låter dig spara markerad text (dvs. ett kodavsnitt) i en projektmallfil.
Spara alla filer som ändrats i editorn.
Återställer det aktuellt dokumentet som har fokus.
Du kan verkligen skriva ut dina dokument. Använder Kprinter-gränssnittet.
Avsluta Quanta Plus.
Ångra den senaste åtgärden som utförts.
Gör om den senast ångrade åtgärden.
Klipp ut det aktuella textblocket och lägg dess innehåll på klippbordet.
Kopiera det aktuella textblocket till klippbordet.
Klistra in klippbordets innehåll på nuvarande markörposition.
Konverterar klippbordstextens HTML-specialtecken till HTML-objekt, innan de klistras in i texten, så att de visas på ett riktigt sätt, och inte hanteras som taggar av webbläsarklienten.
Konverterar klippbordets text till webbadresskodning, som är det rätta sättet att infoga specialtecken och mellanslag i webbadresser. Används i huvudsak när en webbadress klistras in i en ankartagg.
Markera all text i aktuellt dokument.
Avmarkera all text i aktuellt dokument.
Sätt på eller stäng av blockmarkering. Låter dig välja textblock med tangentbordet utan att hålla nere skifttangenten.
Överskrider tangenten Insert.
Sök efter sträng eller reguljärt uttryck i det aktuella dokumentet.
Upprepa sökningen neråt i dokumentet från den nuvarande platsen.
Upprepa sökningen uppåt i dokumentet från den nuvarande platsen.
Ersätt sträng eller reguljärt uttryck med text i den aktuella filen.
Gå direkt till ett angivet radnummer. Det här är verkligen användbart när ett PHP-skript går fel oväntat!
Sök efter en sträng eller ett uttryck i filer i den valda katalogen. En sorts grafisk grep eller sed, med några fördefinierade mönster som hjälp.
Expanderar förkortningarna. Förkortningar kan definieras i dialogrutan ->.
Formaterar om källkoden enligt samma regler som sidlayouteditorn infogar taggarna.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Visa eller dölj filträdet.
Visa eller dölj projektträdet.
Visa eller dölj mallträdet.
Visa eller dölj skriptträdet.
Visa eller dölj dokumentstrukturträdet.
Visa eller dölj egenskapsträdet.
Visa eller dölj dokumentationsträdet.
Visa eller dölj meddelandefönstret. Detta är fönstret där du ser utmatning från skriptåtgärder och avlusaren.
Visa eller dölj Problemrapporter längst ner i Quanta Plus huvudfönster. Problemrapporter aktiveras när du byter till Strukturträd.
Visar noteringsvyn. Läs “Noteringar” för detaljerad information.
Visar filerna på servern för en uppladdningsprofil.
Visa eller dölj ikonkanten till vänster om huvudredigeringsfönstret. Den här kanten tillåter att bokmärken hanteras med ett klick.
Visa eller dölj radnummer längs vänsterkanten på huvudredigeringsfönstret.
Väljer omformatering av text till en särskild bredd medan du skriver.
Byt till källkoden för ett dokument för att redigera den.
Byt till sidlayouteditorn för att redigera ett dokument.
Byt till delat skärmläge för att redigera ett dokument.
Förhandsgranska aktuellt dokument.
Navigera bakåt ett steg i förhandsgranskningen.
Navigera framåt ett steg i förhandsgranskningen, efter att ha gått bakåt i den.
Ladda om förhandsgranskningen från disk.
Visa aktuell fil med Konqueror.
Visa aktuell fil med Mozilla Firefox webbläsare.
Visa aktuell fil med Mozilla®.
Visa aktuell fil med Netscape®.
Visa aktuell fil med Opera.
Visa aktuell fil med Lynx (en textbaserad webbläsare).
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Lägg till ett bokmärke på nuvarande rad i aktuell fil.
Rensar alla bokmärken i aktuellt dokument.
Om du har bokmärken i nuvarande fil, syns de i menyn tillsammans med alternativet Föregående eller Nästa beroende på markörens position i dokumentet.
Om du har bokmärken i andra öppnade dokument, syns de i menyn grupperade enligt de andra dokumentens filnamn.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Hur projekt används i Quanta Plus beskrivs under “Projekt”.
Starta guiden för att skapa projekt.
Öppna ett befintligt projekt från disk. Quanta Plus projekt sparas med filändelsen .webprj.
Visa en lista med projekt som senast används, för snabb åtkomst.
Stäng det aktuella projektet.
Öppnar en “vy”, en specifik kombination av öppna filer som du tidigare sparat.
Spara den nuvarande uppsättningen öppna filer som en “vy”.
Spara den nuvarande uppsättningen öppna filer som en “vy” med ett annat namn.
Ta bort en “vy”.
Visar en dialogruta som låter dig välja filer att lägga till i aktuellt projekt. Filerna kopieras sedan till projektkatalogen för redigering.
Infoga en katalog och hela dess innehåll i aktuellt projekt.
Sök i projektkatalogen efter eventuella nya filer som kan finnas där. Det här låter dig kopiera grafik till projektkatalogen eller en underkatalog i den, och sedan lägga till dem i projektet.
Ladda upp filerna i projektet till värddatorservern. Listan på tillgängliga överföringsformat beror på vilken version av KDE som du kör, och om du har laddad ner extra I/O-slavar eller inte.
Inställningar som påverkar hur Quanta Plus hanterar projektet. Se avsnittet om Quanta Plus projekt för detaljerad information.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Laddar en globalt definierad verktygsrad. Dessa finns normalt i $. KDEDIR/share/apps/quanta/toolbars
Laddar en lokalt definierad verktygsrad. Dessa finns normalt i $. HOME/.kde/share/apps/quanta/toolbars
Ladda en projektverktygsrad. Dessa finns i projektkatalog/toolbars
Dialogruta för att spara verktygsrader. Låter dig ange typ av verktygsrad, lokal eller projekt.
Spara som en lokal verktygsrad i $. HOME/.kde/share/apps/quanta/toolbars
Spara som en projektverktygsrad i projektkatalog/toolbars
Visar en dialogruta för att skapa en ny verktygsrad. Det här skapar bara namnet. Åtgärder måste läggas till med menyalternativet ->. Verktygsrader sparas med menyn ->, eller om du avslutar blir du tillfrågad om att spara verktygsrader som inte sparats.
Ta bort en verktygsrad från användning. Det här tar inte bort den från disk. Om du inte har sparat verktygsraden du tar bort, blir du tillfrågad om att spara den.
Låter dig byta namn på en verktygsrad.
Det här är en åtgärd för att e-posta din egen verktygsrad till någon (kanske till Quanta Plus-gruppen för att lägga till den i nästa utgåva!), så att de kan använda den. Ett e-postfönster startas, och din verktygsrad bifogas automatiskt.
Det här låter dig ladda upp en verktygsrad till huvudresursservern. Se “Dela resurser”.
Det här låter dig ladda upp verktygsrader till huvudservern, där andra kan ladda ner den. Se “Dela resurser”.
Det här låter dig ladda ner verktygsrader från Internet. Se “Hämta resurser”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Visar en dialogruta som låter dig ändra DTD för aktuellt dokument.
Gör det möjligt att ändra inställningsfilen description.rc för en DTEP.
Ladda en DTD som du eller någon annan skapat och konvertera den till Quanta Plus egna beskrivningsformat.
Laddar eller uppdaterar instanser från en DTD. Det är användbart om du vill uppdatera instanserna i en DTEP utan att skapa om hela. I fallet då den är global och du inte har skrivrättigheter till den globala KDE-katalogen, misslyckas laddningen av instanser.
Ladda din egen DTEP.
Skicka din DTEP till en vän via KMail.
Det här låter dig ladda ner DTEP från Internet. Se “Dela resurser”.
Det här låter dig ladda ner DTEP från Internet. Se “Hämta resurser”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Den här menyn innehåller en lista med taggar som finns i verktygsraderna som för närvarande är laddade. Om du t.ex. har Standard (HTML) verktygsraden laddad, så innehåller menyn undermenyn , som innehåller listan med taggar/åtgärder i verktygsraden.
Låter dig komma åt inställningsdialogrutan för aktuell tagg, om det finns en. Den här åtgärden finns alltid med, följd av DTD-specifika undermenyer.
Det här markerar aktuellt taggområde. Taggområdet börjar där musmarkören är placerad.
Aktiverar eller inaktiverar smart infogning av taggar. För närvarande fungerar det bara med (X)HTML DTD:er. Smart infogning betyder att Quanta Plus vägrar att infoga en tagg från verktygsraden om taggen inte kan finnas på nuvarande plats.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Menyn innehåller tillgängliga insticksprogram under ovanstående menyalternativ. Genom att klicka på dem, aktiveras de. Genom att klicka på ett aktiverat insticksprogram, inaktiveras det.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Välj färgläggningsläge för aktuell fil. Listan med tillgängliga färgläggningslägen varierar beroende på vilken version av Kate du har.
Välj kodningstyp för radslut. Användbart om någon använder andra operativsystem för utveckling. Välj , eller .
Flytta det markerade textblocket en tabulatorbredd till höger.
Flytta det markerade textblocket en tabulatorbredd till vänster.
Tar bort all indentering.
Kommenterar markerad text.
Avkommenterar markerad text.
Radbryt texten i aktuellt fönster till en fördefinierad bredd.
Kontrollera stavning i aktuellt dokument.
Redigera specifika egenskaper för ett dokument som för närvarande är laddat, när sidlayouteditorn används.
Konvertera skiftläget för alla tecken i taggar och/eller egenskaper.
Kontrollerar syntaxen för aktuellt dokument mot vald DTD genom att använda det externa programmet tidy.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Stänger aktuell flik (dokument, insticksprogram, förhandsgranskning eller dokumentation).
Stänger alla öppna flikar.
Byter mellan olika lägen för användargränssnittet i farten. På grund av vissa begränsningar i KDE-biblioteken kan bytet ta tid och orsaka fula rester. Det läge som rekommenderas att användas är IDEA-läge, som är förval, eller Fliksidläge, som är samma läge som fanns i Quanta Plus 3.2 och tidigare versioner.
Dessutom innehåller menyn ett alternativ för varje öppen flik. Genom att välja ett sådant alternativ, blir den valda fliken den aktiva.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Visa eller dölj verktygsrader som inte är användardefinierade.
Visa eller dölj den DTD-specifika verktygsraden.
Visa eller dölj statusraden längst ner i Quanta Pluss huvudfönster.
Ställ in Quanta Plus beteende.
Ställ in beteendet hos den integrerade förhandsgranskningen.
Ändringarna som görs i dialogrutan påverkar alla program som använder KHTML-delprogrammet inklusive webbläsaren Konqueror.
Det är här du definierar åtgärder för användning i verktygsrader. Se “Användardefinierade åtgärder”.
Det är här du kan definiera och ändra insticksprogrammen.
Ställ in beteendet hos redigeringsfönstret. Se Kates dokumentation för detaljerad information.
Dialogruta som låter dig lägga till eller ta bort ikoner i verktygsrader och ändra ordningen som ikonerna visas.
Låter dig anpassa de många snabbtangenter för redigering som är tillgängliga 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 innehåller KDE:s standardhjälpmeny med följande alternativ tillagda:
Det här ska ge hjälp baserat på aktuell omgivning för pekaren. När det här skrivs, är funktionen inte realiserad.
Quanta Plus är en högkvalitetsprodukt som är fritt tillgänglig, och har fri licens, men som alla projekt med öppen källkod, behöver utvecklarna alltid hjälp. Om du vill stödja utveckling av Quanta Plus finansiellt, kan du få reda på hur det går till här.
KDE:s standardmeny med hjälpalternativ ser ut som följer:
Startar KDE:s hjälpsystem med början på hjälpsidorna för detta program (det här dokumentet).
Ändrar muspekaren till en kombination av en pil och ett frågetecken. Genom att klicka på objekt i detta program öppnas ett hjälpfönster (om det finns ett för just det här objektet) som förklarar objektets funktion.
Öppnar dialogrutan för felrapportering där du kan rapportera ett fel eller lämna ett förbättringsförslag.
Det här visar information om version och upphovsmän.
Det här visar KDE:s version och annan grundläggande 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
Detta kapitel beskriver hur du kan anpassa Quanta Plus beteende.
Inställningsdialogrutorna kan kommas åt från menyn Inställningar. Här beskriver vi bara några få av dem. Resten är inte specifika för Quanta Plus, och en kort beskrivning finns under “Menyn ”.
Inställningsdialogrutan kan visas genom att använda +. Dialogrutan har flera sidor, som vi beskriver en i taget.
Du kan ändra Quanta Plus beteende rörande taggar, inklusive automatisk komplettering. Alternativen är:
Taggskiftläge: Skiftläget för de automatiskt infogade taggarna. Standardskiftläge betyder att taggarna infogas som de beskrivs i tagXML-filerna.
Egenskapsskiftläge: Skiftläget för de automatiskt infogade egenskaperna. Standardskiftläge betyder att egenskaperna infogas som de beskrivs i tagXML-filerna.
Egenskapscitation: Hur egenskaper som infogas av Quanta Plus ska citeras.
Avsluta automatiskt taggar som är valfria: Om markerad, avslutas taggar vars avslutande tagg är valfri automatiskt så fort > som avslutar taggar skrivs in.
Avsluta automatiskt taggar som inte kan stå ensamma eller är valfria: Samma som tidigare för övriga taggar, med undantag för taggar som inte kan stå ensamma.
Använd automatiskt komplettering: Sätt på eller stäng av automatisk komplettering av taggar, egenskaper, funktioner, etc.
Uppdatera start- och sluttagg automatiskt: Om markerad, så fort du ändrar starttaggen, ändras motsvarande sluttagg också, och tvärtom.
Automatisk ersättning av tecken med accent: Om markerad, ersätts tecken med accent med sina koder när du skriver in dem.
En sida som anpassar miljön och vissa förvalda inställningar.
Mime-typer: Mime-typer använda för att känna igen olika sorters filer. Använd knappen Återställ till standardvärden för att fylla i posterna med sina standardvärden.
Standardteckenkodning: Kodningen för nyskapade filer, eller filer som laddas på annat sätt än med -> (där du kan överskrida kodningen). Inställningen överskrids av samma inställning under Projektegenskaper om ett projekt är laddat.
Standard-DTD: Den DTD som används för nyskapade filer, eller filer vars DTD inte kändes igen. Inställningen överskrids av samma inställning under Projektegenskaper om ett projekt är laddat.
Skapa säkerhetskopia: Quanta Plus skapar säkerhetskopior av filer periodiskt, så att dokumentet kan återställas från säkerhetskopian vid nästa start i händelse av kraftbortfall eller en krasch. Detta är inte samma sak som säkerhetskopian som skapas när en fil sparas. Det skapas en säkerhetskopia också för dokument som ännu inte sparats.
Startalternativ: Självförklarande inställning som styr vad som händer vid start.
Här kan du anpassa utseende och känsla hos Quanta Plus.
Förhandsgranskning och dokumentation kan visas i editorområdet eller i en separat verktygsvy, då det också är möjligt att titta på dokumentationen eller förhandsgranskningen samt källkoden.
Det är också möjligt att anpassa verktygsvyernas och dokumentflikarnas utseende.
Återställ fönsterlayout till standardvärde vid nästa start är användbart om du har ställt till användargränssnittet genom att byta flerfönsterläge och docka eller koppla loss verktygsvyerna. Det är samma sak som kommandoradsväljaren --resetlayout.
Här är också stället där beteendet hos filträd kan anpassas.
Rutan Varningsmeddelanden är användbar för att aktivera eller inaktivera varningsmeddelanden som kan tas bort genom att markera rutan Visa inte igen inne i dem.
Stället där beteendet hos sidlayoutvyn kan ändras. Du kan aktivera visning av en ikon istället för skript, samt anpassa synkronisering av sidlayoutvyn och källkodsvyn när delat läge är aktiverat. Se “Menyn ” för att ta reda på hur olika lägen aktiveras.
Här kan du finjustera tolken och strukturträdet, som är den synliga representationen av de tolkade noderna i dokumentet.
Under Klick på strukturträdobjekt är det möjligt att ändra åtgärder som är tilldelade till musknappar när du klickar på strukturträdet.
Under Strukturträdets utseende och känsla är det möjligt att anpassa vilka noder som är synliga i trädet, hur ofta trädet uppdateras under redigering och, vid en uppdatering, hur djupt strukturträdet automatiskt ska öppnas. Tomma noder är textnoder med blanktecken, medan tomma grupper är grupper för vilka inga element hittades i det nuvarande dokumentet.
Stället där förkortningar (en sorts mallar) kan definieras, som kan expanderas till mer text under redigering. Förkortningar är organiserade i grupper, varje grupp kan vara giltig för mer än en DTEP. Det betyder att du kan ha en grupp som är giltig för PHP, där förkortningsmallen "ifclause" betyder något annat än i en grupp som är giltig för Javascript.
Att skapa och redigera användardefinierade åtgärder beskrivs i “Användardefinierade åtgärder”.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Här kan du hantera insticksprogram. Insticksprogram är Kpart-program som är skrivna av tredje part som kan återanvändas i alla program som kan hantera Kpart-program, där det mest kända är Konqueror. När du skapar ett insticksprogram måste du ange:
Namn: Namnet som syns för användaren
Utmatningsfönster: Insticksprogram kan synas under en flik i editorområdet eller i en separat verktygsvy längst ner
Plats: Sökvägen till insticksprogrammet, om det inte finns på en standardplats, som $.KDEDIR/lib
Filnamn: Den relativa sökvägen och filnamnet för insticksprogrammets biblioteksfil, som kde3/libcervisiapart.la
Inmatning: Insticksprogrammet för den här informationen vid start, så att det kan öppna Aktuell fil, katalogen för aktuell fil (Aktuell filsökväg) eller Projektkatalog.
Läsdel: Markera om insticksprogrammet vägrar att laddas. Delprogram som bara ska kunna läsa vägrar oftast att laddas om alternativet inte är markerat.
Validera insticksprogram: Om markerad testar Quanta Plus om den inmatade informationen är riktig eller inte. Avmarkera det om insticksprogrammet ännu inte är tillgängligt, men du kommer att installera det senare, så att du kan stänga dialogrutan.
Se “Menyn ” och “Använda insticksprogram” för information om hur insticksprogram används.
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
Det här kapitlet ger en översikt av de avancerade funktionerna i Quanta Plus, och hur de används.
Utgåva 3.2 av Quanta Plus för med sig många nya XML-verktyg och funktioner. Verktygen är unika i sin integrering med Quanta Plus. Alla verktyg använder Kommander som gränssnitt, med libxml2 och lixslt för bakgrundsbehandling. Denna kombination ger snabba, effektiva, produktiva och kompletta verktyg.
Quanta Plus stödjer KDE:s två huvudsakliga dokumentationsverktyg: meinproc och checkXML.
Alla som har arbetat med dokumentation av KDE känner till meinproc, och hur superbt det är. Nu blir det ytterligare ett snäpp bättre, med ett utmärkt grafiskt gränssnitt. Du behöver inte längre använda en terminal, utan klicka bara på ikonen som ser ut som en processor, så är du klar!
Det här programmet förväntar att en fil med namnet index.docbook finns i en katalog. Om index.docbook finns i aktuell arbetskatalog, lämna Aktuell arbetskatalog markerad. Om den inte gör det, avmarkera Aktuell arbetskatalog och skriv in katalogen som du vill behandla i fältet Annan katalog.
Utdatafiler placeras i samma katalog som källkodsfilerna. Alla HTML-filer tas bort varje gång meinproc körs.
Återigen, alla som har arbetat med dokumentation av KDE känner till det här hjälpsamma programmet. Quanta Plus erbjuder också här ett utmärkt litet grafiskt gränssnitt till det.
Om den aktuella öppna filen är index.docbook, lämna bara Aktuell arbetskatalog markerad. Om den inte är det, avmarkera Aktuell arbetskatalog och skriv in katalogen där index.docbook kan hittas.
Om det blir någon utmatning är filen ogiltig. Korrigera rapporterade fel och försök igen.
Quanta Plus har ett utmärkt XML-valideringsverktyg, som använder bakgrundsprogrammet xmllint.
Om filen som ska valideras för närvarande har fokus i Quanta Plus, lämna helt enkelt Aktuell fil markerad. Om den inte är det, avmarkera Aktuell fil och välj filen som ska valideras i filväljaren Annan fil.
Om du bara vill veta att en fil är välformad, markera kryssrutan Kontrollera bara att välformat.
Om du använder en DTD, och den specificeras i XML-filen, välj DTD (intern), standardvalet, eller välja annars DTD (extern) och hitta DTD:n med filväljaren för definitionens webbadress. Både för validering av W3C® XML schema och RelaxNG krävs extern definition via filväljaren för definitionens webbadress.
Ja, Quanta Plus har också ett XSL-behandlingsverktyg! Det använder verktyget xsltproc som tillhandahålls med libxml2.
Om filen som ska behandlas för närvarande har fokus i Quanta Plus, lämna helt enkelt Aktuell fil markerad. Om den inte är det, avmarkera Aktuell fil och välj filen som ska behandlas i filväljaren Annan fil.
Välj XSL-filen som du vill ska användas.
Skriv in namnet som du vill att resultatfilen ska kallas. Filen skrivs normalt i din hemkatalog.
Det här programmet saknar flexibilitet. Ursäkta, vi ska bättra oss nästa gång.
Quanta Plus kan ladda insticksprogram, som är delprogram (Kparts). Mekanismen med delprogram, är ytterligare en mycket kraftfull funktion i KDE. Ett delprogram är en relativt liten, återanvändbar behållare för en funktion. Den gör det möjligt för KDE-utvecklare att enkelt bygga vidare på andra programmerares arbete. Ett exempel på detta är Quanta Plus själv. Editorn som Quanta Plus använder är Kates delprogram. Kates delprogram har redan en mängd funktioner som Quanta Plus behöver, som syntaxfärgläggning. Genom att integrera det i Quanta Plus, blev det möjligt för Quanta Plus utvecklare att fokusera på vad Quanta Plus ska kunna göra, istället för att hantera de många problem som skulle orsakats av att utveckla en ny editorkomponent från början.
Insticksprogrammen som Quanta Plus laddar, kanske inte har något alls att göra med Quanta Plus själv. Det gör det till ett mycket kraftfullt system. Du kan dra nytta av extra funktioner, och behöver inte vänta på att någon integrerar dem i Quanta Plus. Insticksprogrammen kan laddas till ett antal olika grafiska element. Mer om detta nedan.
För att installera ett insticksprogram eller ett delprogram, används menyn ->. Då visas följande dialogruta:
Dialogrutan för att redigera insticksprogram.
Den här dialogrutan låter dig hantera alla definierade insticksprogram, och låter dig lägga till nya. Vi beskriver varje element i gränssnittet här.
Här kan du fylla i en sökväg. När du lägger till ett instickprogram utan en Plats, söker Quanta Plus i denna sökväg för att hitta insticksprogrammet.
Det här visar en dialogruta som låter dig lägga till ett nytt insticksprogram.
Det här låter dig ändra inställningar för ett visst insticksprogram.
Tar bort det aktuella markerade insticksprogrammet.
Uppdaterar dialogrutans innehåll.
Läs “Anpassa insticksprogram” för att lära dig mer om insticksprogram.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Ofta har ett projekt mer än en person som arbetar med det, och det finns något sorts hierarkiskt förhållande mellan dem. Quanta Plus stöder begreppet gruppmedlem, och de kan ställas in i dialogrutan -> (Skift+F7).
Redigeringsdialogrutan Gruppmedlemmar
Posterna Namn och E-post är självförklarande. Smeknamn är en användares smeknamn och fungerar som en unik identifierare.
Roll anger medlemmens roll i projektet och kan vara en av följande:
Gruppledare
Delprojektledare
Aktivitetsledare
Enkel medlem
Uppgift är en beskrivning av uppgiften som är tilldelad till medlemmen.
Delprojekt: Du kan välja en lista med delprojekt. Delprojekt kan anpassas och skapas genom att klicka på knappen Redigera delprojekt. Varje delprojekt har ett namn som är synligt för användaren och en plats. Den senare anger en relativ sökväg till en katalog under projektträdet. Det betyder att ett delprojekt är en katalog under huvudprojektet. Huvudprojektet kan till exempel finnas på företagets webbplats, medan ett delprojekt kan vara webbplatsen för intranätet, placerat i underkatalogen intranät i projektet.
En medlem kan ha mer än en roll i projektet, som både gruppledare och delprojektledare.
En användare bör välja vem i listan med gruppmedlemmar som han själv är. Det är möjligt genom att markera en gruppmedlem i listan och trycka på knappen Ange som dig själv. Medlemmen som för närvarande är markerad (din identitet) visas med fetstil efter texten Du är:.
Smeknamn och att ställa in dig själv är viktigt rörande meddelanden och noteringar. Se “Noteringar” för att lära dig mer om noteringar.
Förutom att hålla reda på gruppen, finns det ytterligare en fördel med att ange gruppmedlemmar: Du kan skapa en händelse som informerar gruppledarna när en viss åtgärd utförs. Se “Händelseåtgärder” om hur det görs.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Händelseåtgärder är åtgärder som utförs när en viss händelse inträffar i projektet. Ett exempel kan vara att logga när projektet öppnas och stängs, så att det senare går att granska hur mycket någon arbetade med det, eller skicka e-post när en fil sparas, eller lägga till en ny fil i CVS med hjälp av ett skript när filen läggs till i projektet, och listan kunde fortsätta.
På sidan Händelseinställning i dialogrutan -> (Skift+F7) kan du skapa, redigera och ta bort händelseåtgärder.
Händelseditorns dialogruta
Posterna i dialogrutan är:
åtgärden utförs när händelsen som väljes i listan inträffar. Händelsenamnen är självförklarande.
den utförda åtgärdens typ. Möjliga alternativ är
en åtgärd som inte är en användardefinierad skriptåtgärd. Se “Användardefinierade åtgärder” för användaråtgärder.
Åtgärdsnamn anger åtgärden som ska utföras när händelsen inträffar.
e-post skickas till mottagaren som väljes i listan Mottagare när åtgärden utförs. Mottagaren kan vara en grupp eller delprojektledare. Se “Utveckling i grupp” för att definiera sådana ledare.
händelserna loggas i en fil. Åtgärdens argument är:
filnamnet med fullständig sökväg
Hur mycket information ska loggen innehålla
Om befintlig loggfil ska skrivas över eller om den nya loggade händelsen ska läggas till sist i den.
en användardefinierad skriptåtgärd. Se “Användardefinierade åtgärder” för användaråtgärder.
Åtgärdsnamn anger åtgärden som ska utföras när händelsen inträffar.
Övriga poster beror på typ av åtgärd som beskrivna.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Noteringar är speciella kommentarer i dokumenten. De skiljer sig från vanliga kommentarer i följande avseenden:
informationen samlas in av Quanta och visas i verktygsvyn Noteringar.
informationen kan adresseras till en gruppmedlem
Att skriva in noteringar är enkelt. Du kan antingen använda alternativet Notering i editorns sammanhangsberoende meny, eller skriva in nyckelordet @annotation i ett kommentarområde följt av noteringens text.
Exempel 6.1. Noteringsexempel i XML
<!-- @annotation Det är möjligt att den här koden är felaktig. -->
<!-- @annotation Flerraders notering. -->
Exempel 6.2. Noteringsexempel i PHP
/* @annotation Använd PHP-kommentarer vid noteringar i ett PHP-omåde */
Noteringar kan adresseras till en särskild medlem i gruppen. Syntaxen i detta fall är @annotation(smeknamn) eller @annotation(roll), där smeknamn är gruppmedlemmens smeknamn, medan roll är en projektroll från följande lista:
gruppledare
aktivitetsledare
delprojektledare
Exempel 6.3. Gör en anteckning till en gruppmedlem med smeknamnet eric
<-- @annotation(eric) Eric, ta en titt på det här. Andras -->
Exempel 6.4. Informera gruppledaren
<-- @annotation(gruppledare) Det här är mycket viktigt för gruppen -->
Exempel 6.5. Informera PHP-delprojektledaren
// @annotation(delprojektledare:PHP) Vad tror du om det?
Smeknamn och rollnamn är inte skiftlägeskänsliga, men mellanslag omkring parenteser och : gör noteringen ogiltig.
Mer om gruppmedlemmar, roller och smeknamn finns under “Utveckling i grupp”.
Noteringarna som finns i projektet kan inspekteras i vyn Noteringar. Den består av trädflikar:
Noteringarna som finns i aktuell fil.
Noteringar i projektet adresserade till dig. Posterna grupperas per fil.
Noteringarna som finns i alla projektfiler, grupperade enligt fil.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
I Quanta Plus version 3.3 har felsökningshanteringen implementerats om. Stöd för den numera föråldrade PHP (3) inbyggda felsökningen har tagits bort, så också stöd för dbg-felsökaren. Istället har ett allmänt system med insticksprogram för felsökning utvecklats, för att tillåta olika implementeringar av insticksprogram.
För närvarande är bara ett insticksprogram tillgängligt, som lägger till stöd för att använda Gubed PHP Debugger med Quanta Plus.
För att använda felsökning i projektet, öppna projektegenskaper och välj ett lämpligt insticksprogram för felsökning. För att ändra specifika felsökningsinställningar, tryck på knappen 'Alternativ' intill kombinationsrutan med insticksprogram för felsökning.
När ett projekt har aktiverad felsökning, dyker ett antal ytterligare objekt upp i Quanta Plus användargränssnitt:
En ny meny visas där du kan komma åt de flesta felsökningsfunktionerna.
En verktygsrad där de vanligaste felsökningskommandona kan kommas åt.
En verktygsvy där innehållet i bevakade variabler visas. Ingår normalt i dockningsraden till vänster.
En verktygsvy där brytpunkter, på rader och villkorliga, anges. Ingår normalt i dockningsraden längst ner.
En verktygsvy där utmatningen (som i HTML) från felsökningen visas. Visas normalt i dockningsraden längst ner.
Beroende på vad insticksprogrammet för felsökning stöder, är alla eller en delmängd av följande funktioner tillgängliga.
Det här alternativet används för att ansluta till felsökaren om det krävs, eller tala om för insticksprogrammet att det ska börja vänta på en felsökningsbegäran. Alternativet aktiveras automatiskt när ett projekt som använder felsökning öppnas, så oftast behöver du inte bry dig om det.
Motsatsen till ->->. Stänger anslutningen till felsökaren eller slutar vänta på en begäran.
Skickar en HTTP-begäran till servern för att initiera en felsökningsbegäran. Att använda det här alternativet motsvarar att använda en webbläsare för att titta på det nuvarande dokumentet. Utmatningen från begäran hamnar på dockningsraden i Felsökningsutmatning.
Gör paus i ett skript som kör
Talar om för felsökaren att börja köra skriptet och skicka information om bevakade variabler och nuvarande rad som körs medan den kör. Om detta sker när ett skript gör paus, fortsätter körningen. Om det görs innan en felsökningsbegäran har initierats, börjar skriptet köra så fort en begäran initieras.
Talar om för felsökaren att börja köra skriptet utan att skicka information om bevakade variabler och nuvarande rad som körs medan den kör. Om detta sker när ett skript gör paus, fortsätter körningen. Om det görs innan en felsökningsbegäran har initierats, börjar skriptet köra så fort en begäran initieras.
Talar om för felsökaren att köra nästa instruktion i skriptet, utan att stega in i funktioner eller inkluderade objekt.
Talar om för felsökaren att köra nästa instruktion i skriptet, och stega in i funktioner eller inkluderade objekt om möjligt.
Talar om för felsökaren att köra till den kommer ut ur nuvarande funktion.
Talar om för felsökaren att hoppa över nästa instruktion och fortsätta till den efterföljande som om den nuvarande inte fanns.
Talar om för felsökaren att den ska döda skriptet som för närvarande kör.
Visar en dialogruta där du kan ange villkorliga brytpunkter.
Ändrar en radbrytpunkt på raden där markören finns, den nuvarande raden.
Rensar alla brytpunkter.
Visar en dialogruta där du kan skriva in en variabel eller ett uttryck som du vill bevaka. Det bevakade värdet visas i verktygsvyn Variabler.
Visar en dialogruta där du kan skriva in en variabel och ett nytt värde för den.
KXsldbg är skapat av Keith Isdale, liksom det här avsnittet av dokumentationen. KXsldbg är ett KDE-gränssnitt och en Kpart för xsldbg, som du hittar på http://xsldbg.sf.net tillsammans med mycket annat av Keiths arbete.
För att starta KXsldbg, välj ->.
Se dokumentationen för KXsldbg för ytterligare information om dess användning.
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
Det här kapitlet beskriver hur Quanta Plus kan anpassas till just dina behov, och hur du kan hjälpa till att göra Quanta Plus bättre.
Dokumenttyp-redigeringspaket (DTEP) används i Quanta Plus för att lägga till stöd för taggar, skriptspråk och stilmallar. De tillåter Quanta Plus att tillhandahålla funktioner som automatisk komplettering och nodträd. Deras enkelhet och flexibilitet är vad som gör Quanta Plus en snabb, utvecklarvänlig integrerad uvecklingsmiljö för webbutvecklare. De gör Quanta Plus till en lättanvänd, produktiv miljö.
Det finns två varianter av DTEP, familj 1, som är taggar, och familj 2 som är skriptspråk och stilmallar. En DTEP består av två delar, taggkatalogen och verktygsraderna. Taggkataloger består av två filtyper, filerna description.rc och TagXML, som har ändelsen .tag. Verktygsrader är bekväma, ikonorienterade rader med knappar (ovanför redigeringsfönstret), som lägger till text i ett dokument snabbare än användaren kan skriva.
En DTEP kan skapas för hand (se nedan), laddas ner eller skapas automatiskt från en befintlig DTD. Se “Konvertera en DTD till en DTEP” för information om konvertering.
Det här dokumentet beskriver hur filerna TagXML, description.rc och verktygsrader skapas. I korthet, en DTEP.
TagXML-filer (.tag) definerar både egenskaper specifika för en tagg, samt layout och innehåll i egenskapsdialogrutan som Quanta Plus visar för taggen. Filen description.rc tillhandahåller regler och information om en hel DTEP. Verktygsrader tillhandahåller ett snabbt sätt att lägga till taggar i ett dokument, utan att behöva bekymra sig om felstavningar eller liknande.
Taggkataloger är just det, kataloger. De består bara av filerna description.rc och TagXML-filer. Taggkatalogerna bär taggspråkets namn och version, om det finns någon (till exempel html-4.01-strict).
Tabellen nedan listar elementen som definieras i XML-taggfiler, och anger om de krävs eller inte. Även om inte alla krävs, rekommenderas du att använda så många som du kan, så att andra användare får en bättre erfarenhet och mer information att arbeta med.
| Element | Normal användning | Användningsområde |
|---|---|---|
| TAGS | krävs | alltid |
| tag | krävs | alltid |
| label | valfri | krävs för att skapa en egenskapsdialogruta |
| attr | valfri | krävs för att definiera en egenskap |
| tooltip | valfri | krävs för att låta egenskapsdialogrutan visa ett verktygstips |
| whatsthis | valfri | krävs för att låta egenskapsdialogrutan visa “Vad är det här” |
| list | valfri | krävs när en egenskap har typen “list” |
| item | valfri | krävs när <list> används |
| textlocation | valfri | alltid |
| location | valfri | krävs när label används |
| text | valfri | krävs när label används |
| children | valfri | lista över taggar som kan finnas i taggen som definieras |
| child | krävs | en av posterna i children |
| stoppingtags | valfri | lista över taggar som talar om för en annan tag att den har nått slutet |
| stoppingtag | krävs | en av posterna i stoppingtags |
Följande avsnitt beskriver varje element i detalj. Alltfrån var de kan finnas, till vad som finns i dem presenteras på ett sätt som är enkelt att följa.
Det här är XML-taggdokumentets rotelement. Det får bara finnas en gång i ett dokument. Det kan innehålla definitionen av flera taggar. Det här är ett typelement med bara element.
| Överliggande | Underliggande |
|---|---|
| INGEN | tag |
Omgivning för taggen som definieras. Det här är ett typelement med bara element.
| Överliggande | Underliggande |
|---|---|
| TAGS | label, attr, stoppingtags |
| Egenskap | Typ | Värden | Standard | Användning | Beskrivning |
|---|---|---|---|---|---|
| namn | sträng | krävs | Anger namnet på taggen som håller på att definieras. | ||
| single | Boolean | valfri | Anger om taggen kräver en avslutande tagg </(taggnamn)>. | ||
| type | sträng | xmltag | valfri | Anger typ för taggen som definieras. | |
| xmltag | Typen för taggen är XML-baserad (bara familj 1). | ||||
| entity | Taggen beskriver en post (bara familj 1). | ||||
| egenskap | Typen för taggen är stilmallsrelaterad (bara familj 2). | ||||
| funktion | Typen för taggen är en skriptfunktion. När det används blir <attr> funktionens argument (bara familj 2). | ||||
| klass | Typen för taggen är en skriptklass (bara familj 2). | ||||
| method | Typen för taggen är en klassmetod (bara familj 2). | ||||
| returnType | sträng | void | valfri | Anger returtypen för taggen som definieras (bara familj 2). | |
| void | Taggtypen returnerar ingenting. | ||||
| int | Taggtypen returnerar ett heltal. | ||||
| float | Taggtypen returnerar ett flyttal. | ||||
| long | Taggtypen returnerar ett långt heltal. | ||||
| sträng | Taggtypen returnerar en sträng. | ||||
| version | sträng | valfri | Anger språkets version som taggen är giltig för | ||
| extends | sträng | valfri | Giltig bara om taggens typ är "class". Namnet på basklassen till den här klassen (bara familj 2). | ||
| klass | sträng | valfri | Giltig bara om typen är "method". Anger namnet på klassen som den här metoden hör till (bara familj 2). | ||
| common | Boolean | valfri | Om "yes", anger taggen en gemensam egenskapsgrupp, och egenskaperna inne i taggen kan kopplas till vilken annan tagg som helst (bara familj 1). | ||
| comment | sträng | valfri | kommentarsträngen visas intill taggnamnet i kompletteringsrutan |
Placera en rubrik i dialogrutan. Texten anges av taggen <text>. Det här är ett typelement med bara element.
| Överliggande | Underliggande |
|---|---|
| tag | text, location |
Definierar en egenskap för taggen. Elementet upprepas en gång för varje egenskap. Det definierar egenskapens namn och typ. Det innehåller också ytterligare taggar som anger hur egenskapen ska visas, etc. Det här är ett typelement med bara element.
| Överliggande | Underliggande |
|---|---|
| tag | location, list, tooltip, whatsthis, textlocation |
| Egenskap | Typ | Värden | Standard | Användning | Beskrivning |
|---|---|---|---|---|---|
| namn | sträng | krävs | Anger namnet på egenskapen som håller på att definieras. | ||
| type | sträng | input | krävs | Anger typen för egenskapen som håller på att definieras. | |
| input | Fältet stöder fri textinmatning (textfält). | ||||
| check | Fältets värde är booleskt (kryssruta). | ||||
| färg | Fältets värde är en färg. | ||||
| webbadress | Fältets värde är en webbadress (lokal fil att hänvisa till). | ||||
| list | Fältets värde kommer från en angiven lista. | ||||
| status | sträng | valfri | krävs | Anger om argumentet krävs eller inte (bara familj 2). | |
| valfri | Argumentet krävs inte. | ||||
| krävs | Argumentet krävs. | ||||
| underförstått | Argumentet är underförstått. | ||||
| source | sträng | valfri | Anger källan som används för att fylla i egenskapens post i taggeditorns dialogruta och i egenskapsträdet | ||
| markering | Den markerade texten används som källa | ||||
| dcop | Resultatet av DCOP-metoden används som källa | ||||
| interface | sträng | valfri | Kräver source="dcop". DCOP-gränssnittet inne i Quanta Plus används för att hämta källdata. | ||
| method | sträng | valfri | Kräver source="dcop" och ett gränssnittsnamn. DCOP-metodnamnet inne i Quanta Plus används för att hämta källdata. | ||
| argument | sträng | valfri | Kräver source="dcop", ett gränssnittsnamn och ett metodnamn. Argumenten skickas till metoden. Den kan vara tom eller "%tagname%", vilket betyder den nuvarande taggens namn. |
Definierar verktygstipset för ett fält i dialogrutan. Elementet är bara text.
För närvarande stöds bara vanlig text (du kan inte använda några taggar).
| Överliggande | Underliggande |
|---|---|
| attr | INGEN |
Definierar 'Vad är det här'-hjälp för ett fält i dialogrutan. Elementet är bara text.
För närvarande stöds bara vanlig text (du kan inte använda några taggar).
| Överliggande | Underliggande |
|---|---|
| attr | INGEN |
En omgivande tagg som grupperar objekt i en lista tillsammans. Den kan bara finnas en gång för varje beskrivning av en egenskap. Det här är ett typelement med bara element.
| Överliggande | Underliggande |
|---|---|
| attr | item |
Anger position för en taggs egenskapstext inne i en dialogruta. Taggen kan bara finnas en gång för varje egenskap i dialogrutan (dvs en gång för varje tagg <attr>). Det här elementet är tomt.
| Överliggande | Underliggande |
|---|---|
| attr | INGEN |
| Egenskap | Typ | Användning | Beskrivning |
|---|---|---|---|
| row | positivt heltal | krävs | Anger raden i dialogrutans layout för ett fält eller en rubrik. |
| col | positivt heltal | krävs | Anger kolumnen i dialogrutans layout för ett fält eller en rubrik. |
| rowspan | positivt heltal | valfri | Anger antal rader som ett fält ska uppta. |
| colspan | positivt heltal | valfri | Anger antal kolumner som ett fält ska uppta. |
Anger position och storlek på ett fält i dialogrutan. Taggen ska finnas en gång för varje fält i dialogrutan (dvs en gång för varje tagg <attr> och <label>). Det här elementet är tomt.
| Överliggande | Underliggande |
|---|---|
| label, attr | INGEN |
| Egenskap | Typ | Användning | Beskrivning |
|---|---|---|---|
| row | positivt heltal | krävs | Anger raden i dialogrutans layout för ett fält eller en rubrik. |
| col | positivt heltal | krävs | Anger kolumnen i dialogrutans layout för ett fält eller en rubrik. |
| rowspan | positivt heltal | valfri | Anger antal rader som ett fält ska uppta. |
| colspan | positivt heltal | valfri | Anger antal kolumner som ett fält ska uppta. |
Definierar texten för en rubrik eller kryssruta. Elementet är bara text.
| Överliggande | Underliggande |
|---|---|
| label, attr | INGEN |
Definierar en lista med element som kan finnas i taggen som anges. Det här är ett typelement med bara element.
| Överliggande | Underliggande |
|---|---|
| tag | child |
Definierar en underliggande tagg. Det här elementet är tomt.
| Överliggande | Underliggande |
|---|---|
| children | INGEN |
| Egenskap | Typ | Värden | Användning | Beskrivning |
|---|---|---|---|---|
| namn | sträng | krävs | Anger en tagg som kan finnas i en viss tagg. | |
| usage | sträng | valfri | Anger förhållandet till överliggande objekt. | |
| krävs | Det överliggande objektet måste ha minst ett underliggande objekt med det här namnet. |
Definierar en lista med element som tvingar en tagg att sluta. Det här är ett typelement med bara element.
| Överliggande | Underliggande |
|---|---|
| tag | stoppingtag |
Alla XML-taggfiler måste börja med XML-deklarationen: <?xml version="1.0" encoding="UTF-8"?> och måste vara hierarkiskt korrekta och avslutade.
Mellanslag påverkar ingenting negativt, men se upp med tecknen & och <. Dessa ska troligen ersättas med & och < i element som <tooltip>, <whatsthis>, och <text>. Att inte göra det orsakar ingen krasch, men du får delar av ditt arbete att försvinna om du inte gör det.
För att validera XML-taggfiler, klicka helt enkelt på dialogrutan “Verktyg” längst upp i Quanta Plus och välj “Validera XML-taggar”. En dialogruta visas, och du behöver bara följa de enkla anvisningarna.
Den här funktionen finns inte för närvarande. För tillfället sker validering när XML-taggfilerna laddas i Quanta Plus.
Följande visar dig en korrekt familj 1 XML-taggfil. Filen råkar beskriva W3C® XML Schemas element <schema>. Filnamnet på den här XML-taggfilen skulle vara schema.tag. Enkelt, inte sant?
<?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 unik identifikation för elementet </tooltip> <whatsthis>En unik identifikation för 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 för schema.</tooltip> <whatsthis>Version för schema.</whatsthis> <location col="1" row="1"/> </attr> <label> <text>targetNamespace</text> <location col="0" row="2"/> </label> <attr name="targetNamespace" type="input"> <tooltip>Webbadressreferens till namnrymden för detta schema.</tooltip> <whatsthis>Webbadressreferens till namnrymden för detta schema.</whatsthis> <location col="1" row="2"/> </attr> <label> <text>xmlns</text> <location col="0" row="3"/> </label> <attr name="xmlns" type="input"> <tooltip>Webbadressreferens för en eller flera namnrymder för användning i detta schema. Om inget prefix används, kan komponenterna i namnrymden användas utan kvalifikation </tooltip> <whatsthis>Webbadressreferens för en eller flera namnrymder för användning i detta schema. Om inget prefix används, kan komponenterna i namnrymden användas utan 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>Standardformulär för alla egenskaper i schema.</tooltip> <whatsthis>Standardformulär för alla egenskaper 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>Standardformulär för alla element i schema.</tooltip> <whatsthis>Standardformulär för alla element 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öljande visar dig en korrekt familj 2 XML-taggfil. Filen råkar beskriva PHP:s överlastningsfunktion. Filnamnet på den här XML-taggfilen skulle vara 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 är också mycket enkel, och en editor för den är tillgänglig med ->. Det redigerar description.rc för en DTEP som du kan välja i en lista. För att redigera description.rc för en nyskapad DTEP, måste du skapa en enkel description.rc med följande poster:
[General] Version = Använd 1 för Quanta Plus version <=3.1.2 och 2 för alla senare versioner. Name = DTD-definitionssträng. (-//W3C®//DTD HTML 4.01 Transitional//EN) NickName = Det förskönade namnet på en DTD. (HTML 4.01 Transitional). Om inte definierat används Name som NickName.
När du väl har skapat den och lagt vid sidan om taggfilerna, ladda din nyskapade DTEP med ->. Efter det har laddats kan du fortsätta med att redigera inställningarna i din DTEP. Kontrollera posternas verktygstips och Vad är det här-texter i redigeringsdialogrutan för att förstå betydelsen hos varje post. Som ett alternativ kan du läsa quanta/data/dtep/dtd-description.txt i det komprimerade källkodsarkivet, som innehåller en beskrivning av formatet.
Åtgärder är mycket vanliga i alla program. Du behöver dem ofta när du använder vilket program som helst. Genom att klicka på en ikon i en verktygsrad, välja ett menyalternativ eller använda en snabbtangent utförs oftast en åtgärd. I Quanta Plus har åtgärder tagits till nästa nivå. Istället för hårdkodade åtgärder (som skapas av programmeraren på programmets källkodsnivå) är det möjligt för en vanlig användare att skapa och ändra åtgärder och på så sätt lägga till nya funktioner i Quanta Plus. De är användardefinierade åtgärder, och många av de vanliga åtgärderna i Quanta Plus är också användardefinierade (och ändringsbara) åtgärder.
Det finns tre typer av användardefinierade åtgärder:
Du kan skapa en åtgärd genom att gå till ->. Klicka på så möts du av en liknande dialogruta:
Åtgärdens namn som syns för användaren.
Ikonen som tilldelas till åtgärden. Klicka på den för att ändra aktuell ikon.
Kort beskrivning av vad åtgärden gör.
Snabbtangenten som tilldelas till åtgärden. Klicka på Egen eller knappen intill Egen för att tilldela en genväg. Klicka på Ingen för att ta bort den för närvarande tilldelade genvägen.
De användardefinierade verktygsraderna där åtgärden visas. Se “Skapa verktygsrader”.
Specifika inställningar för de olika åtgärdstyperna. Se nedan.
Användbar för att infoga XML-taggar, men du kan förstås också använda dem för andra syften.
Namnet på taggen.
Om markerad, kommer den här texten infogas som avslutande tagg när åtgärden utförs. Om det finns ett markerat område i dokumentet innan du utför åtgärden, infogas <tagg> innan det markerade området, och </tagg> efter.
Om markerad, och det finns en tagXML-fil för taggen, visas en dialogruta för taggredigering innan taggen infogas i dokumentet, så att du kan finjustera taggens egenskaper.
Först måste du skriva in namnet på skriptet samt tolken. Till exempel: sh /home/namn/mitt_skript.sh.
Även om du kan använda fullständiga sökvägar, är det rekommenderade sättet att använda variabeln %scriptdir på kommandoraden, som sh %scriptdir/mitt_skript.sh. På så sätt försöker Quanta Plus hitta ditt skript på följande ställen:
den globala skriptkatalogen: $KDEDIR/share/apps/quanta/scripts
den lokala skriptkatalogen: $KDEHOME/share/apps/quanta/scripts
din sökväg: $PATH
%f: Ersätts med webbadressen till det aktuella dokumentet. För lokala dokument tas file:/ bort från dokumentnamnet.
%input: Ersätts med markerad inmatning. Se nedan.
%projectbase: Ersätts med webbadressen till aktuellt projekt. Det är tomt om inget projekt är laddat.
%pid: Ersätts med process-id för Quanta Plus-processen som kör. Om Quanta Plus kör i ensamt läge, inleds process-id numret med texten "unique". Användbart när du använder DCOP för att styra Quanta Plus från ett externt skript.
%userarguments: Användbart i fallet med händelser. Posten ersätts av händelsens egenskaper i följande ordning:
Skriptets unika identifikation
händelsenamnet
händelsens parameter, oftast det nuvarande dokumentets filnamn eller sökvägen till projektfilen.
Förutom ovanstående sätt kan skriptet ta emot indata från Quanta Plus via standardinmatningen. I kombinationsrutan Inmatning kan du välja vart standardinmatningen skickas. Alternativen är:
Ingen: Ingenting skickas till skriptet.
Aktuellt dokument: Hela dokumentet skickas till skriptet.
Markerad text: Det markerade området i dokumentet skickas till skriptet. Att använda variabeln %input är oftast bara vettigt när den här inställningen används.
På ett liknande sätt som för Inmatning kan du fånga utmatningen från programmet som körs. Det finns två sorters utmatning:
normal utmatning, som skrivs ut på standardutmatningen,
felmeddelanden, som skrivs ut på standardfelutmatningen.
Ingen: Utmatningen från programmet ignoreras.
Infoga på markörens plats: Utmatningen infogas i aktuellt dokument vid markörens position.
Ersätt markering: Det markerade området i dokumentet ersätts med utmatningen.
Ersätt markering: Det markerade området i dokumentet ersätts med utmatningen.
Skapa ett nytt dokument: Ett nytt dokument skapas som innehåller utmatningen från skriptet.
Ersätt aktuellt dokument: Hela dokumentet ersätts med utmatningen.
Meddelandefönster: Utmatningen visas i verktygsvyn Meddelanden.
Alternativen för standardfelutmatningen (Fel) är samma som för normal utmatning.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Det följande visar dig hur man skapar verktygsrader för en DTEP. Verktygsrader är grafiska element, som tilldelas åtgärder. I Quanta Plus är åtgärder grunden för nästan alla utökningar som Quanta Plus har, och kommer att få i framtiden. Quanta Plus erbjuder också automatisk komplettering och taggdialogrutor. Gränserna för vad du kan göra med åtgärder är nästan obegränsade. Som exempel, använder vi HTML Tidy på våra webbsidor.
Till att börja med, måste du skapa en användarverktygsrad. Välj ->.
Om det finns många taggar i språket, rekommenderas du att dela upp taggarna i logiska grupper. Du måste skapa en ny användarverktygsrad för varje grupp. I det här fallet finns det inte många, så vi skapar en verktygsrad och namnger den efter taggspråket.
Så snart alla verktygsrader har skapats, måste du lägga till och anpassa åtgärderna. För att göra det, välj ->.
Delarna i fönstret är ganska rättframma. Tryck på knappen längst ner i fönstret för att komma till redigeringsläge.
Fyll i alla nödvändiga fält, och lägg till taggen i lämpliga verktygsrader.
Komplettera resten, och om taggarna har egenskaper som du alltid tänker använda, markera rutan Kör dialogen för "Redigera tagg" om den finns, så att du blir tillfrågad varje gång åtgärden används.
Du bör nu ha något som liknar följande:
Tryck på knappen , så ser du att åtgärden har lagts till i verktygsraderna du har markerat.
Usch, då! Vilken hemsk ikon. Hur ska du själv och andra komma ihåg att den ikonen hör ihop med åtgärden. Låt oss ersätta den innan det uppstår problem.
För att skapa en ikon som bättre beskriver åtgärden, använder vi KIconEdit. Välj det i K-menyn, -> (eller var din distribution än har placerat det).
KIconEdit har standardstorleken 32 x 32 bildpunkter, men vi behöver 22 x 22. För att ändra det, välj ->.
Kom ihåg att du skapar en ikon som inte bara ska hjälpa dig själv att komma ihåg vilken åtgärd som gör vad, utan också andra användare av denna DTEP.
Eftersom taggen vi skapar ikonen till, kallas “start”, bestämmer vi oss för att skapa ett “start-tecken”. Genom att använda grön färg (grönt tolkas ofta som “kör”, “starta” eller “fortsätt”) förmedlar vi, eller borde vi åtminstone förmedla, användaren informationen att genom ett klick på åtgärden placeras taggen <start> i det aktuella dokumentet.
Nu när ikonen är färdigskapad, sparar vi den.
När vi är klara med att skapa ikoner, måste ikonen associeras med åtgärden. För att göra det, öppna fönstret -> igen (i Quanta Plus) och välj åtgärden som ikonen skapades för. Intill fältet Text, finns en knapp. Klicka på den.
Välj Övriga ikoner och klicka sedan på knappen .
Gå till katalogen där du sparade ikonen, välj den och klicka på .
Tryck på knappen , och fortsätt antingen att göra samma sak med övriga taggar, eller klicka på för att avsluta.
Antag att vi vill lägga till några vanliga Quanta Plus funktioner i verktygsraden, eller kanske skulle verktygsraden vara bättre om den organiserades på ett annat sätt, med några avskiljare för att gruppera åtgärderna. Öppna dialogrutan Anpassa verktygsrader genom att välja ->. Försäkra dig om att vår verktygsrad är vald.
Vi väljer avskiljaren (längst upp i vänsterkolumnen) för verktygsraden. När man väl har valt objektet som ska läggas till i verktygsraden, trycker man på högerpilen. Då läggs den till i verktygsraden.
Vi vill ha ett snabbt sätt att komma åt Visa med Konqueror. Välj den och lägg till i verktygsraden.
Observera hur avskiljaren hjälper med gruppering. Någon som inte sett vår verktygsrad tidigare, skulle kunna tro att knappen Konqueror liknade eller var motsatsen till start-knappen.
Verkställ dina ändringar, och tryck på när du är klar för att avsluta.
Titta på den fantastiska nya verktygsraden! Mycket bekvämare nu.
Kom ihåg att prova verktygsraden, genom att klicka på knapparna, så att du vet att utmatningen är riktig.
För att nu spara verktygsraden, väljer vi ->->.
Spara den i rätt katalog. Eftersom NeXML inte finns, lägger vi den bara i toppnivåkatalogen, men verktygsrader ska sparas i rätt katalog. Försäkra dig om att du justerar description.rc så att verktygsraderna laddas när en ny fil av typen skapas.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Troligen är de mest anmärkningsvärda tilläggen till Quanta Plus för den vanliga användaren, tillägg av dokumentation för de tagg- eller skriptspråk som är mest omtyckta. Med detta syfte, förklarar det här kapitlet hur jag skapar PHP-dokumentationsträdet för min egen användning.
Innan du börjar skapa din egen dokumentation, vill du kanske titta på Quanta Pluss arkiv för att se om någon redan har gjort den här uppsättningen.
Det finns två delar i processen. Först måste du skaffa befintlig dokumentation för taggspråket, skriptspråket eller något annat språk som du är ute efter. Därefter måste du skapa docrc-filen. Det första får du klara själv, det andra är vad vi täcker här.
Den allmänna formen för docrc-filen är följande:
#KDE konfigurationsfil
[Tree]
Doc dir=sökväg, relativt denna filen, till dokumentationens HTML-filer t.ex. php42/
#toppnivåelement
Top Element=Din beskrivning av de här dokumenten 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 är uppdelad i två avdelningar: Tree (träd) och Context (Sammanhang).
Avdelningen Tree definierar presentationsaspekter för dokumentet under dokumentationsfliken. Du ser till exempel att i PHP-dokumentationen, har du något som liknar det här:
Med referens till ovanstående, ser min PHP docrc ut så här:
#KDE konfigurationsfil [Tree] Doc dir=php42/ #toppnivåelement Top Element=PHP 4.2 dokumentation PHP 4.2 dokumentation=Innehållsförteckning,#Komma igång,#Språkreferens Innehållsförteckning=index.html Komma igång=Inledning, ... Inledning=introduction.html ... Språkreferens=Grundläggande syntax, ... Grundläggande syntax=language.basic-syntax.html ...
Observera # framför “Komma igång” och “Språkreferens”. Det anger att de är delinnehåll i trädet och har eget innehåll. Jag tror inte det finns en angiven gräns för djupet här (utom det som dikteras av sunt förnuft) - använd din egen bedömning.
För innehållsförteckningen, ser du att den direkt refererar till en fil (och som en konsekvens, visas den längst ner i trädvyn, kataloger kommer först).
Mellanslag påverkar ingenting negativt, men se upp med tecknen & och <. Dessa ska troligen ersättas med & och < i alla Quanta Plus XML-baserade resursfiler.
Sammanhangsavsnittet är avsnittet i docrc-filen som används för att möjliggöra sammanhangsberoende hjälp. Om du till exempel skriver ett PHP-skript och vill se dokumentationen för funktionen mysql_fetch_array, markerar du helt enkelt funktionen och trycker sedan Ctrl+H för sammanhangsberoende hjälp. Dokumentationen om mysql_fetch_array visas omedelbart. Det finns bara två typer av poster här: sammanhangslistan och filassociationsraderna.
Mycket enkel. Det här är bara en lista av sammanhangsposter åtskilda med kommatecken, som du vill ha tillgängliga (för PHP är det funktionerna i PHP).
De är på formen sammanhangspost = HTML-dokumentsida. T.ex. acos=function.acos.html.
En rensad version av mitt docrc sammanhangsavsnitt ser ut som följer:
#Nyckelord för sammanhangsberoende 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 kan du bara spara din docrc-fil. Spara den i $ eller HOME/.kde/share/apps/quanta/doc$ för lokal eller global användning. Skapa sedan en katalog (den som anges i KDEDIR/share/apps/quanta/docdocrc-filen) i samma katalog som docrc-filen finns, och kopiera HTML-sidorna dit.
Du måste starta om Quanta Plus, och då ser du dina egna dokument.
När du väl är säker på att de är bra, och värda att dela, skicka docrc-filen tillsammans med en beskrivning av passande information om vilka dokument du använde till Quanta Pluss arkiv för användning av Quanta Pluss gemenskap. Du blir inte rik, men du känner dig nöjd med vetskap om att du bidragit till den bästa webbutvecklingsmiljön som finns.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Du är inte ensam med Quanta Plus. Det är möjligt att dela olika resurser (DTEP-paket, verktygsrader med åtgärder, skript, mallar) med andra. Det finns två sätt att göra det:
Resurser kan skickas med e-post till vänner, kollegor eller till vem du vill. Du ser menyalternativet Skicka med e-post på olika ställen, som ->, ->, och i den sammanhangsberoende menyn för filer och kataloger i träden Mallar och Skript.
Resurser kan laddas upp till vårt huvudarkiv, där alla andra användare av Quanta Plus kan ladda ner dem. Bidragen granskas och görs bara tillgängliga om vår grupp anser dem riktiga och användbara. För att skapa ett giltigt bidrag, föreslår vi att du signerar resursen. Därför behöver du en GPG/PGP-nyckel. Informationen används för att verifiera resursens ursprung, både av vår grupp och av de som laddar ner den.
Om hur resurser hämtas från huvudservern, se “Hämta resurser”.
När du laddar upp blir du tillfrågad om att ange lösenordsfrasen för din hemliga GPG-nyckel (lösenordsfrasen lagras inte), och i fallet med flera hemliga nycklar, kommer du att kunna välja den du vill använda. Fyll i indatafälten i dialogrutan Dela heta nyheter (Webbadress för förhandsgranskning kan få förbli tom) och starta uppladdningen genom att klicka på Ok.
Uppladdningen kan startas från ->, ->, och i den sammanhangsberoende menyn för filer och kataloger i träden Mallar och Skript.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Det är möjligt att uppgradera Quanta Plus utan att skaffa en ny version, genom att hämta nya resurser som DTEP-paket, verktygsrader med åtgärder, mallar, skript och dokumentation. En möjlighet är att du fick resurser med e-post, eller har laddad ner dem från en webbserver. Då måste du oftast installera dem för hand. Om du har tur får du också ett installationsskript när du laddar ner resursen. Men Quanta Plus har en dedicerad server som lagrar resurser som antingen inte finns med i huvuddistributionen på grund av deras storlek eller att de sällan används, eller var senare bidrag av användare. Dessa resurser installeras automatiskt. Ladda ner sådana resurser i de olika menyalternativen Ladda ner. Du hittar dem under ->, ->, och i den sammanhangsberoende menyn i ett tomt område eller topnivåobjekt i träden Mallar, Skript och Dokumentation.
Efter en resurs har laddats ner, men innan den installeras, verifierar Quanta Plus om resursen är giltig genom att kontrollera integriteten och signaturen. I händelse av problem varnas du, och kan bestämma om du vill fortsätta eller inte. Läs varningsdialogrutorna noggrant. Om integriteten är riktig och resursen är rätt signerad, visas ändå en informationsdialogruta så att du kan se vem som skapade resursen.
Försäkra dig om att du bara installerar resurser från pålitliga källor, särskilt verktygsrader och skript!
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Det är möjligt att arbeta med XML-språk som för närvarande inte stöds av Quanta Plus genom att skapa ett DTEP-paket. Men det kan ta tid att skapa den, eftersom du kan behöva skriva hundratals taggfiler med tagXML-format. Det finns förstås ett trevligare sätt att göra det på, genom att automatiskt konvertera en DTD till ett DTEP-paket.
Konverteringen kan startas från menyn ->. Välj .dtd-filen som definierar den DTD du vill använda, och därefter visas följande dialogruta:
Posterna är:
Målkatalognamn: Den nyskapade DTEP kommer att få detta namn i katalogen $. KDEHOME/share/apps/quanta/dtep
Namn: Namnet (definitionssträngen) på DTD:n
Smeknamn: Namnet på en DTEP synligt för användaren
!DOCTYPE-definitionsrad: Strängen som ska finnas i taggen !DOCTYPE, som HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"
DTD-webbadress: Webbadressen som pekar på DTD-filen
Standardändelse: Filändelsen som oftast används för filer som skrevs med denna DTD
Skiftlägeskänsliga taggar och egenskaper: Självförklarande. Oftast sant för XML-språksvarianter
Finjustera DTEP efter konvertering: Om markerad, öppnar Quanta Plus editorn för description.rc när konverteringen är klar, så att du kan finjustera din nyskapade DTEP. Det rekommenderas att alternativet lämnas markerat.
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
Ursäkter till de jag missat, och om jag stavat fel till något namn.
Många tack till alla som har tagit sig tid att bidra!
Quanta Plus-utvecklingsgrupp:
Ursprunglig CSS-editor.
Kommander, diverse funktioner och felrättningar.
Startskärm för många utgåvor
Sidlayoutmodul och nytt ångra/gör om-system
PHP4-felsökare
Ramguide
Diverse rättningar, grundläggande kod för DTD-tolkning och annat DTD-relaterat arbete
Dansk översättning
Pedantisk XML-figur och dokumentation
XSL 1.0 DTEP, KXsldbg
Dokumentation, felrättningar och ramverk för PHP-felsökare.
Projekthanterare och webbplatsadministratör
Huvudsaklig utvecklare
Kodning, ursprungliga TagXML-dokument, med mera
Dokumentation
Dokumentation
Tillägg och underhåll av DTD:er
Före detta huvudutvecklare — flyttade till kommersiell version
Trädbaserad uppladdningsdialogruta
Före detta huvudutvecklare — flyttade till kommersiell version
Särskilt tack till:
Upphovsmännen till libxml2 och libxslt.
Quanta Plus © 2000, 2001, 2002, 2003 Quanta Plus-utvecklingsgruppen.
Quanta Plus handbok © 2002, 2003 Quanta Plus-utvecklingsgrupp.
Den här dokumentationen licensieras under villkoren i GNU Free Documentation License.
Det här programmet licensieras under villkoren 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
Innehållsförteckning
detta program är en del av KDE-projektet http://www.kde.org/.
detta program finns i kdewebdev-paketet på ftp://ftp.kde.org/pub/kde/, KDE-projektets huvudsakliga FTP-plats.
För att kompilera och installera detta program på ditt system, skriv följande i baskatalogen för distributionen av detta program:
%./configure%make%make install
Eftersom detta program använder autoconf och automake bör du inte ha några problem med att kompilera det. Skulle du stöta på problem, var snäll rapportera dem till KDE:s e-postlistor.
Det är troligt att du vill anpassa platsen för Quanta Pluss filer på systemet. För att göra detta, har autoconf ett antal alternativ som kan skickas till configure-skriptet för att styra inställningen. För att få en fullständig lista av dessa alternativ, skriv ./configure --help. De är rättframma och täcks inte här.
Om du har problem med att få Quanta Plus att köra som det ska, bör du kontrollera din sökväg för att försäkra dig om att katalogen bin för KDE 3 finns med. Försäkra dig också om att du inte har några äldre versioner av KDE kvar, som finns i PATH innan katalogen bin för KDE 3. Samma sak gäller för 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
Ett giltigt uttryck som definierar vilken data som krävs. Se W3C®:s hemsida.
Ett fullständigt kvalificerat namn, till exempel xsl:min_variabel. Se W3C®:s hemsida.
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