<chapter id="setup">

<chapterinfo>
  <authorgroup>
    <author
><firstname
>Bernd</firstname
><surname
>Pol</surname
></author>
    <!-- ROLES_OF_TRANSLATORS -->
  </authorgroup>
</chapterinfo>

<title
>Anpassa &kdevelop;</title>

<para
>&kdevelop; är en mycket kraftfull och flexibel integrerad utvecklingsmiljö, som erbjuder många möjligheter för anpassning enligt dina behov. För att göra inställningar, välj <menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa KDevelop...</guimenuitem
></menuchoice
>. Det gör att inställningsdialogrutan dyker upp, som består av ett fönster för att välja inställningar till vänster och inställningsdialogrutan till höger, vars innehåll varierar beroende på gruppen av inställningar du valt. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-select.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Välj en grupp av inställningar </para
></caption>
  </mediaobject>
</screenshot>

<para
>Vi beskriver inställningarna i en annan ordning, uppdelat i huvudämnena <link linkend="setup-general"
>Allmänna inställningar</link
>, <link linkend="setup-docu"
>Inställning av dokumentationsträdet</link
> och <link linkend="setup-advanced"
>Avancerade inställningar</link
>, vilket leder till en intuitivare läsupplevelse. </para>
<para
>Om du vill slå upp en viss grupp av inställningar direkt, använd en av följande länkar. </para>
<simplelist>
  <member
><link linkend="setup-main"
>Allmänt</link
></member>
  <member
><link linkend="setup-plugins"
>Insticksprogram</link
></member>
  <member
><link linkend="setup-format"
>Formatering av källkod</link
></member>
  <member
><link linkend="setup-new-file-wizard"
>Guide för ny fil</link
></member>
  <member
><link linkend="setup-ui"
>Användargränssnitt</link
></member>
  <member
><link linkend="setup-editor"
>Editor</link
></member>
  <member
><link linkend="setup-abbrev"
>Förkortningar</link
></member>
  <member
><link linkend="setup-menu-standard"
>Menyn Verktyg</link
></member>
  <member
><link linkend="setup-menu-external"
>Externa verktyg</link
></member>
  <member
><link linkend="setup-docu"
>Dokumentation</link
></member>
  <member
><link linkend="setup-snippets"
>Kodsnuttar</link
></member>
  <member
><link linkend="setup-fileselector"
>Filväljare</link
></member>
</simplelist>

<sect1 id="setup-general">
<title
>Allmänna inställningar</title>

<para
>Allmänna inställningar rör de vanligare aktiviteterna för att anpassa &kdevelop;, där det finns: </para>
<itemizedlist>
  <listitem
><para>
  <link linkend="setup-main"
>Allmän inställning</link>
  </para
></listitem>
  <listitem
><para>
  <link linkend="setup-ui"
>Välja användargränssnitt</link>
  </para
></listitem>
  <listitem>
    <para
>Aktiviteter för källkodsredigering </para>
    <itemizedlist>
      <listitem
><para>
      <link linkend="setup-editor"
>Välja en editor</link>
      </para
></listitem>
      <listitem
><para>
      <link linkend="setup-format"
>Välja stil för källkodsformatering</link>
      </para
></listitem>
      <listitem
><para>
      <link linkend="setup-snippets"
>Ställa in verktyget för kodsnuttar</link>
      </para
></listitem>
    </itemizedlist>
  </listitem>
  <listitem
><para>
  <link linkend="setup-fileselector"
>Anpassa filväljaren</link>
  </para
></listitem>
</itemizedlist>

<sect2 id="setup-main">
<title
>Allmän inställning</title>

<para
>Inställningsdialogrutan <guilabel
>Allmänt</guilabel
> låter dig definiera grundläggande beteende hos &kdevelop; som sällan ändras under dagligt arbete. Det rör: </para>
<itemizedlist>
  <listitem>
    <para
>Allmänna projektinställningar som </para>
    <itemizedlist>
      <listitem
><para
>definiera en <link linkend="setup-main-projects"
>standardprojektkatalog</link
> som &kdevelop; ska använda för nya projekt. </para
></listitem>
       <listitem
><para
>bestämma om du vill att &kdevelop; <link linkend="setup-main-preload"
>automatiskt ska ladda</link
> projektet du senast arbetade med. </para
></listitem>
   </itemizedlist>
  </listitem>
  <listitem>
    <para
>Välja ett teckensnitt för de oftast använda utmatningsfönstren, nämligen </para>
    <itemizedlist>
      <listitem
><para
><link linkend="setup-main-messages-font"
>Meddelandeutmatningen</link
> som &kdevelop; använder för att visa t.ex. kompileringsprocesser, och </para
></listitem>
      <listitem
><para
><link linkend="setup-main-applications-font"
>Programutmatningen</link
> som visar fel- och tillståndsinformation som rör ett program som kör. </para
></listitem>
    </itemizedlist>
  </listitem>
  <listitem>
    <para
>En del vanliga beteenden som rör rader som visas i fönstret <guilabel
>Meddelandeutmatning</guilabel
>, nämligen </para>
    <itemizedlist>
      <listitem
><para
>om långa rader <link linkend="setup-main-wrap"
>radbryts</link
>, och </para
></listitem>
      <listitem
><para
>om <link linkend="setup-main-navigation"
>meddelanden om katalogbyte</link
> som ges av <command
>Make</command
> visas. </para
></listitem>
    </itemizedlist>
  </listitem>
  <listitem
><para
><link linkend="setup-main-compile"
>Detaljnivån</link
> för meddelanden om kompileringsprocessen som visas i fönstret <guilabel
>Meddelandeutmatning</guilabel
>. </para
></listitem>
</itemizedlist>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-general.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Dialogrutan för allmänna inställningar </para
></caption>
  </mediaobject>
</screenshot>

<formalpara id="setup-main-preload">
<title
>Ladda senaste projekt vid start</title>

<para
>Markera den här kryssrutan om du vill fortsätta att arbeta med det senaste projektet du arbetade med. Det gör att &kdevelop; automatiskt laddar projektet vid start. Det visas oftast med samma tillstånd som du lämnade arbetet, så att du enkelt kan fortsätta. </para>
</formalpara>

<formalpara id="setup-main-projects">
<title
>Standardprojektkatalog</title>
<para
>Normalt använder &kdevelop; en gemensam överliggande katalog för alla nya projekt. Skriv in absolut sökväg till denna gemensamma katalog i rutan eller välj den i katalogstrukturen. &kdevelop; placerar alla nya projekt här som underkataloger. </para>
</formalpara>
<note
><para
>Du kan förstås ändra katalogsökvägen för ett nytt projekt när du ställer in det i <link linkend="applicationwizard"
>Projektguiden</link
>. </para
></note>

<formalpara id="setup-main-messages-font">
<title
>Teckensnitt i fönstret för meddelandeutmatning</title>
<para
>För att välja ett lämpligt teckensnitt för fönstret <guilabel
>Meddelandeutmatning</guilabel
>, klicka på knappen <guilabel
>Fönsterteckensnitt</guilabel
> som visar teckensnittet som för närvarande är valt (det står <quote
>Arial</quote
> på bilden ovan). &kde;:s vanliga dialogruta <guilabel
>Välj teckensnitt</guilabel
> dyker upp, där du kan välja teckensnittet som ska användas. </para>
</formalpara>
<note
><para
>När &kdevelop; först startar initieras teckensnittsinställningen till det standardteckensnitt som &kde;-användaren har inställt. <emphasis
>Den här inställningen är fast</emphasis
>, så om du ändrar <menuchoice
><guimenuitem
>Inställningar</guimenuitem
> <guimenuitem
>Utseende och teman</guimenuitem
> <guimenuitem
>Teckensnitt</guimenuitem
></menuchoice
> i <guilabel
>Inställningscentralen</guilabel
> påverkas inte &kdevelop;s teckensnittsval. Du måste explicit välja ett nytt teckensnitt för fönstret <guilabel
>Meddelandeutmatning</guilabel
>. </para
></note>

<formalpara id="setup-main-wrap">
<title
>Radbrytning</title>
<para
>Normalt radbryter &kdevelop; långa rader i fönstret <guilabel
>Meddelandeutmatning</guilabel
> så att värdefull information inte lätt förbises. Ibland kan detta skräpa ner långa meddelandelistor. Ta bort kryssmarkeringen om du inte vill att radbrytning ska ske. </para>
</formalpara>
<tip
><para
>Det finns ett alternativt sätt att ändra radbrytningen. Högerklicka bara i fönstret <guilabel
>Meddelandeutmatning</guilabel
> och markera eller avmarkera alternativet <guimenuitem
>Radbrytning</guimenuitem
> i menyn som dyker upp. </para
></tip>

<formalpara id="setup-main-navigation">
<title
>Meddelanden om katalogbyte</title>
<para
>Verktyget <command
>Make</command
> visar oftast meddelanden som <quote
>Entering directory</quote
> eller <quote
>Leaving directory</quote
> när byte av arbetskatalog sker. Eftersom det här skräpar ner listan med meddelanden i fönstret <guilabel
>Meddelandeutmatning</guilabel
> undertrycker &kdevelop; normalt dessa meddelanden. Markera kryssrutan om du vill observera vilka kataloger som <command
>Make</command
> arbetar i. </para>
</formalpara>
<note
><para
>Ändringar av inställningen påverkar bara behandling av nya meddelanden. Gamla katalogbytesmeddelanden förblir synliga när den här funktionen stängs av. </para
></note>

<formalpara id="setup-main-compile">
<title
>Kompilatorutmatning</title>
<para
>&kdevelop; förbehandlar meddelanden som fönstret <guilabel
>Meddelandeutmatning</guilabel
> visar under byggprocessen för att filtrera onödig information. Du kan styra detaljnivån som &kdevelop; visar med alternativknapparna i det här fältet. </para>
</formalpara>
<variablelist>
  <varlistentry>
    <term
><guilabel
>Mycket kort</guilabel
></term>
    <listitem
><para
>Visa bara varningar, fel och filnamnen som kompileras. </para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Kort</guilabel
></term>
    <listitem
><para
>Undertryck alla kompileringsflaggor, och ändra format till något mer läsbart. </para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Fullständig</guilabel
></term>
    <listitem
><para
>Visa all utmatning utan förändring. </para
></listitem>
  </varlistentry>
</variablelist>

