<chapter id="plugins">

<chapterinfo>
<authorgroup>
<author
>&Anders.Lund; &Anders.Lund.mail;</author>
<othercredit role="translator"
> <firstname
>Johan</firstname
> <surname
>Thelmén</surname
> <affiliation
><address
><email
>jth@home.se</email
></address
></affiliation
> <contrib
>Översättare</contrib
></othercredit
> 
</authorgroup>
</chapterinfo>

<title
>Arbeta med insticksprogram</title>

<para
>&kate; erbjuder flera typer av insticksprogram. Det finns insticksprogram för &kate;s editorkomponent, som är tillgängliga för alla program som använder editorkomponenten, såsom KDevelop, Quanta, Kile, &kwrite; med flera. Det finns också insticksprogram som bara är tillgängliga i själva &kate;-editorn. Det finns två typer av dessa insticksprogram: vissa är skriva i C++, medan andra är skrivna i programspråket Python. Det finns subtila skillnader mellan dessa, som beskrivs nedan.</para>

<para
>Du kan aktivera vilken typ av insticksprogram som helst i <link linkend="configuring-kate-configdialog"
>inställningsdialogrutan</link
>, som också ger tillgång till ytterligare inställningsalternativ för insticksprogram som kräver det.</para>

<para
>Det finns många insticksprogram för olika syften tillgängliga, och du kan söka efter fler på webben. Ett fåtal insticksprogram levereras med editorkomponenten, för att automatiskt infoga parenteser, infoga filer och exportera text som &HTML;.</para>
&plugins-part-sections; <sect1 id="scripts">
<title
>Skript</title>

<variablelist>

<varlistentry id="scripts-emmet">
<term
><menuchoice
><guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
> <guisubmenu
>Emmet</guisubmenu
> </menuchoice
></term>
<listitem
><variablelist>

<varlistentry id="scripts-emmet-expand-abbreviation">
<term
><menuchoice
><guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
><guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Expandera förkortning</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Konverterar den markerade texten till ett par inledande och avslutande &HTML;- eller &XML;-taggar. Om exempelvis <userinput
>div</userinput
> är markerad, ersätter alternativet det med <computeroutput
>&lt;div&gt;&lt;/div&gt;</computeroutput
>. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-wrap-with-tag">
<term
><menuchoice
><guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
><guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Radbryt enligt tagg</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Omger den markerade texten med taggen som anges på <link linkend="dev-scripting-command-line"
>kommandoraden</link
>. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-select-tag-inwards">
<term
><menuchoice
><guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
><guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Markera &HTML;/&XML;-tagginnehåll inåt</guimenuitem
> </menuchoice
></term>
<listitem
><para
>När markören är inne i ett par av &HTML;- eller &XML;-taggar, ändrar alternativet markeringen till innehållet i dessa &HTML;- eller &XML;-taggar, utan att markera själva taggarna. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-select-tag-outwards">
<term
><menuchoice
><guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
><guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Markera &HTML;/&XML;-tagginnehåll utåt</guimenuitem
> </menuchoice
></term>
<listitem
><para
>När markören är inne i ett par av &HTML;- eller &XML;-taggar, ändrar alternativet markeringen till innehållet i dessa &HTML;- eller &XML;-taggar, inklusive själva taggarna. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-move-cursor-to-matching-tag">
<term
><menuchoice
><guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
><guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Flytta markören till motsvarande tagg</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Om markören är inne i en inledande &HTML;- eller &XML;-tagg, flyttar alternativet den till den avslutande taggen. Om markören är inne i den avslutande taggen, flyttas den istället till den inledande taggen. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-toggle-comment">
<term
><menuchoice
><guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
><guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Växla kommentar</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Om den markerade delen inte är en kommentar, omger alternativet delen med &HTML;- eller &XML;-kommentarer (t.ex. <computeroutput
>&lt;!-- markerad text --&gt;</computeroutput
>). Om den markerade delen är en kommentar, tas kommentartaggarna istället bort. </para
></listitem>
</varlistentry>

<!--FIXME: (Go to|Select next) (previous|next) edit point -->

<varlistentry id="scripts-emmet-toggle-delete-tag">
<term
><menuchoice
><guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
><guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Ta bort tagg vid markören</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Om markören för närvarande är inne i &HTML;- eller &XML;-tagg, tar alternativet bort hela taggen. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-decrement-number-by-1">
<term
><menuchoice
><guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
><guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Minska tal med 1</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Alternativet subtraherar ett från texten som för närvarande är markerad om den är ett tal. Om exempelvis <userinput
>5</userinput
> är markerat, blir det <computeroutput
>4</computeroutput
>. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-decrement-number-by-10">
<term
><menuchoice
><guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
><guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Minska tal med 10</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Alternativet subtraherar 10 från texten som för närvarande är markerad om den är ett tal. Om exempelvis <userinput
>15</userinput
> är markerat, blir det <computeroutput
>5</computeroutput
>. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-decrement-number-by-0_1">
<term
><menuchoice
><guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
><guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Minska tal med 0,1</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Alternativet subtraherar 0,1 från texten som för närvarande är markerad om den är ett tal. Om exempelvis <userinput
>4,5</userinput
> är markerat, blir det <computeroutput
>4,4</computeroutput
>. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-increment-number-by-1">
<term
><menuchoice
><guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
><guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Öka tal med 1</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Alternativet adderar ett till texten som för närvarande är markerad om den är ett tal. Om exempelvis <userinput
>5</userinput
> är markerat, blir det <computeroutput
>6</computeroutput
>. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-increment-number-by-10">
<term
><menuchoice
><guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
><guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Öka tal med 10</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Alternativet adderar 10 till texten som för närvarande är markerad om den är ett tal. Om exempelvis <userinput
>5</userinput
> är markerat, blir det <computeroutput
>15</computeroutput
>. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-emmet-increment-number-by-0_1">
<term
><menuchoice
><guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
><guisubmenu
>Emmet</guisubmenu
> <guimenuitem
>Öka tal med 0,1</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Alternativet adderar 0,1 till texten som för närvarande är markerad om den är ett tal. Om exempelvis <userinput
>4,5</userinput
> är markerat, blir det <computeroutput
>4,6</computeroutput
>. </para
></listitem>
</varlistentry>

</variablelist
></listitem>
</varlistentry>

<varlistentry id="scripts-navigation">
<term
><menuchoice
><guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
> <guisubmenu
>Navigering</guisubmenu
> </menuchoice
></term>
<listitem
><variablelist>

<varlistentry id="scripts-navigation-previous-indent">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Alt;&Shift;<keysym
>Uppåtpil</keysym
></keycombo
></shortcut
> <guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
><guisubmenu
>Navigering</guisubmenu
> <guimenuitem
>Flytta markören till föregående motsvarande indentering</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Flyttar markören till den första raden ovanför den nuvarande som är indenterad till samma nivå som den nuvarande raden. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-navigation-next-indent">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Alt;&Shift;<keysym
>Neråtpil</keysym
></keycombo
></shortcut
> <guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
><guisubmenu
>Navigering</guisubmenu
> <guimenuitem
>Flytta markören till nästa motsvarande indentering</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Flyttar markören till den första raden nedanför den nuvarande som är indenterad till samma nivå som den nuvarande raden. </para
></listitem>
</varlistentry>

</variablelist>
</listitem
></varlistentry>

