<chapter id="using-quanta">
<title
>Använda &quanta;</title>

<sect1 id="intro">
<title
>Inledning</title>
<para
>Under försöken att bli den bästa HTML-editorn, så började utvecklarna av &quanta; fundera på en rätt fascinerande idé. <quote
>Varför inte göra &quanta; till en generell, utökningsbar, editor för taggbaserade språk?</quote
></para>
<para
>Ja, här är början till svaret på den frågan. &quanta; är inte längre begränsad till HTML, utan är på god väg att bli DTD-oberoende. Egentligen ska &quanta; kunna fungera som grafiskt gränssnitt, om du kan definiera något med XML eller SGML.</para>
<para
>Med detta sagt, måste det observeras att &quanta; är en utväxt av de enastående ansträngningar som har gjorts av hela KDE-gruppens utvecklingsgemenskap. &quanta; lovprisar öppen källkod, med modellen <quote
>Varför skriva om något som någon annan redan gjort och utvecklar?</quote
></para>
<para
>&quanta; tillhandahåller webbutvecklare med ett intuitivt och användbart multipelt dokumentgränssnitt som dramatiskt kan öka effektiviteten hos webbutvecklare. Genom användning av egna åtgärder, skript och verktygsrader kan man automatisera nästan vilken uppgift som helst. Genom att använda <application
>Kaptain</application
> kan man utöka &quanta; så att man aldrig behöver komma ihåg skriptkommandosyntax igen. (Mer om detta i avsnittet <link linkend="advanced-quanta"
>Avancerade funktioner</link
>.)</para>
<sect2 id="quanta-workspaces">
<title
>&quanta;s arbetsområde</title>
<para
>&quanta; delar upp arbetsområdets filer i tre delar: global, lokal och projekt. Dessa uppdelningar påverkar området eller synligheten av de olika komponenterna i &quanta;s gränssnitt.</para>
<variablelist
> <varlistentry
> <term
>Global</term
> <listitem
><para
>Globala objekt är tillgängliga för alla som använder &quanta;. Från verktygsrader till åtgärder, allting som markeras som globalt lagras i &quanta;s gemensamma katalogstruktur. Det ger effekten att en grupp administratörer kan spara vissa verktygsrader, åtgärder och mallar i det globala trädet, som sedan kan användas för att hålla en installation för flera användare av &quanta; gemensam för alla i systemet.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Lokal</term
> <listitem
><para
>Lokala objekt är objekt som tillhör enskilda användares samling resurser. De lagras i den enskilda användarens hemkatalogträd, som en del av KDE:s miljöinformation. Det här visar alla objekt som lagras som lokala för all redigering som den enskilda användaren vill arbeta med. Det tillåter att de mest användbara mallarna och verktygsraderna sparas i hemkatalogen och används för alla dokument.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Projekt</term
> <listitem
><para
>Projektobjekt är de objekt som bara är användbara för ett visst projekt. De kan vara allt från en CSS-mall till en verktygsrad med egna åtgärder som utför ett särskilt magiskt trick med projektets filer. Med enkla ord, är detta den mest begränsade användningen. Alla objekt som sparas i projektets arbetsområde, sparas i projektets katalogträd.</para
></listitem
> </varlistentry
> </variablelist>
</sect2>
</sect1>

<sect1 id="mdi-interface">
<title
>&quanta;s multipla dokumentgränssnitt</title>
<screenshot
> <screeninfo
>&quanta; som redigerar det här dokumentet!</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="quantamdi.png" format="PNG" /> </imageobject
> <caption
><para
>&quanta;s multipla dokumentgränssnitt vid redigering av det här dokumentet</para
></caption
> </mediaobject
> </screenshot>
<para
>&quanta;s multipla dokumentgränssnitt är uppdelat i tre huvuddelar: <link linkend="editor"
>redigeringsfönstret</link
>, <link linkend="tree-views"
>trädvyfönstret</link
> och <link linkend="toolbars"
>verktygsraderna</link
>.</para>
</sect1>