<tip
><para
>Det finns ett alternativt sätt att ändra detaljnivå för kompilatorutmatning. Högerklicka bara i fönstret <guilabel
>Meddelandeutmatning</guilabel
> och välj motsvarande detaljnivå i menyn som dyker upp. </para
></tip>

<formalpara id="setup-main-applications-font">
<title
>Teckensnitt i fönstret för programutmatning</title>
<para
>Fönstret <guilabel
>Programutmatning</guilabel
> används för att visa fel- och tillståndsinformation från program som körs inne i &kdevelop;. Det är information som programmen oftast skickar till konsollen när de körs fristående. Alltså behöver du inte lämna den grafiska utvecklingsmiljön när du testar programmet du för närvarande arbetar med. </para>
</formalpara>
<para
>För att välja ett lämpligt teckensnitt för fönstret <guilabel
>Programutmatning</guilabel
>, klicka på knappen <guilabel
>Fönsterteckensnitt</guilabel
> som visar teckensnittet som för närvarande är valt (det står <quote
>Arial</quote
> på bilden ovan). &kde;:s vanliga dialogruta <guilabel
>Välj teckensnitt</guilabel
> dyker upp, där du kan välja teckensnittet som ska användas. </para>
<note
><para
>När &kdevelop; först startar initieras teckensnittsinställningen till det standardteckensnitt som &kde;-användaren har inställt. <emphasis
>Den här inställningen är fast</emphasis
>, så om du ändrar <menuchoice
><guimenuitem
>Inställningar</guimenuitem
> <guimenuitem
>Utseende och teman</guimenuitem
> <guimenuitem
>Teckensnitt</guimenuitem
></menuchoice
> i <guilabel
>Inställningscentralen</guilabel
> påverkas inte &kdevelop;s teckensnittsval. Du måste explicit välja ett nytt teckensnitt för fönstret <guilabel
>Programutmatning</guilabel
>. </para
></note>

</sect2
> <!-- setup-main -->

<sect2 id="setup-ui">
<title
>Välja användargränssnitt</title>

<indexterm zone="setup-ui">
  <primary
>användargränssnitt</primary>
  <secondary
>byta läge</secondary
></indexterm>
<indexterm zone="setup-ui">
  <primary
>byta gränssnittsläget</primary
></indexterm>

<para
>Som redan nämnts i kapitlet <link linkend="uimodes-survey"
>Tillgängliga lägen för användargränssnitt</link
> finns det fyra olika sätt som &kdevelop;s arbetsområde kan ställas in, nämligen: </para>
<itemizedlist>
  <listitem
><para>
  <link linkend="ideal-desc"
>IDEA-fönsterläge</link>
  </para
></listitem>
  <listitem
><para>
  <link linkend="mdi-desc"
>Underramsläge</link>
  </para
></listitem>
  <listitem
><para>
  <link linkend="tabbed-desc"
>Fliksidläge</link>
  </para
></listitem>
  <listitem
><para>
  <link linkend="toplevel-desc"
>Toppnivåläge</link>
  </para
></listitem>
</itemizedlist>

<para
>För att byta läge för användargränssnittet välj <menuchoice
> <guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa KDevelop...</guimenuitem
></menuchoice
> i menyraden. Dialogrutan <guilabel
>Anpassa KDevelop</guilabel
> dyker upp, där du måste välja <guilabel
>Användargränssnitt</guilabel
> i trädet till vänster. Då visas följande inställningsdialogruta till höger: </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="select-user-interface-0.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Välj ett användargränssnittsläge </para
></caption>
  </mediaobject>
</screenshot>

<para
>Markera alternativknappen för gränssnittsläget du vill byta till, och klicka därefter på <guibutton
>Ok</guibutton
>. </para>

<note
><para
>Glöm inte att starta om &kdevelop; för att alla dessa val ska få effekt. </para
></note>

<para
>Om du antingen valt <guilabel
>IDEA-fönsterläge</guilabel
> eller <guilabel
>Fliksidläge</guilabel
> blir ytterligare två inställningsrutor tillgängliga: <link linkend="setup-ui-tabs"
>Använd flikar</link
> och <link linkend="setup-ui-hover"
>Använd stäng när musen hålls stilla</link
>. De gör det möjligt att anpassa under vilka omständigheter flikar visas ovanför dokumentfönster, och om du kan stänga dokument med ett klick på flikens ikon. </para>
<para
>Enbart i <guilabel
>IDEA-fönsterläge</guilabel
> finns ännu en inställningsruta tillgänglig, <link linkend="setup-ui-toolview"
>Fliklayout för verktygsvy</link
> som egentligen låter dig välja mellan olika storlekar hos flikarna för verktygsvyer som omger huvudarbetsytan i detta läge. </para>

<formalpara id="setup-ui-tabs">
<title
>Anpassa visningen av flikraden för dokumentation</title>

<para
>Med IDEA-fönsterläge och fliksidläge finns det normalt namngivna flikar ovanför dokumentfönstren, så att du enkelt kan välja olika dokument med ett vänsterklick. Om du föredrar att ge mer utrymme till dokumentfönstren på huvudarbetsytan i &kdevelop;, kan du byta till ett annat beteende i inställningsrutan <guilabel
>Använd flikar</guilabel
>. </para>
</formalpara>

<variablelist>
<varlistentry>
  <term
><guilabel
>Alltid</guilabel
></term>
  <listitem
><para
>Det här är standardvärdet: Visa en flik som består av en ikon och dokumentnamnet ovanför varje dokumentfönster på huvudytan av skärmen i &kdevelop;. </para
></listitem>
</varlistentry>
<varlistentry>
  <term
><guilabel
>Vid mer än en</guilabel
></term>
  <listitem
><para
>Visa inte en flik när bara ett dokument är öppet. Om mer än ett dokument är öppet, visar &kdevelop; dock en flikrad som motsvarar valet <guilabel
>Alltid</guilabel
> ovan. Du kan vilja använda det här läget om du oftast arbetar med ett enda dokument, eftersom läget tillhandahåller ett större vertikalt utrymme. </para
></listitem>
</varlistentry>
<varlistentry>
  <term
><guilabel
>Aldrig</guilabel
></term>
  <listitem
><para
>Visa aldrig en flikrad för att välja dokument. Du kanske föredrar det här läget om du sällan använder musen för att byta mellan dokument. Det tillhandahåller ett större vertikalt utrymme för alla dokumentfönster. Använd menyn <guimenu
>Fönster</guimenu
> i &kdevelop; för att välja ett annat dokumentfönster eller stänga något. </para
></listitem>
</varlistentry>
</variablelist>

<formalpara id="setup-ui-hover">
<title
>Ställa in att stänga ett dokument genom att klicka på dess flik</title>
<para
>När du anpassar &kdevelop; att visa flikraden för dokument, antingen alltid eller när mer än ett dokument är öppet på huvudarbetsytan, kan du lägga till ytterligare en funktion till flikarna förutom möjligheten att välja dokument. Använd inställningsrutan <guilabel
>Använd stäng när musen hålls stilla</guilabel
> för detta. </para>
</formalpara>
<variablelist>
<varlistentry>
  <term
><guilabel
>Nej</guilabel
></term>
  <listitem
><para
>Det här är standardbeteendet. Ingen extra funktion läggs till för flikarna. De kan bara användas för att välja dokumentfönster med vänsterklick. </para
></listitem>
</varlistentry>
<varlistentry>
  <term
><guilabel
>Ja</guilabel
></term>
  <listitem
><para
>När du markerar den här alternativknappen, låter &kdevelop; dig stänga ett dokumentfönster med ett vänsterklick. Använd musen för att peka på den lilla ikonen till vänster i flikraden. Den ändras till en stängningssymbol. Klicka nu med vänsterknappen på den ändrade symbolen, så stänger &kdevelop; motsvarande dokumentfönster. </para
></listitem>
</varlistentry>
<varlistentry>
  <term
><guilabel
>Ja, fördröjd</guilabel
></term>
  <listitem
><para
>När den här alternativknappen är markerad, låter &kdevelop; dig stänga ett dokumentfönster som beskrivits för fallet <guilabel
>Ja</guilabel
> ovan. Ikonen ändras dock inte omedelbart, utan det blir en kort fördröjning innan stängningsikonen dyker upp. </para
></listitem>
</varlistentry>
</variablelist>

<formalpara id="setup-ui-toolview">
<title
>Anpassa fliklayout för verktygsvyn</title>

<para
>Inställningsrutan <guilabel
>Fliklayout för verktygsvy</guilabel
> är bara tillgänglig i IDEA-fönsterläge. Använd alternativknapparna för att ställa in utseendet för verktygsvyernas flikar som omger huvudarbetsytan i detta läge. </para>
</formalpara>
<variablelist>
<varlistentry>
  <term
><guilabel
>Ikoner</guilabel
></term>
  <listitem>
  <para
>Varje flik visar bara en ikon. Om motsvarande verktygsvy visas, öppnas fliken och en beskrivande text för verktygsvyn visas. Du kan vilja använda det här läget om du arbetar med en bildskärm med begränsad upplösning. </para>
  <para
>Ikonerna är dock inte särskilt beskrivande. Om du vill ta reda på vilken verktygsvy som hör ihop med en given flik, peka på den med musen och vänta en sekund. Ett kort verktygstips dyker då upp med verktygsvyns namn. </para>
  </listitem>
</varlistentry>
<varlistentry>
  <term
><guilabel
>Text</guilabel
></term>
  <listitem
><para
>Det här är standardläget för visning av verktygsvyernas flikar. Varje flik visar namnet på tillhörande verktygsvy. </para
></listitem>
</varlistentry>
<varlistentry>
  <term
><guilabel
>Text och ikoner</guilabel
></term>
  <listitem
><para
>Om du tycker att den vanliga visningen av text för verktygsvyerna verkar för trist, och du arbetar på en bildskärm med hög upplösning, kan du vilja markera den här alternativknappen. Den gör att namnet för motsvarande verktygsvy visas på varje flik med en ikon till vänster om det, vilket gör det enklare att skilja på flikarna. Ett exempel visas på illustrationen <link linkend="folded-toolview-tabs"
>Radbrytning av verktygsvyernas flikar</link
> nedan. </para
></listitem>
</varlistentry>
</variablelist>

