<chapter id="advanced-editing-tools">
<chapterinfo>
<authorgroup>
<author
>&Anders.Lund; &Anders.Lund.mail;</author>
<author
>&Dominik.Haumann; &Dominik.Haumann.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
>Avancerade redigeringsverktyg</title>

<sect1 id="advanced-editing-tools-comment">

<title
>Kommentera/avkommentera</title>

<para
>Kommandona kommentera och avkommentera, som är tillgängliga i menyn <guimenu
>Verktyg</guimenu
>, låter dig lägga till eller ta bort kommentarmarkeringar i den markerade texten, eller den nuvarande raden, om ingen text är markerad, om kommentarer stöds av textformatet som du redigerar.</para>

<para
>Reglerna för hur kommentarer ser ut definieras av syntaxdefinitionerna, så om syntaxfärgläggning inte används, så är det inte möjligt att kommentera eller avkommentera. </para>

<para
>Vissa format definierar kommentarmarkeringar för enstaka rader, vissa för flera rader och vissa både ock. Om kommentarmarkeringar för flera rader inte är tillgängliga, så är det inte möjligt att kommentera en markering där den sista raden inte ingår helt och hållet.</para>

<para
>Om det finns en kommentarmarkering för enstaka rader, så föredras kommentarer för enstaka rader när det är möjligt, eftersom detta hjälper till att undvika problem med nästlade kommentarer.</para>

<para
>När kommentarmarkeringar tas bort, så ska inte någon okommenterad text markeras. När kommentarmarkeringar för flera rader tas bort från en markering, så ignoreras eventuella blanktecken utanför kommentarmarkeringen.</para>

<para
><indexterm
><primary
>kommentera</primary
></indexterm
> För att lägga till kommentarmarkeringar, använd menyalternativet <menuchoice
><guimenu
>Verktyg</guimenu
><guimenuitem
>Kommentera</guimenuitem
></menuchoice
> eller motsvarande snabbtangent, som normalt är <keycombo action="simul"
>&Ctrl;<keycap
>D</keycap
></keycombo
>.</para>

<para
><indexterm
><primary
>avkommentera</primary
></indexterm
> För att ta bort kommentarmarkeringar, använd menyalternativet <menuchoice
><guimenu
>Verktyg</guimenu
><guimenuitem
>Avkommentera</guimenuitem
></menuchoice
> eller motsvarande snabbtangent, som normalt är <keycombo action="simul"
>&Ctrl; <keycap
>Skift</keycap
> <keycap
>D</keycap
></keycombo
>.</para>

</sect1>

<sect1 id="advanced-editing-tools-commandline">
<title
>Editorkomponentens kommandorad</title>

<para
>&kappname;s editorkomponent har en intern kommandorad, som låter dig utföra vissa åtgärder från ett minimalt grafiskt gränssnitt. Kommandoraden är ett textinmatningsfält längst ner i redigeringsområdet. För att visa den, välj <menuchoice
><guimenu
>Visa</guimenu
> <guimenuitem
>Byt till kommandorad</guimenuitem
></menuchoice
> eller använd snabbtangenten (normalt <keycombo action="simul"
><keycap
>F7</keycap
></keycombo
>). Editorn tillhandahåller en uppsättning kommandon som är dokumenterade nedan, och ytterligare kommandon kan tillhandahållas av insticksprogram.</para>

<para
>Skriv in kommandot och tryck på returtangenten för att utföra det. Kommandoraden anger om kommandot lyckades och visar kanske ett meddelande. Om du kom till kommandoraden genom att trycka på <keycap
>F7</keycap
> döljs den automatiskt efter några sekunder. För att rensa meddelandet och skriva in ett nytt kommando, tryck på <keycap
>F7</keycap
> igen.</para>

<para
>Kommandoraden har ett inbyggt hjälpsystem, skriv in kommandot <command
>help</command
> för att komma igång. För att se en lista med alla tillgängliga kommandon, skriv in <command
>help list</command
>. För att visa hjälp om ett visst kommando, skriv <command
>help <replaceable
>kommando</replaceable
></command
>.</para>

<para
>Kommandoraden har en inbyggd historik, så att du kan återanvända kommandon som redan skrivits in. För att navigera i historiken, använd tangenterna <keycap
>Uppåtpil</keycap
> och <keycap
>Neråtpil</keycap
>. När historikkommandon visas är kommandots argument markerade, vilket låter dig enkelt skriva över argumenten.</para>

<sect2 id="advanced-editing-tools-commandline-commands">
<title
>Vanliga kommandon på kommandoraden</title>

<variablelist>
<title
>Argumenttyper</title>