<sect1 id="editor">
<title
>&quanta;s redigeringsfönster</title>
<para
> <screenshot
> <screeninfo
>Inzoomning av redigeringsfönstret</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="quantamdi-editor.png" format="PNG" /> </imageobject
> <caption
><para
>&quanta;s redigeringsfönster</para
></caption
> </mediaobject
> </screenshot
> &quanta;s redigeringsfönster tillåter att flera filer är öppna samtidigt. När bara en fil är öppen, så fyller dokumentet hela redigeringsfönstret. Så fort ett annat dokument öppnas, används lite utrymme längst ner i redigeringsfönstret för att visa flikar med filnamn och statusikoner (den här bilden visar det inte, men det finns en blå diskettikon som visas till vänster om filnamnet när en fil har ändrats, som anger att det måste sparas).</para>
<para
> Längst upp i redigeringsfönstret finns en uppsättning redigeringsverktygsrader. För närvarande har &quanta; en standarduppsättning med verktygsrader som laddas. De är Standard, Teckensnitt, Tabeller, Listor, Formulär och Övriga. Detta är originalverktygsraderna som har varit en del av &quanta; under lång tid nu. Verktygsraderna är enbart för HTML, och kommer att fortsätta vara en del av &quanta;, men kommer slutligen att laddas på begäran och inte som standard. </para>

<para
> Användning av verktygsrader är ganska rättframt. Om du letar efter en grundläggande tagg (som &lt;u&gt;), klickar du på taggen så infogas den i dokumentet. Därefter lägger du till informationen mellan taggarna (om det finns en avslutande tagg), och allt är bra. Om du tänker infoga något som kräver mer information än bara text (som &lt;a href...&gt;) visas en dialogruta med olika fält som du kan fylla i. <screenshot
> <screeninfo
>En dialogruta för att skapa ett HTML-ankare</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="taginputex.png" format="PNG" /> </imageobject
> <caption
><para
>Dialogruta från HTML-verktygsraden för ankare</para
></caption
> </mediaobject
> </screenshot
> </para>
</sect1>

<sect1 id="tree-views">
<title
>&quanta;s trädvyfönster</title>
<mediaobject
> <imageobject
> <imagedata fileref="quantamdi-treeview.png" format="PNG" /> </imageobject
> <caption
><para
>&quanta;s trädvyfönster</para
></caption
> </mediaobject>

<para
>Trädvyn är stället där man navigerar och samlar information i &quanta;. Formatet med flikar visar träd med filer, projekt, mallar, dokumentstruktur och dokumentation. </para>