<formalpara>
<title
>Radbrytning av verktygsvyernas flikar</title>
<para
>Om du valde att låta IDEA-fönsterlägets flikar för verktygsvyer visa text (med eller utan tillhörande ikoner) behöver du inte oroa dig för att de döljs bakom något verktygsvyfönster. Om ett av de nedre verktygsvyfönstren upptar mer utrymme än vad som är tillgängligt för att visa alla (vertikala) flikar, radbryts de som illustrationen visar: </para>
</formalpara>
<screenshot>
  <mediaobject id="folded-toolview-tabs">
    <imageobject>
      <imagedata fileref="folded-tabs.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Verktygsvyernas flikar radbryts för att inte döljas bakom ett annat fönster som visas. </para
></caption>
  </mediaobject>
</screenshot>

<note
><para
>Det aktiva verktygsvyfönstret måste visas fast (utan överlappning), och dela arbetsytan med andra fönster, för att tvinga fram en sådan radbrytning av flikar. Klicka på den lilla fyrkanten i fönsterramen för att åstadkomma läget som visas i exemplet. </para
></note>

</sect2
> <!-- setup-ui -->

<sect2 id="setup-editor">
<title
>Välja en editor</title>

<para
>&kdevelop; låter dig välja ditt favoritverktyg för textredigering. Markera raden <guilabel
>Editor</guilabel
> i trädet till vänster i fönstret <guilabel
>Anpassa KDevelop</guilabel
>. Följande dialogruta visas till höger: </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-editor.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Välja en editor </para
></caption>
  </mediaobject>
</screenshot>

<para
>För att välja en ny editor, klicka på pilen i kombinationsrutan. Beroende på gränssnitten för redigeringsdelprogram som &kde;-versionen har kompilerats med, ser du en lista med editorer som du kan välja bland (se den <link linkend="setup-editor-kparts"
>viktiga anmärkningen</link
> nedan om detta). Klicka på editorn som du vill ha och klicka på <guilabel
>Ok</guilabel
>. För närvarande finns tre möjligheter: </para>
<variablelist>
  <varlistentry>
  <term
><guilabel
>Inbyggd avancerad texteditor</guilabel
></term>
  <listitem
><para
>Det här är &kde;:s vanliga <application
>Kate</application
> redigeringsdelprogram. </para
></listitem>
  </varlistentry>
  <varlistentry>
  <term
><guilabel
>Inbäddad Vim-komponent</guilabel
></term>
  <listitem>
    <para
>Det här tillhandahålller utseendet och känslan av den vanliga Linux-editorn <application
>vi</application
>. </para>
    <note
><itemizedlist>
      <listitem
><para
>Du måste ha installerat ett lämpligt <application
>Vim</application
>-program. Ta en titt på webbsidan om <ulink url="http://www.freehackers.org/kvim/"
>Kvim</ulink
> för mer information. </para
></listitem>
      <listitem
><para
>Dessutom måste du ställa in Vim-komponenten i &kde;:s  <guilabel
>Inställningscentral</guilabel
> (<menuchoice
><guimenuitem
>KDE komponenter</guimenuitem
> <guimenuitem
>Inställning av Vim-komponent</guimenuitem
></menuchoice
>) innan du kan använda den. </para
></listitem>
    </itemizedlist
></note>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term
><guilabel
>Qt Designer-baserad texteditor</guilabel
></term>
  <listitem
><para
>Det här är editorn som Qt tillhandahåller i sin <application
>Designer</application
>-komponent. </para
></listitem>
  </varlistentry>
</variablelist>

<para
>Dessa redigeringsgränssnitt är fullständigt integrerade med &kdevelop;s integrerade utvecklingsmiljö. I synnerhet tillhandahålls möjligheten att hoppa till källkodsraden som orsakat ett fel genom att bara klicka på felmeddelandet i fönstret <guilabel
>Meddelandeutmatning</guilabel
>. </para>

<note
><para
>Att byta editor påverkar inte filer som redan är öppna. Det finns två sätt att fortsätta. Stäng antingen alla öppna textfönster och öppna dem igen ett i taget. Eller stäng helt enkelt hela projektet och öppna det igen. Fönstren öppnas då automatiskt med det nya texteditorgränssnittet. </para
></note>

<important id="setup-editor-kparts"
><para
>KDevelop låter dig använda editorgränssnitt som har registrerats med &kde; och som tillhandahåller ett KatePart-gränssnitt. Om du saknar en av möjligheterna som visas ovan, kontrollera i din &kde;-installation om motsvarande KPart installerats på ett riktigt sätt. </para
></important>
</sect2
> <!-- setup-editor -->

<sect2 id="setup-format">
<title
>Välja en formateringsstil för källkod</title>

<para
>&kdevelop; formaterar automatiskt källkodstext med en fördefinierad stil. Stilen är mycket anpassningsbar. </para>

<note
><para
>Funktionen för att formatera om källkod är för närvarande bara tillgänglig för C, C++ och &Java;. I synnerhet kan du inte använda den för skriptspråk som t.ex. PHP. Det beror på att &kdevelop; använder programmet <ulink url="http://astyle.sourceforge.net/"
>astyle</ulink
> för att implementera funktionen. </para
></note>

<para
>För att ställa in en specifik formateringsstil, välj <menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa KDevelop...</guimenuitem
></menuchoice
> i menyraden. Dialogrutan <guilabel
>Anpassa KDevelop</guilabel
> dyker upp, där du måste välja <guilabel
>Formatering av källkod</guilabel
> i trädet till vänster. Då visas en serie med tre inställningsdialogrutor till höger, benämnda <link linkend="setup-format-general"
>Allmänt</link
>, <link linkend="setup-format-indent"
>Indentering</link
> och <link linkend="setup-format-other"
>Annan</link
>. </para>

<tip
><para
>Alla stiländringar gäller bara för nyinmatad text. Om du vill ändra formateringsstil för en befintlig källkodstext måste du uttryckligen använda kommandot <menuchoice
><guimenu
>Redigera</guimenu
> <guimenuitem
>Formatera om källkod</guimenuitem
></menuchoice
>. </para
></tip>

<note
><para
>Det exakta resultatet av dessa definitioner av formateringsstil beror på <link linkend="setup-editor"
>editorn</link
> du använder. För närvarande är de flesta inställningar anpassade för redigeringsdelprogrammet Kate (<quote
>Inbäddningsbar avancerad texteditor</quote
>). Vissa andra editorer (t.ex. Qt-editorn) kan bero på sina egna formateringsinställningar. I dessa fall måste du experimentera för att ta reda på exakta effekterna av stilinställningarna som tillhandahålls här. </para
></note>

<warning
><para
>Det kan finnas oförenligheter mellan inställning av stilar som tillhandahålls här och editorn du använder, i sådan utsträckning att det i extrema fall till och med kan förstöra dina filer. Försäkra dig om att du har en säkerhetskopia av dina källkodsfiler innan du provar inställningarna med en editor som inte är standard i &kde;. </para
></warning>

<sect3 id="setup-format-general">
<title
>Allmänna formateringsinställningar</title>

<para
>Fliken <guilabel
>Allmänt</guilabel
> i dialogrutan <guilabel
>Formatering av källkod</guilabel
> låter dig välja en av fem fördefinierade formateringsstilar för källkod. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="SF-general.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Allmän inställning av formateringsstil för källkod </para
></caption>
  </mediaobject>
</screenshot>

<para
>Ett exempel på formaterad källkod visas i fältet till höger. Om du inte tycker om någon av de fördefinierade stilarna kan du klicka på den översta alternativknappen <guilabel
>Användardefinierad</guilabel
>, och definiera en egen formateringsstil för källkod du föredrar under de övriga två flikarna som då blir tillgängliga. </para>

<note
><para
>För närvarande illustreras bara de fördefinierade formateringsstilarna för källkod med en exempeltext. Om du bestämmer dig för att definiera din egen stil, finns ingen visning av exempel tillgänglig. Du måste experimentera med verklig källkodstext för att skräddarsy inställningarna som du vill ha dem. </para
></note>

</sect3
> <!-- setup-format-general -->

<sect3 id="setup-format-indent">
<title
>Inställning av indenteringsstil</title>

<para
>Lämplig indentering är det huvudsakliga sättet att öka läsbarhet för källkodstext. Om du väljer fliken <guilabel
>Indentering</guilabel
> i dialogrutan <guilabel
>Formatering av källkod</guilabel
> visas en serie med formateringsval för indentering grupperade i följande tre rutor: </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="SF-indent.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Inställning av indenteringsstil för källkod </para
></caption>
  </mediaobject>
</screenshot>

<formalpara>
<title
>Förvalda inställningar</title>
<para
>Fördefinierade formateringsval gör att källkodstexten liknar formateringsstilen enligt ANSI: </para>
</formalpara>
<screen
>namespace foospace
{
  int Foo()
  {
    if (isBar)
    {
      bar();
      return 1;
    }
    else
      return 0;
  }
}
</screen>

<formalpara id="setup-format-indent-filling">
<title
>Definiera indenteringsbredd och tecken</title>
<para
>Alternativknapparna grupperade under <guilabel
>Utfyllnad</guilabel
> anger hur indentering av källkodstexten visas. </para>
</formalpara>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Använd flikar</guilabel
></term>
    <listitem>
    <para
>Det här gör att editorn infogar ett tabulatortecken för varje indenteringsnivå. Tabulatorbredden är fördefinierad i editorns inställningar (oftast kolumner om 8 eller 4 tecken). Använd <menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa editor...</guimenuitem
></menuchoice
> för att definiera om den. </para>
    <note
><para
>Proceduren för att definiera verklig tabulatorbredd beror på editorn du valt under inställningssteget <link linkend="setup-editor"
>Välja en editor</link
>. Du måste slå upp motsvarande editors hjälp för att ta reda på den. </para
></note>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Använd mellanslag</guilabel
></term>
    <listitem
><para
>Om du markerar alternativknappen, lägger editorn till det antalet mellanslag för varje indenteringsnivå. Ändra värdet från normalvärdet 2 till indenteringsbredden du föredrar. </para
></listitem>
  </varlistentry>
</variablelist>

<formalpara>
<title
>Indentera objekt</title>
<para
>Det här anger vilka (av C/C++) konstruktioner som formateras med en extra indentering från den aktuella indenteringsnivån. </para>
</formalpara>
<para
>Normalt används bara extra indentering för <guilabel
>namnrymder</guilabel
> och <guilabel
>etiketter</guilabel
>. Du kanske vill experimentera med olika inställningar för att anpassa extra indenteringar som du vill ha dem. </para>