<varlistentry>
<term
>BOOLESK</term>
<listitem
><para
>Denna används med kommandon som sätter på eller stänger av någonting. Möjliga värden är <userinput
>on</userinput
> (på), <userinput
>off</userinput
> (av), <userinput
>true</userinput
> (sant), <userinput
>false</userinput
> (falskt), <userinput
>1</userinput
> eller <userinput
>0</userinput
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>HELTAL</term>
<listitem
><para
>Ett heltal.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>STRÄNG</term>
<listitem
><para
>En sträng, omgiven av enkla citationstecken (') eller dubbla citationstecken (") när den innehåller mellanslag.</para
></listitem>
</varlistentry>

</variablelist>



<sect3 id="advanced-editing-tools-commandline-commands-configure">
<title
>Kommandon för att anpassa editorn</title>

<para
>Dessa kommandon tillhandahålls av editorkomponenten och låter dig bara anpassa det aktiva dokumentet och vyn. Det är praktiskt om du vill använda en inställning som skiljer sig från den förvalda inställningen, till exempel för indentering. </para>

<variablelist>

<varlistentry>
<term
><cmdsynopsis
><command
>set-tab-width</command
><arg choice="req"
>HELTAL bredd</arg
></cmdsynopsis
></term>
<listitem
><para
>Ställer in tabulatorbredden till talet <userinput
>bredd</userinput
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-indent-width</command
><arg choice="req"
>HELTAL bredd</arg
></cmdsynopsis
></term>
<listitem
><para
>Ställer in indenteringsbredden till talet <userinput
>bredd</userinput
>. Används bara om du indenterar med mellanslag.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-word-wrap-column</command
><arg choice="req"
>HELTAL bredd</arg
></cmdsynopsis
></term>
<listitem
><para
>Ställer in radbredden för hård radbrytning till <userinput
>bredd</userinput
>. Detta används om du använder automatisk radbrytning för din text.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-icon-border</command
><arg choice="req"
>BOOLESK aktivera</arg
> </cmdsynopsis
></term>
<listitem
><para
>Ställer in synligheten hos ikonkanten.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-folding-markers</command
><arg choice="req"
>BOOLESK aktivera</arg
></cmdsynopsis
></term>
<listitem
><para
>Ställer in synligheten hos vikmarkörrutan.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-line-numbers</command
><arg choice="req"
>BOOLESK aktivera</arg
></cmdsynopsis
></term>
<listitem
><para
>Ställer in synligheten hos radnummerrutan.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-replace-tabs</command
><arg choice="req"
>BOOLESK aktivera</arg
></cmdsynopsis
></term>
<listitem
><para
>Om aktiverad, ersätts tabulatortecken med mellanslag medan du skriver. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-remove-trailing-space</command
><arg choice="req"
>BOOLESK aktivera</arg
></cmdsynopsis
></term>
<listitem
><para
>Om aktiverad, tas avslutande blanktecken bort så fort markören lämnar en rad.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-show-tabs</command
><arg choice="req"
>BOOLESK aktivera</arg
></cmdsynopsis
></term>
<listitem
><para
>Om aktiverad, synliggörs tabulatortecken och avslutande blanktecken med en liten punkt.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-show-indent</command
><arg choice="req"
>BOOLESK aktivera</arg
></cmdsynopsis
></term>
<listitem
><para
>Om aktiverad, synliggörs indentering av en vertikal punktlinje.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-indent-spaces</command
><arg choice="req"
>BOOLESK aktivera</arg
></cmdsynopsis
></term>
<listitem
><para
>Om aktiverad, indenterar editorn med <option
>indenteringsbredd</option
> mellanslag för varje indenteringsnivå, istället för ett tabulatortecken.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-mixed-indent</command
><arg choice="req"
>BOOLESK aktivera</arg
></cmdsynopsis
></term>
<listitem
><para
>Om aktiverad, använder &kappname; en blandning av tabulatortecken och mellanslag för indentering. Varje indenteringsnivå har bredden <option
>indenteringsbredd</option
>, och fler indenteringsnivåer optimeras så att så många tabulatortecken som möjligt används.</para>
<para
>När det utförs aktiverar kommandot dessutom indentering med mellanslag, och om indenteringsbredden inte anges ställs den in till halva <option
>tabulatorbredden</option
> för dokumentet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-word-wrap</command
><arg choice="req"
>BOOLESK aktivera</arg
></cmdsynopsis
></term>
<listitem
><para
>Aktiverar dynamisk radbrytning enligt <userinput
>aktivera</userinput
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-replace-tabs-save</command
><arg choice="req"
>BOOLESK aktivera </arg
></cmdsynopsis
></term>
<listitem
><para
>Om aktiverad, ersätts tabulatortecken med blanktecken så fort dokumentet sparas.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-remove-trailing-space-save</command
><arg choice="req"
>BOOLESK aktivera</arg
></cmdsynopsis
></term>
<listitem
><para
>Om aktiverad, tas avslutande mellanslag bort från alla rader så fort dokumentet sparas.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-indent-mode</command
><arg choice="req"
>STRÄNG namn</arg
></cmdsynopsis
></term>
<listitem
><para
>Ställer in automatiskt indenteringsläge till <userinput
>namn</userinput
>. Om <userinput
>namn</userinput
> inte känns igen, ställs läget in till 'none'. Giltiga lägen är 'none', 'normal', 'cstyle', 'haskell', 'lilypond', 'lisp', 'python', 'ruby' och 'xml'.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-auto-ident</command
><arg choice="req"
>BOOLESK skript</arg
></cmdsynopsis
></term>
<listitem
><para
>Aktivera eller inaktivera automatisk indentering.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-highlight</command
><arg choice="req"
>STRÄNG färgläggning</arg
></cmdsynopsis
></term>
<listitem
><para
>Ställer in dokumentets syntaxfärgläggningssystem. Argumentet måste vara ett giltigt färgläggningsnamn, som visas i menyn <menuchoice
><guimenu
>Verktyg</guimenu
> <guisubmenu
>Färgläggning</guisubmenu
></menuchoice
>. Kommandot tillhandahåller en lista för automatisk komplettering av dess argument.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>reload-scripts</command
></cmdsynopsis
></term>
<listitem
><para
>Läs in alla <link linkend="advanced-editing-tools-scripting"
>Javascript-filer</link
> som används av Kate,  inklusive indenterare och kommandoradskript.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>set-mode</command
><arg choice="req"
>STRÄNG läge</arg
></cmdsynopsis
></term>
<listitem
><para
>Välj filtypschema för aktuellt dokument. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>nn[oremap]</command
><arg choice="req"
>STRÄNG original</arg
> <arg choice="req"
>STRÄNG avbildad</arg
></cmdsynopsis
></term>
<listitem
><para
>Avbilda tangentsekvensen <userinput
>original</userinput
> till <userinput
>avbildad</userinput
>.</para
></listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="advanced-editing-tools-commandline-commands-edit">
<title
>Kommandon för redigering</title>

<para
>Dessa kommandon ändrar aktuellt dokument.</para>

<variablelist>
<varlistentry>
<term
><cmdsynopsis
><command
>indent</command
></cmdsynopsis
></term>
<listitem
><para
>Indenterar de markerade raderna eller den nuvarande raden.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>unindent</command
></cmdsynopsis
></term>
<listitem
><para
>Avindenterar markerade rader eller nuvarande rad.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>cleanindent</command
></cmdsynopsis
></term>
<listitem
><para
>Rensar indenteringen för markerade rader eller nuvarande rad enligt dokumentets indenteringsinställningar. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>comment</command
></cmdsynopsis
></term>
<listitem
><para
>Infogar kommentarmarkeringar för att göra markeringen, markerade rader eller nuvarande rad en kommentar enligt textformatet som definieras av dokumentets syntaxfärgläggningsdefinition.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>uncomment</command
></cmdsynopsis
></term>
<listitem
><para
>Tar bort kommentarmarkeringar från markeringen, markerade rader eller nuvarande rad enligt textformatet som definieras av dokumentets syntaxfärgläggningsdefinition.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>kill-line</command
></cmdsynopsis
></term>
<listitem
><para
>Tar bort den nuvarande raden.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>replace</command
><arg choice="req"
> STRÄNG mönster</arg
> <arg choice="req"
>STRÄNG ersättning</arg
></cmdsynopsis
></term>
<listitem
><para
>Ersätter text som matchar <userinput
>mönster</userinput
> med <userinput
>ersättning</userinput
>. Om du vill att <userinput
>mönster</userinput
> ska innehålla blanktecken, måste både <userinput
>mönster</userinput
> och <userinput
>ersättning</userinput
> placeras inom enkla eller dubbla citationstecken. Om argumenten inte är citerade, används det första ordet som <userinput
>mönster</userinput
> och resten som <userinput
>ersättning</userinput
>. Om <userinput
>ersättning</userinput
> är tom, tas varje förekomst av <userinput
>mönster</userinput
> bort.</para>
<para
>Du kan anpassa kommandot genom att lägga till ett kolon följt av en eller flera bokstäver som var och en representerar en inställning, genom att ange <userinput
>replace:alternativ mönster ersättning</userinput
>. Tillgängliga alternativ är: <variablelist>

<varlistentry>
<term
><userinput
>b</userinput
></term>
<listitem
><para
>Sök bakåt.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>c</userinput
></term>
<listitem
><para
>Sök från markörens position.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>e</userinput
></term>
<listitem
><para
>Sök bara i markeringen.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>r</userinput
></term>
<listitem
><para
>Utför en sökning med ett reguljärt uttryck. Om det anges, kan du använda <userinput
>\N</userinput
>, där N är ett tal, för att representera hittad text i ersättningssträngen.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>s</userinput
></term>
<listitem
><para
>Utför skiftlägeskänslig sökning.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>p</userinput
></term>
<listitem
><para
>Fråga efter tillåtelse att ersätta nästa förekomst.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>w</userinput
></term>
<listitem
><para
>Matcha bara hela ord.</para
></listitem>
</varlistentry>

</variablelist>

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

<varlistentry>
<term
><cmdsynopsis
><command
>date</command
><arg choice="req"
>STRÄNG format</arg
></cmdsynopsis
></term>
<listitem
><para
>Infogar en datum- och tidssträng som definieras av angivet <userinput
>format</userinput
>, eller formatet <quote
>yyyy-MM-dd hh:mm:ss</quote
> om inget anges. Följande översättningar görs när <userinput
>format</userinput
> tolkas: <informaltable
> <tgroup cols="2"
> <tbody>
<row
><entry
><literal
>d</literal
></entry
><entry
>Dagen som ett tal utan inledande nolla (1-31).</entry
></row>
<row
><entry
><literal
>dd</literal
></entry
><entry
>Dagen som ett tal med inledande nolla (01-31).</entry
></row>
<row
><entry
><literal
>ddd</literal
></entry
><entry
>Dagens förkortade lokala namn (t.ex. 'mån', 'sön').</entry
></row>
<row
><entry
><literal
>dddd</literal
></entry
><entry
>Dagens långa lokala namn (t.ex. 'måndag', 'söndag').</entry
></row>
<row
><entry
><literal
>M</literal
></entry
><entry
>Månaden som ett tal utan inledande nolla (1-12).</entry
></row>
<row
><entry
><literal
>MM</literal
></entry
><entry
>Månaden som ett tal med inledande nolla (01-12).</entry
></row>
<row
><entry
><literal
>MMMM</literal
></entry
><entry
>Månadens långa lokala namn (t.ex. 'januari', 'december').</entry
></row>
<row
><entry
><literal
>MMM</literal
></entry
><entry
>Månadens förkortade lokala namn (t.ex. 'jan', 'dec').</entry
></row>
<row
><entry
><literal
>yy</literal
></entry
><entry
>Året som ett tal med två siffror (00-99).</entry
></row>
<row
><entry
><literal
>yyyy</literal
></entry
><entry
>Året som ett tal med fyra siffror (1752-8000)</entry
></row>
<row
><entry
><literal
>h</literal
></entry
><entry
>Timman utan inledande nolla (0-23 eller 1-12 om FM/EM visas).</entry
></row>
<row
><entry
><literal
>hh</literal
></entry
><entry
>Timman med inledande nolla (00-23 eller 01-12 om FM/EM visas).</entry
></row>
<row
><entry
><literal
>m</literal
></entry
><entry
>Minuten utan inledande nolla (0-59).</entry
></row>
<row
><entry
><literal
>mm</literal
></entry
><entry
>Minuten med inledande nolla (00-59).</entry
></row>
<row
><entry
><literal
>s</literal
></entry
><entry
>Sekunden utan inledande nolla (0-59).</entry
></row>
<row
><entry
><literal
>ss</literal
></entry
><entry
>Sekunden med inledande nolla (00-59).</entry
></row>
<row
><entry
><literal
>z</literal
></entry
><entry
>Millisekunden utan inledande nolla (0-999).</entry
></row>
<row
><entry
><literal
>zzz</literal
></entry
><entry
>Millisekunden med inledande nolla (000-999).</entry
></row>
<row
><entry
><literal
>AP</literal
></entry
><entry
>Använd FM/EM visning. AP ersätts antingen av "FM" eller "EM".</entry
></row>
<row
><entry
><literal
>ap</literal
></entry
><entry
>Använd fm/em visning. ap ersätts antingen av "fm" eller "em".</entry
></row>
</tbody>
</tgroup>
</informaltable>

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

<varlistentry>
<term
><cmdsynopsis
><command
>char</command
><arg choice="req"
>STRÄNG identifierare</arg
></cmdsynopsis
></term>
<listitem>
<para
>Det här kommandot låter dig infoga enskilda tecken med deras numeriska kod, på decimal, oktal eller hexadecimal form. För att använda det, starta dialogrutan för redigeringskommandot och skriv <userinput
>char: [nummer]</userinput
> i inmatningsrutan, och tryck sedan på <guibutton
>Ok</guibutton
>.</para>

<example>
<title
>Exempel på användning av <command
>char</command
></title>

<para
>Inmatning: <userinput
>char:234</userinput
></para>
<para
>Utmatning: <computeroutput
>&#234;</computeroutput
></para>
<para
>Inmatning: <userinput
>char:0x1234</userinput
></para>
<para
>Utmatning: <computeroutput
>&#x1234;</computeroutput
></para>
</example>

</listitem>
</varlistentry>

<varlistentry>
<term>
<indexterm
><primary
>ersätt, sed-stil</primary>
<secondary
>sök, sed-stil</secondary
></indexterm>
<command
>s///[ig]</command
> <command
>%s///[ig]</command
></term>

<listitem>
<para
>Det här kommandot söker och ersätter på ett sätt som liknar sed, för den nuvarande raden, eller för hela filen (<command
>%s///</command
>).</para>

<para
>I kortet, så söks texten igenom efter en text som matchar <emphasis
>sökmönstret</emphasis
>, det reguljära uttrycket mellan det första och andra snedstrecket, och vid en träff så ersätts texten med uttrycket mellan mitten och sista delen av strängen. Parenteser i sökmönstret skapar <emphasis
>bakåtreferenser</emphasis
>, det vill säga kommandot kommer ihåg vilken del av texten som matchade inom parenteserna. De här strängarna kan återanvändas i ersättningsmönstret, med referenserna <userinput
>\1</userinput
>, för första paret parenteser, <userinput
>\2</userinput
> för det andra, och så vidare.</para>

<para
>För att söka efter tecknen <literal
>(</literal
> eller <literal
>)</literal
>, måste du <emphasis
>undanta</emphasis
> dem med ett bakstreckstecken <userinput
>\(\)</userinput
>.</para>

<para
>Om du lägger till <userinput
>i</userinput
> sist i uttrycket, blir matchningen skiftlägesokänslig. Om du lägger till <userinput
>g</userinput
> sist, ersätts alla förekomster av mönstret, annars ersätts bara den första förekomsten.</para>

<example>

<title
>Ersätta text på den nuvarande raden</title>

<para
>Din vänliga kompilator stannade just, och talade om för dig att klassen <literal
>minKlass</literal
> som nämns på rad 3902 i din källkodsfil inte är definierad.</para>

<para
>&quot;Tusan också!&quot; tänker du. Det ska förstås vara <literal
>MinKlass</literal
>. Du går till rad 3902, och istället för att försöka hitta ordet i texten, så startar du dialogrutan för redigeringskommandot, och skriver in <userinput
>s/minklass/MinKlass/i</userinput
>, trycker på knappen <guibutton
>Ok</guibutton
>, sparar filen och kompilerar &ndash; utan problem med felet borta.</para>

</example>

<example>
<title
>Ersätta text i hela filen</title>

<para
>Antag att du har en fil där du nämner namnet <quote
>Anna Johansson</quote
> flera gånger, och någon kommer in och talar om för dig att hon precis har gift sig och bytt namn till <quote
>Anna Svensson</quote
>. Du vill, förstås, byta ut alla förekomster av <quote
>Anna Johansson</quote
> mot <quote
>Anna Svensson</quote
>.</para>

<para
>Starta kommandoraden, och skriv in kommandot: <userinput
>%s/Anna Johansson/Anna Svensson/</userinput
>, tryck på returtangenten och du är klar.</para>

</example>

<example>
<title
>Ett mer avancerat exempel</title>

<para
>Det här exemplet använder <emphasis
>bakåtreferenser</emphasis
> samt en <emphasis
>ordklass</emphasis
> (om du inte vet vad det är, se tillhörande dokumentation som nämns nedan).</para>

<para
>Antag att du har följande rad: <programlisting
>void MyClass::DoStringOps( String      &amp;foo, String &amp;bar, String *p, int  &amp;a, int &amp;b )</programlisting>
</para>
<para
>Nu inser du att det inte är bra kod, och bestämmer dig för att du vill använda nyckelordet <constant
>const</constant
> för alla <quote
>adress</quote
>- parametrar, de som markeras med operatorn &amp; framför argumentets namn. Du skulle också vilja förenkla blanktecknen, så att det bara finns ett blanktecken mellan varje ord.</para>

<para
>Starta dialogrutan för redigeringskommandot, skriv in: <userinput
>s/\s+(\w+)\s+(&amp;)/ const \1 \2/g</userinput
> och tryck sedan på knappen <guibutton
>Ok</guibutton
>. Tecknet <userinput
>g</userinput
> i slutet på raden gör att det reguljära uttrycket görs om för varje träff, så att  <emphasis
>bakåtreferenserna</emphasis
> sparas.</para>

<para
>Utmatning: <computeroutput
>void MinKlass::DoStringOps( const String &amp;x, const String &amp;y String *p, const int &amp;a, const int &amp;b )</computeroutput
></para>

<para
>Åtgärden utförd! Vad hände nu egentligen? Ja, vi letade efter blanktecken (<literal
>\s+</literal
>), följt av en eller flera bokstäver (<literal
>\w+</literal
>), följt av ytterligare blanktecken (<literal
>\s+</literal
>), följt av ett och-tecken, och sparade bokstäverna samt och-tecknet för att återanvända i ersättningsoperationen. Därefter ersatta vi den matchande delen av vår rad, med ett blanktecken följt av <quote
>const</quote
>, följt av ett blanktecken, följt av våra sparade bokstäver (<literal
>\1</literal
>), följt av vårt sparade och-tecken (<literal
>\2</literal
>)</para>

<para
>I vissa fall var bokstäverna <quote
>String</quote
>, i andra <quote
>int</quote
>, så att använda teckenklassen <literal
>\w</literal
> och tecknet <literal
>+</literal
> visade sig vara en värdefull tillgång.</para>

</example>

</listitem>

</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>sort</command
></cmdsynopsis
></term>
<listitem
><para
>Sorterar den markerade texten eller hela dokumentet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>natsort</command
></cmdsynopsis
></term>
<listitem
><para
>Sorterar de markerade raderna eller hela dokumentet i naturlig ordning.</para>

<example>
<title
><command
>sort</command
> mot <command
>natsort</command
></title>
<para
><userinput
>sort(a10, a1, a2)</userinput
> ger resultatet <computeroutput
>a1, a10, a2</computeroutput
></para>
<para
><command
>natsort(a10, a1, a2)</command
> ger resultatet <computeroutput
>a1, a2, a10</computeroutput
></para>
</example
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>moveLinesDown</command
></cmdsynopsis
></term>
<listitem
><para
>Flytta markerade rader neråt.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>moveLinesUp</command
></cmdsynopsis
></term>
<listitem
><para
>Flytta markerade rader uppåt.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>uniq</command
></cmdsynopsis
></term>
<listitem
><para
>Ta bort duplicerade rader från den markerade texten eller hela dokumentet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>rtrim</command
></cmdsynopsis
></term>
<listitem
><para
>Ta bort avslutande blanktecken från den markerade texten eller hela dokumentet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>ltrim</command
></cmdsynopsis
></term>
<listitem
><para
>Ta bort inledande blanktecken från den markerade texten eller hela dokumentet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>join</command
><arg choice="opt"
>STRÄNG separator</arg
></cmdsynopsis
></term>
<listitem
><para
>Sammanfoga markerade linjer eller hela dokumentet. Har en valfri parameter som definierar ett separatortecken, till exempel: <userinput
><command
>join</command
> ','</userinput
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>rmblank</command
></cmdsynopsis
></term>
<listitem
><para
>Ta bort alla blanktecken från den markerade texten eller hela dokumentet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>unwrap</command
></cmdsynopsis
></term>
<listitem
><para
>Ta bort radbrytning för markerad text eller hela dokumentet.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>each</command
><arg choice="req"
>STRÄNG skript</arg
></cmdsynopsis
></term>
<listitem
><para
>Givet en Javascript-funktion som argument, anropa den för listan med markerade rader och ersätt dem med returvärdet från anropet.</para>

<example>
<title
>Sammanfoga markerade linjer</title>
<para
><userinput
><command
>each</command
> 'function(lines){return lines.join(", ")}' </userinput
></para>

<para
>Eller, kortare:</para>
<para
><userinput
><command
>each</command
> 'lines.join(", ")'</userinput
></para>
</example>

</listitem>
</varlistentry>



<varlistentry>
<term
><cmdsynopsis
><command
>filter</command
><arg choice="req"
>STRÄNG skript</arg
></cmdsynopsis
></term>
<listitem
><para
>Givet en Javascript-funktion som argument, anropa den för listan med markerade rader och ta bort de där anropet returnerar falskt.</para>

<example>
<title
>Ta bort tomma linjer</title>
<para
><userinput
><command
>filter</command
> 'function(1){return 1.length 
> 0;}' </userinput
></para>