<variablelist id="treeview-icon-defs"
> <title
>Flikar i trädvyn</title
> <varlistentry
> <term
></term
> <listitem
><para
><mediaobject
> <imageobject
> <imagedata fileref="ftab.png" format="PNG" /> </imageobject
> </mediaobject
><emphasis
>Filträd:</emphasis
> Här kan du bläddra i hela filsystemet på trädformat. Du ser två perspektiv av filsystemet. Den första är börjar i din hemkatalog, och den andra i filsystemets rot. Använd detta för att hitta befintliga filer på datorn som du vill redigera eller lägga till i ett aktivt projekt. Ett högerklick på en fil i den här vyn, ger dig flera alternativ för att hantera den markerade filen och låter dig också infoga filen i det aktiva projektet (om det finns något), eller byta vy mellan träd och lista. Ta en titt!</para
></listitem
> </varlistentry
> <varlistentry
> <term
></term
> <listitem
><para
><mediaobject
> <imageobject
> <imagedata fileref="ptab.png" format="PNG" /> </imageobject
> </mediaobject
> <emphasis
>Projektträd:</emphasis
> Om du använder &quanta;, använder du förhoppningsvis projekt. <link linkend="quanta-projects"
>Projekthantering</link
> är det enskilt mest användbara verktyget som &quanta; erbjuder. Den här vyn ger dig direkt åtkomst till den strukturen, och låter dig hantera filerna i projektet med åtkomst via högerklick. Lägg till, ta bort eller ladda upp enskilda filer eller ta bort dem helt och hållet från disk. Allt med ett högerklick på musen.</para
></listitem
> </varlistentry
> <varlistentry
> <term
> </term
> <listitem
><para
> <mediaobject
> <imageobject
> <imagedata fileref="ttab.png" format="PNG" /> </imageobject
> </mediaobject
> <emphasis
>Mallträdet:</emphasis
> En av de nya funktionerna i &quanta; 3 är mallar. Mallarna kan vara vad som helst som du vill, från bilder till kodfragment eller en hel webbsida som du byter rubriker i. Mallar sorteras i tre kategorier baserat på område, eller synlighet, i aktuell omgivning. De är global, lokal och projekt. Som du kanske gissar, är globala mallar alltid synliga. Lokala mallar är synliga för användaren som skapat dem, och projektmallar är bara synliga för ett enda projekt. Mer om mallar <link linkend="templates"
>här</link
>. </para
></listitem
> </varlistentry
> <varlistentry
> <term
> </term
><listitem
><para
> <mediaobject
> <imageobject
> <imagedata fileref="view_sidetree.png" format="PNG" /> </imageobject
> </mediaobject
> <emphasis
>Strukturträd:</emphasis
> Den här bekväma lilla vyn ger dig en bild av hur tolken ser ditt dokument. Det är ganska rättframt och kan verkligen hjälpa till med de besvärliga avslutande taggarna, som vi alltid verkar glömma bort. </para
></listitem
> </varlistentry
> <varlistentry
> <term
> </term
><listitem
><para
> <mediaobject
> <imageobject
> <imagedata fileref="contents2.png" format="PNG" /> </imageobject
> </mediaobject
> <emphasis
>Dokumentationsträd:</emphasis
> Här visas all dokumentation som är tillgänglig för att bläddra i inne i &quanta;. Du kan ladda ner färdigförpackade dokument för &quanta; på <ulink url="http://quanta.sourceforge.net/docs.html"
>http://quanta.sourceforge.net/docs.html</ulink
> eller du kan <link linkend="creating-quanta-docs"
>skapa egen dokumentation</link
> för &quanta;.</para
></listitem
> </varlistentry
> </variablelist>

</sect1>