<formalpara>
<title
>Fortsättning</title>
<para
>Inställningarna som är grupperade här gäller de fall när källkodsformateringen automatiskt radbryter långa källkodsrader. De tar hänsyn till två specialfall, nämligen att det ska finnas tillräckligt med utrymme för källkoden för djupa indenteringsnivåer och att villkor ska få extra indentering för fortsättningsrader så att de utmärks på ett riktigt sätt. </para>
</formalpara>

<note
><para
>Det här gäller bara för fall med <emphasis
>statisk radbrytning</emphasis
> när en fast maximal radlängd används i källkodstexten. Om du ställer in editorn för att bara dynamiskt radbryta långa rader vid visning (som är möjligt i redigeringsdelprogrammet Kate) visas oftast inte effekten av de här inställningarna. </para
></note>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Maximum i sats</guilabel
></term>
    <listitem>
    <para
>Den här inställningen begränsar maximal möjlig indentering av fortsättningsrader så att det finns tillräckligt med utrymme för att texten ska förbli läsbar. Inga fortsättningsrader indenteras någonsin förbi kolumnantalet som du väljer i det här fältet. </para>
    <para
>Standardinställningen är 40 kolumner (en halv standardsida på 80 kolumner). Du kan vilja öka det här värdet för att hantera bredare papper (t.ex. om du använder utskrift av källkod på liggande format). Eller minska värdet på motsvarande sätt för att ta hänsyn till större marginalinställningar för dina utskrifter. </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Minimum i villkor</guilabel
></term>
    <listitem>
    <para
>Villkor eller källkod som till exempel följer en tilldelningsoperator ska ofta få en extra indentering för fortsättningsrader för att göra texten läsbar. Värdet på den extra indenteringen definieras här. </para>
    <para
>Standardvärdet är <quote
>Två gånger nuvarande</quote
>, vilket betyder att fortsatta villkor får en extra indenteringsnivå jämfört med indenteringsstorleken du valt i gruppen <link linkend="setup-format-indent-filling"
>Utfyllnad</link
>. Du kan ändra den extra indenteringen till ett annat fast värde (inklusive noll) med pilarna, eller genom att direkt skriva in värdet. </para>
    </listitem>
  </varlistentry>
</variablelist>

</sect3
> <!-- setup-format-indent -->

<sect3 id="setup-format-other">
<title
>Annan inställning av formatering</title>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="SF-other.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Annan inställning av formateringsstil för källkod </para
></caption>
  </mediaobject>
</screenshot>

<formalpara>
<title
>Styra positionen av hakparenteser</title>
<para
>Alternativknapparna i (den något felaktigt benämnda) gruppen <guilabel
>Hakparenteser</guilabel
> styr positionen av klamrar som avdelar (C/C++) källkodstext. Det finns tre möjligheter att välja bland. </para>
</formalpara>
<variablelist>
  <varlistentry>
    <term
><guilabel
>Bryt</guilabel
></term>
    <listitem>
    <para
>Det här infogar en radbrytning innan varje inledande klammer. Båda avdelande klamrar i alla block placeras på samma indenteringsnivå som blockets huvudsats.</para>
    <screen
>namespace foospace
{
  int Foo()
  {
    if (isBar)
    {
      bar();
      return 1;
    }
    else
      return 0;
  }
}
    </screen>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Bifoga</guilabel
></term>
    <listitem>
    <para
>Det här behåller inledande klammern i ett block på samma nivå som blockets huvudsats. Avslutande klamrar är på samma indenteringsnivå som blockets huvudsats. Det avslutande <token
>else</token
> i en <token
>if</token
>-sats hålls på samma nivå som avslutande klammer i föregående block. </para>
    <screen
>namespace foospace {
  int Foo() {
    if (isBar) {
      bar();
      return 1;
    } else
      return 0;
  }
}
    </screen>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Linuxstil</guilabel
></term>
    <listitem>
    <para
>Det här är en kompromiss mellan stilarna som anges ovan. Avgränsande klamrar för funktionsblock placeras på nya rader. Klamrar som inleder ett block i en villkorssats eller snurra behålls på samma rad. </para>
    <screen
>namespace foospace
{
  int Foo()
  {
    if (isBar) {
      bar();
      return 1;
    } else
      return 0;
  }
}
    </screen>
    </listitem>
  </varlistentry>
</variablelist>

<formalpara>
<title
>Styra extra mellanslag</title>
<para
>Normalt minimerar &kdevelop; användning av mellanslag i källkodstext. </para>
</formalpara>

<screen
>if (isBar(fooArg)==barValue)
</screen>

<para
>Du kan öka läsbarheten om du tvingar källkodsformateringen att infoga extra mellanslag på särskilda platser. </para>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Lägg till mellanslag omkring parenteser</guilabel
></term>
    <listitem>
    <para
>Vad som i själva verket avses är att lägga till mellanslag omkring text som är inom parenteser. Det ökar läsbarheten för funktionsargument och villkor.</para>
    <screen
>if ( isBar( fooArg )==barValue )
    </screen>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Lägg till mellanslag omkring operatorer</guilabel
></term>
    <listitem>
    <para
>Det här lägger till mellanslag omkring tilldelningar och jämförelseoperatorer för att öka läsbarheten.</para>
    <screen
>if (isBar(fooArg) == barValue)
    </screen>
    </listitem>
  </varlistentry>
</variablelist>

<formalpara>
<title
>Styra formatering av enradskonstruktioner</title>
<para
>Det finns några få tillfällen då du inte vill att källkodsformateringen ska dela en lång rad. Detta kan styras här för C/C++ kod. </para>
</formalpara>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Behåll enradssatser</guilabel
></term>
    <listitem
><para
>Det här behåller enradssatser tillsammans i vissa situationer även om de överskrider en fast maximal radlängd. </para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Behåll enradsblock</guilabel
></term>
    <listitem
><para
>Det här behåller enradsblock tillsammans i vissa situationer även om de överskrider en fast maximal radlängd. </para
></listitem>
  </varlistentry>
</variablelist>

</sect3
> <!-- setup-format-other -->

</sect2
> <!-- setup-format -->

<sect2 id="setup-snippets">
<title
>Anpassa verktyget för kodsnuttar</title>

<para
>När du redigerar i &kdevelop; kan du lagra delar av kod som ofta används som <link linkend="editing-snippets"
>kodsnuttar</link
>. För att anpassa funktionerna hos delprogrammet för kodsnuttar, välj <menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa KDevelop...</guimenuitem
></menuchoice
> i menyraden. Dialogrutan <guilabel
>Anpassa KDevelop</guilabel
> dyker upp, där du måste välja <guilabel
>Kodsnuttar</guilabel
> i trädet till vänster. Då visas följande dialogruta till höger: </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-snippets.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Anpassa verktyget för kodsnuttar </para
></caption>
  </mediaobject>
</screenshot>

<formalpara>
<title
>Aktivera förhandsgranskning av kodsnuttar</title>
<para
>Markera kryssrutan <quote
><guilabel
>Visa kodsnuttens text i verktygstips</guilabel
></quote
> om du vill visa den lagrade texten i ett verktygstipsfönster så fort du håller musmarkören över den kodsnuttens rubrik. </para>
</formalpara>

<formalpara>
<title
>Arbeta med variabler i kodsnuttar</title>
<para
>Verktyget <guilabel
>Kodsnuttar</guilabel
> tillåter varierande text på fördefinierade platser när som helst när du infogar en kodsnutt i en fil. För att åstadkomma det, tillhandahåller <guilabel
>Kodsnuttar</guilabel
> sin egen variabelmekanism. Du kan ställa in dess beteende i gruppen <guilabel
>Variabler</guilabel
>. </para>
</formalpara>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Avskiljare</guilabel
></term>
    <listitem
><para
>Verktyget <guilabel
>Kodsnuttar</guilabel
> känner igen variabler i texten genom att omge variabelnamnet med särskilda skiljetecken. För att använda ett eget skiljetecken, ändra det fördefinierade tecknet <guilabel
>$</guilabel
> i fältet <guilabel
>Avskiljare</guilabel
>. </para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Inmatningsmetod för variabler</guilabel
></term>
    <listitem
><itemizedlist>
      <listitem
><para
><guilabel
>En dialogruta för varje variabel i en kodsnutt</guilabel
> visar i tur och ordning en särskild dialogruta för varje variabel som verktyget hittar när den valda kodsnutten infogas. </para
></listitem>
      <listitem
><para
><guilabel
>En dialogruta för alla variabler i en kodsnutt</guilabel
> visar en gemensam dialogruta där användaren måste fylla i värden för alla variabler innan kodsnutten infogas. </para
></listitem>
    </itemizedlist
></listitem>
  </varlistentry>
</variablelist>

</sect2
> <!-- setup-snippets -->

<sect2 id="setup-fileselector">
<title
>Anpassa filväljaren</title>

<para
>&kdevelop; tillhandahåller insticksprogrammet <guilabel
>Filväljare</guilabel
> som när det laddas vid start, gör det möjligt att navigera till vilken fil eller katalog som helst på systemet. </para>

<screenshot id="setup-fileselector-image">
  <mediaobject>
    <imageobject>
      <imagedata fileref="file-selector.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Filväljaren (IDEA-läge) </para
></caption>
  </mediaobject>
</screenshot>

<para
>Beteendet hos <guilabel
>Filväljaren</guilabel
> kan anpassas i stor utsträckning. Välj <menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa KDevelop...</guimenuitem
></menuchoice
> i menyraden. Dialogrutan <guilabel
>Anpassa KDevelop</guilabel
> dyker upp, där du måste välja <guilabel
> Filväljare</guilabel
> i trädet till vänster. Då visas följande dialogruta till höger. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-file-selector.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Anpassa filväljaren </para
></caption>
  </mediaobject>
</screenshot>

<formalpara>
<title
>Anpassa verktygsraden</title>
<para
>Det finns en verktygsrad längst upp i <guilabel
>Filväljaren</guilabel
> som kan anpassas som vanligt i gruppen <guilabel
>Verktygsrad</guilabel
>. </para>
</formalpara>

<procedure id="setup-fileselector-add-action">
  <title
>Lägg till en åtgärd i verktygsraden</title>
  <step>
    <para
>Markera ett objekt till listan till höger <guilabel
>Aktuella åtgärder</guilabel
>, som den nya åtgärden ska infogas efter. </para>
  </step>
  <step>
    <para