<para
>Eller, kortare:</para>
<para
><userinput
><command
>filter</command
> 'line.length 
> 0'</userinput
></para>
</example>

</listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>map</command
><arg choice="req"
>STRÄNG skript</arg
></cmdsynopsis
></term>
<listitem
><para
>Givet en Javascript-funktion som argument, anropa den för listan med markerade rader och ersätt raden med värdet från anropet.</para>

<example>
<title
>Ta bort tomma linjer</title>
<para
><userinput
><command
>map</command
> 'function(line){return line.replace(/^s+/,"");}' </userinput
></para>

<para
>Eller, kortare:</para>
<para
><userinput
><command
>map</command
> 'line.replace(/^s+/,"")'</userinput
></para>
</example>

</listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>duplicateLinesUp</command
></cmdsynopsis
></term>
<listitem
><para
>Duplicera markerade rader ovanför den nuvarande markeringen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>duplicateLinesDown</command
></cmdsynopsis
></term>
<listitem
><para
>Duplicera markerade rader nedanför den nuvarande markeringen.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="advanced-editing-tools-commandline-commands-navigation">
<title
>Kommandon för navigering</title>

<variablelist>

<varlistentry>
<term
><cmdsynopsis
><command
>goto</command
><arg choice="req"
>HELTAL rad</arg
></cmdsynopsis
></term>
<listitem
><para
>Det här kommandot går till den angivna raden.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>grep</command
> <arg choice="req"
>STRÄNG mönster</arg
> </cmdsynopsis
></term>
<listitem
><para
>Sök i dokumentet efter det reguljära uttrycket <userinput
>mönster</userinput
>. För mer information, se <xref linkend="regular-expressions"/></para>
</listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>find</command
><arg choice="req"
>STRÄNG mönster</arg
></cmdsynopsis
></term>
<listitem
><para
>Kommandot går till första förekomsten av <userinput
>mönster</userinput
> enligt inställningen. Följande förekomster kan hittas genom att använda <menuchoice
><guimenu
>Redigera</guimenu
> <guimenuitem
>Sök igen</guimenuitem
></menuchoice
> (normal snabbtangent är <keycap
>F3</keycap
>).</para>
<para
>Kommandot kan anpassas genom att lägga till ett kolon följt av ett eller flera alternativ. Formatet är <userinput
>find:alternativ mönster</userinput
>. Följande alternativ stöds:</para>

<variablelist>

<varlistentry>
<term
><userinput
>b</userinput
></term>
<listitem
><para
>Sök bakåt.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>c</userinput
></term>
<listitem
><para
>Sök från markörens position.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>e</userinput
></term>
<listitem
><para
>Sök bara i markeringen.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>r</userinput
></term>
<listitem
><para
>Utför en sökning med ett reguljärt uttryck. Om det anges, kan du använda <userinput
>\N</userinput
>, där N är ett tal, för att representera hittad text i ersättningssträngen.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>s</userinput
></term>
<listitem
><para
>Utför skiftlägeskänslig sökning.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>w</userinput
></term>
<listitem
><para
>Matcha bara hela ord.</para
></listitem>
</varlistentry>

</variablelist>
</listitem>

</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>ifind</command
><arg choice="req"
>STRÄNG mönster</arg
></cmdsynopsis
></term>
<listitem
><para
>Kommandot tillhandahåller <quote
>sökning medan du skriver</quote
>. Du kan ställa in beteendet eller sökningen genom att lägga till ett kolon följt av ett eller flera alternativ, på detta sätt: <userinput
>ifind:alternativ mönster</userinput
>. Tillåtna alternativ är: <variablelist>
<varlistentry>
<term
><userinput
>b</userinput
></term>
<listitem
><para
>Sök bakåt.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>r</userinput
></term>
<listitem
><para
>Gör en sökning med ett reguljärt uttryck.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>s</userinput
></term>
<listitem
><para
>Utför skiftlägeskänslig sökning.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><userinput
>c</userinput
></term>
<listitem
><para
>Sök från markörens position.</para
></listitem>
</varlistentry>

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

</variablelist>

</sect3>


<sect3 id="advanced-editing-tools-commandline-commands-basic">
<title
>Kommandon för grundläggande redigeringsfunktioner (dessa beror på programmet som editorkomponenten används i)</title>

<variablelist>