<sect1 id="toolbars">
<title
>&quanta;s verktygsrader</title>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="toolbars.png" format="PNG" />
</imageobject>
</mediaobject>
</screenshot>
<para
>En stor del av &quanta;s försök att bli DTD-oberoende beror på hur lättanvänd varje enskild DTD är. För att uppnå detta, har &quanta;s verktygsrader utökats en hel del. Verktygsrader är enkla nog att förstå. Du klickar på knappen och får motsvarande åtgärd utförd. Den riktigt häftiga delen här, är att du kan definiera dina egna åtgärder i &quanta;.</para>
<para
>Att använda verktygsrader i &quanta; är otroligt enkelt. Väljs menyalternativet <menuchoice
><shortcut
><keycombo action="simul"
>&Alt;<keycap
>l</keycap
></keycombo
></shortcut
> <guimenu
>Verktygsrader</guimenu
></menuchoice
>, visas alternativ för att ladda, spara, lägga till och e-posta verktygsrader.</para>
<para
>Att ladda och spara verktygsrader är ganska rättframt. När du väljer att ladda en verktygsrad, kan du välja från en av de tre <link linkend="quanta-workspaces"
>arbetsområdena</link
> i &quanta;. </para>
<para
>En av de mest spännande nya funktionerna för &quanta;s verktygsrader är att du kan e-posta dem direkt från &quanta;. När du gör det, samlar &quanta; ihop alla åtgärderna och verktygsradsinformationen i ett komprimerat tar-arkiv, och skickar sedan ut det med &kmail;. När du tar emot en verktygsrad med e-post, kan du spara den var du vill och ladda in den i &quanta;, som vilken annan verktygsrad som helst.</para>
<sect2 id="toolbars-howto">
<title
>Hur verktygsrader används i &quanta;</title>
<para
> Som tidigare nämnts, hanteras verktygsrader i &quanta; i huvudsak med menyn <menuchoice
><guimenu
>Verktygsrader</guimenu
></menuchoice
>. Att använda och skapa dem skiljer sig något åt. Att skapa dem skjuts upp till senare, eftersom mer är inblandat här. Användning beskrivs här.</para>
<para
>Att använda verktygsrader är mycket enkelt. Man klickar på ikonen för önskad tagg, och en av tre möjliga saker händer: taggen infogas (eventuellt med en avslutande tagg, t.ex. HTML-taggen för fetstil), en taggdialogruta visas där man kan fylla i flera taggfunktioner (t.ex. HTML-taggen ankare), och slutligen en åtgärd aktiveras som gör något smart med aktuell fil, projekt eller vad som helst. Inget exempel visas för det första fallet, eftersom det är lätt nog att förstå. För det andra och tredje, läs vidare ...</para>
<para
>Taggdialogrutor definieras med XML, och lagras i underkatalogen tags under .kde, eller med &quanta;s utgåva, var du nu lagrat den. Detta nämns bara för att observera att om du märker att du enformigt och upprepat skriver in en viss tagg som inte finns i &quanta;, kan du lägga till den. Hur som helst, ser en taggdialogruta precis ut så här:</para>
<screenshot>
<mediaobject>
<imageobject>
<imagedata fileref="taginputex.png" format="PNG" />
</imageobject>
</mediaobject>
</screenshot>
<para
> Det här råkar vara en ankartagg som refereras till ovanför. Om du vet något om HTML, märker du att det är i stort sett alla egenskaper som finns för ett ankare. Observera flikarna ovanför för i18n och händelser. Allt du gör nu är att fylla i tomrummen för objekten du vill ha i ankaret, klicka på Ok, och, voila!, du har ett riktigt sammansatt ankare tillagt på markörens nuvarande plats.</para>
<para
>När det gäller skriptåtgärder, om du skapar två filer i din hemkatalog med följande innehåll, får du en trevlig överraskning.</para>
<para
><emphasis
>dt.actions</emphasis
> <informalexample
> <screen>
&lt;!DOCTYPE actionsconfig>
&lt;actions>
&lt;action icon=<quote
>mini-book1.png</quote
> type=<quote
>script</quote
> name=<quote
>usr_1</quote
> \
	text=<quote
>Shell</quote
> 
> &lt;script output=<quote
>message</quote
> error=<quote
>message</quote
> \
	input=<quote
>none</quote
> 
>xterm&lt;/script>
&lt;/action>
&lt;/actions>
</screen
> </informalexample
> </para>
<para
><emphasis
>dt.toolbar</emphasis
> <informalexample
> <screen>
&lt;!DOCTYPE kpartgui SYSTEM "kpartgui.dtd">
&lt;kpartgui name="quanta" version="2">
  &lt;ToolBar tabname="MinVerktygsrad" name="dt" >
   &lt;text
>MinVerktygsrad&lt;/text>
   &lt;Action name="usr_1" />
  &lt;/Toolbar>
&lt;/kpartgui>
</screen
> </informalexample
> Klicka nu på <menuchoice
><guimenu
>Verktygsrader</guimenu
> <guimenuitem
>Ladda verktygsrader</guimenuitem
> <guimenuitem
>Ladda lokal verktygsrad</guimenuitem
> </menuchoice
>, bläddra till filen dt.toolbar i din hemkatalog (kom ihåg att ändra filfiltret till * från *.toolbar.gz) och åtgärden som du skapade är nu laddad i en verktygsrad som heter MinVerktygsrad, till höger om de andra. Genom att klicka på åtgärden i verktygsraden, dyker ett xterm fönster upp. </para>
</sect2>
</sect1>