>Markera åtgärden som ska infogas i listan till vänster <guilabel
>Tillgängliga åtgärder</guilabel
>. </para>
  </step>
  <step>
    <para
>Klicka på (den övre) högerpilen mellan de båda listorna. </para>
    <para
>Åtgärden tas bort från listan <guilabel
>Tillgängliga åtgärder</guilabel
> och infogas i listan <guilabel
>Aktuella åtgärder</guilabel
> under den markerade åtgärden. </para>
  </step>
</procedure>

<procedure>
  <title
>Ta bort en åtgärd från verktygsraden</title>
  <step>
    <para
>Markera åtgärden som ska tas bort i listan till höger <guilabel
>Aktuella åtgärder</guilabel
>. </para>
  </step>
  <step>
    <para
>Klicka på (den nedre) vänsterpilen mellan de båda listorna. </para>
    <para
>Den markerade åtgärden tas bort från listan <guilabel
>Aktuella åtgärder</guilabel
> och läggs tillbaka i listan <guilabel
>Tillgängliga åtgärder</guilabel
>. </para>
  </step>
</procedure>

<procedure>
  <title
>Ordna om åtgärderna på verktygsraden</title>
  <step>
    <para
>Markera åtgärden som ska flyttas i listan till höger <guilabel
>Aktuella åtgärder</guilabel
>. </para>
  </step>
  <step>
    <para
>Klicka på uppåt- eller neråtpilen till höger om listan. </para>
    <para
>Den markerade åtgärden flyttas upp eller ner i listan <guilabel
>Aktuella åtgärder</guilabel
>. </para>
  </step>
</procedure>

<formalpara id="setup-fileselector-autosync">
<title
>Definiera när innehållet ska ändras</title>
<para
>Att uppdatera innehållet i fönstret <guilabel
>Filväljare</guilabel
> tar tid och resurser, särskilt vid byte till en annan katalog. Därför är <guilabel
>Filväljaren</guilabel
> normalt inställd på så sätt att dess innehåll bara ändras på begäran, dvs. när du väljer en annan katalog eller när du uttryckligen vill uppdatera innehållet. </para>
</formalpara>

<note
><para
>Klicka på knappen <guilabel
>Uppdatera</guilabel
> i verktygsraden för att uppdatera innehållet i <guilabel
>Filväljaren</guilabel
>. Den här verktygsradsknappen är dock inte normalt tillgänglig. Du måste först <link linkend="setup-fileselector-add-action"
>lägga till den där</link
>. </para
></note>

<para
>Du kan ställa in <guilabel
>Filväljaren</guilabel
> att omedelbart visa vissa ändringar i ditt arbete. Inställningarna i gruppen <guilabel
>Automatisk synkronisering</guilabel
> är ansvariga för detta. </para>

<variablelist>
  <varlistentry>
    <term
><guilabel
>När ett dokument aktiveras</guilabel
></term>
    <listitem
><para
>Om du markerar den här kryssrutan, uppdateras innehållet i <guilabel
>Filväljarens</guilabel
> fönster så fort du går till ett annat dokument som redan är öppnat, t.ex. när du klickar på fliken för motsvarande redigeringsfönster i IDEA-läge. Om det behövs byter <guilabel
>Filväljaren</guilabel
> till katalogen som filen tillhör och uppdaterar skärmen för att visa det verkliga innehållet där. </para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>När ett dokument öppnas</guilabel
></term>
    <listitem
><para
>Om du markerar den här kryssrutan, uppdateras innehållet i <guilabel
>Filväljarens</guilabel
> fönster så fort ett dokument öppnas, t.ex. via menyn <menuchoice
><guimenu
>Arkiv</guimenu
> <guimenuitem
>Öppna</guimenuitem
></menuchoice
>. Om det behövs byter <guilabel
>Filväljaren</guilabel
> till katalogen som filen tillhör och uppdaterar skärmen för att visa det verkliga innehållet där. </para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>När filväljaren blir synlig</guilabel
></term>
    <listitem
><para
>Om du markerar den här kryssrutan uppdateras <guilabel
>Filväljarens</guilabel
> fönster så fort det blir synligt igen. Om det behövs byter det till katalogen som aktuellt dokument tillhör och uppdatera skärmen så att det verkliga innehållet där visas. </para
></listitem>
  </varlistentry>
</variablelist>

<para
>Du kan kombinera inställningarna fritt för att skräddarsy verkligt beteende hos <guilabel
>Filväljaren</guilabel
> som du vill. </para>

<formalpara>
<title
>Styra historiken i kombinationsrutorna</title>
<para
>Det finns två kombinationsrutor längst upp och längst ner i <guilabel
>Filväljarens</guilabel
> innehållsfönster som styr katalogen som visas (den övre kombinationsrutan) och filter som används för visningen (den nedre kombinationsrutan). En historik av de senaste inställningarna finns i urvalsfältet i varje kombinationsruta. Du kan ställa in antalet historikposter enligt följande. </para>
</formalpara>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Kom ihåg platser</guilabel
></term>
    <listitem
><para
>Skriv in maximalt antal katalogval som den övre kombinationsrutan ska komma ihåg här. </para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Kom ihåg filter</guilabel
></term>
    <listitem
><para
>Skriv in maximalt antal filterdefinitioner som den nedre kombinationsrutan ska komma ihåg här. </para
></listitem>
  </varlistentry>
</variablelist>

<formalpara>
<title
>Styra vad som ska kommas ihåg mellan sessioner</title>
<para
>Normalt är <guilabel
>Filväljaren</guilabel
> inställd så att den visar den senaste sessionen igen när &kdevelop; startas nästa gång. Du kan ändra beteendet i inställningsgruppen <guilabel
> Session</guilabel
>. </para>
</formalpara>

<note
><para
>Om &kdevelop; automatiskt startades om av &kde;:s sessionshantering, så har ändringar av dessa inställningar ingen effekt. I detta fall återställs alltid plats- och filterinställningar från den senaste &kde;-sessionen. </para
></note>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Återställ plats</guilabel
></term>
    <listitem>
    <para
>Ta bort kryssmarkeringen här om du inte vill att platser som visas ska kommas ihåg mellan sessioner. </para>
    <note
><para
>Om du markerad en av inställningarna för <link linkend="setup-fileselector-autosync"
>automatisk uppdatering</link
> kan platserna som visas automatiskt ändras oberoende av vad som har kommits ihåg från den tidigare sessionen. </para
></note>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Återställ senaste filter</guilabel
></term>
    <listitem>
    <para
>Ta bort kryssmarkeringen här om du inte vill att filter som används för visningen ska kommas ihåg mellan sessioner. </para>
    </listitem>
  </varlistentry>
</variablelist>

</sect2
> <!-- setup-fileselector -->

<sect2 id="setup-new-file-wizard">
<title
>Anpassa Guiden för ny fil</title>

<para
>(... ännu inte skrivet ...) </para>

</sect2
> <!-- setup-new-file-wizard -->

</sect1
> <!-- setup-general -->

<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->

<sect1 id="setup-docu">
<title
>Anpassa dokumentationen</title>

<para
>&kdevelop; innehåller en mycket kraftfull dokumentationsfunktion som tillhandahåller möjlighet att komma åt flera olika sorters omfattande dokumentation. I IDEA-läge hittar du till exempel fliken <guilabel
>Dokumentation</guilabel
> vid arbetsområdets högerkant. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="documents-contents.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Dokumentationsträdet i &kdevelop; (IDEA-läge) </para
></caption>
  </mediaobject>
</screenshot>

<note
><para
>&kdevelop; måste ha laddat insticksprogrammet <guilabel
>Dokumentation</guilabel
> för att kunna visa dokumentationsträdet. Se avsnittet <link linkend="setup-plugins"
>Insticksverktyg</link
> för mer information. </para
></note>

<para
>Du kan ställa in innehållet i dokumentationsträdet om du väljer <menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa KDevelop...</guimenuitem
></menuchoice
> i menyraden. Dialogrutan <guilabel
>Anpassa KDevelop</guilabel
> dyker upp, där du måste välja <guilabel
>Dokumentation</guilabel
> i fönstret till vänster. </para>

<para
><link linkend="configure-docu-general"
>Inställningssidan</link
> som visas på så sätt, har tre inställningsdialogsidor med flikar, närmare bestämt: </para>

<simplelist>
  <member
><link linkend="setup-docu-general"
>Dokumentationssamlingar</link
></member>
  <member
><link linkend="setup-docu-textsearch"
>Fulltextsökning</link
></member>
  <member
><link linkend="setup-docu-other"
>Övriga</link
></member>
</simplelist>

<sect2 id="setup-docu-general">
<title
>Ställa in dokumentationssamlingar</title>

<para
>Anpassningen av dokumentationsinställningarna har delats upp i en serie dokumentationssamlingar, där var och en ger åtkomst till dokumentationsfiler av något unikt format och någon typ av innehåll. Inställningarna styr vilka dokumentationsposter som listas på sidan <guilabel
>Innehåll</guilabel
> under funktionen <guilabel
>Dokumentation</guilabel
> i &kdevelop;, och hur användaren kan komma åt detaljer i dokumentationen med indexerade sökningar och fulltextsökningar. </para>
<para
>Fliken <guilabel
>Dokumentation</guilabel
> tillhandahåller en serie inställningssidor som är ordnade vertikalt som en hög med indexkort. En sida i taget visas efter ett klick på titeln för dess indexkort: </para>
<simplelist>
  <member
><link linkend="setup-docu-general-qt"
>Qt-dokumentationssamling</link
></member>
  <member
><link linkend="setup-docu-general-chm"
>CHM-dokumentationssamling</link
></member>
  <member
><link linkend="setup-docu-general-dox"
>Doxygen-dokumentationssamling</link
></member>
  <member
><link linkend="setup-docu-general-toc"
>KDevelop innehållsförteckning-dokumentationssamling</link
></member>
  <member
><link linkend="setup-docu-general-devhelp"
>DevHelp-dokumentationssamling</link
></member>
  <member
><link linkend="setup-docu-general-custom"
>Egen dokumentationssamling</link
></member>
</simplelist>

<para id="configure-docu-general">
<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-docu-general.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Ställa in dokumentationssamlingar </para
></caption>
  </mediaobject>
</screenshot>
</para>

<sect3 id="setup-docu-general-common">
<title
>Vanlig struktur för dokumentationsinställning</title>

