<chapter id="advanced-quanta">
<title
>Avancerade funktioner i &quanta;</title>
<para
>Det här kapitlet ger en översikt av de avancerade funktionerna i &quanta;.</para>

<sect1 id="kommander">
<title
>Använda <application
>Kommander</application
> med &quanta;</title>
<para
>Kommander av Marc Britton.</para>
</sect1>

&debugging-quanta;

<sect1 id="tag-files">
<title
>&quanta; taggfiler</title>
<para
>&quanta; använder taggfiler för att definiera de olika åtgärder som är tillgängliga för att associera med verktygsrader. Taggfilerna kan definiera en enkel tagg utan egenskaper, eller en taggdialogruta som kommer ihåg alla tillgängliga egenskaper åt dig, så att du helt enkelt kan fylla i tomrummen.</para>
<important
> <para
>Mellanslag påverkar ingenting negativt, men se upp med tecknen &amp; och &lt;. Dessa ska troligen ersättas med &amp;amp; och &amp;lt; i alla &quanta;s XML-baserade resursfiler. Detta orsakar ingen krasch, men delar av ditt arbete försvinner, om du glömmer det.</para
> </important>
<sect2 id="tag-file-structure">
<title
>Taggfilstruktur</title>
<sect3>
<title
></title>
<para
>Möjliga värden på typegenskapen för taggen attr: För att få en lista över möjliga typer, gjorde jag följande i taggkatalogerna: grep -h type= *.tag |sed -e 's/^.*type=\"\([a-z]*\).*/\1/'| sort |uniq</para>
<para
>Detta är typerna för objekt i taggdialogrutor: <simplelist
><member
>check</member
> <member
>color</member
> <member
>input</member
> <member
>list</member
> <member
>text</member
> <member
>url</member
> </simplelist
> </para>
<para
> Detta är argumenttyper inne i PHP-funktionstaggar, fråga Andras om de i stort sett har fri form, och de föregående är nyckelord: <simplelist
> <member
>array</member
> <member
>bool</member
> <member
>boolean</member
> <member
>char</member
> <member
>constant</member
> <member
>flags</member
> <member
>float</member
> <member
>function</member
> <member
>int</member
> <member
>long</member
> <member
>mixed</member
> <member
>number</member
> <member
>object</member
> <member
>resource</member
> <member
>resource</member
> <member
>string</member
> </simplelist
> </para>
<para
>Taggdefinitionerna har följande ytterligare egenskaper: <variablelist
> <varlistentry
> <term
>hasScript</term
> <listitem
><para
>"1" om vanliga händelser/skript kan höra ihop med den här taggen (onclick, etc.)</para
></listitem
> </varlistentry
> <varlistentry
> <term
>hasCore</term
> <listitem
><para
>"1" om vanliga kärnegenskaper finns (id, class, etc.)</para
></listitem
> </varlistentry
> <varlistentry
> <term
>hasI18n</term
> <listitem
><para
>"1" om vanliga i18n-egenskaper finns (lang, dir)</para
></listitem
> </varlistentry
> <varlistentry
> <term
>single </term
> <listitem
><para
>"1" om detta är en ensam tagg (t.ex. &lt;hr
>)</para
></listitem
> </varlistentry
> <varlistentry
> <term
>optional </term
> <listitem
><para
>"1" om detta är en valfri tagg (t.ex. &lt;colgroup
>)</para
></listitem
> </varlistentry
> <varlistentry
> <term
>returnType</term
> <listitem
><para
>för skriptspråk, funktionens returtyp om det finns någon (t.ex. int)</para
></listitem
> </varlistentry
> </variablelist
> </para>

<para
> Definitionen av &lt;attr
> kan ha följande egenskaper: <variablelist
> <varlistentry
> <term
>defaultValue</term
><listitem
><para
>taggens standardvärde???</para
></listitem
> </varlistentry
> <varlistentry
> <term
>status</term
> <listitem
><para
>kan vara <quote
>optional</quote
> (valfri), <quote
>required</quote
> (krävs), <quote
>implied</quote
> (underförstådd)</para
></listitem
> </varlistentry
> </variablelist
> </para>
</sect3>
<sect3>
<sect3info>
<author
> <firstname
></firstname
> <surname
></surname
> </author>
</sect3info>
<title
></title>
<para
> För funktioner i skriptspråk, definiera taggfilen så här: <informalexample
> <literallayout>
&lt;!DOCTYPE tags>
&lt;tags>

&lt;tag name=<quote
>[funktionsnamn]</quote
> type=<quote
>function</quote
> returnType=<quote
>[returtyp]</quote
>>
  &lt;attr name=<quote
>[argument1]></quote
> type=<quote
>[argument1-typ]</quote
>
>&lt;/attr>
  &lt;attr name=<quote
>[argument2]</quote
> type=<quote
>[argument2-typ]</quote
> status=<quote
>optional</quote
>
>&lt;/attr>
    ...
&lt;/tag>
&lt;tag ...
...
&lt;/tag>
 ...
&lt;/tags>
</literallayout
> </informalexample
> </para>
<para
> Objekt inom [] ska ersättas. Det första argumentet, argument1, krävs och det andra, argument2, är valfritt. </para>
<para
> En taggfil som du vill kunna använda för redigering i en taggdialogruta, ska se ut så här: <informalexample
> <programlisting>
<markup>
&lt;!DOCTYPE tags>
&lt;tags>
  &lt;tag name="[namn] [hasCore="[01]" hasI18n="[01]" hasScript="[01]"]>
    &lt;attr name="[egenskap1]" type="[check|color|input|list|text|url]">
      &lt;text
>&lt;/text>
      &lt;textlocation col="0" row="0" />
      &lt;tooltip
>&lt;/tooltip>
      &lt;location col="1" row="0" colspan="3"/>
    &lt;/attr>
  ...
  &lt;/tag>
  ...
&lt;/tags>
</markup>
</programlisting
> </informalexample
> </para>

<para
> &lt;text
>&lt;/text
> anger en kort beskrivande text för objektet. </para>
<para
> &lt;textlocation ... /> anger layout av rad och kolumn för taggen &lt;text
>. </para>
<para
> &lt;tooltip
>&lt;/tooltip
> är textbeskrivningen när användaren håller pekaren stilla. </para>
<para
> &lt;location ../> anger platsen för egenskapens värde. </para>
<para
> Alla egenskaper måste räknas upp i taggfilen. Om du inte vill att den ska visas i taggdialogrutan, glöm då bara taggen &lt;location
>, t.ex. &lt;attr ...
> &lt;/attr
> </para>
</sect3>
</sect2>
</sect1>

</chapter>