<varlistentry>
<term
><cmdsynopsis
><command
>w</command
></cmdsynopsis
></term>
<listitem
><para
>Spara aktuellt dokument.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>wa</command
></cmdsynopsis
></term>
<listitem
><para
>Spara alla dokument som för närvarande är öppna.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>q</command
></cmdsynopsis
></term>
<listitem
><para
>Stäng aktuellt dokument.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>qa</command
></cmdsynopsis
></term>
<listitem
><para
>Stäng alla öppna dokument.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>wq</command
></cmdsynopsis
></term>
<listitem
><para
>Spara och stäng aktuellt dokument.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>wqa</command
></cmdsynopsis
></term>
<listitem
><para
>Spara och stäng alla dokument som för närvarande är öppna.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>x</command
></cmdsynopsis
></term>
<listitem
><para
>Spara och stäng aktuellt dokument, men bara om det har ändrats. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>x</command
></cmdsynopsis
></term>
<listitem
><para
>Spara och stäng alla dokument som för närvarande är öppna, men bara om de har ändrats.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>bp</command
></cmdsynopsis
></term>
<listitem
><para
>Gå till föregående dokument i dokumentlistan. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>bn</command
></cmdsynopsis
></term>
<listitem
><para
>Gå till nästa dokument i dokumentlistan. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>new</command
></cmdsynopsis
></term>
<listitem
><para
>Öppna ett nytt dokument i en horisontellt delad vy. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>vnew</command
></cmdsynopsis
></term>
<listitem
><para
>Öppna ett nytt dokument i en vertikalt delad vy. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>e</command
></cmdsynopsis
></term>
<listitem
><para
>Läs in aktuellt dokument om det har ändrats på disk. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>enew</command
></cmdsynopsis
></term>
<listitem
><para
>Redigera ett nytt dokument. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><cmdsynopsis
><command
>print</command
></cmdsynopsis
></term>
<listitem
><para
>Öppna utskriftsdialogrutan för att skriva ut det aktuella dokumentet. </para
></listitem>
</varlistentry>

</variablelist>

</sect3>


</sect2>

</sect1>

<sect1 id="advanced-editing-tools-code-folding">
<title
>Använda kodvikning</title>

<para
>Kodvikning låter dig dölja delar av ett dokument i editorn, vilket gör det lättare att få en överblick av stora dokument. I &kappname; görs beräkningen av områden som kan fällas ihop genom att använda reglerna som anges i definitionerna av syntaxfärgläggning, och därför är det bara tillgängligt i vissa format, typiskt i programkällkod, XML-markering och liknande. De flesta definitioner av syntaxfärgläggning som stöder kodvikning låter dig också manuellt definiera områden som kan fällas ihop, typiskt genom att använda nyckelorden <userinput
>BEGIN</userinput
> och <userinput
>END</userinput
>.</para>

<para
>För att använda kodvikningsfunktionen, aktivera vikmarkörer genom att använda menyalternativet <menuchoice
><guimenu
>Visa</guimenu
> <guimenuitem
>Visa vikmarkörer</guimenuitem
></menuchoice
> om de inte redan är synliga. Vikmarkörrutan till vänster på skärmen visar en grafisk vy av områden som kan fällas ihop, med triangelsymboler för att ange möjliga åtgärder för ett givet område: en triangel med spetsen neråt betyder att området är expanderat, och att klicka på den fäller ihop området så att en triangel som pekar åt höger visas istället.</para>

<para
>Elva kommandon tillhandahålls för att hantera tillståndet hos områden som kan fällas ihop, se <link linkend="view-code-folding"
>menydokumentationen</link
>. </para>

<para
>De ihopfällda raderna blir ihågkomna när en fil stängs, så när filen öppnas igen är de ihopfällda delarna fortfarande ihopfällda. Det gäller också vid uppdatering.</para>

<para
>Om du inte vill använda kodvikningsfunktionen kan du inaktivera alternativet <guilabel
>Visa vikmarkörer (om tillgängliga)</guilabel
> på sidan <link linkend="appearance"
>Utseende</link
> i editorns inställningar.</para>

</sect1>

<sect1 id="advanced-editing-tools-scripting">
<title
>Utöka &kappname; med skript</title>

<para
>Sedan &kappname; 3.4 i &kde; 4.4 kan &kappname;s editorkomponent enkelt utökas genom att skriva skript. Skriptspråket är ECMAscript (känt överallt som Javascript). &kappname; stöder två sorters skript: intenterings- och kommandoradskript. </para>

<sect2 id="advanced-editing-tools-scripting-indentation">
<title
>Indenteringsskript</title>

<para
>Indenteringsskript, som också kallas indenterare, indenterar automatiskt källkoden medan texten skrivs in. Som ett exempel, efter att ha tryckt på returtangenten ökar ofta indenteringsnivån. </para>

<para
>Följande avsnitt beskriver steg för steg hur skelettet för en enkel indenterare skapas. Som första steg, skapa en ny <filename
>*.js</filename
>-fil, som t.ex. heter <filename
>javascript.js</filename
> i den lokala hemkatalogen <filename
>$KDEHOME/share/apps/katepart/script/indentation</filename
>. </para>

<sect3 id="advanced-editing-tools-scripting-indentation-header">
<title
>Indenteringsskriptets huvud</title>
<para
>Huvudet i filen <filename
>javascript.js</filename
> är inbäddat i en kommentar, och har följande form <programlisting>
/* kate-script
 * name: JavaScript
 * author: Exempel Namn &lt;exempel.namn@någon.adress.org&gt;
 * license: BSD
 * revision: 1
 * kate-version: 3.4
 * required-syntax-style: javascript
 * indent-languages: javascript
 * priority: 0
 * i18n-catalog: min_katalog
 *
 * En rad utan kolon ':' stoppar tolkning av huvudet. Alltså kan du lägga till valfri
 * text här som en detaljerad licens.
 */
</programlisting
> Varje post förklaras nu i detalj: <itemizedlist>
<listitem
><para
><literal
>kate-script</literal
> [krävs]: Textsträngen måste finnas på första raden i <filename
>*.js</filename
>-filen, annars hoppar &kappname; över skriptet. </para
></listitem>
<listitem
><para
><literal
>name</literal
> [krävs]: Detta är indenterarens namn som visas i menyn  <menuchoice
><guimenu
>Verktyg</guimenu
><guimenuitem
>Indentering</guimenuitem
></menuchoice
> och i inställningsdialogrutan. </para
></listitem>
<listitem
><para
><literal
>author</literal
> [valfri]: Upphovsmannens namn och kontaktinformation. </para
></listitem>
<listitem
><para
><literal
>license</literal
> [valfri]: Kort form av licensen, såsom BSD eller LGPLv3. </para
></listitem>
<listitem
><para
><literal
>revision</literal
> [krävs]: Skriptets utgåva. Numret ska ökas så fort skriptet ändras. </para
></listitem>
<listitem
><para
><literal
>kate-version</literal
> [krävs]: Minimal version av &kappname; som krävs. </para
></listitem>
<listitem
><para
><literal
>required-syntax-style</literal
> [valfri]: Lista åtskild med komman av syntaxfärgläggningsstilar som krävs. Det är viktigt för indenterare som förlitar sig på specifik syntaxfärgläggningsinformation i dokumentet. Om en krävd syntaxstil specificeras, är bara indenteraren tillgänglig när lämplig syntaxfärgläggning är aktiv. Det förhindrar <quote
>odefinierat beteende</quote
> orsakat av att använda indenteraren utan den förväntade färgläggningsmetoden. Exempelvis använder sig Ruby-indenteraren sig av det i filen <filename
>ruby.js</filename
> och <filename
>ruby.xml</filename
>. </para
></listitem>
<listitem
><para
><literal
>indent-languages</literal
> [valfri]: Lista åtskild med kommatecken av syntaxstilar som indenteraren kan indentera korrekt, t.ex. c++, java. </para
></listitem>
<listitem
><para
><literal
>priority</literal
> [valfri]: Om flera indenterare är lämpliga för en viss färglagd fil, bestämmer prioriteten vilken indenterare som väljes som standardindenterare. </para
></listitem>
<listitem
><para
><literal
>i18n-catalog</literal
> [valfri]: Ytterligare meddelandekatalog (<literal
>po</literal
>-fil) inläst för översättning av indenterare från tredjepart.</para
></listitem>
</itemizedlist>
</para>

<para
>&kappname; läsera alla par av formen <quote
><replaceable
>nyckel</replaceable
>: <replaceable
>värde</replaceable
></quote
> till ett kolon inte längre hittas. Det betyder att huvudet kan innehålla valfri text som en licens, vilket visas i exemplet. </para>

</sect3>

<sect3 id="advanced-editing-tools-scripting-indentation-body">
<title
>Indenteringens källkod</title>
<para
>Efter att ha specificerat huvudet, förklarar det här avsnittet hur själva indenteringsskriptet fungerar. Det grundläggande skelettet för implementeringen ser ut så här: <programlisting>
// nödvändiga katepart js bibliotek, t.ex. range.js om Range används
require ("range.js");

triggerCharacters = "{}/:;";
function indent(line, indentWidth, ch)
{
    // anropas för varje nyrad (ch == '\n') och alla tecken angivna i
    // den globala variabeln triggerCharacters. Vid anrop av <menuchoice
><guimenu
>Verktyg</guimenu
><guimenuitem
>Justera</guimenuitem
></menuchoice>
    // är variabeln ch tom, dvs. ch == ''.
    //
    // se också: Programmeringsgränssnittet för skripthantering
    return -2;
}
</programlisting
> Funktionen <function
>indent()</function
> har tre parametrar: <itemizedlist
> <listitem
><para
><literal
>line</literal
>: raden som ska indenteras</para
></listitem
> <listitem
><para
><literal
>indentWidth</literal
>: indenteringsbredden i antal mellanslag</para
></listitem
> <listitem
><para
><literal
>ch</literal
>: antingen ett nyradstecken (<literal
>ch == '\n'</literal
>), avtryckartecknet angivet i <literal
>triggerCharacters</literal
> eller tom om användaren utförde åtgärden <menuchoice
><guimenu
>Verktyg</guimenu
><guimenuitem
>Justera</guimenuitem
></menuchoice
>.</para
></listitem
> </itemizedlist
> Returvärdet från funktionen <function
>indent()</function
> anger hur raden kommer att indenteras. Om returvärdet är ett enkelt heltal, tolkas det på följande sätt: <itemizedlist
> <listitem
><para
>returvärde <literal
>-2</literal
>: gör ingenting</para
></listitem
> <listitem
><para
>returvärde <literal
>-1</literal
>: behåll indentering (söker efter föregående icke tomma rad)</para
></listitem
> <listitem
><para
>returvärde <literal
> 0</literal
>: tal &gt;= 0 anger indenteringsdjupet i mellanslag</para
></listitem
> </itemizedlist
> Som alternativ kan ett fält med två element returneras. <itemizedlist
> <listitem
><para
><literal
>return [ indent, align ];</literal
></para
></listitem
> </itemizedlist
> I detta fall är det först elementet indenteringsdjupet ovan med samma betydelse för specialvärden. Det andra elementet är dock ett absolutvärde som representerar en kolumn för <quote
>justering</quote
>. Om värdet är större än indenteringsvärdet, representerar skillnaden ett antal mellanslag att lägga till efter indentering av den första parametern. Annars ignoreras det andra numret. Att använda tabulator och mellanslag för indentering kallas ofta <quote
>blandat läge</quote
>. </para>