<para
>Alla inställningssidor under fliken <guilabel
>Dokumentation</guilabel
> använder en gemensam layout. Du hittar dokumentationsposter som för närvarande är tillgängliga, av typen som listas på den öppna sidan, till vänster och en uppsättning knappar till höger. </para>

<formalpara id="setup-docu-buttons">
<title
>Knappar för att underhålla innehåll i dokumentationlistan</title>

<para
>Det finns tre knappar tillgängliga för att underhålla innehållet på inställningssidorna för dokumentation: </para>
</formalpara>

<variablelist>
  <varlistentry>
    <term
><guibutton
>Lägg till</guibutton
></term>
    <listitem>
      <para
>Visar dialogrutan <guilabel
>Egenskaper för dokumentationskatalog</guilabel
> som visas nedan, där du kan välja källan för dokumentationsposten som ska läggas till och namnge den.</para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guibutton
>Redigera</guibutton
></term>
    <listitem>
      <para
>Visar dialogrutan <guilabel
>Egenskaper för dokumentationskatalog</guilabel
> som visas nedan, där du kan ändra källan för dokumentationsposten tidigare markerad i listan och byta namn på den.</para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guibutton
>Ta bort</guibutton
></term>
    <listitem>
      <para
>Tar bort markerad dokumentationspost från listan.</para>
      <note
><para
>Posten tas bara bort från listan. De verkliga källorna till dokumentationen förblir orörda. Du måste ta bort dem explicit på annat sätt. </para
></note>
    </listitem>
  </varlistentry>
</variablelist>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-docu-edit.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Lägga till eller ändra en dokumentationspost </para
></caption>
  </mediaobject>
</screenshot>

<para
>Knappen till höger om fältet <guilabel
>Plats</guilabel
> visar en katalogdialogruta vars poster oftast är filtrerade enligt den valda inställningssidans filtyp. </para>
<para
>Fältet <guilabel
>Titel</guilabel
> kanske inte går att komma åt, beroende på dokumentationstypen som underhålls. </para>

<formalpara id="setup-docu-columns">
<title
>Dokumentationslistans struktur</title>

<para
>Varje inställningssida för dokumentation visar listade dokumentationsposter i en tabell med fyra kolumner: </para>
</formalpara>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Innehållsförteckning</guilabel
></term>
    <listitem>
      <para
>Om kryssrutan är markerad, visas dokumentationsposten på sidan <guilabel
>Innehåll</guilabel
> under funktionen <guilabel
>Dokumentation</guilabel
> i &kdevelop;. </para>
      <note
><para
>Genom att avmarkera kryssrutan <guilabel
>Innehållsförteckning</guilabel
> inaktiverar i sin tur kryssrutorna <guilabel
>Index</guilabel
> och <guilabel
>Sök</guilabel
> (se nedan). Alltså kan du inte ha poster i dokumentationssamlingen indexerade utan att visa deras innehåll. </para
></note>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Index</guilabel
></term>
    <listitem>
      <para
>Om kryssrutan är markerad byggs ett internt index för dokumentationsposten. Det ger snabb åtkomst till dokumentationen genom att använda sidan <guilabel
>Index</guilabel
> och (valfritt) <guilabel
>Sökning</guilabel
> under funktionen <guilabel
>Dokumentation</guilabel
> i &kdevelop;. </para>
      <note>
        <para
>Det interna indexet byggs första gången användaren väljer sidan <guilabel
>Index</guilabel
>. Det fördröjer den första åtkomsten väsentligt, eftersom indexet läses från disk och lagras i en cache. </para>
        <para
>Alla efterföljande indexsökningar använder dock cachen och är därför väsentligt snabbare. </para>
      </note>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Sök</guilabel
></term>
    <listitem>
      <para
>Om kryssrutan är markerad, inkluderas innehållet i dokumentationsposten i den sökvägen för fulltextsökning på sidan <guilabel
>Sök</guilabel
> under funktionen <guilabel
>Dokumentation</guilabel
> i &kdevelop;. </para>
      <note>
        <para
>&kdevelop; utnyttjar programsamlingen htdig för att utföra fulltextsökningar. Sökningen görs i ett internt index, som htdig-maskineriet måste bygga innan den kan användas. </para>
        <para
>Alla ändringar av kryssrutorna under <guilabel
>Sök</guilabel
> påverkar alltså bara sökningar efter att du har byggt om indexet på sidan <guilabel
>Sök</guilabel
> under funktionen <guilabel
>Dokumentation</guilabel
> i &kdevelop;. </para>
      </note>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Titel</guilabel
></term>
    <listitem
><para
>Det här är namnet på dokumentationsposten som den visas på sidan <guilabel
>Innehåll</guilabel
> under funktionen <guilabel
>Dokumentation</guilabel
> i &kdevelop;. </para
></listitem>
  </varlistentry>
</variablelist>

<note
><para
>Tidigare versioner av &kdevelop; tillät att dokumentationsposterna visades baserat på varje projekt. Det är inte längre tillgängligt. </para
></note>

</sect3
> <!-- setup-docu-general-common -->

<sect3 id="setup-docu-general-qt">
<title
>Qt dokumentationssamlingar</title>

<para
>På den här inställningssidan anpassas all &Qt;-dokumentation. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-docu-general.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Ställa in &Qt;-dokumentationssamlingen </para
></caption>
  </mediaobject>
</screenshot>

<para
>Normalt fyller &kdevelop; i detta vid första start. Det tittar efter vanliga <filename
>*.xml</filename
>, eller <filename
>*.dcf</filename
> dokumentationsfiler i &Qt;-installationskatalogen. Tabellen till vänster listar filerna som &kdevelop; hittade med deras vanliga titlar. </para>

<para
>Om du har en installation som inte följer standard, finns det antingen ingen information listad alls, eller kanske adresserna pekar på felaktiga platser (t.ex. på en annan installation av &Qt; som är tillgänglig på systemet). Du kan justera posterna med <link linkend="setup-docu-buttons"
>knapparna</link
> till höger om listfältet. </para>

<note
><para
>&kdevelop; använder titlar som redan tillhandahålls av den installerade &Qt;-dokumentationen. Därför är inte fältet <guilabel
>Titel</guilabel
> i dialogrutan <guilabel
>Egenskaper för dokumentationskatalog</guilabel
> åtkomligt. </para
></note>

<para
>Normalt visas inte all &Qt;-dokumentation på sidan <guilabel
>Innehåll</guilabel
> under funktionen <guilabel
>Dokumentation</guilabel
> i &kdevelop;. Använd kryssrutan <guilabel
>Innehållsförteckning</guilabel
> i <link linkend="setup-docu-columns"
>inställningstabellen</link
> för att välja vilken dokumentation som ska visas. </para>

<para
>Om du vill att viss specifik &Qt;-dokumentation ska inkluderas i sökindex eller fulltextsökning, använd kryssrutorna <guilabel
>Index</guilabel
> och <guilabel
>Sök</guilabel
> i <link linkend="setup-docu-columns"
>inställningstabellerna</link
>. </para>

</sect3
> <!-- setup-docu-general-qt -->

<sect3 id="setup-docu-general-chm">
<title
>Ställa in CHM-dokumentationssamlingen</title>

<para
>På den här inställningssidan kan du samla dokumentation enligt &Microsoft; CHM-hjälpfilstandard. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-docu-chm.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Ställa in &Microsoft; CHM-standarddokumentationsfiler </para
></caption>
  </mediaobject>
</screenshot>

<para
>Normalt är inställningssidan tom (som visas ovan). Du kan lägga till nya poster med <link linkend="setup-docu-buttons"
>knapparna</link
> till höger om listan. &kdevelop; filtrerar <filename
>*.chm</filename
>-filer i katalogdialogrutan som hör ihop med knapparna <guibutton
>Lägg till</guibutton
> och <guibutton
>Redigera</guibutton
>. </para>

<para
>För mer information om formatet för &Microsoft; <filename
>*.chm</filename
>-filer, se t.ex. "PHP: Documentation - Extended CHM Format" på <ulink url="http://de2.php.net/docs-echm.php"
>http://de2.php.net/docs-echm.php</ulink
>. </para>

</sect3
> <!-- setup-docu-general-chm -->

<sect3 id="setup-docu-general-dox">
<title
>Dokumentation skapad av Doxygen</title>

<para
>På den här inställningssidan anpassas all dokumentation av programmeringsgränssnitt som skapats av &doxygen;. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-docu-dox.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Ställa in dokumentationen av programmeringsgränssnitt skapat av Doxygen </para
></caption>
  </mediaobject>
</screenshot>

<para
>I kortet dokumenterar ett sådant programmeringsgränssnitt gränssnittet för vissa biblioteksfunktioner. Dokumentationen av programmeringsgränssnittet på den här sidan ska skapas av det externa verktyget <ulink url="http://www.stack.nl/~dimitri/doxygen/"
>&doxygen;</ulink
>. </para>
<para
>Dokumentation av programmeringsgränssnitt skapad av &doxygen; består av en serie <filename
>html</filename
>-filer, som börjar med <filename
>index.html</filename
>. Dessutom kan det finnas <filename
>tag</filename
>-filer, som innehåller information med länkar till befintlig dokumentation av programmeringsgränssnitt. Alltså tittar &kdevelop; efter <filename
>index.html</filename
> och <filename
>*.tag</filename
>-filer vid sökning efter dokumentation av programmeringsgränssnitt skapad av &doxygen;. </para>
<para
>Vissa begränsningar i strukturen antas vid sökning efter dokumentation av programmeringsgränssnitt skapad av &doxygen;. Katalogen där filen <filename
>index.html</filename
> finns ska innehålla underkataloger med separata dokumentationssamlingar. Var och en av underkatalogerna antas innehålla en <filename
>.tag</filename
>-fil och en underkatalog vid namn <filename class="directory"
>html/</filename
>. </para>
<para
>Du kan ta en titt på <filename class="directory"
>$KDEDIR/share/doc/HTML/en/kdelibs-apidocs</filename
> där det finns ett exempel på en sådan layout för dokumentation av programmeringsgränssnitt med &doxygen;. </para>

<note
><para
>&kde;:s äldre dokumentation av programmeringsgränssnitt skapat med <ulink url="http://sirtaj.net/projects/kdoc/"
>KDoc</ulink
> stöds inte direkt längre. Om du fortfarande vill använda sådan dokumentation, kan du lägga till den på sidan <link linkend="setup-docu-general-custom"
>Egen dokumentationssamling</link
>. </para
></note>