&quanta-menus;
&quanta-projects;

<sect1 id="templates">
<title
>&quanta;s mallar</title>
<para
> Mallar är i grunden dokumentskelett, kodfragment och filer som ska länkas till. &quanta; använder primärt mallar som ett vanligt filsystem med utökad organisation och gränssnitt. Du kan kopiera, flytta och länka alla förråd som finns i systemet till mallträdet. Tänk på Quantas mallar som om de har ungefär samma begränsningar som filsystemet har. </para>
<para
> Mallar finns i en katalogstruktur. Det finns ingen begränsning hur djupt du kan lagra dem, men i en given katalog förväntar sig Quanta en konsekvent åtgärd för basmalltypen som beskrivs nedan. Ytterligare mallar tillåter för- och eftertext att läggas till i mallar som inte är av dokumenttyp. Detta underlättar skapande av taggar. Nästa uppdatering efter de har lagts till är planerad att lägga till möjligheten att skicka variabler till texten, som information om bildstorlek för att hjälpa till att skapa taggar. </para>
<para
>Vårt mål med mallar är att utöka dem så att de omfattar mallar med flera filer för "koncept", som är användbara för saker som att lägga en beställning eller skapa ett beskrivande avsnitt. Idealt blir detta ett verktyg för att göra arbetet produktivare och dynamiskt. Ett möjligt mål är att ha ett strukturerat mallkonstruktionsläge för att hantera layout och struktur för en plats, som du kan använda för att konstruera och interaktivt uppdatera en plats. Om du vill vara med, titta på vår sida <ulink url="http://quanta.sourceforge.net/main1.php?contfile=needs"
>Hjälp behövs</ulink
>.</para>
<para
><important
><para
>Vissa mallar som levereras med &quanta; har villkor för sin användning. Läs villkoren i användningsanvisningarna överst i varje mall innan du använder den.</para
></important
></para>

<sect2 id="template-types">
<title
>Malltyper</title>
<para
> För närvarande är mallar begränsade till någon av följande objekttyper: <simplelist
> <member
>Dokument</member
> <member
>Text att infoga i ett dokument</member
> <member
>En fil att länka till för att skapa ett dokument</member
> </simplelist
> </para>
<para
> Dokument kan vara av vilken typ som helst. I allmänhet vill du lägga mer specifika eller olika dokument i underkataloger. Här kan du skapa ett grundläggande stomme för det du gör, och tillhandahålla den för arbetet på ett organiserat sätt och uppnå mycket högre effektivitet. Tillägg av text kan vara vad som helst, från ett kodfragment till ett skript, eller vad som helst som du vill använda. Det här går ihop med möjligheten att infoga textblock med en åtgärd, som kan startas från en verktygsrad. Länkade filer kan vara binära, PHP-klassbibliotek eller vad som helst. </para>
</sect2>
<sect2 id="template-scope">
<title
>Synlighet för mallar</title>
<para
>Mallar kan kommas åt baserat på deras angivna <link linkend="quanta-workspaces"
>arbetsområde</link
> i &quanta;.</para>
</sect2>