<para
>Betrakta följande exempel: Antag att tabulator används för indentering, och tabulatorbredden är inställd till 4. Här representerar &lt;tab&gt; en tabulator, och '.' ett mellanslag. <programlisting>
1: &lt;tab&gt;&lt;tab&gt;anropa("Hej",
2: &lt;tab&gt;&lt;tab&gt;......."allesamman");
</programlisting
> Vid indentering av rad 2, returnerar funktionen <function
>indent()</function
> [8, 15]. Som resultat infogas två tabulatorer för att indentera till kolumn 8, och 7 mellanslag läggs till för att justera den andra parametern under den första, så att den förblir justerad om filen visas med en annan tabulatorbredd. </para>

<para
>En standardinstallation av KDE levererar &kappname; med flera indenterare. Den motsvarande Javascript-koden finns i <filename
>$KDEDIR/share/apps/katepart/script/indentation</filename
>. </para>

<para
>Att utveckla en indenterare kräver att skript läses in igen för att se om ändringar beter sig lämpligt. Istället för att starta om programmet, byt helt enkelt till kommandoraden och utför kommandot <command
>reload-scripts</command
>. </para>

<para
>Om du utvecklar användbara skript, fundera på att bidra med det till &kappname;-projektet genom att <ulink url="mailto:kwrite-devel@kde.org"
>kontakta e-postlistan</ulink
>. </para>

</sect3>
</sect2>

<sect2 id="advanced-editing-tools-scripting-command-line">
<title
>Kommandoradskript</title>

<para
>Eftersom det är svårt att uppfylla allas behov, stöder &kappname; små hjälpverktyg för snabb textbehandling via den <link linkend="advanced-editing-tools-commandline"
>inbyggda kommandoraden</link
>. Exempelvis är kommandot <command
>sort</command
> implementerat som ett skript. Det här avsnittet förklarar hur man skapar <filename
>*.js</filename
>-filer för att utöka &kappname; med godtyckliga hjälpskript. </para>

<para
>Kommandoradskript är placerade i samma katalog som indenteringsskript. Som första steg, skapa alltså en ny <filename
>*.js</filename
>-fil som heter <filename
>mina_verktyg.js</filename
> i den lokala hemkatalogen <filename
>$KDEHOME/share/apps/katepart/script/commands</filename
>. </para>

<sect3 id="advanced-editing-tools-scripting-command-line-header">
<title
>Kommandoradskriptets huvud</title>
<para
>Huvudet för varje kommandoradsskript är inbäddat i en kommentar och har följande form <programlisting>
/* kate-script
 * author: Exempel Namn &lt;exempel.namn@någon.adress.org&gt;
 * license: BSD
 * revision: 1
 * kate-version: 3.4
 * type: commands
 * functions: sort, format-paragraph
 * i18n-catalog: min_katalog
 *
 * En rad utan kolon ':' stoppar tolkning av huvudet. Alltså kan du lägga till valfri
 * text här som en detaljerad licens.
 */
</programlisting
> Varje post förklaras nu i detalj: <itemizedlist>
<listitem
><para
><literal
>kate-script</literal
> [krävs]: Textsträngen måste finnas på första raden i <filename
>*.js</filename
>-filen, annars hoppar &kappname; över skriptet.</para
></listitem>
<listitem
><para
><literal
>author</literal
> [valfri]: Upphovsmannens namn och kontaktinformation.</para
></listitem>
<listitem
><para
><literal
>license</literal
> [valfri]: Kort form av licensen, såsom BSD eller LGPLv3.</para
></listitem>
<listitem
><para
><literal
>revision</literal
> [krävs]: Skriptets utgåva. Numret ska ökas så fort skriptet ändras.</para
></listitem>
<listitem
><para
><literal
>kate-version</literal
> [krävs]: Minimal version av &kappname; som krävs.</para
></listitem>
<listitem
><para
><literal
>functions</literal
> [krävs]: Lista åtskild med kommatecken av kommandon i skriptet.</para
></listitem>
<listitem
><para
><literal
>i18n-catalog</literal
> [valfri]: Ytterligare meddelandekatalog (<literal
>po</literal
>-fil) inläst för översättning av skript från tredjepart.</para
></listitem>
</itemizedlist>
</para>

<para
>&kappname; läsera alla par av formen <quote
><replaceable
>nyckel</replaceable
>: <replaceable
>värde</replaceable
></quote
> till ett kolon inte längre hittas. Det betyder att huvudet kan innehålla valfri text som en licens, vilket visas i exemplet. Värdet på nyckeln functions är en lista åtskild med kommatecken av kommandon för kommandoraden. Varje funktion är tillgänglig via &kappname;s <link linkend="advanced-editing-tools-commandline"
>inbyggda kommandorad</link
>. </para>
</sect3>

<sect3 id="advanced-editing-tools-scripting-command-line-body">
<title
>Skriptets källkod</title>

<para
>Alla funktioner specificerade i huvudet måste implementeras i skriptet. Exempelvis måste skriptfilen i exemplet ovan implementera de två funktionerna <command
>sort</command
> och <command
>format-paragraph</command
>. Alla funktioner har följande syntax: <programlisting
>// nödvändiga katepart.js bibliotek, t.ex. range.js om Range används
require ("range.js");

function &lt;namn&gt;(arg1, arg2, ...)
{
    // ... implementering, se också: Programmeringsgränssnittet för skripthantering
}
</programlisting>
</para>

<para
>Argument på kommandoraden skickas till funktionen som <parameter
>arg1</parameter
>, <parameter
>arg2</parameter
>, etc. För att ge dokumentation av varje kommando, implementera helt enkelt funktionen '<function
>help</function
>' på följande sätt: <programlisting>
function help(cmd)
{
    if (cmd == "sort") {
        return "Sortera markerad text.";
    } else if (cmd == "...") {
        // ...
    }
}
</programlisting
> Att utföra <command
>help sort</command
> på kommandoraden anropar hjälpfunktionen med argumentet <parameter
>cmd</parameter
> inställd till det givna kommandot, dvs. <parameter
>cmd == "sort"</parameter
>. &kappname; visar därefter den returnerade texten som dokumentation för användaren. Försäkra dig om att <link linkend="advanced-editing-tools-scripting-api-i18n"
>översätta strängarna</link
>. </para>

<sect4 id="advanced-editing-tools-scripting-command-line-shortcuts">
<title
>Tilldela genvägar</title>
<para
>För att kunna tilldela genvägar, måste skriptet tillhandahålla en funktion som heter <literal
>action</literal
> enligt följande: <programlisting>
function action(cmd)
{
    var a = new Object();
    if (cmd == "sort") {
        a.text = i18n("Sort Selected Text");
        a.icon = "";
        a.category = "";
        a.interactive = false;
        a.shortcut = "";
    } else if (cmd == "moveLinesDown") {
        // samma för nästa åtgärd
    }
    return a;
}
</programlisting
> Funktionens parameter <literal
>cmd</literal
> anger kommandot som genvägen begärs för. Det finns flera fält som du måste ange i Javascript-objektet som returneras: <itemizedlist>
<listitem
><para
><literal
>a.text</literal
> [krävs]: Texten visas i menyn <menuchoice
><guimenu
>Verktyg</guimenu
> <guisubmenu
>Skript</guisubmenu
></menuchoice
>. Försäkra dig om att du använder <literal
>i18n</literal
> för översättning.</para
></listitem>
<listitem
><para
><literal
>a.icon</literal
> [valfri]: Ikonen visas intill texten i menyn. Alla KDE:s ikonnamn kan användas här.</para
></listitem>
<listitem
><para
><literal
>a.category</literal
> [valfri]: Om en kategori anges, visas skriptet i en undermeny. Försäkra dig om att använda <literal
>i18n</literal
> för översättning.</para
></listitem>
<listitem
><para
><literal
>a.interactive</literal
> [valfri]: If the script needs user input, set this to <literal
>true</literal
>.</para
></listitem>
<listitem
><para
><literal
>a.shortcut</literal
> [valfri]: Genvägen som anges här är förvald genväg. Exempel: Ctrl+Alt+t. Se <ulink url="http://doc.qt.nokia.com/latest/qt.html#Key-enum"
>Qt:s dokumentation</ulink
> för ytterligare detaljinformation.</para
></listitem>
</itemizedlist>
</para>


<para
>Att utveckla ett kommandoradskript kräver att skript läses in igen för att se om ändringar beter sig lämpligt. Istället för att starta om programmet, byt helt enkelt till kommandoraden och utför kommandot <command
>reload-scripts</command
>. </para>

<para
>Om du utvecklar användbara skript, fundera på att bidra med det till &kappname;-projektet genom att <ulink url="mailto:kwrite-devel@kde.org"
>kontakta e-postlistan</ulink
>. </para>

</sect4>
</sect3>
</sect2>

<sect2 id="advanced-editing-tools-scripting-api">
<title
>Programmeringsgränssnittet för skripthantering</title>

<para
>Programmeringsgränssnittet för skripthantering som presenteras här är tillgängligt i alla skript, dvs. indenteringsskript och kommandon för kommandoraden. <classname
>Cursor</classname
> och <classname
>Range</classname
> tillhandahålls av biblioteksfiler i <filename
>$KDEDIR/share/apps/katepart/libraries</filename
>. Om du vill använda dem i skriptet, vilket krävs för att använda vissa av funktionerna i <classname
>Document</classname
> eller <classname
>View </classname
>, inkludera det nödvändiga biblioteket med: <programlisting
>// nödvändiga katepart.js bibliotek, t.ex. range.js om Range används
require ("range.js");
</programlisting>
</para>

<para
>För att utöka det vanliga skriptprogrammeringsgränssnittet med egna funktioner och prototyper, skapa helt enkelt en ny fil i KDE:s lokala inställningskatalog <filename
>$KDEHOME/share/apps/katepart/libraries</filename
> och inkludera den i skriptet med: <programlisting
>require ("mitt_skriptnamn.js");
</programlisting>