<para
>&kdevelop; har fyllt i en länk till aktuellt programmeringsgränssnitt för &kde;-biblioteket, under förutsättning att någon hittades. Det finns flera sätt för &kdevelop; att få reda på den: </para>

<itemizedlist>
  <listitem
><para
>Antingen angav du väljaren <option
>--with-kdelibsdoxy-dir</option
> till kommandot <command
>configure</command
> när du kompilerade &kdevelop; (se kapitlet <link linkend="make-api"
>Hur man skaffar dokumentation av programmeringsgränssnittet för KDevelop</link
>). </para
></listitem>
  <listitem
><para
>Eller hittade kommandot <command
>configure</command
> automatiskt ett programmeringsgränssnitt för &kde;-biblioteken som skapats med &doxygen; på en av flera standardplatser som det känner till. </para
></listitem>
  <listitem
><para
>Eller som en sista utväg hittades <filename class="directory"
>$KDEDIR/share/doc/HTML/en/kdelibs-apidocs/</filename
> när &kdevelop; först startade. </para
></listitem>
</itemizedlist>

<para
>Om &kdevelop; inte hittade ett giltigt programmeringsgränssnitt för &kde;-biblioteken som skapats med &doxygen; vid första start, är listan <guilabel
>Dokumentation skapad av Doxygen</guilabel
> tom. </para>

<para
>Du kan lägga till dina egna poster med dokumentation av programmeringsgränssnitt (t.ex. från dina nuvarande projekt) genom att använda <link linkend="setup-docu-buttons"
>knapparna</link
> till höger. Om du vill att de ska inkluderas i indexerad sökning och/eller fulltextsökning, markera kryssrutorna <guilabel
>Index</guilabel
> eller <guilabel
>Sök</guilabel
> i <link linkend="setup-docu-columns"
>inställningstabellen</link
>. </para>

<note
><para
>&kdevelop; använder titelinformationen från <filename
>index.html</filename
>. Därför är inte fältet <guilabel
>Titel</guilabel
> i dialogrutan <guilabel
>Egenskaper för dokumentationskatalog</guilabel
> åtkomligt. </para
></note>

<tip>
  <para
>&kde;-systemet tillhandahåller mer dokumentation av programmeringsgränssnittet än bara &kde;-bibliotekens programmeringsgränssnitt. Du behöver ytterligare information om gränssnitt om du t.ex. vill inkludera &kate;-delprogrammet i dina program. För &kate;-delprogrammet ska du till exempel kompilera och installera &kde;:s programmeringsgränssnitt för basbiblioteken från <ulink url="http://developer.kde.org/source/index.html"
>källkoden</ulink
> (genom att använda kommandona <command
>make apidox</command
> och <command
>make install</command
> för källkoden i <filename class="directory"
>kdebase</filename
>) och därefter lägga till en post i listan <guilabel
>Dokumentation skapad av Doxygen</guilabel
> på detta sätt: </para>
  <screenshot
><mediaobject>
      <imageobject>
        <imagedata fileref="configure-adddialog-baselibs.png" format="PNG"/>
      </imageobject>
      <caption
><para
>Lägga till ett basprogrammeringsgränssnitt för &kde; i listan </para
></caption>
    </mediaobject
></screenshot>
  <para
>(Du ska förstås ersätta exempelkatalogen <filename class="directory"
>/opt/kde-cvs/</filename
> i fältet <guilabel
>Plats</guilabel
> med sökvägen till din &kde;-installation.) </para>
</tip>

<note
><para
>Du måste också lägga till programmeringsgränssnittet för ditt nuvarande projekt i <guilabel
>Doxygen-dokumentationssamling</guilabel
>. Tidigare versioner av &kdevelop; lade till det i dokumentationsträdet baserat på varje projekt. Det är inte längre tillgängligt. </para
></note>

</sect3
> <!-- setup-docu-general-dox -->

<sect3 id="setup-docu-general-toc">
<title
>Hantera strukturerad dokumentation (KDevelop innehållsförteckningsfiler)</title>

<para
>Huvuddelen av &kdevelop;s dokumentationsfunktion tillhandahåller omedelbar åtkomst av strukturerad dokumentation, både lokal och fjärrdokument. Du kan ställa in det på sidan <guilabel
>KDevelop-innehållsdokumentation</guilabel
>. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-docu-toc.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Tillhandahålla dokumentationsåtkomst strukturerad med KDevelop innehållsförteckning </para
></caption>
  </mediaobject>
</screenshot>

<para
>&kdevelop; levereras med en samling fördefinierade KDevelop innehållsförteckningsfiler som automatiskt läggs till i tabellen vid installation. För att hålla visningen hanterbar, är bara de oftast använda markerade för att visas. Om du vill se annan dokumentation, markera kryssrutan <guilabel
>Innehållsförteckning</guilabel
> i <link linkend="setup-docu-columns"
>inställningstabellen</link
>. </para>

<para
>KDevelop innehållsförteckningsfiler kan inte indexeras för att utföra fulltextsökning eftersom de oftast pekar på fjärrplatser. Å andra sidan, kan en sådan <filename
>.toc</filename
>-fil ha ett manuellt definierat index, med taggen <computeroutput
>&lt;index&gt;</computeroutput
>. Alltså aktiveras kryssrutan <guilabel
>index</guilabel
> bara när &kdevelop; hittar taggen <computeroutput
>&lt;index&gt;</computeroutput
> i <filename
>.toc</filename
>-filen. (För mer information, se beskrivningen nedan i avsnittet om <link linkend="setup-docu-general-toc-files"
>&kdevelop; innehållsförteckningsfiler</link
>.) </para>
<para
>Kryssrutan <guilabel
>Sök</guilabel
> i <link linkend="setup-docu-columns"
>inställningstabellen</link
> är alltid inaktiv. </para>

<para
>Du kan lägga till nya poster med <link linkend="setup-docu-buttons"
>knapparna</link
> till höger om listan. &kdevelop; filtrerar <filename
>*.toc</filename
>-filer i katalogdialogrutan som hör ihop med knapparna <guibutton
>Lägg till</guibutton
> och <guibutton
>Redigera</guibutton
>. </para>

<note
><para
>I motsats till tidigare versioner av &kdevelop;, så ändrar inte knappen <guibutton
>Ta bort</guibutton
> <filename
>*.toc</filename
>-filerna på disk, så borttagningsåtgärden är nu säker. </para
></note>

</sect3
> <!-- setup-docu-general-toc -->

<sect3 id="setup-docu-general-toc-files">
<title
>&kdevelop; innehållsförteckningsfiler</title>

<para
>Det finns en särskild funktion som hör ihop med detta. Som illustration, utför följande steg: Hitta en post strax under dokumentationen för &Qt; och &kde; (t.ex. <quote
>KDE2 Development Book (kde.org)</quote
>). Klicka på plustecknet intill den. Ett träd visas, där du snabbt kan navigera till efterföljande kapitel som finns på en hierarkisk nivå flera nivåer djupare, allt utan att vara uppkopplad. Men om du till sist väljer ett av kapitlen, försöker &kdevelop; i många fall komma åt en <emphasis
>fjärrfil</emphasis
> med dokumentation. </para>

<para
>Den logiska grunden för detta är inte bara att lokalt kunna navigera i fjärrdokumentation utan att slösa med nätverksresurser, utan också att ge utvecklare en enkel strukturerad åtkomst till dokumentation som behövs. Med verktygen som tillhandahålls här kan man komma åt nästan vilken lokal eller fjärrdokumentation som helst på ett strukturerat sätt, även om originalet är utan struktur eller strukturerat på ett annat sätt. Allt som behövs är åtkomst till filer och/eller delar av filer som kan visas av Konqueror. </para>

<para
>Sådan strukturerad åtkomst blir möjlig genom användning av särskilda filer med <quote
>innehållsförteckning</quote
>, som anges med filändelsen <filename
>.toc</filename
>. Alla sådana &kdevelop;-innehållsförteckningsfiler innehåller en strukturerad &XML;-beskrivning av dokumentet som ska kommas åt. </para>

<formalpara>
<title
>Standardkatalog för &kdevelop; innehållsförteckningsfiler</title>
<para
>När &kdevelop; installerades har en serie med fördefinierade <filename
>.toc</filename
>-filer oftast placerats i katalogen <filename class="directory"
>$KDEDIR/share/apps/kdevdocumentation/tocs</filename
>. De är ganska enkla, strukturerade textfiler. Du kan titta på dem med en texteditor eller ett annat verktyg för att visa text. </para>
</formalpara>

<variablelist id="toc-file-structure">
  <title
>Grundstruktur för &kdevelop; innehållsförteckningsfiler</title>
  <varlistentry>
    <term
>huvud</term>
    <listitem>
      <simplelist>
        <member>
          <computeroutput
>&lt;!DOCTYPE kdeveloptoc&gt;</computeroutput>
        </member>
        <member>
          <computeroutput
>&lt;kdeveloptoc&gt;</computeroutput>
        </member>
        <member>
          <emphasis
>(titel)</emphasis>
        </member>
        <member>
          <emphasis
>(basadress)</emphasis>
        </member>
        <member>
          <emphasis
>(innehållsstruktur)</emphasis>
        </member>
        <member>
          <emphasis
>(indexstruktur)</emphasis>
        </member>
        <member>
          <computeroutput
>&lt;/kdeveloptoc&gt;</computeroutput>
        </member>
      </simplelist>
      <para
>&XML;-strukturen tolkas av &kdevelop;s insticksprogram <guilabel
>Dokumentation</guilabel
> för att skapa dokumentationsträdets innehåll och hjälpa användaren att navigera i dokumentationen. Den innehåller all information som behövs för att visa titlar och komma åt dokumentationsfilernas innehåll. </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
>titel</term>
    <listitem>
      <simplelist>
        <member
><computeroutput
>&lt;title&gt;</computeroutput
> <emphasis
>(någon titelsträng)</emphasis
> <computeroutput
>&lt;/title&gt;</computeroutput
> </member>
      </simplelist>
      <para
>Det här är titeln som &kdevelop; visar på grundnivån i dokumentationsträdet. </para>
      <note
><para
>Titeln som visas kan inte ändras av användaren. Om du vill att en annan text ska visas, måste du ändra posten <computeroutput
>&lt;title&gt;</computeroutput
> för hand i <filename
>.toc</filename
>-filen. </para
></note>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
>basadress</term>
    <listitem>
      <simplelist>
        <member