<!--FIXME: Quick Coding -> Expand Abbreviation (CTRL+ALT+#) -->

<varlistentry id="scripts-editing">
<term
><menuchoice
><guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
> <guisubmenu
>Redigering</guisubmenu
> </menuchoice
></term>
<listitem
><variablelist>

<varlistentry id="scripts-editing-sort">
<term
><menuchoice
><guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
> <guisubmenu
>Redigering</guisubmenu
> <guimenuitem
>Sortera markerad text</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Sortera den markerade texten eller hela dokumentet i stigande ordning. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-editing-move-down">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Shift;<keysym
>Neråtpil</keysym
></keycombo
></shortcut
> <guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
><guisubmenu
>Redigering</guisubmenu
> <guimenuitem
>Flytta ner rader</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Flytta markerade rader neråt. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-editing-move-up">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Shift;<keysym
>Uppåtpil</keysym
></keycombo
></shortcut
> <guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
><guisubmenu
>Redigering</guisubmenu
> <guimenuitem
>Flytta upp rader</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Flytta markerade rader uppåt. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-editing-dupe-down">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Shift;<keysym
>Neråtpil</keysym
></keycombo
></shortcut
> <guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
><guisubmenu
>Redigering</guisubmenu
> <guimenuitem
>Duplicera markerade rader neråt</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Duplicerar markerade rader neråt. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-editing-dupe-up">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Shift;<keysym
>Uppåtpil</keysym
></keycombo
></shortcut
> <guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
><guisubmenu
>Redigering</guisubmenu
> <guimenuitem
>Duplicera markerade rader uppåt</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Duplicera markerade rader uppåt. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-editing-uri-encode">
<term
><menuchoice
><guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
> <guisubmenu
>Redigering</guisubmenu
> <guimenuitem
>Koda markerad text till webbadress</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Kodar den markerade texten så att den kan användas som en del av en frågesträng i en webbadress, och ersätter markeringen med den kodade texten. </para
></listitem>
</varlistentry>

<varlistentry id="scripts-editing-uri-decode">
<term
><menuchoice
><guimenu
>Verktyg</guimenu
><guisubmenu
>Skript</guisubmenu
> <guisubmenu
>Redigering</guisubmenu
> <guimenuitem
>Avkoda markerad text från webbadress</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Om en del av en frågesträng i en webbadress är markerad, avkodar detta den och ersätter markeringen med den ursprungliga obehandlade texten. </para
></listitem>
</varlistentry>

</variablelist
></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="kate-application-plugins">
<title
>Insticksprogram för programmet &kate;</title>

<!-- from doc/kate-addons/index.docbook -->
<para
>&kate; insticksprogram är ytterligare funktioner för editorn &kate;. De kan lägga till extra menyer och snabbtangenter, och utöka &kate;s funktioner. Du kan installera så många eller så få du vill, inne i &kate;. Öppna &kate;s inställningsdialogruta med <menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa &kate;...</guimenuitem
></menuchoice
> Använd <menuchoice
><guimenu
>Program</guimenu
> <guimenuitem
>Insticksprogram</guimenuitem
></menuchoice
> för att välja önskade insticksprogram. </para>

<para
>De tillgängliga insticksprogrammen är: </para>
<itemizedlist>
<listitem>
<para
>Bläddring i bakåtspårning: Navigeringsverktyg med vy av bakåtspårning</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-build"
>Bygginsticksprogram</link
>: Kompilera eller bygg och tolka felmeddelanden</para>
</listitem>
<listitem>
<para
>Stäng förutom/som: Stäng grupp av dokument baserat på en gemensam sökväg eller filändelse</para>
</listitem>
<listitem>
<para
>CTags: Slå upp definitioner och deklarationer med CTags</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-fsbrowser"
>Filsystembläddrare</link
>: Verktygsvy för filsystembläddring</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-filetemplate"
>Filmallar</link
>: Skapa nya filer från mallar</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-gdb"
>&gdb;</link
> - Tillhandahåller ett enkelt gränssnitt för &gdb;</para>
</listitem>
<listitem>
<para
>Jovie text-till-tal: Lägger till ett menyalternativ för att läsa upp texten</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-mail"
>E-posta filer</link
>: Skicka filer via e-post</para>
</listitem>
<listitem>
<para
>Flerraders flikrad: Lägger till en flikrad med flera rader i &kate;s huvudfönster</para>
</listitem>
<listitem>
<para
>Öppna deklarationsfil: Öppnar den motsvarande .h/[.cpp|.c]-filen</para>
</listitem>
<listitem>
<para
>Projektinsticksprogram: Projektinsticksprogram för Kate</para>
</listitem>
<listitem>
<para
>Python-insticksprogram: &pate; värd för Python-insticksprogram</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-searchinfiles"
>Sök och ersätt</link
>: Sök eller ersätt mönster i öppnade dokument eller i filer på disk</para>
</listitem>
<listitem>
<para
>Verktygsvy med kodsnuttar: Verktygsvy med inbäddad hantering av kodsnuttar</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-sql"
>SQL-insticksprogram</link
> - Utför en förfrågan i SQL-databaser</para>
</listitem>
<listitem>
<para
>Symbolvisning: Hämta och visa referenssymboler från källkod</para>
</listitem>
<listitem>
<para
>Flikrad: Lägger till en flikrad i &kate;s huvudfönster</para>
<!--http://kate-editor.org/2011/04/25/kates-tab-bar-plugins/-->
</listitem>
<listitem>
<para
>Verktygsvyn Terminal: Verktygsvy med en inbäddad grafisk terminalkomponent</para>
</listitem>
<listitem>
<para
>Textfilter: Enkel textfiltrering</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-xmltools"
>&XML;-komplettering</link
>: Listar XML-element, attribut, attributvärden och objekt som tillåts av DTD</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-xmlcheck"
>&XML;-validering</link
>: Validerar &XML;-filer med XMLlint</para>
</listitem>

<!-- not in 4.10
<listitem>
<para
>Text Snippets - Configurable Text Snippets</para>
</listitem-->
<!--listitem>
<para
>Kate Python Browser Plugin - A Python browser plugin for Kate</para>
</listitem-->
<!--<listitem>
<para
><link linkend="kate-application-plugin-exttools"
>External Tools</link
></para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-snippets"
>Kate Snippets</link
> - Snippets plugin with code completion support</para>
</listitem>
<para
>Tabify - Adds a tab bar to Kate's main window</para>
http://kate-editor.org/2011/04/25/kates-tab-bar-plugins/
</listitem>
-->
</itemizedlist>
</sect1>

<sect1 id="pate">
<title
>Python &pate;-insticksprogram</title>

<para
>Python-insticksprogramvärden &pate; gör många insticksprogram skrivna i <ulink url="http://www.python.org/"
>programspråket Python</ulink
> tillgängliga.</para>

<para
>För att aktivera &pate;-insticksprogram måste du först aktivera insticksprogrammet <guilabel
>Python-insticksprogram</guilabel
> på sidan <link linkend="config-dialog-plugins"
><guilabel
>Insticksprogram</guilabel
> i &kate;s inställningsdialogruta</link
>. Du kan därefter aktivera, inaktivera och anpassa dem på sidan <guilabel
>Python-insticksprogram</guilabel
> i inställningsdialogrutan. För mer information om att anpassa &pate;-insticksprogram, se <xref linkend="pate-config"/>.</para>

<sect2 id="pate-plugins">
<title
>Tillgängliga insticksprogram</title>

<variablelist>

<varlistentry id="pate-plugin-block">
<term
><guilabel
>block</guilabel
></term>
<listitem
><para
>Insticksprogram för hjälpa till med kodredigering </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-cmake_utils">
<term
><guilabel
>cmake_utils</guilabel
></term>
<listitem
><para
>Hjälpinsticksprogram för CMake </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-color_tools">
<term
><guilabel
>color_tools</guilabel
></term>
<listitem
><para
>Klass som inkapslar möjligheten att visa färgprover (färglagda verktygstips) </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-commentar">
<term
><guilabel
>commentar</guilabel
></term>
<listitem
><para
>Flytta en insprängd kommentar innan aktuell rad med samma indenteringsnivå </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-django_utils">
<term
><guilabel
>django_utils</guilabel
></term>
<listitem
><para
>Django-verktyg: Snuttar och mallverktyg </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-expand">
<term
><guilabel
>expand</guilabel
></term>
<listitem>
<para
>Användardefinierad textexpansion.</para>

<para
>Varje textexpansion är en enkel funktion som måste returnera en sträng. Strängen infogas i ett dokument med åtgärden <command
>expandAtCursor</command
>. Om man exempelvis har funktionen <quote
>exempel</quote
> i file <filename
>all.expand</filename
> som är definierad som:</para>

<informalexample
><programlisting
>def exempel:
  return 'Hej från exemplet!'
</programlisting
></informalexample>

<para
>ersätter åtgärden <quote
>exempel</quote
> med <quote
>Hej från exemplet!</quote
> när man skriver <quote
>exempel</quote
>. Expansionsfunktionen kan också ha parametrar. Exempelvis innehåller filen <filename
>text_x-c++src.expand</filename
> funktionen <function
>cl</function
> som skapar en klass (eller klassmall). Den expanderar cl(test) till:</para>

<informalexample
><programlisting
>/**
 * \\kortfattad klass \c test
 */
class test
{
public:
    /// Standardkonstruktor
    explicit test()
    {
    }
    /// Destruktor
    virtual ~test()
    {
    }
};
</programlisting
></informalexample>

<para
>men <quote
>cl(test, T1, T2, T3)</quote
> expanderas till:</para>

<informalexample
><programlisting
>/**
 * \\kortfattad klass \c test
 */
template &lt;typename T1, typename T2, typename T3&gt;
class test
{
public:
    /// Standardkonstruktor
    explicit test()
    {
    }
    /// Destruktor
    virtual ~test()
    {
    }
};
</programlisting
></informalexample>
</listitem>
</varlistentry>

<varlistentry id="pate-plugin-format">
<term
><guilabel
>format</guilabel
></term>
<listitem
><para
>Insticksprogram för att arbeta med C++ kodformatering </para
></listitem>
</varlistentry>

<!--not in 4.12
<varlistentry id="pate-plugin-gdb">
<term
><guilabel
>gdb</guilabel
></term>
<listitem
><para>
Use <application
>gdb</application
>, the GNU debugger, from &kate;
</para
></listitem>
</varlistentry>
-->

<varlistentry id="pate-plugin-gid">
<term
><guilabel
>gid</guilabel
></term>
<listitem>
<para
>Bläddra bland symbolerna i en <application
>GNU idutils</application
> id-fil, och använd den för att navigera i en kodbas.</para>

<para
>De nödvändiga delarna av id-filen behålls i minnet för att ge tillräcklig prestanda för symbolkomplettering, när användningen av en symbol slås upp, eller när man går till definitionen. <command
>etags(1)</command
> används för att lokalisera definitionen.</para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-js_utils">
<term
><guilabel
>js_utils</guilabel
></term>
<listitem
><para
>Javascript-verktyg: Automatisk komplettering, jQuery automatisk komplettering, JSLint kontrollverktyg, snygg JSON, snuttar </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-python_autocomplete">
<term
><guilabel
>python_autocomplete</guilabel
></term>
<listitem
><para
>Python automatisk komplettering (beta, bara för Python 2) </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-python_console_classic">
<term
><guilabel
>python_console_classic</guilabel
></term>
<listitem
><para
>Interaktiv terminal för att inspektera interna delar av &kate; och leka med dem </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-python_console_ipython">
<term
><guilabel
>python_console_ipython</guilabel
></term>
<listitem
><para
>IPython-terminal för att programmera &kate; och vetenskapligt arbete </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-python_utils">
<term
><guilabel
>python_utils</guilabel
></term>
<listitem
><para
>Python-verktyg: Tolkningskontroll, PEP8-kontroll, Pyflakes-kontroll, snuttar </para
></listitem>
</varlistentry>

<varlistentry id="pate-plugin-xml_pretty">
<term
><guilabel
>xml_pretty</guilabel
></term>
<listitem
><para
>Enkel snygg utskrift för &XML;. Det formaterar &XML; med bra indentering. </para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="pate-config">
<title
>Anpassa &pate;</title>

<sect3 id="pate-config-manager">
<title
>Fliken <guilabel
>Hanterare</guilabel
></title>

<para
>Den här fliken innehåller en lista med &pate;-insticksprogram. Markera eller avmarkera kryssrutan till vänster om insticksprogrammets namn för att aktivera eller inaktivera dem.</para>

<para
>För att uppdatera listan över insticksprogram, ladda in alla insticksprogram som för närvarande kör, eller starta alla nyligen valda insticksprogram, klicka på knappen <guibutton
>Ladda insticksprogram igen</guibutton
> längst ner i fönstret.</para>

<warning
><para
>Att ladda ett insticksprogram igen kan få oförutsägbara effekter. Överväg att spara ditt arbete innan kommandot används.</para
></warning>

</sect3>

<sect3 id="pate-config-documentation">
<title
>Fliken <guilabel
>Dokumentation</guilabel
></title>

<para
>Fliken <guilabel
>Dokumentation</guilabel
> innehåller information om åtgärderna, menyalternativen, snabbtangenterna och inställningssidorna som erbjuds av &pate;-insticksprogram, samt en referens för programmerare som använder insticksprogrammens funktioner.</para>

<para
>Följande flikar är tillgängliga:</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Åtgärder</guilabel
></term>
<listitem
><para
>Listar alla åtgärder som erbjuds av insticksprogrammet, inklusive menyalternativ, ikon och snabbtangent som utför åtgärden.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Inställningssidor</guilabel
></term>
<listitem
><para
>Listar alla inställningssidor som erbjuds av insticksprogrammet, inklusive deras rubriker och ikoner.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Programmeringsreferens</guilabel
></term>
<listitem
><para
>Inkluderar information om alla moduler, klasser och funktioner som erbjuds av ett insticksprogram, skapat av <command
>pydoc</command
>.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

</sect2>

</sect1>

<!-- from doc/kate-addons/filetemplates.docbook -->
<sect1 id="kate-application-plugin-filetemplate">
<sect1info>
<authorgroup>
<author
>&Anders.Lund; &Anders.Lund.mail;</author>
</authorgroup>
</sect1info>
<title
>Filmallar</title>

  <para
>Insticksprogrammet Filmallar låter dig skapa filer baserade på andra filer.</para>
  <para
>När &kate; först installeras, måste insticksprogrammet aktiveras.</para>
  <orderedlist>
        <listitem>
          <para
>Klicka på <menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa &kate;</guimenuitem
></menuchoice
> </para>
        </listitem>
        <listitem>
          <para
>I trädet till vänster på skärmen, klicka på <guilabel
>Insticksprogram</guilabel
>. </para>
        </listitem>
        <listitem>
          <para
>Välj <guilabel
>Filmallar</guilabel
> i rutan <guilabel
>Insticksprogramhanterare</guilabel
> till höger, och klicka på <guilabel
>Ok</guilabel
>. </para>
        </listitem>
   </orderedlist>
  <para
>Du kan nu använda vilken fil som helst som mall (vilket skapar en kopia av filen med en tom webbadress). Särskilda mallfiler som kan innehålla makron för att fylla i information, som ditt namn och din e-postadress, dagens datum, och placera markören på en bekväm plats i den nya filen. </para>
  <para
>Du kan enkelt skapa en ny mall från ett öppet dokument.</para>
  <para
>Mallar som sparas i mallkatalogen listas i menyalternativet <menuchoice
><guimenu
>Arkiv</guimenu
> <guimenuitem
>Ny från mall</guimenuitem
></menuchoice
>.</para>
  <para
>Mallkatalogen är en del av &kde;:s filsystem, och innehåller åtminstone</para>
    <itemizedlist>
      <listitem>
	<para>
	 <filename role="directory"
>$<envar
>KDEDIR</envar
>/share/applications/kate/plugins/katefiletemplates/templates</filename>
	</para>
      </listitem>
      <listitem>
       <para>
        <filename role="directory"
>$<envar
>KDEHOME</envar
>/share/applications/kate/plugins/katefiletemplates/templates.</filename>
	</para>
      </listitem>
    </itemizedlist>
    <para
>Om miljövariabeln <envar
>KDEDIRS</envar
> innehåller ytterligare kataloger, söks de dessutom igenom efter liknande underkataloger. Om mallar med samma namn hittas, väljes mallen i den lokala katalogen (KDEHOME).</para>
  <sect2 id="katefiletemplates-menu">
    <title
>Menystruktur</title>

    <variablelist>
      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Arkiv</guimenu
> <guisubmenu
>Ny från mall</guisubmenu
> <guimenuitem
>Vilken fil som helst...</guimenuitem
> </menuchoice>
        </term>
        <listitem
><para
>Visar en dialogruta för att öppna en fil, som låter dig välja vilken fil som helst som mall. Om den valda filen har filändelsen <filename
>katetemplate</filename
> tolkas den för att hitta mallinformation och makron.</para
></listitem>
      </varlistentry>
      <!-- not in 4.4
      <varlistentry>
        <term>
          <menuchoice>
            <guimenu
>File</guimenu>
            <guisubmenu
>New From Template</guisubmenu>
            <guimenuitem
>Use Recent</guimenuitem>
          </menuchoice>
        </term>
        <listitem
><para
>Presents a list of files recently used as
            templates, represented by their &URL;.</para
></listitem>
      </varlistentry>
      -->
      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Arkiv</guimenu
> <guimenu
>Ny från mall</guimenu
>  </menuchoice>
        </term>
        <listitem
><para
>Återstoden av undermenyer innehåller länkar till mallar. Klicka på ett menyalternativ för att skapa en fil som beskrivs av menyalternativets text.</para
></listitem>
      </varlistentry>

      <!-- Settings menu -->

      <varlistentry>
        <term>
          <menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Hantera mallar...</guimenuitem
></menuchoice
></term>
        <listitem
><para
>Det här visar en dialogruta med en lista över mallar som hittas i mallkatalogerna, tillsammans med alternativ för att lägga till, redigera eller ta bort mallar.</para
></listitem>
      </varlistentry>
    </variablelist>
  </sect2>

  <sect2 id="katefiletemplates-use">
    <title
>Använda en &kate;-mall</title>
    <para
>När en fil skapas från en mall som innehåller mallmakron, visas vissa makron som redigerbara variabler i texten. Sådana variabler visas som understrukna ord i texten.</para>
    <para
>Den första variabeln väljes, så du behöver bara skriva för att redigera den. Om dokumenttexten innehåller flera förekomster av samma variabel, ändras de medan du redigerar. För att gå till nästa redigerbara variabel, tryck på tabulatortangenten. När den sista variabeln redigeras, försvinner listan och tabulatortangenten fungerar som vanligt.</para>
  </sect2>

  <sect2 id="katefiletemplates-create">
    <title
>Skapa dina egna mallar</title>
    <para
>Använd <menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Hantera mallar</guimenuitem
></menuchoice
> som startar mallhanteringsdialogrutan, för att skapa en ny mall. Klicka på <guibutton
>Ny...</guibutton
> i den för att starta Filmallsguiden. Du blir tillfrågad om en valfri fil att omvandla till en mall samt om mallinformationsinställningar, och en mallfil skapas åt dig.</para
> <para
>Som ett alternativ kan du skapa mallen för hand genom att lägga till mallinformation längst upp i vilken fil som helst, lägga till text och makron, och spara den med filändelsen <filename
>katetemplate</filename
>.</para>
    <para
>Mallmenyn uppdateras automatiskt om du väljer att lagra din mall i mallkatalogen.</para>
  </sect2>

  <sect2 id="katefiletemplates-edit">
    <title
>Redigera mallar</title>
    <para
>Använd <menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Hantera mallar...</guimenuitem
></menuchoice
> för att redigera en mall. Markera mallen du vill arbeta med, och klicka på <guibutton
>Redigera...</guibutton
>, så öppnas mallfilen. Stäng dialogrutan, redigera mallfilen som önskas, spara och stäng den. Ändringar i mallen får omedelbart effekt, och du kan aktivera mallen för att prova dina ändringar efter du har sparat den.</para>
  </sect2>

  <sect2 id="katefiletemplates-format">
    <title
>&kate;s mallformat</title>
    <para
>Om du använder filer med filändelsen <filename
>katetemplate</filename
>, tolkas de för att hitta mallinformation, makron och en markörposition.</para>

    <sect3 id="katefiletemplates-template-info">
      <title
>Mallinformation</title>
      <para
>Medan filen läses in, behåller tolken rader som börjar med ordet <constant
>katetemplate:</constant
> och söker i dem efter mallinformation på formen VARIABELNAMN=VÄRDE. Den första raden som inte börjar med <constant
>katetemplate:</constant
> antas vara början på mallens innehåll. VÄRDE kan innehålla vilket tecken som helst utom likhetstecken (=). Riktiga variabelnamn är: <variablelist>
          <varlistentry>
            <term
><varname
>Mall</varname
></term>
            <listitem
><para
>Det här är mallens namn, som visas i menyn <menuchoice
><guimenu
>Arkiv</guimenu
> <guimenuitem
>Ny från mall</guimenuitem
></menuchoice
>.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Group</varname
></term>
            <listitem
><para
>Gruppen placerar mallen i en undermeny till menyn <menuchoice
><guimenu
>Arkiv</guimenu
> <guimenuitem
>Ny från mall</guimenuitem
></menuchoice
>.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><varname
>Name</varname
></term>
            <listitem
><para
>Det här är namnet som dokumentet får, och som visas i fillistan och namnlisten. Om namnet innehåller <userinput
>%n</userinput
> ersätts det med ett nummer, som ökas om flera dokument har samma namn.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Highlight</varname
></term>
            <listitem
><para
>Insticksprogrammet försöker ställa in färgläggningen för det nya dokumentet till den här variabelns värde. Värdet ska vara namnet, som syns under <menuchoice
><guimenu
>Verktyg</guimenu
> <guimenuitem
>Färgläggning</guimenuitem
></menuchoice
>.</para>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term
><varname
>Description</varname
></term>
            <listitem
><para
>En kort informativ beskrivning av mallen. Den används för närvarande för att visa en <guimenuitem
>Vad är det här?</guimenuitem
>-sträng för menyalternativet, men kan användas för ytterligare syften i framtiden.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
>Author</term>
            <listitem
><para
>En sträng som identifierar upphovsmannen, till exempel på formen <userinput
>Namn &lt;e-postadress&gt;</userinput
>. Den används för närvarande för att visa strängen från <guimenuitem
>Vad är det här?</guimenuitem
> för menyalternativet, men kan användas för ytterligare syften i framtiden.</para
></listitem>
          </varlistentry>
        </variablelist>
      </para>

    </sect3>

    <sect3 id="katetemplates-macros">
      <title
>Mallmakron</title>

      <para
>Medan mallens innehåll tolkas, expanderas makron på formen <userinput
>%{NAMN}</userinput
> eller <userinput
>${NAMN}</userinput
>. Om du använder prefixet <userinput
>$</userinput
>, behandlas det expanderade makrot som en redigerbar variabel när ett dokument skapas från mallen, medan om du använder <userinput
>%</userinput
> gör det inte det, om inte expansion misslyckades.</para>
      <para
>Följande makron expanderas: <variablelist>
          <varlistentry
><term
><literal
>time</literal
></term>
            <listitem
><para
>Expanderas till aktuell tid med format enligt landsinställningarna.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>date</literal
></term>
            <listitem
><para
>Expanderas till dagens datum med kort format.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>datetime</literal
></term>
            <listitem
><para
>Expanderas till aktuell tid och datum, formaterat som en sträng enligt landsinställningarna.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>year</literal
></term>
            <listitem
><para
>Innevarande år som ett tal med fyra siffror.</para
></listitem>
          </varlistentry>
          <varlistentry>
            <term
><literal
>month</literal
></term>
            <listitem
><para
>Fullständigt namn på innevarande månad, enligt dina landsinställningar.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>dag</literal
></term>
            <listitem
><para
>Expanderas till dagen i innevarande månad.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>hostname</literal
></term>
            <listitem
><para
>Expanderas till datorns värddatornamn.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>index</literal
></term>
            <listitem
><para
>Expanderas till 'i'.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>fullname</literal
></term>
            <listitem
><para
>Expanderas till ditt fullständiga namn, som det definieras i ägarens adress i den vanliga adressboken i &kde;.</para
></listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>firstname</literal
></term>
            <listitem
><para
>Expanderas till ditt förnamn, som det definieras av ägarens adress i den vanliga adressboken i &kde;.</para>
            </listitem>
          </varlistentry>
          <varlistentry
><term
><literal
>lastname</literal
></term>
            <listitem
><para
>Expanderas till ditt efternamn, som det definieras av ägarens adress i den vanliga adressboken i &kde;.</para>
            </listitem>
          </varlistentry>
          <!-- <varlistentry>
            <term
>username</term>
            <listitem
><para
>Expands to your username.</para
></listitem>
          </varlistentry
> -->
          <varlistentry>
            <term
>email</term>
            <listitem
><para
>Expanderas till din e-postadress, som den definieras i ägarens adress i den vanliga adressboken i &kde;.</para
></listitem>
          </varlistentry>
          <!--<varlistentry>
            <term
>organisation</term>
            <listitem
><para
>This is your organisation, as defined by
                the owner address in your standard KDE
                addressbook.</para
></listitem>
          </varlistentry
>-->
        </variablelist>
      </para>
      <para
>Ett makron som inte finns i listan ovan behandlas som en redigerbar variabel oberoende av prefix. Om samma variabel förekommer flera gånger i mallen, kan de redigeras omedelbart efter dokumentet skapats från mallen.</para>
    </sect3>

    <sect3 id="katefiletemplates-cursor">
      <title
>Ange markörens position</title>
      <para
>Det speciella makrot <userinput
>${cursor}</userinput
> ersätts med en vertikal rad och läggs till sist i listan med redigerbara variabler, oberoende av sin plats i texten.</para>
    </sect3>

  </sect2>
  <sect2>
    <title
>Tack och erkännanden</title>
    <para
>&kate;-insticksprogrammet <quote
>Filmallar</quote
> copyright 2004 &Anders.Lund; &Anders.Lund.mail;. </para>
    <para
>Dokumentation copyright 2004 &Anders.Lund;</para>
  </sect2>
</sect1>

<!-- from doc/kate-addons/xmlcheck.docbook -->
<sect1 id="kate-application-plugin-xmlcheck">
<sect1info>
<authorgroup
><author
>&Daniel.Naber; &Daniel.Naber.mail; </author
></authorgroup>
</sect1info>

<title
>&XML;-validering</title>

<para
>Det här insticksprogrammet kontrollerar att &XML;-filer är giltiga och välformade.</para>
<para
>Det här insticksprogrammet kontrollerar nuvarande fil. En lista med varningar och fel visas längst ner i &kate;s huvudfönster. Du kan klicka på ett felmeddelande för att hoppa till motsvarande plats i filen. Om filen har en <quote
>DOCTYPE</quote
>, så används den DTD som anges av DOCTYPE för att kontrollera filens giltighet. Denna DTD förväntas finnas på en plats relativt den nuvarande filen, t.ex. om DOCTYPE refererar till <quote
>DTD/xhtml1-transitional.dtd</quote
> och filen heter <filename
>/home/peter/test.xml</filename
>, så förväntas denna DTD finnas under <filename
>/home/peter/DTD/xhtml1-transitional.dtd</filename
>. Dock så stöds också DTD:er som anges med HTTP.</para>

<para
>Om filen inte har någon doctype, så kontrolleras att den är välformad.</para>

<para
>För att ta reda på mer om &XML;, titta på <ulink url="http://www.w3.org/XML/"
>de officiella W3C &XML;-sidorna</ulink
>.</para>

<para
>Internt anropar insticksprogrammet det externa kommandot <command
>xmllint</command
>, som är en del av libxml2. Om det här programmet inte är riktigt installerat på systemet, fungerar inte insticksprogrammet.</para>

<note
><para
>En tillfällig fil måste skrivas i samma katalog där filen som ska kontrolleras finns, så du måste ha skrivrättigheter i denna katalog.</para
></note>

<para
>För att ladda insticksprogrammet, öppna först &kate;s inställningsdialogruta under <menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa &kate;...</guimenuitem
></menuchoice
> . Markera därefter <guilabel
>&XML;-validering</guilabel
>, som visas under <guilabel
>Program</guilabel
> <guilabel
>Insticksprogram</guilabel
> och stäng dialogrutan. </para>

<sect2 id="xmlcheck-menu">
<title
>Menystruktur</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>&XML;</guimenu
> <guimenuitem
>Validera &XML;</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Det här startar kontrollen, som beskrivs ovan.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmlcheck-thanks-and-acknowledgements">
<title
>Tack och erkännanden</title>
<para
>&kate;s insticksprogram <quote
>&XML;-validering</quote
> copyright 2002 &Daniel.Naber; &Daniel.Naber.mail;. </para>
<para
>Dokumentation copyright 2002 &Daniel.Naber;</para>

</sect2>
</sect1>

<sect1 id="kate-application-plugin-xmltools">
<sect1info>
<authorgroup
><author
>&Daniel.Naber; &Daniel.Naber.mail; </author
></authorgroup>
</sect1info>
<title
>&XML;-komplettering</title>

<para
>Det här insticksprogrammet ger tips om vad som är tillåtet på vissa ställen i en &XML;-fil, i enlighet med filens DTD. Det listar möjliga element, egenskaper, egenskapsvärden eller objekt, beroende på markörens plats (t.ex. så listas alla objekt om tecknet till vänster om markören är <quote
>&amp;</quote
>). Det är också möjligt att avsluta den närmaste taggen till vänster som ännu ej avslutats.</para>

<para
>En <acronym
>DTD</acronym
> på &XML;-format, som skapas av Perl-programmet <command
>dtdparse</command
> måste finnas. Den här sortens DTD:er kallas för <quote
>meta-DTD:er</quote
>. Vissa meta-DTD:er medföljer. De är installerade i <filename class="directory"
>$KDEDIR/share/apps/katexmltools/</filename
>, som också är den förvalda katalogen när du väljer <guimenuitem
>Tilldela meta-DTD...</guimenuitem
>. För att skapa dina egna meta-DTD:er, hämta <command
>dtdparse</command
> från <ulink url="http://dtdparse.sourceforge.net"
>http://dtdparse.sourceforge.net</ulink
>.</para>

<sect2 id="xmltools-how-to-use">
<title
>Användning</title>

<para
>Starta &kate; och öppna  inställningsdialogrutan med <menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa &kate;...</guimenuitem
></menuchoice
>. Markera därefter <guilabel
>&XML;-komplettering</guilabel
>, som visas i avsnittet <guilabel
>Program</guilabel
> <guilabel
>Insticksprogram</guilabel
>. Välj därefter <menuchoice
><guimenu
>&XML;</guimenu
> <guimenuitem
>Tilldela meta-DTD...</guimenuitem
></menuchoice
>. Om dokumentet inte innehåller någon <quote
>DOCTYPE</quote
> eller en okänd doctype, måste du välja en meta-DTD i filsystemet. Annars så laddas automatiskt den meta-DTD som hör ihop med det nuvarande dokumentets doctype.</para>

<para
>Nu kan du använda insticksprogrammet medan du skriver in text:</para>

<variablelist>

<varlistentry>
<term
><keycap
>&lt;</keycap
> (mindre än tecken)</term>
<listitem
><para
>Det här visar en lista med möjliga element om inte markören redan är inne i en tagg. Observera att du för närvarande inte kan använda det här för att infoga toppnivåelementet (t.ex. <quote
>&lt;html&gt;</quote
>).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&lt;</keycap
><keycap
>/</keycap
> (mindre än tecken + snedstreck)</term>
<listitem
><para
>Att skriva in de här tecknen erbjuder att avsluta det aktuella elementet (det närmaste oavslutade till vänster om markören). Tryck på returtangenten för att acceptera förslaget. I motsats till menyalternativet <guimenuitem
>Avsluta element</guimenuitem
>, fungerar det här bara när en DTD har tilldelats.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>"</keycap
> (citationstecken)</term>
<listitem
><para
>Ett citationstecken visar en lista med möjliga attributvärden (om det finns några) när du är inne i en tagg.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&nbsp;</keycap
> (mellanslag)</term>
<listitem
><para
>Den här tangenten visar en lista med möjliga egenskaper för det nuvarande elementet om du är inne i en tagg.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&amp;</keycap
> (och-tecken)</term>
<listitem
><para
>Den här tangenten visar en lista med namngivna objekt.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmltools-features-and-limitations">
<title
>Funktioner och begränsningar</title>

<para
>Du kan prova alla funktioner och begränsningar genom att ladda <filename
>$KDEDIR/share/apps/katexmltools/testcases.xml</filename
> i &kate; och följa instruktionerna.</para>

</sect2>


<sect2 id="xmltools-menu">
<title
>Menystruktur</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Retur</keycap
> </keycombo
> </shortcut
> <guimenu
>&XML;</guimenu
> <guimenuitem
>Infoga element...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Det här visar en dialogrutan som låter dig infoga &XML;-element. Tecknen &lt;, &gt; och avslutande tagg infogas automatiskt. Om du har markerat text när menyalternativet utförs, omges den markerade texten av inledande och avslutande tagg. Dialogrutan erbjuder också komplettering av alla element som kan ha infogats på aktuell markörposition, om du har tilldelat en meta-DTD genom att använda <guimenuitem
>Tilldela meta-DTD...</guimenuitem
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>&lt;</keycap
></keycombo
> </shortcut
> <guimenu
>&XML;</guimenu
> <guimenuitem
>Avsluta element</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Det här söker i texten efter en tagg som ännu inte avslutats och avslutar den genom att sätta in motsvarande avslutningstagg. Sökningen börjar på markörens plats och går åt vänster. Om ingen tagg som inte har avslutats hittas, händer ingenting.</para
></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>&XML;</guimenu
> <guimenuitem
>Tilldela meta-DTD...</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Det här talar om för insticksprogrammet vilken meta-DTD som ska användas för det nuvarande dokumentet. Observera att den här tilldelningen inte sparas. Du måste upprepa den när du startar &kate; nästa gång.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmltools-thanks-and-acknowledgements">
<title
>Tack och erkännanden</title>
<para
>&kate;s insticksprogram <quote
>&XML;-validering</quote
> copyright 2001, 2002 &Daniel.Naber; &Daniel.Naber.mail;. </para>
<para
>KDE programvarusamling 4 version copyright 2010 Tomáš Trnka</para>
<para
>Dokumentation copyright 2001,2002 &Daniel.Naber;</para>
</sect2>

</sect1>
<!--FIXME this belongs to Extensions, it is an editor plugin-->
<sect1 id="kate-editor-plugin-exporter">
<!--<sect1info>
<authorgroup
><author>
&TC.Hollingsworth; &TC.Hollingsworth.mail;
</author
></authorgroup>
</sect1info
>-->
<title
>Exportverktyg</title>

<sect2 id="exporter-menu">
<title
>Menystruktur</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>Arkiv</guimenu
> <guimenuitem
>Exportera som &HTML;...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Exportera filen med &HTML;-format så att dokumentet kan visas som en webbsida. </para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Redigera</guimenu
> <guimenuitem
>Kopiera som &HTML;...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Kopierar markerad text med syntaxfärgläggningen som &HTML;-text.</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-searchinfiles">
<sect1info>
<authorgroup
><author
>&TC.Hollingsworth; &TC.Hollingsworth.mail; </author
></authorgroup>
</sect1info>
<title
>Sök och ersätt</title>

<sect2 id="searchinfiles-intro">
<title
>Inledning</title>
<para
>&kappname;s insticksprogram Sök och ersätt låter dig söka efter text eller <link linkend="regular-expressions"
>reguljära uttryck</link
> i många olika filer på en gång. Du kan söka i alla öppna filer, alla filer i en katalog och valfritt i dess underkataloger, eller alla filer i aktuellt projekt. Du kan till och med filtrera enligt filnamn, exempelvis för att bara söka i filer som slutar med en viss filändelse.</para>

</sect2>

<sect2 id="searchinfiles-ui">
<title
>Gränssnitt</title>

<sect3 id="searchinfiles-ui-query">
<title
>Sökbegrepp</title>

<para
>Följande alternativ visas alltid längst upp i verktygsvyn Sök i filer:</para>

<variablelist>

<varlistentry>
<term
><guiicon
>Ny flik</guiicon
></term>
<listitem
><para
>Du kan ha så många sökningar som du vill igång samtidigt. Klicka helt enkelt på knappen <guibutton
>Ny flik</guibutton
> längst upp till vänster i sökverktygets vy, så öppnas en ny resultatflik som låter dig utföra en ny sökning. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Växla resultat</guiicon
></term>
<listitem
><para
>Neråtpilen i övre högra hörnet av verkygsvyn Sök i filer växlar nedre halvan av  verktygsvyn mellan att visa ytterligare alternativ för katalogsökläget och resultatet av sökningarna. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Sök</guilabel
></term>
<listitem
><para
>Här skriver du in vad du vill söka efter. Du kan skriva in vanlig text, eller ett reguljärt uttryck om det är aktiverat. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ersätt</guilabel
> (textruta)</term>
<listitem
><para
>Ersättningstext som läggs till i filen eller filerna istället för texten i textrutan <guilabel
>Sök</guilabel
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Sök</guibutton
></term>
<listitem
><para
>När du är klar med att ställa in allting, klicka bara på knappen <guibutton
>Sök</guibutton
> för att utföra sökningen. Du kan också trycka på returtangenten i textruta <guilabel
>Sök</guilabel
> för att åstadkomma samma sak. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Ersätt</guibutton
></term>
<listitem
><para
>När du är klar med att ställa in allting, klicka bara på knappen <guibutton
>Ersätt</guibutton
> för att ersätta texten som matades in i textrutan <guilabel
>Sök</guilabel
> med den i textrutan <guilabel
>Ersätt</guilabel
>. Du kan också trycka på returtangenten i textrutan <guilabel
>Ersätt</guilabel
> för att göra samma sak. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Nästa</guibutton
></term>
<listitem
><para
>Gå till nästa träff i sökningen, byter filer om det behövs. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Ersätt markerade</guibutton
></term>
<listitem
><para
>Samma som <guibutton
>Ersätt</guibutton
> men utför bara ersättningar i filer som är markerade i rutan nedanför. </para
></listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="searchinfiles-ui-folder">
<title
>Alternativ för sök i katalog</title>

<para
>Alternativen visas under de tidigare nämnda sökalternativen. Om sökresultaten visas istället, klicka på knappen <guiicon
>Växla resultat</guiicon
> för att visa dem.</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Matcha skiftläge</guilabel
></term>
<listitem
><para
>Begränsar sökresultaten till bara de som har exakt samma kombination av stora och små bokstäver som sökbegreppet. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Reguljära uttryck</guilabel
></term>
<listitem
><para
>Låter dig använda <link linkend="regular-expressions"
>reguljära uttryck</link
> istället för enkel text som sökbegrepp. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Expandera resultat</guilabel
></term>
<listitem
><para
>Visar alla resultat som hittas i varje fil, istället för bara en lista med filer som innehåller sökbegreppet. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Sök</guilabel
></term>
<listitem
><para
>Detta har tre alternativ. Välj <guilabel
>i öppna filer</guilabel
> för att söka i alla filer som för närvarande är öppna i &kappname;. Välj <guilabel
>i katalog</guilabel
> för att söka inne i en katalog och valfritt i dess  underkataloger. Välj <guilabel
>I projekt</guilabel
> för att söka i alla filer listade i projektet som för närvarande är öppet. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Katalog</guilabel
></term>
<listitem
><para
>Du kan skriva in sökvägen för katalogen som du vill söka i. Du kan exempelvis skriva in <userinput
>~/utveckling/kde/kate/</userinput
> om du skulle vilja söka i &kate;s källkod. Alternativet är bara tillgängligt när <guilabel
>I katalog</guilabel
> används. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Öppna fildialogruta</guiicon
></term>
<listitem
><para
>Tryck på knappen för att bestämma katalogen med skrivbordets katalogbläddrare. Knappen är bara tillgänglig när alternativet <guilabel
>I katalog</guilabel
> används. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Upp</guiicon
></term>
<listitem
><para
>Klicka på knappen för att ändra <guilabel
>Katalog</guilabel
> till den överliggande katalogen till katalogen som för närvarande är vald. Knappen fungerar bara när alternativet <guilabel
>I katalog</guilabel
> används. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Återställ nuvarande katalog</guiicon
></term>
<listitem
><para
>Den här knappen ändrar <guilabel
>Katalog</guilabel
> till den katalog där dokumentet som för närvarande är öppet finns. Knappen fungerar bara när alternativet <guilabel
>I katalog</guilabel
> används. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Filter</guilabel
></term>
<listitem
><para
>Det här låter dig enbart söka efter filnamn som motsvarar ett visst mönster. För att exempelvis bara söka efter filer som är skrivna i C++, ändra det till <userinput
>*.cpp</userinput
>. För att söka efter filer som börjar med <literal
>kate</literal
>, ändra det till <userinput
>kate*</userinput
>. Du kan skriva in flera filter åtskilda med kommatecken (<userinput
>,</userinput
>). Alternativet är inte tillgängligt när <guilabel
>I öppna filer</guilabel
> används. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Undanta</guilabel
></term>
<listitem
><para
>Motsatsen till <guilabel
>Filter</guilabel
>, och förhindrar &kappname; från att söka i filer som motsvarar de angivna mönstren. Som med <guilabel
>Filter</guilabel
> kan du ange flera mönster åtskilda med kommatecken (<userinput
>,</userinput
>). Alternativet är inte tillgängligt när <guilabel
>I öppna filer</guilabel
> används. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Rekursiv</guilabel
></term>
<listitem
><para
>Om alternativet är aktiverat, söker &kappname; också i alla underkataloger till den valda katalogen. Alternativet är bara tillgängligt när <guilabel
>I katalog</guilabel
> används. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>inkludera dolda</guilabel
></term>
<listitem
><para
>Om alternativet är aktiverat, söker &kappname; också i filer eller kataloger som normalt är dolda av operativsystemet. Alternativet är bara tillgängligt när <guilabel
>I katalog</guilabel
> används. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Följ symboliska länkar</guilabel
></term>
<listitem
><para
>Insticksprogrammet Sök i filer, följer normalt inte <ulink url="http://en.wikipedia.org/wiki/Symbolic_link"
>symboliska länkar</ulink
>. När det här alternativet är aktiverat, följer insticksprogrammet dem och söker i filerna eller katalogerna de refererar till. Alternativet är bara tillgängligt när <guilabel
>I katalog</guilabel
> används. </para>
<warning
><para
>Det är möjligt för symboliska länkar att referera till en katalog som är överliggande katalog till den katalog som för närvarande söks igenom, eller andra kataloger som innehåller symboliska länkar till sina överliggande kataloger. Om en sådan länk finns i en katalog som söks igenom och det här alternativet är aktiverat, kommer &kappname; följa länken upprepade gånger och söka igenom katalogen, och sökningen kommer aldrig att avslutas.</para
></warning>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Sök även i binärfiler</guilabel
></term>
<listitem
><para
>Om aktiverat, söker &kappname; också i filer som inte verkar vara textfiler. </para
></listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="searchinfiles-ui-results">
<title
>Sökresultat</title>

<para
>Sökresultaten visas under sökalternativen. Om alternativen för Sök i katalog visas, klicka helt enkelt på knappen <guiicon
>Växla resultat</guiicon
> för att visa dem. De visas också automatiskt så fort en sökning utförs.</para>

<para
>Sökresultatet visar en lista med filer som innehåller text som motsvarar sökbegreppet, följt av antal träffar i den filen.</para>

<para
>För att se en lista med träffar i filen, klicka helt enkelt på expansionspilen till vänster om filnamnet (om du valde alternativet <guilabel
>Expandera resultat</guilabel
>, är det redan gjort åt dig). Radnumret där varje träff hittades visas, följt av innehållet på raden, med sökbegreppet angivet med fetstil.</para>

<para
>För att öppna filen som resultatet hittades i, dubbelklicka helt enkelt på den. &kappname; öppnar filen om det behövs. Du kan också flytta markören till platsen för en viss träff genom att dubbelklicka där den listas istället för filnamnet. </para>

</sect3>
</sect2>

<sect2 id="searchinfiles-menu">
<title
>Menystruktur</title>

<variablelist>

<varlistentry>
<term>
<menuchoice
><guimenu
>Redigera</guimenu
> <guimenuitem
>Sök i filer</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Startar verktygsvyn Sök och ersätt</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Redigera</guimenu
> <guimenuitem
>Gå till nästa träff</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Gå till nästa träff i en sökning utförd av insticksprogrammet Sök och ersätt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Redigera</guimenu
> <guimenuitem
>Gå till föregående träff</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Gå till föregående träff i en sökning utförd av insticksprogrammet Sök och ersätt.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice
><guimenu
>Visa</guimenu
> <guisubmenu
>Verktygsvyer</guisubmenu
> <guimenuitem
>Visa Sök och ersätt</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Visar eller döljer &kappname;s verktyg <guilabel
>Sök och ersätt</guilabel
>. </para>
</listitem>
</varlistentry>

</variablelist>

</sect2>
</sect1>

<sect1 id="kate-application-plugin-mail">
<!--<sect1info>
<authorgroup
><author>
&TC.Hollingsworth; &TC.Hollingsworth.mail;
</sect1info
>-->
<title
>E-posta filer</title>

<sect2 id="mail-menu">
<title
>Menystruktur</title>
<variablelist>

<varlistentry>
<term>
<menuchoice
><guimenu
>Arkiv</guimenu
> <guimenuitem
>Skicka e-post...</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Öppnar ditt e-postprogram och lägger till filen som bilaga i brevet. </para>
</listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-fsbrowser">
<!--<sect1info>
<authorgroup
><author>
&TC.Hollingsworth; &TC.Hollingsworth.mail;
</author
></authorgroup>
</sect1info
>-->
<title
>Filsystembläddrare</title>

<para
>Filsystembläddraren är en katalogvy, som låter dig öppna filer i en katalog som visas i den nuvarande rutan.</para>

<sect2 id="fsbrowser-menu">
<title
>Menystruktur</title>
<variablelist>

<varlistentry>
<term>
<anchor id="view-toolviews-show-fileselector"/>
<menuchoice
><guimenu
>Visa</guimenu
> <guisubmenu
>Verktygsvyer</guisubmenu
> <guimenuitem
>Visa Filsystembläddrare</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Visar eller döljer &kate;s filsystembläddrare.</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="fsbrowser-interface">
<title
>Gränssnitt</title>

<para
>Uppifrån och ner, består filsystembläddraren av följande delar:</para>

<variablelist>
<varlistentry>
<term
>En verktygsrad</term>
<listitem>
<para
>Den här innehåller vanliga navigationsknappar:</para>
<variablelist>
<varlistentry>
<term
><guibutton
>Tillbaka</guibutton
></term>
<listitem
><para
>Gör att katalogvyn byter till katalogen som tidigare visades i historiken med kommandot <command
>cd</command
>. Knappen är inaktiv om det inte finns någon tidigare katalog.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Framåt</guibutton
></term>
<listitem
><para
>Gör att katalogvyn byter till nästa katalog i historiken med kommandot <command
>cd</command
>. Knappen är inaktiv om det inte finns någon nästa katalog.</para
></listitem>
</varlistentry>
<!--varlistentry>
<term
><guibutton
>Parent Folder</guibutton
></term>
<listitem
><para
>This will cause the folder view to <command
>cd</command
> to the immediate parent of the currently displayed
folder if possible.</para
></listitem>
</varlistentry-->
<varlistentry>
<term
><guibutton
>Bokmärken</guibutton
></term>
<listitem
><para
>Visar en undermeny för att redigera eller lägga till bokmärken, och för att lägga till en ny bokmärkeskatalog.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Aktuell dokumentkatalog</guibutton
></term>
<listitem
><para
>Den här knappen gör att katalogvyn byter till katalogen för det nuvarande aktiva dokumentet med kommandot <command
>cd</command
>, om möjligt. Knappen är inaktiv om det nuvarande dokumentet är en ny, osparad fil, eller om katalogen som den finns i inte kan bestämmas.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guibutton
>Alternativ</guibutton
></term>
<listitem>
<variablelist>
<varlistentry>
<term
><guimenuitem
>Kort format</guimenuitem
></term>
<listitem
><para
>Visar bara filnamnen.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Detaljerat format</guimenuitem
></term>
<listitem
><para
>Visar filernas <guilabel
>Namn</guilabel
>, <guilabel
>Datum</guilabel
>, <guilabel
>Storlek</guilabel
> och <guilabel
>Typ</guilabel
>.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Trädformat</guimenuitem
></term>
<listitem
><para
>Som Kort format, men kataloger kan expanderas för att se deras innehåll.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Detaljerat trädformat</guimenuitem
></term>
<listitem
><para
>Det tillåter också att kataloger expanderas, men visar de ytterligare kolumnerna tillgängliga i Detaljerat format.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Visa dolda filer</guimenuitem
></term>
<listitem
><para
>Visar filer som normalt döljs av operativsystemet.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Synkronisera automatiskt med aktuellt dokument</guimenuitem
></term>
<listitem
><para
>När alternativet är aktiverat använder filsystembläddraren <command
>cd</command
> för att automatiskt gå till katalogen där dokumentet som för närvarande är öppet i redigeringsområdet finns, varje gång det ändras.</para
></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
>En platsangivelse</term>
<listitem>
<para
>Den visar en länkstig till katalogen som för närvarande är öppen, på liknande sätt som i &dolphin;. Du kan klicka på vilken katalog som helst för att gå till den, eller klicka på någon av pilarna till vänster om en katalog för att välja vilken katalog som helst under den. Du kan också välja i listan med platser genom att klicka på ikonen längst till vänster i länkstigen, där en ikon visas som representerar nuvarande platser.</para>

<para
>Du kan också klicka till höger om länkstigen för att ändra den till en textruta, där du kan skriva in sökvägen till katalogen som ska visas. Inmatningsrutan behåller en lista med de senast inskrivna sökvägarna. För att välja en, använd pilknappen till höger om fältet.</para>
<tip
><para
>Inmatningsrutan har automatisk komplettering av kataloger. Kompletteringsmetoden kan anges via menyn som visas genom att klicka med höger musknapp på textfältet.</para
></tip>
</listitem>
</varlistentry>

<varlistentry>
<term
>En katalogvy</term>
<listitem
><para
>Det här är &kde;:s standardkatalogvy.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Ett filterfält</term>
<listitem>
<para
>Filterfältet låter dig skriva in ett filter för filerna som visas i katalogvyn. Filtret använder vanliga jokertecken, där mönster måste skiljas åt av blanktecken. Till exempel: <userinput
>*.cpp *.h *.moc</userinput
>.</para>
<para
>För att visa alla filer, skriv in en ensam asterisk <userinput
>*</userinput
>.</para>
<para
>Filterfältet sparar de senaste tio filtren mellan sessioner. För att använda ett, tryck på pilknappen till höger i fältet och välj önskad filtersträng. Filtret kan inaktiveras genom att klicka på knappen <guibutton
>Rensa text</guibutton
> till vänster om pilknappen för automatisk komplettering.</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>


<sect2 id="fsbrowser-config">
<title
>Inställning</title>

<para
>Insticksprogrammet kan anpassas på sidan <guilabel
>Filsystembläddrare</guilabel
> i <link linkend="configuring-kate-configdialog"
>&kate;s inställningsruta</link
>.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Verktygsrad</guilabel
></term>
<listitem
><para
>Anpassa knapparna i filsystembläddrarens verktygsrad genom att flytta de du vill ha aktiverade till listan <guilabel
>Markerade åtgärder</guilabel
>, och ordna dem med pilknapparna vid sidan om listan.</para>
 </listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<!--some material from mdi.docbook needs to be migrated here too-->
<!--<sect1 id="kate-application-plugin-exttools">
<sect1info>
<authorgroup
><author>
&TC.Hollingsworth; &TC.Hollingsworth.mail;
</author
></authorgroup>
</sect1info>
<title
>External Tools</title>

<para
>In the <guimenu
>Tools</guimenu
> menu you will find a submenu labeled
<guisubmenu
>External Tools</guisubmenu
>, if you have enabled them in &kate; settings.
These tools invoke external applications with data related to the current document,
for example its URL, directory, text or selection.</para>

<para
>External tools are user defined, you can add, edit or remove tools using
the <link linkend="exttools-config"
>External Tools</link
> configuration panel.
</para>

<sect2 id="exttools-menu">
<title
>Menu Structure</title>
<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>Tools</guimenu
><guisubmenu
>External
Tools</guisubmenu
></menuchoice
></term>
<listitem
><para
>This submenu contains all the external tools you have
configured.</para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="exttools-config">
<title
>Configuration</title>

<para
>External tools are configured on the <guilabel
>External Tools</guilabel
> page
of <link linkend="configuring-kate-configdialog"
>&kate;'s configuration</link
>. These tools invoke external
applications with data related to the current document, for example its URL,
directory, text or selection. This page allows you to manage the menu and edit,
remove or add new tools.</para>

<para
>Each external tool is a shell command which contains macros representing
the document data. When activated, the macros are substituted with data from the
active document.</para>

<variablelist>
<title
>Available Commands</title>

<varlistentry>
<term
><guibutton
>New</guibutton
></term>
<listitem
><para
>Add a new external tool to the list.  This will launch the property
sheet described below where you can configure an external tool.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Edit</guibutton
></term>
<listitem
><para
>Edit the currently selected external tool, using the property
sheet described below.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Insert Separator</guibutton
></term>
<listitem
><para
>Adds a separator line that appears in the menu below the currently
selected item.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Up Arrow</guibutton
></term>
<listitem
><para
>Moves the currently selected item above the previous
one.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Down Arrow</guibutton
></term>
<listitem
><para
>Moves the currently selected item below the subsequent
one.</para
></listitem>
</varlistentry>

</variablelist>

<variablelist>
<title
>External Tools Properties</title>
<varlistentry>
<term
><guilabel
>Label</guilabel
></term>
<listitem
><para
>A friendly label that will appear in the <guisubmenu
>External Tools</guisubmenu
> menu.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Icon</guibutton
></term>
<listitem
><para
>Allows you to select an icon that appears next to the label in the
<guisubmenu
>External Tools</guisubmenu
> menu.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Script</guilabel
></term>
<listitem
><para
>The script to execute when the tool is activated. Before passing
the script to the shell, the following macros are substituted:

<variablelist>
<varlistentry>
<term
><userinput
>%URL</userinput
></term>
<listitem
><para
>The full URL of the current document, or an empty string if the
document is unsaved.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%URLs</userinput
></term>
<listitem
><para
>A space separated list of the URLs of all open documents
(except unsaved ones).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%directory</userinput
></term>
<listitem
><para
>The directory part of the current documents URL or an empty
string if the current document is unsaved.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%filename</userinput
></term>
<listitem
><para
>The filename of the current document without the path, or an
empty string if the current document is unsaved.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%line</userinput
></term>
<listitem
><para
>The line number of the insertion cursor is in the current
document.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%column</userinput
></term>
<listitem
><para
>The column number of the insertion cursor in the current
document.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%selection</userinput
></term>
<listitem
><para
>The selected text in the current document, or an empty string
if no text is selected</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>%text</userinput
></term>
<listitem
><para
>The full text of the current document. Beware that this may
potentially exceed the maximum command length allowed on your system.
Use with care.</para
></listitem>
</varlistentry>

</variablelist>

</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Executable</guilabel
></term>
<listitem
><para
>The main executable in the script. This is mandatory, and is used
to test if the command can be run at all. A fully qualified path is allowed
in case the executable is not in your <envar
>PATH</envar
> variable.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Mime types</guilabel
></term>
<listitem
><para
>A semicolon separated list of mimetypes for which this command
should be enabled.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Save</guilabel
></term>
<listitem
><para
>You can optionally select to have the current or all documents
saved prior to executing the script. This is handy if your script reads the file
from disk.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Command line name</guilabel
></term>
<listitem
><para
>If you fill this, the tool will be available in the
<link linkend="advanced-editing-tools-commandline"
>editors command line</link
> as
<command
>exttool-<replaceable
>Command Line Name</replaceable
></command>
(the string you enter here prepended <quote
>exttool-</quote
>).</para
></listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1
>-->

 <!--
 FIXME: replaced by built-in functionality in 4.12
        lots of this is wrong, other parts need to be moved somewhere else
<sect1 id="kate-application-plugin-snippets">
<sect1info>
<authorgroup>
<author
><firstname
>Martin</firstname
> <surname
>Gergov</surname
></author>
<author
>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
</authorgroup>
</sect1info>
<title
>Kate Snippets</title>

<sect2 id="snippets-intro">
<title
>Introduction</title
>       
<para
>Kate Snippets is a plugin used to save you some time by adding support for
so-called <quote
>snippets</quote
> (re-usable source code, machine code or text). The plugin
also supports code completion and QtScript.</para>
</sect2>

<sect2 id="snippets-menu">
<title
>Menu Structure</title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>View</guimenu
><guisubmenu
>Tool Views</guisubmenu>
<guimenuitem
>Show Snippets</guimenuitem
></menuchoice
></term>
<listitem
><para
>Shows snippets panel containing all snippets in your repository
that are for the currently opened file type.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="snippets-panel">
<title
>Snippets panel</title>

<screenshot id="screenshot-snippets-panel">
<screeninfo
>Kate Snippets Panel</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="snippets-panel.png" format="PNG"/></imageobject>
<textobject
><phrase
>The &kate; snippets panel.</phrase
></textobject>
<caption
><para
>The panel for &kate; Snippets.</para
></caption>
</mediaobject>
</screenshot>

<para
>In the panel you should see a list of snippet repositories,
along with options to create your own, get them from the Internet or load
them from a local file.  Each repository has a checkbox that can be used to
activate or deactivate it.  There are also buttons to edit and delete existing
repositories.</para>

<sect3 id="snippets-repo-internet">
<title
>Loading Snippet Repository Files</title>
<para
>You can download snippet repositories from the Internet.  Just click 
<guibutton
>Get New Snippets</guibutton
> and a window with a list of snippet 
repositories will open.  After downloading the desired snippet, make sure that
you have activated it.</para>
<!- -FIXME no way to load a local file ?- ->
<para
>You can also load snippet repositories from a local file using the file
browser at the bottom of the panel.  Click <guibutton
>Copy to repository</guibutton>
when finished.</para>
</sect3>

<sect3 id="snippets-repo-editor">
<title
>Creating and Editing Snippets</title>

<screenshot id="screenshot-snippets-form">
<screeninfo
>Snippet Editor</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="snippets-form.png" format="PNG"/></imageobject>
<textobject
><phrase
>The snippet editor.</phrase
></textobject>
<caption
><para
>The snippet editor interface.</para
></caption>
</mediaobject>
</screenshot>

<para
>To create a new snippet repository, click <guibutton
>New Snippet File</guibutton
>.
You should now see a dialog that asks for the name of the snippet file, license and
author.  After choosing the desired options, click <guibutton
>Create</guibutton
>,
and the snippet editor will open.</para>

<para
>The snippet editor contains the following options:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>File Type</guilabel
></term>
<listitem
><para
>Select the file type(s) you want the snippet repository to apply
to.  It is set to <quote
>*</quote
> by default, so the repository applies to all files.  You 
can change it to something like <userinput
>C++</userinput
> for instance, or select
from a list by hitting the <guibutton
>Edit</guibutton
>.  You can specify more
than one file type by separating them with <userinput
>;</userinput
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Authors</guilabel
></term>
<listitem
><para
>Enter the name(s) of the author(s) of the snippet file.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Snippets List</term>
<listitem
><para
>Contains all snippets defined in the snippet file.  You can
simply click on a snippet listed there to edit it.</para
></listitem>
</varlistentry>
    
<varlistentry>
<term
>Add (<guibutton
>+</guibutton
>)</term>
<listitem
><para
>Used to add a new snippet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Delete (<guibutton
>-</guibutton
>)</term>
<listitem
><para
>Used to delete a snippet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Match/Name</guilabel
></term>
<listitem
><para
>Appears in the list of snippets in the tool view and is also
searched when using the code completion feature.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Display Prefix</guilabel
>, <guilabel
>Display Postfix</guilabel
>,
and <guilabel
>Display Arguments</guilabel
></term>
<listitem
><para
>Used to display helpful information while using code completion.
The prefix and postfix are displayed before and after the name, while the arguments
are displayed in parenthesis immediately after the name.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Snippet Content</guilabel
></term>
<listitem
><para
>Reusable text or code.  This is what appears in your document
when the snippet is used.</para
></listitem>
</varlistentry>

</variablelist>

<para
>In <guilabel
>Snippet Content</guilabel
> you can specify variables with 
<userinput
>${<replaceable
>name</replaceable
>}</userinput
> or
<userinput
>%{<replaceable
>name</replaceable
>}</userinput
>.  These can be filled
by QtScript or when the snippet is used.  There is a special variable - 
${cursor} or %{cursor} - which automatically sets the cursor to its first 
occurrence.</para>

</sect3>
</sect2>

<sect2 id="snippets-using">
<title
>Using Snippets</title>

<screenshot id="screenshot-snippets-usage">
<screeninfo
>Kate Snippets in Action</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="snippets-usage.png" format="PNG"/></imageobject>
<textobject
><phrase
>Accessing &kate; Snippets from a tool view and a drop down menu.</phrase
></textobject>
<caption
><para
>Selecting from a list of snippets.</para
></caption>
</mediaobject>
</screenshot>

<para
>You can call snippets in two ways:</para>

<itemizedlist>
<listitem
><para
>By choosing the snippet from the tool view.</para
></listitem>
<listitem
><para
>While writing, you can press <keycombo action="simul"
>&Ctrl;
<keysym
>Space</keysym
></keycombo
>, which will display all the snippets in a
convenient window from which you can choose.  You may enter the beginning
of the snippets name before or after pressing this key combination, which provides
functionality similar to code completion.</para
></listitem>
</itemizedlist>

<para
>If the snippet contains variables (besides <literal
>${cursor}</literal
>)
the cursor will automatically go to the first occurrence of a variable and will
wait for you to write something. When you are done, you can press &Tab; to move
to the next variable, and so on.</para>

</sect2>

<sect2 id="snippets-ack">
<title
>Thanks and Acknowledgments</title>
<para
>&kate; Snippets was written by Joseph Wenninger.</para>
<para
>Special thanks to Google Code-In 2011 participant Martin Gergov for
writing much of this section.</para>
</sect2>

</sect1>
-->

<sect1 id="kate-application-plugin-build">
<!--http://kate-editor.org/2011/06/21/kate-plugin-updates-part-1/ -->
<sect1info>
<authorgroup>
<author
><firstname
>Salma</firstname
> <surname
>Sultana</surname
></author>
<author
>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
</authorgroup>
</sect1info>
<title
>Bygginsticksprogram</title>

<sect2 id="build-intro">
<title
>Inledning</title>

<para
>Bygginsticksprogrammet låter dig utföra åtgärder som bygg, rensa och kompilera för ett projekt.</para>

<!--When you first install Kate, you need to enable the plugin:

Click `Settings → Configure Kate`

In the tree on the left of the screen, click `Plugins`.

In the `Plugin Manager` panel on the right, select `Build plugin`, and then click `OK`.-->

</sect2>

<sect2 id="build-using">
<title
>Använda bygginsticksprogrammet</title>

<para
>Bygginsticksprogrammet lägger till verktygsvyn <guilabel
>Byggutmatning</guilabel
> längst ner och menyn <guimenu
>Bygg</guimenu
> i menyraden. Verktygsvyn kan användas för att anpassa inställningar av byggmål, medan menyn kan användas för att bygga, rensa och kompilera.</para>


<para
>Verktygsvyn <guilabel
>Byggutmatning</guilabel
> har tre flikar:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Målinställningar</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Utmatning</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Fel och varningar</guilabel
></para
></listitem>
</itemizedlist>

<sect3 id="build-using-target-settings">
<title
>Fliken målinställningar</title>

<para
>Fliken målinställningar kan användas för att anpassa diverse byggmål.</para>

<para
>Varje mål innehåller fyra inställningsalternativ:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Arbetskatalog</guilabel
></term>
<listitem
><para
>Här kan sökvägen till projektet anges. Lämna den tom för att använda katalogen där aktuellt dokument finns.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Bygg</guilabel
></term>
<listitem
><para
>Alternativen låter dig definiera byggkommandot. Det är normalt inställt till <command
>make</command
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Rensa</guilabel
></term>
<listitem
><para
>Alternativen låter dig definiera rensningskommandot. Det är normalt inställt till <command
>make clean</command
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Snabbkompilering</guilabel
></term>
<listitem
><para
>Alternativen låter dig definiera snabbkompileringskommandot. Det är normalt inställt till <command
>gcc -Wall -g %f</command
>.</para
></listitem>
</varlistentry>
</variablelist>

<para
>Man kan skapa ett nytt mål genom att använda knappen <guibutton
>Ny</guibutton
>. Knappen <guibutton
>Kopiera</guibutton
> kan användas för att skapa en kopia av ett befintligt mål. Använd knappen <guibutton
>Ta bort</guibutton
> för att ta bort ett mål.</para>

</sect3>

<sect3 id="build-using-output">
<title
>Fliken Utmatning</title>

<para
>Fliken <guilabel
>Utmatning</guilabel
> visar terminalutmatningen som genererades av det senaste kommandot.</para>

</sect3>

<sect3 id="buiid-using-errors">
<title
>Fel och varningar</title>

<para
>Fliken <guilabel
>Fel och varningar</guilabel
> listar felen och varningarna som orsakades av det senaste kommandot.</para>

<para
>Varje rad innehåller ett meddelande, filnamnet och radnumret om tillgängligt. Att klicka på felet eller varningen går till lämplig fil och placerar markören på motsvarande radnummer.</para>

<para
>Knapparna <guibutton
>Fel</guibutton
>, <guibutton
>Varningar</guibutton
> och <guibutton
>Övrigt</guibutton
> finns längst upp för att låta dig visa eller dölja dessa kategorier av utdata.</para>

<!--FIXME: These shortcuts now seem to be used by the Project plugin in 4.11.
            https://bugs.kde.org/show_bug.cgi?id=328170 -->
<para
>För att gå till föregående fel, tryck på <keycombo action="simul"
>&Ctrl;&Alt;<keysym
>Vänster</keysym
></keycombo
>. För att gå till nästa fel, tryck på <keycombo action="simul"
>&Ctrl;&Alt;<keysym
>Höger</keysym
></keycombo
>.</para>

</sect3>
</sect2>

<sect2 id="build-menu">
<title
>Menystruktur</title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Bygg</guimenu
> <guimenuitem
>Bygg</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Kör kommandot <guilabel
>Bygg</guilabel
> för målet som för närvarande är valt.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Bygg</guimenu
> <guimenuitem
>Rensa</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Kör kommandot <guilabel
>Rensa</guilabel
> för målet som för närvarande är valt.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Bygg</guimenu
> <guimenuitem
>Snabbkompilering</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Kör kommandot <guilabel
>Snabbkompilera</guilabel
> för målet som för närvarande är valt.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Alt;<keysym
>Left</keysym
></keycombo
></shortcut
> <guimenu
>Bygg</guimenu
><guimenuitem
>Föregående fel</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Flyttar markören till platsen för det föregående felet i dokumentet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Alt;<keysym
>Höger</keysym
></keycombo
></shortcut
> <guimenu
>Bygg</guimenu
><guimenuitem
>Nästa fel</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Flyttar markören till platsen för det nästa felet i dokumentet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Bygg</guimenu
><guimenuitem
>Mål</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Välj från en lista med mål inställda av användaren.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Bygg</guimenu
><guimenuitem
>Nästa mål</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Byt till nästa mål inställt av användaren.</para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="build-ack">
<title
>Tack och erkännanden</title>
<para
>&kate;s bygginsticksprogram är skrivet av Kåre Särs.</para>
<para
>Särskilt tack till deltagaren i Google Code-In 2011, Salma Sultana, för att ha skrivit stora delar av det här avsnittet.</para>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-sql">
<sect1info>
<authorgroup>
<author
><firstname
>Ömer</firstname
> <othername
>Faruk</othername
> <surname
>ORUÇ</surname
></author>
<author
>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
</authorgroup>
</sect1info>
<title
>SQL-insticksprogram</title>

<sect2 id="sql-intro">
<title
>Inledning</title>

<para
>Structured Query Language (SQL) är ett specialiserat språk för att uppdatera, ta bort och efterfråga information i databaser.</para>

<para
>&kate;s SQL-insticksprogram låter dig:</para>

<itemizedlist>
<listitem
><para
>Skapa en databas</para
></listitem>
<listitem
><para
>Ansluta till befintliga databaser</para
></listitem>
<listitem
><para
>Infoga och ta bort data i databasen</para
></listitem>
<listitem
><para
>Utföra en förfrågan</para
></listitem>
<listitem
><para
>Visa resultat i en tabell</para
></listitem>
</itemizedlist>

<!--If Kate is installed on your computer, at first open Kate.
If Kate isn't installed on your computer, download and install it.

Using SQL Plugin
After opening the Kate;
Click Settings→ Configure Kate
and then;
Click Application → Select Plugins in the tree widget

In the Plugin Manager panel on the right, check SQL Plugin and click OK.
-->

</sect2>

<sect2 id="sql-connecting">
<title
>Ansluta till en databas</title>

<para
>Använd <guibutton
>Lägg till anslutning</guibutton
> i menyn <guimenu
>SQL</guimenu
> eller i verktygsraden, och välj därefter den Qt-databasdrivrutin du vill använda (inklusive QSQLITE, QMYSQL3, QMYSQL, QODBC3, QODBC, QPSQL7 och QPSQL). Om du inte kan se en önskad drivrutin, måste den installeras. Klicka därefter på <guibutton
>Nästa</guibutton
>. </para>

<para
>Om databasen du valde använder en fil, ange helt enkelt databasens plats och klicka på knappen <guibutton
>Nästa</guibutton
>. Om den kräver anslutning till en server, måste du skriva in serverns värddatornamn, ditt användarnamn och lösenord, och eventuell ytterligare information som just den drivrutinen kräver. Klicka därefter på <guibutton
>Nästa</guibutton
>.</para>

<para
>Ge till sist anslutningen ett namn, och klicka på <guibutton
>Slutför</guibutton
>.</para>

</sect2>

<sect2 id="sql-querying">
<title
>Starta en förfrågan</title>

<sect3 id="sql-querying-insert-delete-update">
<title
>INSERT/DELETE/UPDATE</title>

<para
>Du kan infoga, ta bort och uppdatera data med SQL-insticksprogrammet, precis som du skulle göra på kommandoraden eller inne i ett program. Skriv helt enkelt in en förfrågan och klicka på knappen <guibutton
>Utför förfrågan</guibutton
>.</para>

<example>
<title
>Några exempel på en förfrågan</title>
<variablelist>

<varlistentry>
<term
><command
>INSERT</command
></term>
<listitem
><para
><programlisting
>INSERT INTO <replaceable
>tabellnamn</replaceable
> ("<replaceable
>nyckel-1</replaceable
>", "<replaceable
>nyckel-2</replaceable
>", "<replaceable
>nyckel-3</replaceable
>", "<replaceable
>nyckel-4</replaceable
>", "<replaceable
>nyckel-5</replaceable
>")
VALUES ("<replaceable
>värde-1</replaceable
>", "<replaceable
>värde-2</replaceable
>", "<replaceable
>värde-3</replaceable
>", "<replaceable
>värde-4</replaceable
>", "<replaceable
>värde-5</replaceable
>" )
</programlisting
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><command
>DELETE</command
></term>
<listitem
><para
><programlisting
>DELETE FROM <replaceable
>tabellnamn</replaceable
> WHERE name = "<replaceable
>text</replaceable
>"
</programlisting
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><command
>UPDATE</command
></term>
<listitem
><para
><programlisting
>UPDATE <replaceable
>tabellnamn</replaceable
> SET "<replaceable
>nyckel-1</replaceable
>" = "<replaceable
>text</replaceable
>", "<replaceable
>nyckel-2</replaceable
>" = "<replaceable
>text</replaceable
>", "<replaceable
>nyckel-3</replaceable
>" = "<replaceable
>text</replaceable
>", "<replaceable
>nyckel-4</replaceable
>" = "<replaceable
>text</replaceable
>", "<replaceable
>nyckel-5</replaceable
>" = "<replaceable
>text</replaceable
>"
</programlisting
></para
></listitem>
</varlistentry>

</variablelist>
</example>

</sect3>

<sect3 id="sql-querying-select">
<title
>SELECT</title>

<para
>Efter att ha utfört förfrågan <command
>SELECT</command
>, kan resultatet ses som en tabell som dyker upp i verktygsvyn <guilabel
>SQL-datautmatning</guilabel
> längst ner i &kappname;, eller som text under <guilabel
>SQL-textutmatning</guilabel
>. Om ett fel uppstår visas det i textutmatningen.</para>

<example>
<title
>Exempel på <command
>SELECT</command
>-förfrågan</title>
<para
><programlisting
>SELECT * FROM <replaceable
>tabellnamn</replaceable
>
</programlisting
></para>
</example>

<para
>I verktygsvyn <guilabel
>SQL-datautmatning</guilabel
> finns flera knappar:</para>

<variablelist>

<varlistentry>
<term
><guibutton
>Ändra storlek på kolumner till innehållet</guibutton
></term>
<listitem
><para
>Ändra storlek på kolumner så att de passar till innehållet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Ändra storlek på rader till innehållet</guibutton
></term>
<listitem
><para
>Ändra storlek på rader så att de passar till innehållet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Kopiera</guibutton
></term>
<listitem
><para
>Markerar hela tabellens innehåll och kopierar det till klippbordet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Exportera</guibutton
></term>
<listitem
><para
>Exporterar hela tabellens innehåll till en fil, eller det nuvarande dokumentet med formatet kommaseparerade värden (CSV).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Rensa</guibutton
></term>
<listitem
><para
>Ta bort allt från tabellvyn.</para
></listitem>
</varlistentry>

</variablelist>

<para
>Nu kan du ändra färgerna som visas i tabellen på sidan <guilabel
>SQL</guilabel
> i <menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa &kate;</guimenuitem
> </menuchoice
>.</para>

</sect3>
</sect2>

<sect2 id="sql-browsing">
<title
>Bläddring</title>

<para
>Du kan bläddra i databasen med verktygsvyn <guilabel
>SQL-schemabläddrare</guilabel
> till vänster. Informationen som visas beror på vilken databasdrivrutin som används.</para>

<para
>Högerklicka var som helst i verktygsvyn och välj <guimenuitem
>Uppdatera</guimenuitem
> för att uppdatera listan. För att skapa en förfrågan för någon post i listan, högerklicka på en post, välj <guisubmenu
>Skapa</guisubmenu
> och välj frågetyp (<guimenuitem
>SELECT</guimenuitem
>, <guimenuitem
>UPDATE</guimenuitem
>, <guimenuitem
>INSERT</guimenuitem
> eller <guimenuitem
>DELETE</guimenuitem
>) i undermenyn som visas.</para>

</sect2>

<sect2 id="sql-menus">
<title
>Menystruktur</title>
<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>SQL</guimenu
> <guimenuitem
>Lägg till anslutning...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Lägger till en ny anslutning med användning av vilken databasdrivrutin som helst. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>SQL</guimenu
> <guimenuitem
>Ta bort anslutning</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Tar bort den markerade anslutningen. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>SQL</guimenu
> <guimenuitem
>Redigera anslutning...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Redigerar den nuvarande anslutningens inställningar. </para
></listitem>
</varlistentry>

<varlistentry>
<term
>Anslutningar</term>
<listitem
><para
>Alla databasanslutningar som du har skapat listas mellan menyalternativen <guimenuitem
>Redigera anslutning</guimenuitem
> och <guimenuitem
>Utför förfrågan</guimenuitem
>. Välj en för att utföra en förfrågan eller göra ändringar i den. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>E</keycap
></keycombo
></shortcut
> <guimenu
>SQL</guimenu
><guimenuitem
>Utför förfrågan</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Utför din förfrågan. </para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="sql-ack">
<title
>Tack och erkännanden</title>

<para
>SQL-insticksprogrammet är skrivet av Marco Mentasti.</para>
<para
>Särskilt tack till deltagaren i Google Code-In 2011, Ömer Faruk Oruç, för att ha skrivit stora delar av det här avsnittet.</para>

</sect2>

</sect1>

<sect1 id="kate-application-plugin-gdb">
<!--http://kate-editor.org/2011/06/23/kate-plugin-updates-part-2/-->
<sect1info>
<authorgroup>
<author
><firstname
>Martin</firstname
> <surname
>Gergov</surname
></author>
<author
>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
</authorgroup>
</sect1info>
<title
>Insticksprogram för &gdb;</title>

<sect2 id="gdb-intro">
<title
>Inledning</title>

<para
>Insticksprogrammet för &gdb; i &kappname; tillhandahåller ett enkelt gränssnitt för den populära avlusaren från &GNU;-projektet.</para>

<important>
<para
>Tidigare erfarenhet av &gdb; rekommenderas starkt. För mer information om att använda &gdb;, besök <ulink url="http://www.gnu.org/s/gdb/"
>&gdb;:s hemsida</ulink
>.</para>
</important>

<para
>Insticksprogrammet för &gdb; kan aktiveras på <link linkend="config-dialog-plugins"
>sidan med insticksprogram i &kappname;s inställningar</link
>.</para>

<para
>För att insticksprogrammet ska fungerar riktigt, måste du ha en källkodsfil (av vilken typ som helst som stöds av &gdb;) och ett körbart program.</para>

<tip>
<para
>Om du kompilerar med &gcc;/<command
>g++</command
> bör du kanske använda kommandoradsväljaren <command
><parameter
>-ggdb</parameter
></command
>. </para>
</tip>

<para
>Efter dessa förberedelser har gjorts, öppna källkodsfilen i &kappname;, skriv in sökvägen till det körbara programmet under fliken <guilabel
>Inställningar</guilabel
> i verktygsvyn <guilabel
>Avlusningsvy</guilabel
>, och välj <menuchoice
><guimenu
>Avlusa</guimenu
> <guimenuitem
>Starta avlusning</guimenuitem
></menuchoice
> i menyn för att komma igång.</para>

</sect2>

<sect2 id="gdb-menus">
<title
>Meny- och verktygsradstruktur</title>

<para
>Alla dessa alternativ är tillgängliga i &kappname;s menyer, och många är också tillgängliga från avlusningsverktygsraden.</para>

<variablelist>

<varlistentry id="gdb-menus-show-debug-view">
<term
><menuchoice
><guimenu
>Visa</guimenu
> <guisubmenu
>Verktygsvyer</guisubmenu
> <guimenuitem
>Visa avlusningsvy</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Visar en verktygsvy som innehåller utmatning från &gdb;, kommandoraden för &gdb; som använts, och andra inställningar.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-show-locals">
<term
><menuchoice
><guimenu
>Visa</guimenu
> <guisubmenu
>Verktygsvyer</guisubmenu
> <guimenuitem
>Visa lokala objekt</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Visar en lista med alla variabler som för närvarande är inlästa och deras värden. </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-show-call-stack">
<term
><menuchoice
><guimenu
>Visa</guimenu
> <guisubmenu
>Verktygsvyer</guisubmenu
> <guimenuitem
>Visa anropsstack</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Visar en bakåtspårning från &gdb;.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-targets">
<term
><menuchoice
><guimenu
>Avlusa</guimenu
><guimenuitem
>Mål</guimenuitem
> </menuchoice
></term>
<listitem
><para
>En undermeny som innehåller en lista med mål (körbara program). </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-arg-lists">
<term
><menuchoice
><guimenu
>Avlusa</guimenu
><guimenuitem
>Argumentlistor</guimenuitem
> </menuchoice
></term>
<listitem
><para
>En undermeny som innehåller alla argumentlistor.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-start">
<term
><menuchoice
><guimenu
>Avlusa</guimenu
> <guimenuitem
>Starta avlusning</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Startar &gdb; med ett mål.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-kill">
<term
><menuchoice
><guimenu
>Avlusa</guimenu
> <guimenuitem
>Döda eller stoppa avlusning</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Stoppar &gdb;.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-restart">
<term
><menuchoice
><guimenu
>Avlusa</guimenu
> <guimenuitem
>Starta om avlusning</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Startar om &gdb;.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-break">
<term
><menuchoice
><guimenu
>Avlusa</guimenu
> <guimenuitem
>Växla brytpunkt</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Sätt en brytpunkt på markörens nuvarande position. </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-step-in">
<term
><menuchoice
><guimenu
>Avlusa</guimenu
> <guimenuitem
>Stega in i</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Kör aktuell sats (funktionsanrop avlusas). </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-step-over">
<term
><menuchoice
><guimenu
>Avlusa</guimenu
> <guimenuitem
>Stega förbi</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Kör aktuell sats (funktionsanrop avlusas inte)</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-step-out">
<term
><menuchoice
><guimenu
>Avlusa</guimenu
> <guimenuitem
>Stega ut ur</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Återupptar körning till programmet som kör avslutas.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-move-pc">
<term
><menuchoice
><guimenu
>Avlusa</guimenu
> <guimenuitem
>Flytta programräknare</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Flyttar programräknaren (nästa körning).</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-run-to-cursor">
<term
><menuchoice
><guimenu
>Avlusa</guimenu
> <guimenuitem
>Kör till markören</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Kör programmet till det når nuvarande markörposition. </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-continue">
<term
><menuchoice
><guimenu
>Avlusa</guimenu
> <guimenuitem
>Fortsätt</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Ignorerar eventuella brytpunkter och kör programmet till det avslutas (med lyckat resultat eller inte).</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-print-value">
<term
><menuchoice
><guimenu
>Avlusa</guimenu
> <guimenuitem
>Skriv ut värde</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Skriver ut värdet på variabeln som markören för närvarande pekar på.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-toolbar">
<term
><menuchoice
><guimenu
>Inställningar</guimenu
> <guisubmenu
>Visade verktygsrader</guisubmenu
> <guimenuitem
>Insticksprogram för &gdb;</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Visar avlusningsverktygsraden.</para
></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="gdb-debug-view">
<title
>Avlusningsvy</title>

<para
>Verktygsvyn <guilabel
>Avlusningsvy</guilabel
> består av flera flikar: </para>

<variablelist>

<varlistentry>
<term
><guilabel
>Utmatning från &gdb;</guilabel
></term>
<listitem>
<para
>Innehåller utmatning från &gdb; och en &gdb; kommandorad.</para>

<screenshot id="screenshot-gdb-output">
<screeninfo
>Fliken Utmatning</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-output.png" format="PNG"/></imageobject>
<textobject
><phrase
>Fliken Utmatning.</phrase
></textobject>
<caption
><para
>Fliken <guilabel
>Utmatning</guilabel
> visar utmatningen från en avlusningssession.</para
></caption>
</mediaobject>
</screenshot>

</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Inställningar</guilabel
></term>
<listitem>
<variablelist>

<varlistentry>
<term
><guilabel
>Mål</guilabel
></term>
<listitem
><para
>Sökväg till mål (körbart program) att avlusa.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Arbetskatalog</guilabel
></term>
<listitem
><para
>Nuvarande arbetskatalog som tillhandahålls till målet. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Argumentlista</guilabel
></term>
<listitem
><para
>Argument som skickas till programmet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Behåll fokus</guilabel
></term>
<listitem
><para
>Behåller fokus på &gdb;:s kommandorad.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Omdirigera in- och utmatning</guilabel
></term>
<listitem
><para
>Visar en ny flik för <guilabel
>I/O</guilabel
> i <guilabel
>Avlusningsvyn</guilabel
> där du kan se utmatning från och ge inmatning till programmet som kör.</para
></listitem>
</varlistentry>

</variablelist>

<screenshot id="screenshot-gdb-settings">
<screeninfo
>Fliken Inställningar</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-settings.png" format="PNG"/></imageobject>
<textobject
><phrase
>Fliken Inställningar.</phrase
></textobject>
<caption
><para
>Fliken <guilabel
>Inställningar</guilabel
> visar inställningen för en avlusningssession.</para
></caption>
</mediaobject>
</screenshot>

</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>I/O</guilabel
></term>
<listitem>
<para
>Innehåller ett område som visar utmatning från programmet som kör och en kommandorad där du kan ange inmatning till det.</para>

<screenshot id="screenshot-gdb-io">
<screeninfo
>Fliken I/O</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-io.png" format="PNG"/></imageobject>
<textobject
><phrase
>Fliken I/O.</phrase
></textobject>
<caption
><para
>Fliken <guilabel
>I/O</guilabel
> som visar utmatning från ett enkelt testprogram.</para
></caption>
</mediaobject>
</screenshot>

</listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="gdb-other">
<title
>Anropsstack och lokala objekt</title>

<para
>Verktygsvyn <guilabel
>Anropsstack</guilabel
> innehåller en lista av formaterad bakåtspårning som returneras från &gdb;.</para>

<screenshot id="screenshot-gdb-call-stack">
<screeninfo
>Verktygsvyn Anropsstack i &gdb;</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-call-stack.png" format="PNG"/></imageobject>
<textobject
><phrase
>Verktygsvyn Anropsstack.</phrase
></textobject>
<caption
><para
>Verktygsvyn <guilabel
>Anropsstack</guilabel
> i insticksprogrammet för &gdb;. </para
></caption>
</mediaobject>
</screenshot>

<para
>Verktygsvyn <guilabel
>Lokala objekt</guilabel
> innehåller en lista över alla variabler som för närvarande är laddade från programmet, och deras motsvarande värden.</para>

<screenshot id="screenshot-gdb-locals">
<screeninfo
>Verktygsvyn Lokala objekt i &gdb;</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-locals.png" format="PNG"/></imageobject>
<textobject
><phrase
>Verktygsvyn Lokala objekt</phrase
></textobject>
<caption
><para
>Verktygsvyn <guilabel
>Lokala objekt</guilabel
> i insticksprogrammet för &gdb;. </para
></caption>
</mediaobject>
</screenshot>

</sect2>

<sect2 id="gdb-ack">
<title
>Tack och erkännanden</title>

<para
>Särskilt tack till deltagaren i Google Code-In 2011, Martin Gergov, för att ha skrivit stora delar av det här avsnittet.</para>

</sect2>

</sect1>

<sect1 id="kate-application-plugin-konsole">
<title
>Vyinsticksprogrammet Terminalverktyg</title>

<para
><indexterm
><primary
>Terminalemulator</primary
></indexterm
> Den inbyggda terminalemulatorn är en kopia av &kde;:s &konsole; terminalprogram, för bekväm användning. Den är tillgänglig via menyalternativet <menuchoice
><guimenu
>Visa</guimenu
> <guisubmenu
>Verktygsvyer</guisubmenu
> <guimenuitem
>Visa terminal</guimenuitem
></menuchoice
>, och får fokus så fort den visas. Dessutom, om alternativet <link linkend="konsole-config"
>Synkronisera automatiskt terminalen med nuvarande dokument om möjligt</link
> är aktiverat, så byter den till det nuvarande dokumentets katalog om möjligt när den visas, eller när nuvarande dokument ändras.</para>

<para
>Den normala platsen i &kate;:s fönster är längst ner, under redigeringsområdet.</para>

<para
>Du kan anpassa terminalen, med menyn som visas med höger musknapp. För mer information, se <ulink url="help:/konsole/index.htm"
>handboken för Terminal</ulink
>.</para>

<para
>Den inbyggda terminalemulatorn tillhandahålls av vyinsticksprogrammet Terminalverktyg, som normalt är aktiverat.</para>

<sect2 id="konsole-menus">
<title
>Menystruktur</title>

<variablelist>

<varlistentry>
<term>
<anchor id="view-toolviews-show-konsole"/>
<menuchoice
><guimenu
>Visa</guimenu
> <guisubmenu
>Verktygsvyer</guisubmenu
> <guimenuitem
>Visa Terminal</guimenuitem
> </menuchoice>
</term>
<listitem>
<para
>Visar eller döljer den inbyggda terminalemulatorn.</para>
<para
>När det aktiveras för första gången, skapas terminalen.</para>
<para
>När terminalemulatorn visas, så får den fokus, så att du kan börja skriva in kommandon omedelbart. Om alternativet <link linkend="konsole-config"
>Synkronisera automatiskt terminalen med nuvarande dokument om möjligt</link
> är aktiverat på sidan <guilabel
>Terminal</guilabel
> i den huvudsakliga <link linkend="config-dialog"
>inställningsdialogrutan</link
>, så byter skalsessionen arbetskatalog till katalogen för det aktiva dokumentet, om det är en lokal fil.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Verktyg</guimenu
> <guimenuitem
>Skicka till terminal</guimenuitem
></menuchoice
></term>
<listitem
><para
>Skicka texten som för närvarande är markerad till den inbyggda terminalemulatorn. Någon nyrad läggs inte till efter texten.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><anchor id="tools-sync-terminal-document"/><menuchoice
><guimenu
>Verktyg</guimenu
> <guimenuitem
>Synkronisera terminalen med nuvarande dokument</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Detta gör att den inbyggda terminalen byter arbetskatalog med <command
>cd</command
> till det aktiva dokumentets katalog.</para>

<para
>Som ett alternativ kan du ställa in &kappname; att alltid hålla terminalen synkroniserad med aktuellt dokument. Se <xref linkend="konsole-config"/> för mer information.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><anchor id="tools-focus-terminal"/><menuchoice
><guimenu
>Verktyg</guimenu
> <guimenuitem
>Ge fokus till/Ta bort fokus från ' terminalen</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Byt fokus från aktuellt dokument till terminalen och vice versa. </para>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="konsole-config">
<title
>Inställning</title>

<para
>Du kan ställa in vyinsticksprogrammet Terminalverktyg på sidan <guilabel
>Terminal</guilabel
> i <link linkend="configuring-kate"
>inställningsdialogrutan</link
>.</para>

<para
>Följande alternativ är tillgängliga:</para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Synkronisera automatiskt terminalen med aktuellt dokument om möjligt</guilabel
></term>
<listitem
><para
>Det gör att den inbyggda terminalen att byta katalog med <command
>cd</command
> till katalogen för det aktiva dokumentet, när den startas, och när ett nytt dokument får fokus. Om det inte aktiveras, måste du flytta dig i terminalen själv. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ställ in miljövariabeln EDITOR till 'kate -b'</guilabel
></term>
<listitem
><para
>Detta ställer in miljövariabeln <envar
>EDITOR</envar
> så att program som kör i den inbyggda terminalen som automatiskt öppnar en fil i editorn, öppnar dem i &kate; istället för standardeditorn som är inställd i skalet. Du kommer inte att kunna fortsätta använda terminalen innan du har stängt filen i &kate;, så att det anropande programmet är medvetet om att du är klar med redigeringen av filen.</para
></listitem>
</varlistentry>

</variablelist>
</sect2>

</sect1>

<!--
Missing (according to config docs)
Additional pages for enabled plugins:
Backtrace Browser
Symbol Viewer
-->
</chapter>