</para>

<para
>För att utöka befintliga prototyper som <classname
>Cursor</classname
> eller <classname
>Range</classname
>, är det rekommenderade sättet <emphasis
>inte</emphasis
> att ändra den globala <filename
>*.js</filename
>-filen. Ändra istället prototypen för <classname
>Cursor</classname
> i Javascript efter att <filename
>cursor.js</filename
> har inkluderats i skriptet via <literal
>require</literal
>. </para>

<sect3 id="advanced-editing-tools-scripting-api-prototypes">
<title
>Markörer och intervall</title>

<para
>Eftersom &kappname; är en texteditor är alla programmeringsgränssnitt baserade på markörer och intervall om det är möjligt. En markör (Cursor) är ett enkelt par <literal
>(rad, kolumn)</literal
>, som representerar en textposition i dokumentet. Ett intervall (Range) omfattar text från en markörs startposition till en markörs slutposition. Programmeringsgränssnittet förklaras i detalj i följande avsnitt. </para>

<sect4 id="advanced-editing-tools-scripting-api-cursors">
<title
>Prototypen för Cursor</title>

<variablelist
><varlistentry>
<term
><synopsis
>Cursor();
</synopsis
></term>
<listitem
><para
>Konstruktor. Returnerar en markör på position <literal
>(0, 0)</literal
>.</para>
<para
>Exempel: <function
>var cursor = new Cursor();</function
> </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Cursor(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Konstruktor. Returnerar en markör på position (rad, kolumn). </para>
<para
>Exempel: <function
>var cursor = new Cursor(3, 42);</function
> </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Cursor(<parameter
>Cursor <replaceable
>annan</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Kopieringskonstruktor. Returnerar en kopia av markören <replaceable
>annan</replaceable
>. </para>
<para
>Exempel: <function
>var copy = new Cursor(other);</function
> </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Cursor Cursor.clone();
</synopsis
></term>
<listitem
><para
>Returnerar en klon av markören.</para>
<para
>Exempel: <function
>var clone = cursor.clone();</function
> </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Cursor.isValid();
</synopsis
></term>
<listitem
><para
>Kontrollera om markören är giltig. Markören är ogiltig om rad och/eller kolumn har värdet <literal
>-1</literal
>. </para>
<para
>Exampel: <function
>var valid = cursor.isValid();</function
> </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Cursor Cursor.invalid();
</synopsis
></term>
<listitem
><para
>Returnerar en ny ogiltig markör placerad på <literal
>(-1, -1)</literal
>. </para>
<para
>Exempel: <function
>var invalidCursor = cursor.invalid();</function
> </para
></listitem>
</varlistentry>

<varlistentry>
<term
><synopsis
>int Cursor.compareTo(<parameter
>Cursor <replaceable
>annan</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Jämför den här markören med markören <replaceable
>annan</replaceable
>. Returnerar <itemizedlist>
<listitem
><para
><literal
>-1</literal
>, om den här markören är placerad innan markören <replaceable
>annan</replaceable
>,</para
></listitem>
<listitem
><para
><literal
>0</literal
>, om båda markörerna är lika, och</para
></listitem>
<listitem
><para
><literal
>+1</literal
>, om den här markören är placerad efter markören <replaceable
>annan</replaceable
>.</para
></listitem>
</itemizedlist>
</para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Cursor.equals(<parameter
>Cursor <replaceable
>annan</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om den här markören och markören <replaceable
>annan</replaceable
> är lika, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String Cursor.toString();
</synopsis
></term>
<listitem
><para
>Returnerar markören som en sträng på formen <quote
><literal
>Cursor(rad, kolumn)</literal
></quote
>. </para
></listitem>
</varlistentry
></variablelist>

</sect4>


<sect4 id="advanced-editing-tools-scripting-api-ranges">
<title
>Prototyp för Range</title>

<variablelist
><varlistentry>
<term
><synopsis
>Range();
</synopsis
></term>
<listitem
><para
>Konstruktor. Att anropa <literal
>new Range()</literal
> returnerar intervallet (0, 0) - (0, 0). </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Range(<parameter
>Cursor <replaceable
>start</replaceable
></parameter
>, <parameter
>Cursor <replaceable
>slut</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Konstruktor. Att anropa <literal
>new Range(<replaceable
>start</replaceable
>, <replaceable
>slut</replaceable
>)</literal
> returnerar intervallet (<replaceable
>start</replaceable
>, <replaceable
>slut</replaceable
>). </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Range(<parameter
>int <replaceable
>startrad</replaceable
></parameter
>, <parameter
>int <replaceable
>startkolumn</replaceable
></parameter
>, <parameter
>int <replaceable
>slutrad</replaceable
></parameter
>, <parameter
>int <replaceable
>slutkolumn</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Constructor. Calling <literal
>new Range(<replaceable
>startrad</replaceable
>, <replaceable
>startkolumn</replaceable
>, <replaceable
>slutrad</replaceable
>, <replaceable
>slutkolumn</replaceable
>)</literal
> returnerar intervallet från (<replaceable
>startrad</replaceable
>, <replaceable
>startkolumn</replaceable
>) to (<replaceable
>startrad</replaceable
>, <replaceable
>slutkolumn</replaceable
>). </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Range(<parameter
>Range <replaceable
>annat</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Kopieringskonstruktor. Returnerar en kopia av intervallet <replaceable
>annat</replaceable
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Range Range.clone();
</synopsis
></term>
<listitem
><para
>Returnerar en klon av intervallet. </para>
<para
>Exempel: <function
>var clone = range.clone();</function
> </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.isValid();
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om både start- och slutmarkörerna är giltiga, annars <literal
>falskt</literal
>. </para>
<para
>Exempel: <function
>var valid = range.isValid();</function
> </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.invalid();
</synopsis
></term>
<listitem
><para
>Returnerar intervallet från (-1, -1) till (-1, -1). </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.contains(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <constant
>true</constant
> om intervallet innehåller markörpositionen, annars <constant
>false</constant
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.contains(<parameter
>Range <replaceable
>annat</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om det här intervallet innehåller intervallet <replaceable
>annat</replaceable
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.containsColumn(<parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om <replaceable
>kolumn</replaceable
> är i det halvöppna intervallet <literal
>[startkolumn, slutkolumn)</literal
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.containsLine(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om <replaceable
>rad</replaceable
> är i det halvöppna intervallet <literal
>[startrad, slutrad)</literal
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.overlaps(<parameter
>Range <replaceable
>annat</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om det här intervallet och intervallet <replaceable
>annat</replaceable
> delar ett gemensamt område, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.overlapsLine(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om <replaceable
>rad</replaceable
> är i intervallet <literal
>[startrad, slutrad]</literal
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.overlapsColumn(<parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om <replaceable
>kolumn</replaceable
> är i intervallet <literal
>[startkolumn, slutkolumn]</literal
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.onSingleLine();
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om intervallet startar och slutar på samma rad, dvs. om <replaceable
>Range.start.line == Range.end.line</replaceable
>. </para>
<para
>Sedan: KDE 4.9 </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool Range.equals(<parameter
>Range <replaceable
>annan</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om det här intervallet och intervallet <replaceable
>annat</replaceable
> är lika, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String Range.toString();
</synopsis
></term>
<listitem
><para
>Returnerar intervallet som en sträng på formen <quote
><literal
>Range(Cursor(rad, kolumn), Cursor(rad, kolumn))</literal
></quote
>. </para
></listitem>
</varlistentry
></variablelist>

</sect4>
</sect3>

<sect3 id="advanced-editing-tools-scripting-api-global">
<title
>Globala funktioner</title>
<para
>Det här avsnittet listar alla globala funktioner.</para>


<sect4 id="advanced-editing-tools-scripting-api-includes">
<title
>Att läsa och inkludera filer</title>

<variablelist
><varlistentry>
<term
><synopsis
>String read(<parameter
>String <replaceable
>fil</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Söker efter angiven <replaceable
>fil</replaceable
> relativt i förhållande till katalogen <literal
>katepart/script/files</literal
> och returnerar innehållet som en sträng. </para
></listitem>
</varlistentry
></variablelist>

<variablelist
><varlistentry>
<term
><synopsis
>void require(<parameter
>String <replaceable
>fil</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Söker efter angiven <replaceable
>fil</replaceable
> relativt i förhållande till katalogen <literal
>katepart/script/libraries</literal
> och utvärdera den. Internt skyddas <literal
>require</literal
> från att samma <replaceable
>fil</replaceable
> inkluderas flera gånger. </para>
<para
>Sedan: KDE 4.10 </para>
</listitem>
</varlistentry
></variablelist>

</sect4>

<sect4 id="advanced-editing-tools-scripting-api-debug">
<title
>Felsökning</title>

<variablelist
><varlistentry>
<term
><synopsis
>void debug(<parameter
>String <replaceable
>text</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Skriver ut <replaceable
>text</replaceable
> på <literal
>standardutmatningen</literal
> i terminalen som startade programmet. </para
></listitem>
</varlistentry
></variablelist>

</sect4>

<sect4 id="advanced-editing-tools-scripting-api-i18n">
<title
>Översättning</title>

<para
>För att stödja fullständig landsanpassning, finns det flera funktioner för att översätta strängar i skript, närmare bestämt <literal
>i18n</literal
>, <literal
>i18nc</literal
>, <literal
>i18np</literal
> och <literal
>i18ncp</literal
>. Funktionerna beter sig exakt likadant som <ulink url="http://techbase.kde.org/Development/Tutorials/Localization/i18n"
>KDE:s översättningsfunktioner</ulink
>. </para>

<para
>Översättningsfunktionerna översätter strängarna de omger via KDE:s översättningssystem till det språk som används i programmet. Strängar i skript som utvecklas i &kappname;s officiella källkod extraheras automatiskt och är översättningsbara. Med andra ord, som utvecklare av &kappname; behöver man inte bry dig om att extrahera och översätta meddelanden. För skript från tredjepart som utvecklas utanför KDE, måste man dock extrahera och översätta meddelandena själv. En översättningskatalog som innehåller alla översatta strängar måste distribueras tillsammans med skriptet. Dessutom måste skriptets huvud explicit definiera katalogen som ska läsas in genom att ange <literal
>i18n-catalog</literal
>. </para>

<variablelist
><varlistentry>
<term
><synopsis
>void i18n(<parameter
>String <replaceable
>text</replaceable
></parameter
>, <replaceable
>arg1</replaceable
>, ...);
</synopsis
></term>
<listitem
><para
>Översätter <replaceable
>text</replaceable
> till språket som används av programmet. Parametrarna <replaceable
>arg1</replaceable
>, ... , är valfria och används för att ersätta platsmarkörerna <literal
>%1</literal
>, <literal
>%2</literal
>, etc.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><synopsis
>void i18nc(<parameter
>String <replaceable
>sammanhang</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>, <replaceable
>arg1</replaceable
>, ...);
</synopsis
></term>
<listitem
><para
>Översätter <replaceable
>text</replaceable
> till språket som används av programmet. Dessutom är strängen <replaceable
>sammanhang</replaceable
> synlig för översättare, så att de kan tillhandahålla en bättre översättning. Parametrarna <replaceable
>arg1</replaceable
>, ... , är valfria och används för att ersätta platsmarkörerna <literal
>%1</literal
>, <literal
>%2</literal
>, etc.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><synopsis
>void i18np(<parameter
>String <replaceable
>singularis</replaceable
></parameter
>, <parameter
>String <replaceable
>pluralis</replaceable
></parameter
>, <parameter
>int <replaceable
>antal</replaceable
></parameter
>, <replaceable
>arg1</replaceable
>, ...);
</synopsis
></term>
<listitem
><para
>Översätter antingen <replaceable
>singularis</replaceable
> eller <replaceable
>pluralis</replaceable
> till språket som används av programmet, beroende på angivet <replaceable
>antal</replaceable
>. Parametrarna <replaceable
>arg1</replaceable
>, ... , är valfria och används för att ersätta platsmarkörerna <literal
>%1</literal
>, <literal
>%2</literal
>, etc.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><synopsis
>void i18ncp(<parameter
>String <replaceable
>sammanhang</replaceable
></parameter
>, <parameter
>String <replaceable
>singularis</replaceable
></parameter
>, <parameter
>String <replaceable
>pluralis</replaceable
></parameter
>, <parameter
>int <replaceable
>antal</replaceable
></parameter
>, <replaceable
>arg1</replaceable
>, ...);
</synopsis
></term>
<listitem
><para
>Översätter antingen <replaceable
>singularis</replaceable
> eller <replaceable
>pluralis</replaceable
> till språket som används av programmet, beroende på angivet <replaceable
>antal</replaceable
>. Dessutom är strängen <replaceable
>sammanhang</replaceable
> synlig för översättare, så att de kan tillhandahålla en bättre översättning. Parametrarna <replaceable
>arg1</replaceable
>, ... , är valfria och används för att ersätta platsmarkörerna <literal
>%1</literal
>, <literal
>%2</literal
>, etc.</para
></listitem>
</varlistentry
></variablelist>

</sect4>
</sect3>

<sect3 id="advanced-editing-tools-scripting-api-view">
<title
>Programmeringsgränssnittet för vyn</title>
<para
>När ett skript håller på att köras, finns det en global variabel <quote
><literal
>view</literal
></quote
> som representerar den för närvarande aktiva editorvyn. Det följande är en lista med alla tillgängliga funktioner i View. <variablelist
><varlistentry>
<term
><synopsis
><function
>Cursor view.cursorPosition()</function
>
</synopsis
></term>
<listitem
><para
>Returnerar den nuvarande markörpositionen i vyn.</para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>void view.setCursorPosition(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
void view.setCursorPosition(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Ställ in den nuvarande markörpositionen till antingen (rad, kolumn) eller till den givna markören. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Cursor view.virtualCursorPosition();
</synopsis
></term>
<listitem
><para
>Returnerar den virtuella markörpositionen, där varje tabulator räknas som motsvarande antal mellanslag, beroende på nuvarande tabulatorbredd. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>void view.setVirtualCursorPosition(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
void view.setVirtualCursorPosition(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Ställ in den nuvarande virtuella markörpositionen till (rad, kolumn) eller till den givna markören. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String view.selectedText();
</synopsis
></term>
<listitem
><para
>Returnerar den markerade texten. Om ingen text är markerad, är den returnerade strängen tom. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool view.hasSelection();
</synopsis
></term>
<listitem
><para
>Returnerar <constant
>true</constant
> om vyn har markerad text, annars <constant
>false</constant
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Range view.selection();
</synopsis
></term>
<listitem
><para
>Returnerar det markerade textintervallet. Det returnerade intervallet är ogiltigt om det inte finns någon markerad text. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>void view.setSelection(<parameter
>Range <replaceable
>intervall</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Ställer in markerad text till angivet intervall. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>void view.removeSelectedText();
</synopsis
></term>
<listitem
><para
>Tar bort den markerade texten. Om vyn inte har någon markerad text, händer ingenting. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>void view.selectAll();
</synopsis
></term>
<listitem
><para
>Markerar hela texten i dokumentet. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>void view.clearSelection();
</synopsis
></term>
<listitem
><para
>Rensar textmarkeringen utan att ta bort texten. </para
></listitem>
</varlistentry
></variablelist>
</para>
</sect3>

<sect3 id="advanced-editing-tools-scripting-api-document">
<title
>Programmeringsgränssnittet för dokumentet</title>
<para
>När ett skript håller på att köras, finns det en global variabel <quote
><literal
>document</literal
></quote
> som representerar det för närvarande aktiva dokumentet. Det följande är en lista med alla tillgängliga funktioner i Document. <variablelist
><varlistentry>
<term
><synopsis
>String document.fileName();
</synopsis
></term>
<listitem
><para
>Returnerar dokumentets filnamn eller en tom sträng för osparade textbuffrar. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.url();
</synopsis
></term>
<listitem
><para
>Returnerar dokumentets fullständiga webbadress eller en tom sträng för osparade textbuffrar. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.mimeType();
</synopsis
></term>
<listitem
><para
>Returnerar dokumentets Mime-typ eller Mime-typen <literal
>application/octet-stream</literal
> om ingen lämplig Mime-typ kunde hittas. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.encoding();
</synopsis
></term>
<listitem
><para
>Returnerar den nuvarande kodningen använd för att spara filen. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><synopsis
>String document.highlightingMode();
</synopsis
></term>
<listitem
><para
>Returnerar det allmänna färgläggningsläget som används för hela dokumentet. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><synopsis
>String document.highlightingModeAt(<parameter
>Cursor <replaceable
>pos</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar färgläggningsläget som används på den givna positionen i dokumentet. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><synopsis
>Array document.embeddedHighlightingModes();
</synopsis
></term>
<listitem
><para
>Returnerar ett fält med färgläggningslägen inbäddade i det här dokumentet. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><synopsis
>bool document.isModified();
</synopsis
></term>
<listitem
><para
>Returnerar <constant
>true</constant
> om dokumentet har osparade ändringar (är modifierat), annars <constant
>false</constant
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.text();
</synopsis
></term>
<listitem
><para
>Returnerar dokumentets hela innehåll i en enda textsträng. Nya rader är markerade med nyradstecknet <quote
><literal
>\n</literal
></quote
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.text(<parameter
>int <replaceable
>från_rad</replaceable
></parameter
>, <parameter
>int <replaceable
>från_kolumn</replaceable
></parameter
>, <parameter
>int <replaceable
>till_rad</replaceable
></parameter
>, <parameter
>int <replaceable
>till_kolumn</replaceable
></parameter
>);
String document.text(<parameter
>Cursor <replaceable
>från</replaceable
></parameter
>, <parameter
>Cursor <replaceable
>till</replaceable
></parameter
>);
String document.text(<parameter
>Range <replaceable
>intervall</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar texten i det angivna intervallet. Det rekommenderas att använda markör- och intervallbaserade versioner för bättre läsbarhet hos källkoden. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.line(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar den givna textraden som en sträng. Strängen är tom om den begärda raden är utanför tillgängligt intervall. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.wordAt(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
String document.wordAt(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar ordet på den angivna markörposition. </para
></listitem>
</varlistentry>


<varlistentry>
<term>
<synopsis
>Range document.wordRangeAt(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
Range document.wordRangeAt(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis>
</term>
<listitem
><para
>Returnerar intervallet för ordet på den givna markörpositionen. Det returnerade intervallet är ogiltigt (se Range.isValid()) om textpositionen är efter ett radslut. Om det inte finns något ord vid den givna markörpositionen returneras ett tomt intervall. </para>
<para
>Sedan: KDE 4.9 </para>
</listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.charAt(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
String document.charAt(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar tacknet på den angivna markörpositionen. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.firstChar(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar det första tecknet på angiven <replaceable
>rad</replaceable
> som inte är ett blanktecken. Det första tecknet finns på kolumn 0. Om raden är tom, eller bara innehåller blanktecken, är den returnerade strängen tom. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.lastChar(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar det sista tecknet på angiven <replaceable
>rad</replaceable
> som inte är ett blanktecken. Om raden är tom, eller bara innehåller blanktecken, är den returnerade strängen tom. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.isSpace(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
bool document.isSpace(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om tecknet på den givna markörpositionen är ett blanktecken, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.matchesAt(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>);
bool document.matchesAt(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om given <replaceable
>text</replaceable
> matchar på den motsvarande markörpositionen, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.startsWith(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>, <parameter
>bool <replaceable
>hoppa_över_blanktecken</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om raden börjar med <replaceable
>text</replaceable
>, annars <literal
>falskt</literal
>. Argumentet <replaceable
>hoppa_över_blanktecken</replaceable
> bestämmer om inledande blanktecken ignoreras. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.endsWith(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>, <parameter
>bool <replaceable
>hoppa_över_blanktecken</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om raden slutar med <replaceable
>text</replaceable
>, annars <literal
>falskt</literal
>. Argumentet <replaceable
>hoppa_över_blanktecken</replaceable
> bestämmer om inledande blanktecken ignoreras. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.setText(<parameter
>String <replaceable
>text</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Anger hela dokumentets text. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.clear();
</synopsis
></term>
<listitem
><para
>Tar bort hela texten i dokumentet. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.truncate(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
bool document.truncate(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Avkortar den givna raden på den givna kolumnen eller markörpositionen. Returnerar <literal
>sant</literal
> om det lyckas, eller <literal
>falskt</literal
> om den givna raden inte ingår i dokumentets intervall. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.insertText(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>);
bool document.insertText(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Infogar <replaceable
>text</replaceable
> på den givna markörpositionen. Returnerar <literal
>sant</literal
> om det lyckas, eller <literal
>falskt</literal
> om dokumentet är skrivskyddat. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.removeText(<parameter
>int <replaceable
>från_rad</replaceable
></parameter
>, <parameter
>int <replaceable
>från_kolumn</replaceable
></parameter
>, <parameter
>int <replaceable
>till_rad</replaceable
></parameter
>, <parameter
>int <replaceable
>till_kolumn</replaceable
></parameter
>);
bool document.removeText(<parameter
>Cursor <replaceable
>från</replaceable
></parameter
>, <parameter
>Cursor <replaceable
>till</replaceable
></parameter
>);
bool document.removeText(<parameter
>Range <replaceable
>intervall</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Tar bort text i det givna intervallet. Returnerar <literal
>sant</literal
> om det lyckas, eller <literal
>falskt</literal
> om dokumentet är skrivskyddat. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.insertLine(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Infogar text på den givna raden. Returnerar <literal
>sant</literal
> om det lyckas, eller <literal
>falskt</literal
> om dokumentet är skrivskyddat eller raden inte ingår i dokumentets intervall. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.removeLine(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Tar bort den givna textraden. Returnerar <literal
>sant</literal
> om det lyckas, eller <literal
>falskt</literal
> om dokumentet är skrivskyddat eller raden inte ingår i dokumentets intervall. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.wrapLine(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
bool document.wrapLine(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Radbryter raden vid den givna markörpositionen. Returnerar <literal
>sant</literal
> om det lyckas, eller <literal
>falskt</literal
>, t.ex. om rad &lt; 0. </para>
<para
>Sedan: KDE 4.9 </para>
</listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>void document.joinLines(<parameter
>int <replaceable
>startrad</replaceable
></parameter
>, <parameter
>int <replaceable
>slutrad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Sammanfogar rader från <replaceable
>startrad</replaceable
> till <replaceable
>slutrad</replaceable
>. Två på varandra följande rader åtskiljs alltid med exakt ett mellanslag. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.lines();
</synopsis
></term>
<listitem
><para
>Returnerar antal rader i dokumentet. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.length();
</synopsis
></term>
<listitem
><para
>Returnerar antal tecken i dokumentet. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.lineLength(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar längden på <replaceable
>rad</replaceable
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>void document.editBegin();
</synopsis
></term>
<listitem
><para
>Startar en redigeringsgrupp för gruppering av ångra/gör om. Försäkra dig om att alltid anropa <function
>editEnd()</function
> lika många gånger som du anropar <function
>editBegin()</function
>. Att anropa <function
>editBegin()</function
> använder en referensräknare internt, dvs. anropet kan nästlas. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>void document.editEnd();
</synopsis
></term>
<listitem
><para
>Avslutar en redigeringsgrupp. Det sista anropet av <function
>editEnd()</function
> (dvs. det för det första anropet till <function
>editBegin()</function
>) avslutar redigeringssteget. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.firstColumn(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar det första tecknet som inte är ett blanktecken på given <replaceable
>rad</replaceable
>. Om det bara finns blanktecken på raden, är returvärdet <literal
>-1</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.lastColumn(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar det sista tecknet som inte är ett blanktecken på given <replaceable
>rad</replaceable
>. Om det bara finns blanktecken på raden, är returvärdet <literal
>-1</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.prevNonSpaceColumn(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
int document.prevNonSpaceColumn(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar kolumnen med ett tecken som inte är ett blanktecken med början på given markörposition genom att söka bakåt. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.nextNonSpaceColumn(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
int document.nextNonSpaceColumn(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar kolumnen med ett tecken som inte är ett blanktecken med början på given markörposition genom att söka framåt. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.prevNonEmptyLine(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar nästa rad som inte är tom och som innehåller tecken som inte är blanktecken, genom att söka bakåt. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.nextNonEmptyLine(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar nästa rad som inte är tom och som innehåller tecken som inte är blanktecken, genom att söka framåt. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.isInWord(<parameter
>String <replaceable
>tecken</replaceable
></parameter
>, <parameter
>int <replaceable
>egenskap</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
>, om givet <replaceable
>tecken</replaceable
> med given <replaceable
>egenskap</replaceable
> kan vara en del av ett  ord, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.canBreakAt(<parameter
>String <replaceable
>tecken</replaceable
></parameter
>, <parameter
>int <replaceable
>egenskap</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
>, om givet <replaceable
>tecken</replaceable
> med given <replaceable
>egenskap</replaceable
> är lämpat att bryta en rad, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.canComment(<parameter
>int <replaceable
>startegenskap</replaceable
></parameter
>, <parameter
>int <replaceable
>slutegenskap</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om ett intervall som börjar och slutar med den givna egenskapen är lämpat att kommenteras bort, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.commentMarker(<parameter
>int <replaceable
>egenskap</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar kommentarmarkören för enraderskommentarar för en given <replaceable
>egenskap</replaceable
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.commentStart(<parameter
>int <replaceable
>egenskap</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar kommentarmarkören för början av flerraderskommentarer för en given <replaceable
>egenskap</replaceable
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.commentEnd(<parameter
>int <replaceable
>egenskap</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar kommentarmarkören för slutet av flerraderskommentarer för en given <replaceable
>egenskap</replaceable
>. </para
></listitem>
</varlistentry>



<varlistentry>
<term
><synopsis
>int document.attribute(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
int document.attribute(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar egenskapen på den angivna markörpositionen. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.isAttribute(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>, <parameter
>int <replaceable
>egenskap</replaceable
></parameter
>);
bool document.isAttribute(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>, <parameter
>int <replaceable
>egenskap</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om egenskapen på den givna markörpositionen är lika med <replaceable
>egenskap</replaceable
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.attributeName(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
String document.attributeName(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar egenskapsnamnet som läsbar text. Det är lika med namnet <literal
>itemData</literal
> i syntaxfärgläggningsfilerna. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.isAttributeName(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>, <parameter
>String <replaceable
>namn</replaceable
></parameter
>);
bool document.isAttributeName(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>, <parameter
>String <replaceable
>namn</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om egenskapsnamnet på en viss markörposition motsvara givet <replaceable
>namn</replaceable
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.variable(<parameter
>String <replaceable
>nyckel</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar värdet på den begärda dokumentvariabeln <replaceable
>nyckel</replaceable
>. Om dokumentvariabeln inte finns, är returvärdet en tom sträng. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>String document.setVariable(<parameter
>String <replaceable
>nyckel</replaceable
></parameter
>, <parameter
>String <replaceable
>värde</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Ställ in värdet på den begärda dokumentvariabeln <replaceable
>nyckel</replaceable
>. Returnerar värdet av den inställda variabeln. </para>
<para
>Se också: <link linkend="config-variables"
>Kate-dokumentvariabler</link
> </para>
<para
>Sedan: KDE 4.8 </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.firstVirtualColumn(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar den virtuella kolumnen för det första tecknet som inte är ett blanktecken på den givna raden, eller <literal
>-1</literal
> om raden är tom eller bara innehåller blanktecken. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.lastVirtualColumn(<parameter
>int <replaceable
>rad</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar den virtuella kolumnen för det sista tecknet som inte är ett blanktecken på den givna raden, eller <literal
>-1</literal
> om raden är tom eller bara innehåller blanktecken. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.toVirtualColumn(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
int document.toVirtualColumn(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
Cursor document.toVirtualCursor(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Konverterar den givna <quote
>verkliga</quote
> markörpositionen till en virtuell markörposition, och returnerar antingen ett heltal eller ett markörobjekt. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.fromVirtualColumn(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>virtuell_kolumn</replaceable
></parameter
>);
int document.fromVirtualColumn(<parameter
>Cursor <replaceable
>virtuell_markör</replaceable
></parameter
>);
Cursor document.fromVirtualCursor(<parameter
>Cursor <replaceable
>virtuell_markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Konverterar den givna virtuella markörpositionen till en <quote
>verklig</quote
> markörposition, och returnerar antingen ett heltal eller ett markörobjekt. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Cursor document.anchor(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>, <parameter
>Char <replaceable
>tecken</replaceable
></parameter
>);
Cursor document.anchor(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>, <parameter
>Char <replaceable
>tecken</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Söker bakåt efter det givna tecknet med början på den givna markören. Om exempelvis '(' anges som tecken, returnerar funktionen positionen på ett inledande '('. Det sker med referensräkning, dvs. andra '(...)' ignoreras. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>Cursor document.rfind(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>, <parameter
>int <replaceable
>egenskap</replaceable
> = -1</parameter
>);
Cursor document.rfind(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>, <parameter
>String <replaceable
>text</replaceable
></parameter
>, <parameter
>int <replaceable
>egenskap</replaceable
> = -1</parameter
>);
</synopsis
></term>
<listitem
><para
>Söker bakåt efter den givna texten med lämplig <replaceable
>egenskap</replaceable
>. Argumentet <replaceable
>egenskap</replaceable
> ignoreras om det anges som <literal
>-1</literal
>. Den returnerade markören är ogiltig om texten inte kunde hittas. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>int document.defStyleNum(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
int document.defStyleNum(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar standardstilen som används på den givna markörpositionen. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.isCode(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
bool document.isCode(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
> om egenskapen på given markörposition inte är lika med någon av följande stilar: <literal
>dsComment</literal
>, <literal
>dsString</literal
>, <literal
>dsRegionMarker</literal
>, <literal
>dsChar</literal
>, <literal
>dsOthers</literal
>. </para
></listitem>
</varlistentry>



<varlistentry>
<term
><synopsis
>bool document.isComment(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
bool document.isComment(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
>, om egenskapen för tecknet på markörpositionen är <literal
>dsComment</literal
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.isString(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
bool document.isString(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
>, om egenskapen för tecknet på markörpositionen är <literal
>dsString</literal
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.isRegionMarker(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
bool document.isRegionMarker(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
>, om egenskapen för tecknet på markörpositionen är <literal
>dsRegionMarker</literal
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.isChar(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
bool document.isChar(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
>, om egenskapen för tecknet på markörpositionen är <literal
>dsChar</literal
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry>


<varlistentry>
<term
><synopsis
>bool document.isOthers(<parameter
>int <replaceable
>rad</replaceable
></parameter
>, <parameter
>int <replaceable
>kolumn</replaceable
></parameter
>);
bool document.isOthers(<parameter
>Cursor <replaceable
>markör</replaceable
></parameter
>);
</synopsis
></term>
<listitem
><para
>Returnerar <literal
>sant</literal
>, om egenskapen för tecknet på markörpositionen är <literal
>dsOthers</literal
>, annars <literal
>falskt</literal
>. </para
></listitem>
</varlistentry
></variablelist>
</para>

</sect3>
</sect2>
</sect1>
</chapter>