><computeroutput
>&lt;base href="</computeroutput
> <emphasis
>(basdokumentets webbadress)</emphasis
> <computeroutput
>"/&gt;</computeroutput
> </member>
      </simplelist>
      <para
>Webbadressen pekar på platsen där alla dokumentationens filer finns. Den läggs till i början av varje avsnittswebbadress i följande innehållsstrukturlista. Om du t.ex. laddar ner dokumentation från en fjärrserver, är allt du behöver göra för att visa filerna på den nya platsen att ändra webbadressen <computeroutput
>&lt;base&gt;</computeroutput
>. </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
>innehållsstruktur</term>
    <listitem>
      <simplelist>
        <member
><computeroutput
>&lt;tocsect1 name="</computeroutput
> <emphasis
>(avsnittstitel)</emphasis
> <computeroutput
>" url="</computeroutput
> <emphasis
>(avsnittswebbadress)</emphasis
> <computeroutput
>"&gt;</computeroutput
> </member>
        <member
>...</member>
        <member
><computeroutput
>&lt;tocsectn name="</computeroutput
> <emphasis
>(avsnittstitel)</emphasis
> <computeroutput
>" url="</computeroutput
> <emphasis
>(avsnittswebbadress)</emphasis
> <computeroutput
>"/&gt;</computeroutput
> </member>
        <member
>...</member>
        <member>
          <computeroutput
>&lt;/tocsect1&gt;</computeroutput>
        </member>
      </simplelist>
      <para
>All återstående navigerings- och åtkomstinformation lagras i en serie hierarkiska <computeroutput
>&lt;tocsecti&gt;</computeroutput
> ... <computeroutput
>&lt;/tocsecti&gt;</computeroutput
> par. Varje <emphasis
>i</emphasis
> anger följande hierarkiska nivå ner till talet <emphasis
>n</emphasis
> som motsvarar dokumentationsavsnittet som visas sist. </para>
      <para
>Alla poster <computeroutput
>&lt;tocsecti&gt;</computeroutput
> måste ha motsvarande egenskap <computeroutput
>name="xxx"</computeroutput
> ("xxx" representerar den verkliga titelsträngen). Den visas som nivåns titel i dokumentationsträdet. Den ska motsvara ett verkligt avsnitt av dokumentationen. </para>
      <para
>Det kan finnas en egenskap <computeroutput
>url=""</computeroutput
> som hör ihop med vilken hierarkisk nivå <emphasis
>i</emphasis
> som helst. När användaren klickar på en avsnittstitel i dokumentationsträdet försöker &kdevelop; komma åt filen på platsen som pekas på den kombinerade bas- och avsnittswebbadressen. </para>
      <para
>Posten <computeroutput
>&lt;tocsectn/&gt;</computeroutput
> måste hur som helst ha egenskapen <computeroutput
>url=""</computeroutput
>. Detta sista hierarkiska <computeroutput
>&lt;tocsectn/&gt;</computeroutput
> ingår inte i ett par, utan avslutas omedelbart av <computeroutput
>/</computeroutput
> innan tecknet <computeroutput
>&gt;</computeroutput
>. </para>
      <note
><para
>Vilken adress som helst som kombinerar bas- och avsnittswebbadress måste peka på en textfil som går att visa. Oftast är det en HTML strukturerad fil. Det är möjligt att länka till ankarmärken inne i en sådan HTML-fil genom att använda den vanliga #-beteckningen med formatet <filename
>/baswebbadress/sektionswebbadress#ankarmärke</filename
>. </para
></note>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
>indexstruktur</term>
    <listitem>
      <simplelist>
        <member>
          <computeroutput
>&lt;index&gt;</computeroutput>
        </member>
        <member
><computeroutput
>&lt;entry name="</computeroutput
> <emphasis
>(indexposttitel)</emphasis
> <computeroutput
>" url="</computeroutput
> <emphasis
>(webbadress till indexavsnitt)</emphasis
> <computeroutput
>"/&gt;</computeroutput
> </member>
        <member>
          <computeroutput
>&lt;/index&gt;</computeroutput>
        </member>
      </simplelist>
      <para
>Index är en enkel lista med indexposter, par med titel och webbadress. Ett index krävs inte. </para>
    </listitem>
  </varlistentry>
</variablelist>

</sect3
> <!-- setup-docu-general-toc-files  -->

<sect3 id="setup-docu-general-devhelp">
<title
>DevHelp-dokumentation</title>

<para
>DevHelp-dokumentation är ett annat sätt att komma åt strukturerad dokumentation. Den använder en strukturerad innehållsförteckning som anges av filändelsen <filename
>.devhelp</filename
> på liknande sätt som <link linkend="setup-docu-general-toc-files"
>&kdevelop;-innehållsfiler</link
> för att komma åt dokumentation för GNOME 2- skrivbordet. </para>
<para
>Du kan styra vilka DevHelp-filer som ska vara tillgängliga på inställningssidan <guilabel
>DevHelp-dokumentationssamling</guilabel
>. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-docu-devhelp.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Tillhandahålla DevHelp-dokumentation </para
></caption>
  </mediaobject>
</screenshot>

<formalpara>
<title
>Hur man skaffar DevHelp-dokumentation</title>
<para
>DevHelp-filer kunde ursprungligen kommas åt på webbplatsen <ulink url="http://lidn.sourceforge.net/"
>LIDN</ulink
>, men det verkar som om den inte underhålls sedan en tid tillbaka. Senare DevHelp-dokumentation är tillgänglig på webbsidan <ulink url="http://htmlhelp.berlios.de/books/devhelp.php"
>DevHelp Books Download</ulink
>. </para>
</formalpara>

<para
>När &kdevelop; installeras, försöker det hitta alla <filename
>.devhelp</filename
>-filer på vissa standardplatser i systemet, t.ex. underkatalogerna i <filename class="directory"
>/opt/gnome/share/</filename
>. Från början markeras inte filerna för visning. Om du vill se annan dokumentation, markera kryssrutan <guilabel
>Innehållsförteckning</guilabel
> i <link linkend="setup-docu-columns"
>inställningstabellen</link
>. </para>

<para
>Du kan lägga till nya poster med <link linkend="setup-docu-buttons"
>knapparna</link
> till höger om listan. &kdevelop; filtrerar <filename
>*.toc</filename
>-filer i katalogdialogrutan som hör ihop med knapparna <guibutton
>Lägg till</guibutton
> och <guibutton
>Redigera</guibutton
>. </para>

</sect3
> <!-- setup-docu-general-devhelp -->

<sect3 id="setup-docu-general-custom">
<title
>Ställa in egna dokumentationssamlingar</title>

<para
>Det här är till för dina egna syften. Du kan lägga till nästan vilka dokumentationsfiler som helst här, under förutsättning att de kan visas av insticksprogram i &konqueror;. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-docu-custom.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Tillhandahålla egen dokumentation </para
></caption>
  </mediaobject>
</screenshot>

<para
>Oftast är den här samlingen tom när &kdevelop; först startas. Vi har avsiktligt fyllt i den med ett objekt för att visa poststrukturen. </para>
<para
>Här är hanteringen är rättfram. Använd <link linkend="setup-docu-buttons"
>knapparna</link
> till höger om listan för att lägga till, redigera eller ta bort dokumentationsposter. &kdevelop; filtrerar inte någonting i katalogdialogrutan som hör ihop med knapparna <guibutton
>Lägg till</guibutton
> och <guibutton
>Redigera</guibutton
>. </para>

<para
>Du måste explicit välja posterna för att visa dem i &kdevelop;s dokumentationsfunktion. Markera kryssrutan <guilabel
>Innehållsförteckning</guilabel
> för posten i <link linkend="setup-docu-columns"
>inställningstabellen</link
>. </para>

<note
><para
>Egen dokumentation kan inte indexeras eller sökas. Därför har inte kryssrutorna <guilabel
>Index</guilabel
> och <guilabel
>Sök</guilabel
> någon effekt här, som visas ovan. </para
></note>

</sect3
> <!--- setup-docu-general-custom -->

</sect2
> <!-- setup-docu-general -->

<sect2 id="setup-docu-textsearch">
<title
>Inställning av index för textsökning</title>

<para
>(... ännu inte skrivet ...) </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-doctree-textsearch.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Inställning av index för textsökning </para
></caption>
  </mediaobject>
</screenshot>

</sect2
> <!-- setup-docu-textsearch -->

<sect2 id="setup-docu-other">
<title
>Andra inställningar av dokumentationssamlingen</title>

<para
>(... ännu inte skrivet ...) </para>

</sect2
> <!-- setup-docu-other -->

</sect1
> <!-- setup-docu -->

<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->

<sect1 id="setup-advanced">
<title
>Avancerade inställningar</title>

<para
>(... ännu inte skrivet ...) </para>

<sect2 id="setup-plugins">
<title
>Insticksverktyg</title>

<para
>(... ännu inte skrivet ...) </para>
</sect2
> <!-- setup-plugins -->

<sect2 id="setup-abbrev">
<title
>Förkortningar för ordkomplettering</title>

<para
>(... ännu inte skrivet ...) </para>
</sect2
> <!-- setup-abbrev -->

<sect2 id="setup-menu-standard">
<title
>Lägga till &kde;:s standardprogram i verktygsmenyn</title>

<para
>(... ännu inte skrivet ...) </para>
</sect2
> <!-- setup-menu-standard -->


<sect2 id="setup-menu-external">
<title
>Lägga till externa program i menyer</title>

<para
>(... ännu inte skrivet ...) </para>

<sect3 id="setup-menu-external-tools">
<title
>Lägga till i verktygsmenyn</title>

<para
>(... ännu inte skrivet ...) </para>
</sect3
> <!-- setup-menu-external-tools -->

<sect3 id="setup-menu-external-filecontext">
<title
>Lägga till i sammanhangsberoende meny för filer</title>

<para
>(... ännu inte skrivet ...) </para>
</sect3
> <!-- setup-menu-external-filecontext -->

<sect3 id="setup-menu-external-dircontext">
<title
>Lägga till i sammanhangsberoende meny för kataloger</title>

<para
>(... ännu inte skrivet ...) </para>
</sect3
> <!-- setup-menu-external-dircontext -->

</sect2
> <!-- setup-menu-external -->

</sect1
> <!-- setup-advanced -->

</chapter
> <!-- setup -->