<sect2 id="creating-templates">
<title
>Skapa mallar</title>
<para
>Skapa en dokumentstruktur som du tycker bra om (XML, HTML, DocBook, etc) och klicka på <menuchoice
><guimenu
>Arkiv</guimenu
> <guimenuitem
>Spara som mall</guimenuitem
> <guimenuitem
>Spara som lokal/projektmall</guimenuitem
></menuchoice
>.</para>
<para
>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.</para>
<para
>Om du dessutom tittar på alternativen 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.</para>
</sect2>
<sect2 id="using-templates-with-projects">
<title
>Använda mallar tillsammans med projekt</title>
<para
>Projektmallar låter dig bli hårdare fokuserad. Du kan skapa sidhuvud, sidfot, eller använda dynamiskt innehåll med infogade PHP-filer och länkar till dem. Dessutom finns det en del häftiga saker som vi tog hänsyn till när mallar används i projekt.</para>
<para
>När ett projekt skapas, kan du välja att kopiera alla globala och användarmallar. Tidigare projekt får möjligheterna i standardmallar, så ingenting går förlorat. Du kan välja var mallfiler ska placeras, så att de kan finnas i serverns rotkatalog och blir lätta att ladda upp, eller kan de göras säkra genom att länka nedanför serverns rotkatalog, vilket är ett häftigt trick. När du länkar till en fil som inte finns i projektmallen, blir du tillfrågad om att kopiera filen till projektmallen innan du länkar. Det här förhindrar felaktiga länkar vid uppladdning. Du kan alltid styra var du placerar mallarna, så du kan välja att flytta dem. Quanta följer dock inte detta, så du måste ändra länkarna. Detta är en bra uppgift för kfilereplace, som vi förbereder för att kunna lägga till som ett insticksprogram.</para>
</sect2>
<sect2 id="managing-templates">
<title
>Hantera mallbeteende</title>
<para
>Mallstrukturen under <link linkend="treeview-icon-defs"
>mallfliken</link
> är baserad på filer som hittas i <filename class="directory"
>$<envar
>KDEDIR</envar
>/share/apps/quanta/templates</filename
> och <filename class="directory"
>$<envar
>HOME</envar
>/.kde/share/apps/quanta/templates</filename
>. Var och en av dessa kataloger anges med ett av tre olika typer av innehåll:</para>
<variablelist
> <varlistentry
> <term
>files/all</term
> <listitem
><para
>binärfiler och sådant som infogas med webbadress (dvs. bilder som &lt;img src=/källa/webbadress
>)</para
></listitem
> </varlistentry
> <varlistentry
> <term
>text/all</term
> <listitem
><para
>text som du kan infoga i det nuvarande Quanta-dokumentet, saker som upprepade block, etc.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>template/all</term
> <listitem
><para
>dokumentmallar som du kan använda för att skapa nya dokument. De här öppnar ett nytt fönster i Quanta.</para
></listitem
> </varlistentry
> </variablelist>
<para
>För att ställa in beteendet hos varje katalog, högerklicka på katalogen i mallvyn och välj Egenskaper. Följande dialogruta visas: <screenshot
> <mediaobject
> <imageobject
> <imagedata fileref="template-rmb.png" format="PNG" /> </imageobject
> </mediaobject
> </screenshot
> <variablelist
> <varlistentry
> <term
>Typ</term
> <listitem
><para
>Kombinationsruta med de tre typerna som beskrivs tidigare: filer, text mallar. Den här rutan är grå om du har markerat rutan Ärv egenskap.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Ärv egenskap (&lt;något
>)</term
> <listitem
><para
>Det här är normalt markerat, och är bra för allt utom toppnivåkataloger i mallträdet. Om toppnivåkatalogen har det markerat, inaktiveras mallar i stort sett för den katalogen, och alla som inte uttryckligen ställs in under den. Om detta inte är en toppnivåkatalog, så har &lt;något
> fått ett värde som text/all. Om ingenting anges, är det troligt att du befinner dig i en toppnivåkatalog.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Använd för/eftertext</term
> <listitem
><para
>Aktiverar för- och eftertext för mallar i den här katalogen. Detta kan vara ett gemensamt sidhuvud/sidfot för alla mallar i ett givet projekt och därefter kopierar du in innehållsmallar till katalogen och har en fullständig sida med eget sidhuvud/sidfot som utgångspunkt. </para
></listitem
> </varlistentry
> <varlistentry
> <term
>Förtext</term
> <listitem
><para
>Själva texten som infogas före mallens innehåll.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Eftertext</term
> <listitem
><para
>Själva texten som infogas efter mallens innehåll.</para
></listitem
> </varlistentry
> </variablelist
> </para>
</sect2>
</sect1>
</chapter>

