<chapter id="setup">

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

<title
>Indstilling af &kdevelop;</title>

<para
>&kdevelop; er en meget kraftig og fleksibel IDE som kan skræddersys på mange måder til dine behov. For at indstille KDevelop, vælges <menuchoice
><guimenu
>Opsætning</guimenu
><guimenuitem
>Indstil &kdevelop;...</guimenuitem
></menuchoice
>. Dette bringer indstillingsdialogen frem. Den består af et markeringsvindue i venstre side og indstillingsdialogen i højre side. Indholdet varierer afhængigt af det indstillingspunkt du valgte. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-select.png" format="PNG"/>
    </imageobject>
<textobject>
<phrase
>Vælg er indstillingspunkt</phrase>
</textobject>
    <caption
><para
>Vælg er indstillingspunkt </para
></caption>
  </mediaobject>
</screenshot>

<para
>Vi vil diskutere disse indstillinger i en anden rækkefølge, opdelt i hovedemnerne <link linkend="setup-general"
>Generel indstilling</link
>, <link linkend="setup-docu"
>Indstilling af dokumentation</link
> og <link linkend="setup-advanced"
>Avanceret indstilling</link
> hvilket giver en mere intuitiv læsning. </para>
<para
>Hvis du ønsker at slå et bestemt indstillingspunkt op, så brug et af følgende link. </para>

<simplelist>
  <member
><link linkend="setup-main"
>Generelt</link
></member>
  <member
><link linkend="setup-ui"
>Brugergrænseflade</link
></member>
  <member
><link linkend="setup-templates"
>Filskabeloner</link
></member>
<member
><link linkend="setup-editor"
>Editor</link
></member>
 <member
><link linkend="setup-abbrev"
>Forkortelser</link
></member>
 <member
><link linkend="setup-scripting"
>Scripter</link
></member>
  <member
><link linkend="setup-menu-standard"
>Værktøjer-menu</link
></member>
  <member
><link linkend="setup-menu-external"
>Eksterne værktøjer</link
></member>
  <member
><link linkend="setup-docu"
>Dokumentation</link
></member>
  <member
><link linkend="setup-snippets"
>Kodestumper</link
></member>
  <member
><link linkend="setup-file-list"
>Filliste</link
></member>
  <member
><link linkend="setup-file-selector"
>Filvælger</link
></member>
  <member
><link linkend="setup-cpp-generator"
>Opret ny klasse i C++</link
></member>
  <member
><link linkend="setup-format"
>Formatering</link
></member>
  <member
><link linkend="setup-cpp-parsing"
>Tolkning af C++</link
></member>
</simplelist>

<sect1 id="setup-general">
<title
>Generelle indstillinger</title>

<para
>Generel indstilling drejer sig om de mere almindelige opgaver af at skræddersy &kdevelop; som følger: </para>
<itemizedlist>
  <listitem
><para>
  <link linkend="setup-main"
>Generel opsætning</link>
  </para
></listitem>
  <listitem
><para>
  <link linkend="setup-ui"
>Valg af brugergrænsefladen</link>
  </para
></listitem>
  <listitem>
    <itemizedlist>
<title
>Kilderedigeringsopgaver</title>
      <listitem
><para>
      <link linkend="setup-editor"
>Valg ef editor</link>
      </para
></listitem>
      <listitem
><para>
      <link linkend="setup-format"
>Valg af kildeformateringsstil</link>
      </para
></listitem>
      <listitem
><para>
      <link linkend="setup-snippets"
>Opsætning af værktøj for kodestumper</link>
      </para
></listitem>
    </itemizedlist>
  </listitem>
  <listitem
><para>
  <link linkend="setup-file-selector"
>Indstilling af filvælgeren</link>
  </para
></listitem>
</itemizedlist>

<sect2 id="setup-main">
<title
>Generel opsætning</title>

<para
>Den <guilabel
>Generelle</guilabel
> indstillingsdialog tillader dig at definere nogen basal &kdevelop;-opførsel som sjældent ændres i dagligt arbejde. Dette drejer sig om: </para>

<variablelist>
<varlistentry>
<term
>Generelle projekttilvalg såsom</term>
<listitem>
    <itemizedlist>
      <listitem
><para
>at definere en <link linkend="setup-main-projects"
>standard overmappe</link
> &kdevelop; skal bruge til nye projekter. </para
></listitem>
       <listitem
><para
>at afgøre om du ønsker at &kdevelop; skal <link linkend="setup-main-preload"
>automatisk indlæse</link
> projektet du sidst arbejdede på. </para
></listitem>
   </itemizedlist>
  </listitem>
</varlistentry>

<varlistentry>
<term
>Valg af en skrifttype for de mest almindeligt brugte vinduer til uddatavisning, nemlig:</term>
<listitem>

<itemizedlist>
<listitem>
<para
><link linkend="setup-main-messages-font"
>Besked uddatavisningen</link
> &kdevelop; bruger til at kommunikere &eg; kompileringsfremskridt, og</para>
</listitem>
<listitem>
<para
>Programuddata, som viser fejl- og tilstandsinformation angående et program som kører.</para>
</listitem>
</itemizedlist>

</listitem>
</varlistentry>

<varlistentry>
<term
>Nogen almindelig opførsel angående de viste linjer i <guilabel
>Besked uddatavisningens</guilabel
> vindue, nemlig:</term>
<listitem>
    <itemizedlist>
<listitem>
<para
>Om lange linjer skal <link linkend="setup-main-wrap"
>ombrydes</link
>, og </para>
</listitem>
<listitem>
<para
>om <link linkend="setup-main-navigation"
>mappeindgangs og udgangsbeskeder</link
> udstedt af <command
>make</command
> skal vises.</para>
</listitem>
</itemizedlist>

<para
><link linkend="setup-main-compile"
>detaljeniveauet</link
> af beskeder angående kompileringsprocessen vist i <guilabel
>Besked uddatavisningens</guilabel
> vindue.</para>
</listitem>
</varlistentry>
</variablelist>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-general.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Den generelle indstillingsdialog </para
></caption>
  </mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term id="setup-main-preload"
><guilabel
>Indlæs sidste projekt ved opstart</guilabel
></term>
<listitem>
<para
>Markér dette hvis du ønsker at fortsætte med at arbejde på dit sidste projekt. Dette vil få &kdevelop; til automatisk at indlæse dette projekt når der startes. Det vil sædvanligvis blive vist i den tilstand du efterlod det da du sidst arbejdede på det så du kan gå i gang med det samme. </para>
</listitem>
</varlistentry>

<varlistentry>
<term id="setup-main-projects">
<guilabel
>Standard-projektmappe:</guilabel
></term>
<listitem>
<para
>Som standard bruger &kdevelop; en fælles overmappe for alle nye projekter. Indtast den absolutte sti for denne fælles mappe i feltet eller vælg den  ud fra din mappestruktur. &kdevelop; vil placere de nye projekter her som en undermappe.</para>
<note
><para
>Du kan naturligvis ændre mappestien for et nyt projekt på det tidspunkt du sætter det op med <link linkend="applicationwizard"
>Programguiden</link
>. </para
></note>
</listitem>
</varlistentry>

<varlistentry>
<term id="setup-main-messages-font"
><guilabel
>Vindueskrifttype:</guilabel
></term>
<listitem>
<para
><guilabel
>Program uddatavisningens</guilabel
> vindue bruges til at vise fejl- og tilstandsinformation for programmer der køres inde fra &kdevelop;. Disse er informationer som programmerne sædvanligvis sender til konsollen når de køres normalt. På denne måde behøver du ikke at forlade IDE når du tester det program du er ved at arbejde på. </para>
<para
>For at vælge en passende skrifttype for <guilabel
>beskeduddatavisningens</guilabel
> vindue klikkes på <guilabel
>Vinduesskrifttype</guilabel
>-knappen der viser den  for øjeblikket valgte skrifttype (den siger <quote
>Luxi Sans</quote
> i illustrationen ovenfor). &kde;'s standard <guilabel
>Vælg skrifttype</guilabel
> dialog vil komme frem og herfra kan du vælge den skrifttype du ønsker skal  bruges. </para>
<note
><para
>Ved første opstart initialiserer &kdevelop; denne skrifttypeindstilling til at være den standardskrifttype der er blevet indstillet for din &kde;-bruger. <emphasis
>Denne indstilling er fast</emphasis
>, så hvis du ændrer <menuchoice
><guimenuitem
>Indstillinger</guimenuitem
><guimenuitem
>Udseende &amp; Temaer</guimenuitem
><guimenuitem
>Skrifttyper</guimenuitem
></menuchoice
> i <guilabel
>kontrolcenteret</guilabel
>, vil dette ikke påvirke denne &kdevelop; indstilling. Du vil eksplicit skulle vælge skrifttype igen for at ændre <guilabel
>Besked uddatavisnings</guilabel
> skrifttype. </para
></note>
</listitem>
</varlistentry>

<varlistentry>
<term id="setup-main-compile"
><guilabel
>Oversætteruddata</guilabel
></term>
<listitem>
<para
>&kdevelop; forbehandler beskederne som <guilabel
>Besked uddatavisningens</guilabel
> vindue modtager under byggeprocesser for at filtrere overflødig information bort. Du kan kontrollere detaljeniveauet &kdevelop; vil vise ved at bruge dette dropned-felt. </para>
<variablelist>
<varlistentry>
<term
><guilabel
>Meget kort</guilabel
></term>
<listitem
><para
>Viser kun advarsler, fejl og filnavnene som bliver kompileret. </para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Kort</guilabel
></term>
<listitem
><para
>Undertrykker alle kompiler-flag og formaterer uddata til at være mere læseligt. </para
></listitem>
</varlistentry>
<varlistentry>
<term
><guilabel
>Fuld</guilabel
></term>
<listitem
><para
>Viser alle uddatabeskeder uændret. </para
></listitem>
</varlistentry>
</variablelist>

<tip
><para
>Der er en anden måde at ændre detaljeniveauet for uddata fra kompileren. Højreklik blot i <guilabel
>Besked uddatavisningens</guilabel
> vindue og vælg et passende detaljeniveau fra menuen der kommer frem. </para
></tip>
</listitem>
</varlistentry>

<varlistentry>
<term id="setup-main-wrap"
><guilabel
>Tekstombrydning</guilabel
></term>
<listitem>
<para
>Som standard vil &kdevelop; bryde lange linjer i <guilabel
>Besked uddatavisningens</guilabel
> vindue, så værdifuld information ikke nemt bliver overdet. I visse tilfælde vil dette føre til rod med lange beskedlister. Fjern afkrydsningfeltets mærke hvis du ikke ønsker at lange linjer skal brydes. </para>
<tip
><para
>Der er en anden måde at ændre linjebrydning. Klik blot i <guilabel
>Besked uddatavisningens</guilabel
> vindue og markér/afmarkér <guimenuitem
>Tekstombrydning</guimenuitem
>-indgangen i menuen som vil komme frem. </para
></tip>
</listitem>
</varlistentry>

<varlistentry>
<term id="setup-main-navigation"
><guilabel
>Mappenavigeringsbeskeder</guilabel
></term>
<listitem>
<para
><command
>make</command
>-værktøjet vil sædvanligvis vise beskeder såsom <quote
>Entering directory</quote
>, eller <quote
>Leaving directory</quote
> når det skifter mellem de mapper det arbejder i for øjeblikket. Da dette roder i beskedlisten i <guilabel
>Besked uddatavisningens</guilabel
> vindue, undertrykker &kdevelop; disse beskeder som standard. Markér afkrydsningsfeltet hvis du ønsker at protokollere hvilke mapper <command
>make</command
> arbejdede i. </para>
<note
><para
>Ændringer i denne indstilling vil kun påvirke behandlingen af nye beskeder. Gamle mappenavigationsbeskeder vil blive holdt synlige når du slår denne funktion fra. </para
></note>
</listitem>
</varlistentry>

<varlistentry>
<term id="ui-designer-integration"
><guilabel
>Integrering med Designer for grafisk grænseflade</guilabel
></term>
<listitem>
<para
>Dette lader dig vælge hvordan du ønsker at <filename
>.ui</filename
>-filer skal vises i &kdevelop;. &kdevelop; levereres med sin egen Designer for grafiske grænseflade som hedder KDevDesigner. Den kan enten indlejres eller køres som et separat program. Qt Designer kan også bruges til at redigere <filename
>.ui</filename
>-filer. </para>
<itemizedlist>
  <listitem
><para
>Brug &kdevelop;s indlejrede Designer </para
><para
>Dette bruger &kdevelop;s egen Designer indlejret i &kdevelop;.</para
></listitem>
  <listitem
><para
>Kører &kdevelop; Designer som et separat program </para
><para
>Programmet KDevDesigner køres separat i et eget vindue.</para>
<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="kdevdesigner.png" format="PNG"/>
    </imageobject>
    <caption
><para
>KDevDesigner i eget vindue </para
></caption>
  </mediaobject>
</screenshot>
</listitem>
  <listitem
><para
>Kør Qt Designer </para
><para
>Qt-Designer fra installationen af Qt vil blive startet eksternt, når du klikker på en <filename
>.ui</filename
>-fil i &kdevelop;.</para
></listitem>
</itemizedlist>
</listitem>
</varlistentry>

<varlistentry>
<term id="terminal-emulation"
><guilabel
>Terminalemulering</guilabel
></term>
<listitem>
<para
>Her vælger du hvilken terminal du vil skal integreres i KDevelop. </para>
<itemizedlist>
  <listitem
><para
>Brug &kde;-indstilling </para
><para
>Bruger &kde;'s indstilling som angives i Kontrolcentret under fanebladet <guilabel
>&kde;-komponenter</guilabel
><guilabel
>Komponentvælger</guilabel
>, som angiver hvilket terminalprogram som bruges af alle &kde;-programmer som behøver en terminal.</para
></listitem>
  <listitem
><para
>Anden </para
><para
>Vælg en anden terminal som er forskellig sig fra standard.</para>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>

</variablelist>

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

<sect2 id="setup-ui">
<title
>Valg af brugergrænsefladen</title>

<indexterm zone="setup-ui">
  <primary
>brugergrænseflade</primary>
  <secondary
>skifte tilstand</secondary
></indexterm>
<indexterm zone="setup-ui">
  <primary
>skifte grænsefladetilstand</primary
></indexterm>

<para
>Som allerede sagt i kapitlet <link linkend="uimodes-survey"
>Tilgængelige brugergrænseflade-tilstande</link
> er der fem forskellige måder &kdevelop;'s arbejdsområde kan sættes op, nemlig: </para>
<itemizedlist>
  <listitem
><para>
  <link linkend="ideal-desc"
>Forenklet IDEA-vinduestilstand</link>
  </para
><para
>Dette er en forenklet version af IDEA-brugergrænsefladen. Den er designet til at være enkel og ren. Den bruger ikke heller dokkede værktøjsvisninger.</para
></listitem>
  <listitem
><para>
  <link linkend="ideal-desc"
>IDEA-vinduestilstand</link>
  </para
><para
>Dette er en klon af IDEA-brugergrænsefladen som ligner fanebladssidetilstand, og er standardtilstanden.</para
></listitem>
  <listitem
><para>
  <link linkend="mdi-desc"
>Underrammetilstand</link>
  </para
><para
>Alle værktøjsvisninger er dokkede i hovedrammen fra begyndelsen. Editoren og browser-visningerne eksisterer som topniveauvinduer inde i hovedrammens visningsmråde. Et typisk eksempel på denne brugergrænseflade er MS Visual Studio 6.0.</para
></listitem>
  <listitem
><para>
  <link linkend="tabbed-desc"
>Fanebladssidetilstand</link>
  </para
><para
>Alle værktøjsvisninger er dokkedede i hovedrammen fra begyndelsen. Editoren og browser-visninger  lægges ovenpå hinanden i et fanebladsvindue. Et typisk eksempel på denne brugergrænseflade er KDEStudio, en anden C++ integreret udviklingsmiljø i KDE-verdenen.</para
></listitem>
  <listitem
><para>
  <link linkend="toplevel-desc"
>Topniveauvinduetilstand</link>
  </para
><para
>Alle editorvisninger, browser-visninger og værktøjsvisninger er topniveauvinduer (direkte på desktoppen). Hovedkomponenten indeholder kun menuen, værktøjslinjer og statuslinjen. Et typisk eksempel på denne brugergrænseflade er Borland Delphi 6.0.</para
></listitem>
</itemizedlist>

<para
>For at skifte tilstand for brugergrænsefladen, vælges <menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Indstil &kdevelop;...</guimenuitem
></menuchoice
> i menulinjen. Dialogen <guilabel
>Indstil &kdevelop;</guilabel
> dukker op, hvor du skal vælge <guilabel
>Brugergrænseflade</guilabel
> i træet til venstre. Dette bringer dig til indstillingssiden som vises til højre.</para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="select-user-interface-0.png" format="PNG"/>
    </imageobject>
<textobject
><phrase
>Vælg en brugergrænsefladetilstand</phrase
></textobject>
    <caption
><para
>Vælg en brugergrænsefladetilstand </para
></caption>
  </mediaobject>
</screenshot>

<para
>Vælg radioknappen for grænsefladestilstanden du vil skifte til, og klik derefter på <guibutton
>O.k</guibutton
>. </para>

<note
><para
>Glem ikke at genstarte &kdevelop; for at lade nogen af disse ændringer få virkning. </para
></note>

<para
>Når du vælger enten<guilabel
>Simplificeret IDEAl vinduestilstand</guilabel
> eller <guilabel
>IDEAl vinduestilstand</guilabel
> eller <guilabel
>Fanebladssider tilstanden</guilabel
> vil to indstillingsafsnit mere blive tilgængelige: <link linkend="setup-ui-tabs"
>Brug faneblade</link
> og <link linkend="setup-ui-hover"
>Brug luk ved svævning</link
>. Disse tillader at indstille under hvilke omstændigheder faneblade vil blive vist over dokumentvinduerne og om du kan lukke dokumentet ved at klikke på fanebladsikonen. </para>

<para
>I <guilabel
>Simplificeret IDEAl vinduestilstand</guilabel
> og i <guilabel
>IDEAl vinduestilstand</guilabel
> er der kun et til indstillingsafsnit,  <link linkend="setup-ui-toolview"
>Værktøjsvisningens faneblads-layout</link
> som effektivt tillader at vælge mellem forskellige størrelser af værktøjsvisningens faneblade, som omgiver hovedarbejdsområdet i denne tilstand. </para>

<variablelist>
<varlistentry>
<term id="setup-ui-tabs"
>Indstilling af dokumentationens visning af fanebladslinje</term>
<listitem>
<para
>I IDEAl og fanebladssider-tislandene vil der være navngivne faneblade for oven i dokumentvinduerne som standard, så du kan nemt vælge forskellige dokumenter med et klik med &LMB;. Hvis du foretrækker at sørge for mere plads for dokumentets vinduer i &kdevelop;'s hovedarbejdsområde, kan du ændre en anden opførsel i indstillingsafsnittet <guilabel
>Brug faneblade</guilabel
>. </para>

<variablelist>
<varlistentry>
  <term
><guilabel
>Altid</guilabel
></term>
  <listitem
><para
>Dette er standarden &mdash; vis et faneblad der består af en ikon og dokumentets navn for oven i ethvert dokumentvindue i &kdevelop;'s hovedområde. </para
></listitem>
</varlistentry>
<varlistentry>
  <term
><guilabel
>Når der er mere end én</guilabel
></term>
  <listitem
><para
>Vis ikke et faneblad når der kun vises et dokument. Hvis der er mere end et dokument, vil &kdevelop; imidlertid vise en tilsvarende fanebladslinje som i afsnittet<guilabel
>Altid</guilabel
> ovenfor. Du vil måske ønske at vælge denne tilstand hvis du arbejder på et enkelt dokument for det meste af tiden, da dette giver mere lodret plads. </para
></listitem>
</varlistentry>
<varlistentry>
  <term
><guilabel
>Aldrig</guilabel
></term>
  <listitem
><para
>Vis aldrig noget dokuments faneblad. Du vil måske foretrække denne tilstand hvis du sjældent bruger musen til at skifte mellem dokumenter. Det giver mere lodret plads for alle dokumentvinduer. For at vælge et andet dokumentvindue eller for at lukke et, bruges &kdevelop;'s <guimenu
>Vindue</guimenu
>-menu. </para
></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term id="setup-ui-hover"
>Opsætning af at lukke et dokument ved at klikke på dets faneblad</term>
<listitem>
<para
>Hvis du indstillede &kdevelop; til at vise dokumentfanebladslinjen, enten altid eller når mere end et dokument vises i hovedarbejdsområdet, kan du give tilføje funktionalitet til fanebladene udover deres evne til dokumentvalg. Brug indstillingsafsnittet <guilabel
>Brug luk ved svævning</guilabel
> til dette. </para>

<variablelist>
<varlistentry>
  <term
><guilabel
>Nej</guilabel
></term>
  <listitem
><para
>Dette er standardopførslen. Ingen ekstra funktionalitet er tilføjet fanebladene. De kan kun bruges til at vælge dokumentvinduer ved klik med &LMB;. </para
></listitem>
</varlistentry>
<varlistentry>
  <term
><guilabel
>Ja</guilabel
></term>
  <listitem
><para
>Hvis du valgte denne radioknap, vil &kdevelop; tillade dig at lukke et  dokumentvindue ved et klik med &LMB;. Brug musen til at pege på den lille ikon på den venstre kant af fanebladet. Den vil så ændres til et lukkesymbol. Klik så med &LMB; på dette ændrede symbol, så vil &kdevelop; lukke det tilsvarende dokumentvindue. </para
></listitem>
</varlistentry>
<varlistentry>
  <term
><guilabel
>Ja, forsinket</guilabel
></term>
  <listitem
><para
>Hvis denne radioknap er valgt, vil &kdevelop; tillade at lukke et dokumentvindue som vist i <guilabel
>Ja</guilabel
>-tilfældet ovenfor. Ikonen vil imidlertid ikke blive ændret med det samme, men der vil være en kort forsinkelse før lukkeikonen dukker op. </para
></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term id="setup-ui-toolview"
>Indstilling af værktøjslinjens faneblads-layout</term>
<listitem>
<para
>Indstillingsafsnittet <guilabel
>Værktøjsvisningen faneblads-layout</guilabel
> vil kun være tilgængeligt i IDEAl tilstand. Brug disse radioknapper  til opsætning af udseendet af værktøjsvisningens faneblade som omgiver hovedarbejdsområdet i denne tilstand. </para>

<variablelist>
<varlistentry>
  <term
><guilabel
>Ikoner</guilabel
></term>
  <listitem>
  <para
>Hvert faneblaf vil kun  vise en ikon. Hvis den tilknyttede værktøjsvisning vises, vil fanebladet blive åbnet og en beskrivende tekst for denne værktøjsvisning vil blive vist. Du vil måske ønske at bruge denne tilstand hvis du arbejder med en skærm med begrænset opløsning. </para>
  <para
>Ikonerne er imidlertid ikke særligt beskrivende. Hvis du ønsker at finde ud af hvilken værktøjsvisning der er knyttet til hvilket faneblad, så peg på det med musen og vent et sekund. Et kort værktøjsvink vil så dukke op med værktøjsvisningen navn. </para>
  </listitem>
</varlistentry>
<varlistentry>
  <term
><guilabel
>Tekst</guilabel
></term>
  <listitem
><para
>Dette er standardværktøjsvisningens fanebladsvisningstilstand. Hvert faneblad viser navnet på sin tilknyttede værktøjsvisning. </para
></listitem>
</varlistentry>
<varlistentry>
  <term
><guilabel
>Tekst og ikoner</guilabel
></term>
  <listitem
><para
>Hvis standardteksten i værktøjsvisningen ser for flad ud og du arbejder på en skærm med høj opløsning, vil du muligvis ønske at vælge denne radioknap. Det vil få navnet på den tilknyttede værktøjsvisning til at blive vist på hvert faneblad plus en ikon til venstre for den, hvilket gør det nemmere at skelne mellem fanebladene. Se illustrationen <link linkend="folded-toolview-tabs"
>Foldede værktøjsvisnings-faneblade</link
> nedenfor for et eksempel. </para
></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
>Foldede værktøjsvisningfaneblade</term>
<listitem>
<para
>Hvis du valgte IDEAl-tilstandens værktøjsvisningsfaneblade til at vise tekster (med eller uden tilhørtende ikoner) behøver du ikke at bekymre dig om at bliver skjult bagved et eller andet værktøjsvisningsvindue. Hvis et af de nederste vinduer optager mere plads end der er til at vise alle (lodrette) faneblade, vil de blive foldet rundt som denne illustration viser: </para>

<screenshot>
  <mediaobject id="folded-toolview-tabs">
    <imageobject>
      <imagedata fileref="folded-tabs.png" format="PNG"/>
    </imageobject>
<textobject
><phrase
>Værktøjsvisningens faneblade foldet til ikke at blive skjult bag et andet vindue</phrase
></textobject>
    <caption
><para
>Værktøjsvisningens faneblade foldet til ikke at blive skjult bag et andet vindue </para
></caption>
  </mediaobject>
</screenshot>

<note
><para
>Det aktive værktøjsvisningsvindue skal vises fast (ikke-overlappende tilstand), og dele arbejdsområdet med de andre vinduer, for at påtvinge sådan fanebladsfoldning. Tryk på den lille firkant i vinduets kant for at opnå dette som vist i eksemplet. </para
></note>
</listitem>
</varlistentry>
</variablelist>

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

<sect2 id="setup-templates">
<title
>Filskabeloner</title>
<!--TODO fill--><para
></para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-file-templates.png" format="PNG"/>
    </imageobject>
<textobject
><phrase
>Indstil filskabeloner</phrase
></textobject>
    <caption
><para
>Indstil filskabeloner </para
></caption>
  </mediaobject>
</screenshot>
</sect2
> <!-- setup-templates -->

<sect2 id="setup-editor">
<title
>Valg af editor</title>

<para
>&kdevelop; tillader dig at vælge din foretrukne teksteditor. Markér <guilabel
>Editor</guilabel
>-indgangen i venstre side af markeringstræet i <guilabel
>Indstil KDevelop</guilabel
>-vinduet. Følgende dialog vil så blive vist i højre side. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-editor.png" format="PNG"/>
    </imageobject>
<textobject
><phrase
>Valg en editor</phrase
></textobject>
    <caption
><para
>Vælg en editor </para
></caption>
  </mediaobject>
</screenshot>

<para
>For at vælge en ny editor, klikkes på pilen i listefeltet der dropper ned. Afhængig af de editor-partgrænseflader din udgave af &kde; har kompileret, vil du blive givet en liste af editorer du kan vælge fra (se <link linkend="setup-editor-kparts"
>Vigtigt</link
> noten nedefor om dette). Klik på den editor du foretrækker og klik på <guilabel
>O.k</guilabel
>. For øjeblikket er der to muligheder: </para>

<variablelist>
  <varlistentry>
  <term
><guilabel
>Indlejret avanceret teksteditor</guilabel
></term>
  <listitem
><para
>Dette er &kde;'s standard <application
>Kate</application
> editor-part. </para
></listitem>
  </varlistentry>

  <varlistentry>
  <term
><guilabel
>Qt Designer baseret teksteditor</guilabel
></term>
  <listitem
><para
>Dette er den editor &Qt; sørger for i sin <application
>Designer</application
> komponent. </para
></listitem>
  </varlistentry>
</variablelist>

<para
>Disse editor-grænseflader er fuldt integreret &kdevelop;' IDE-begreb. Specielt muligheden for at springe hen til den kildekodelinje der giver problemer ved blot at klikke på en fejlbesked i <guilabel
>Besked uddatavisningens</guilabel
> vindue, er der sørget for. </para>

<note
><para
>Ændring af editor vil ikke påvirke allerede åbne filer. Der er to måder at gå videre på. Enten luk alle åbne tekstvinduer og åbn dem igen en ad gangen. Eller luk hele projektet og åbn det igen. Vinduerne vil så automatisk åbne i den nye teksteditors grænseflade. </para
></note>

<important id="setup-editor-kparts"
><para
>KDevelop lader dig bruge editorgrænseflader som er registreret af &kde; og som sørger for en KatePart-grænseflade. Hvis du mangler et af valgene vist ovenfor, så kontrollér din &kde;-installation for om den tilsvarende KPart er korrekt installeret. </para
></important>

<para
>Hvad der skal gøres hvis filen er ændret eksternt:</para>
<variablelist>
  <varlistentry>
  <term
><guilabel
>Gør ingenting</guilabel
></term>
  <listitem
><para
>Filen markeres som ændret eksternt, og brugeren bliver bedt om at bekræfte alle forsøg på at overskrive den. </para
></listitem>
  </varlistentry>
  <varlistentry>
  <term
><guilabel
>Underret brugeren</guilabel
></term>
  <listitem
><para
>En dialog underretter brugeren at filen er ændret, og tilbyder brugeren at opdatere filen. </para
></listitem>
  </varlistentry>
  <varlistentry>
  <term
><guilabel
>Genindlæs filen automatisk hvis det er sikkert, underret ellers brugeren</guilabel
></term>
  <listitem
><para
>Alle filer som ikke er ændrede i hukommelsen, opdateres og en advarsel vises ved eventuelle konflikter. </para
></listitem>
  </varlistentry>
</variablelist>
</sect2
> <!-- setup-editor -->

<sect2 id="setup-abbrev">
<title
>Forkortelser til ordkomplettering</title>

<para
>(... endnu ikke skrevet ...) </para>
</sect2
> <!-- setup-abbrev -->

<sect2 id="setup-scripting">
<title
>Scripter</title>

<para
>(... endnu ikke skrevet ...) </para>
</sect2
> <!-- setup-scripting -->

<sect2 id="setup-menu-standard">
<title
>Tilføjelse af &kde;'s standardprogrammer til værktøjsmenuen</title>

<para
>(... endnu ikke skrevet ...) </para>
</sect2
> <!-- setup-menu-standard  Tools Menu-->

<sect2 id="setup-menu-external">
<title
>Tilføjelse af eksterne programmer til menuerne</title>

<para
>(... endnu ikke skrevet ...) </para>

<sect3 id="setup-menu-external-tools">
<title
>Tilføjer til  værktøjsmenuen</title>

<para
>(... endnu ikke skrevet ...) </para>
</sect3
> <!-- setup-menu-external-tools -->

<sect3 id="setup-menu-external-filecontext">
<title
>Tilføjelse til Fil-sammenhængsmenu</title>

<para
>(... endnu ikke skrevet ...) </para>
</sect3
> <!-- setup-menu-external-filecontext -->

<sect3 id="setup-menu-external-dircontext">
<title
>Tilføjelse til mappesammenhængsmenu</title>

<para
>(... endnu ikke skrevet ...) </para>
</sect3
> <!-- setup-menu-external-dircontext -->

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

<sect2 id="setup-format">
<title
>Valg af kildeformateringsstil</title>

<para
>&kdevelop; formaterer automatisk en kildetekst i en prædefineret stil. Denne stil er meget indstillelig. </para>

<note
><para
>Funktionen til reformatering af kilden er for øjeblikket kun tilgængelig for C, C++, og &Java;. Specielt kan du ikke bruge den til script-sprog som &eg; PHP. Det er fordi &kdevelop; bruger <ulink url="http://astyle.sourceforge.net/"
>astyle</ulink
>-programmet til at implementere denne funktion. </para
></note>

<para
>For at indstille en specifik formateringsstil, vælges <menuchoice
> <guimenu
>Opsætning</guimenu
> <guimenuitem
>Indstil &kdevelop;...</guimenuitem
> </menuchoice
> fra menulinjen. <guilabel
>Brugerindstil &kdevelop;</guilabel
> dialogen vil komme frem, hvor du skal vælge <guilabel
>Kildeformatering</guilabel
> i træet til venstre. Dette vil vise en serie af tre indstillingsdialogfaneblade til højre, nemlig en <link linkend="setup-format-general"
>Generel formatering opsætning</link
>, a <link linkend="setup-format-indent"
>Indrykningsstil opsætning</link
>, og en <link linkend="setup-format-other"
>Anden formatering opsætning</link
>. </para>

<tip
><para
>Enhver ændring af stil anvendes kun på ny tekst. Hvis du ønsker at ændre formateringsstil for en allerede eksisterende kildetekst må du eksplicit bruge <menuchoice
><guimenu
>Redigér</guimenu
><guimenuitem
>Omformatér kilde</guimenuitem
></menuchoice
>-kommandoen. </para
></tip>

<note
><para
>Det nøjagtige resultat af disse stilformateringsdefinitioner afhænger af den <link linkend="setup-editor"
>editor</link
> du bruger. For øjeblikket er de fleste indstillinger skræddersyet til Kate editor-parten (den <quote
>Indlejrede Avancerede Tekst Editor</quote
>). Visse andre editorer (&eg; Qt-editoren) afhænger måske af deres egen  opsætning. Du vil skulle eksperimentere i dette tilfælde for at finde ud af den nøjagtige virkning af den  stil-opsætning der sørges for her. </para
></note>

<warning
><para
>Der kan være inkompatibiliteter mellem indstillingsstilens opsætning der sørges for her og den editor du bruger. I ekstreme tilfælde kunne det endda ødelægge dine filer. Sørg for at du har en sikkerhedskopi af dine kildefiler før du prøver denne opsætning med en editor der ikke er standard for KDE. </para
></warning>

<sect3 id="setup-format-general">
<title
>Generel formateringsopsætning</title>

<para
><guilabel
>Generelt</guilabel
>-fanebladet i <guilabel
>Kildeformaterings</guilabel
>-dialog lader dig vælge en ud af fem prædefinerede kildeformat-stiler. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="SF-general.png" format="PNG"/>
    </imageobject>
<textobject
><phrase
>Generel opsætning af kildeformat-stil</phrase
></textobject>
    <caption
><para
>Generel opsætning af kildeformat-stil </para
></caption>
  </mediaobject>
</screenshot>

<para
>Et formateret eksempel på kilde vil blive vist i feltet til højre. Hvis  ingen af de prædefinerede stiler passer dig, kan du klikke på radioknappen  <guilabel
>Brugerdefineret</guilabel
> for oven, og definere din egen kildeformateringstil i de andre to faneblade der så vil blive tilgængelige. </para>

<note
><para
>For øjeblikket er det kun de prædefinerede kildeformateringsstiler der vil blive demonstreret ved en eksempeltekst. Hvis du beslutter dig for at definere din egen stil, vil ingen eksempelvisning være tilgængelig. Du vil skulle eksperimenter på en egentlig kildetekst for at skræddersy opsætningen efter din smag. </para
></note>

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

<sect3 id="setup-format-indent">
<title
>Opsætning af indrykningsstil</title>

<para
>Korrekt indrykning er en af hovedmetoderne til at øge læseligheden af en kildetekst. Hvis du vælger <guilabel
>Indryknings</guilabel
>fanebladet i <guilabel
>Formatering af kildekode</guilabel
>dialogen, vil du blive præsenteret for en serie af valg for indrykningsformatering, grupperet i tre felter som følger. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="SF-indent.png" format="PNG"/>
    </imageobject>
<textobject
><phrase
>Opsætning af indrykningsstil</phrase
></textobject>
    <caption
><para
>Opsætning af indrykningsstil </para
></caption>
  </mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term
>Standard-opsætning</term>
<listitem>
<para
>Det forudindstillede valg vil få kildeteksten til at ligne ANSI formateringsstil:</para>

<screen
>namespace foospace
{
  int Foo()
  {
    if (isBar)
    {
      bar();
      return 1;
    }
    else
      return 0;
  }
}
</screen>
</listitem>
</varlistentry>

<varlistentry>
<term id="setup-format-indent-filling"
>Definition af indrykningsbredde og tegn</term>
<listitem>
<para
>Radioknapperne grupperet i <guilabel
>Udfyldnings</guilabel
>gruppen definerer hvordan indrykninger i kildeteksten vil blive tegnet.</para>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Brug tabulatorer</guilabel
></term>
    <listitem>
    <para
>Dette vil få editoren til at indsætte tab-tegn for hvert indrykningsniveau. Tab-bredden er prædefineret i opsætningen af editoren (8 eller 4 tegnsøjler sædvanligvis). Brug <menuchoice
><guimenu
>Opsætning</guimenu
><guimenuitem
>Indstil editor...</guimenuitem
></menuchoice
> til at omdefinere det. </para>
    <note
><para
>Den egentlige procedure for defintion af tab-bredde afhænger af den editor du valgte i <link linkend="setup-editor"
>Valg ef editor</link
> indstillingstrinnet. Du vil skulle slå op i den tilsvarende editors hjælp for at find ud af det. </para
></note>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Brug mellemrum</guilabel
></term>
    <listitem
><para
>Hvis du vælger denne radioknap, vil editoren indtaste et antal mellemrum for hvert indrykningsniveau. Ændr antallet fra standarden på 2 til den indrykningsbredde du foretrækker. </para
></listitem>
  </varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
>Indrykkede entiteter</term>
<listitem>
<para
>Dette definerer hvilke af (C/C++) entiteterne der vil blive formateret med en ekstra indrykning udover det nuværende indrykningsniveau.</para>

<para
>Som standard er det kun <guilabel
>navnerum</guilabel
> og <guilabel
>etiketter</guilabel
> der bliver ekstra indrykket. Du vil måske ønske at eksperimentere med forskellige indstillinger for at skræddersy disse ekstra indrykninger efter din smag.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Fortsættelse</term>
<listitem>
<para
>Indstillingerne grupperet her anvendes på de tilfælde hvor kildeformateringen automatisk ombryder lange kildelinjer. Der er to specialtilfælde der tages hensyn til, nemlig at i dybe indrykninger skal der være nok plads til at kilde og betingelser kan få et ekstra indrykningsniveau så de fortsætter med at stå tydeligt frem. </para>

<note
><para
>Dette gælder kun <emphasis
>statisk tekstombrydningstilfalde</emphasis
> hvor en fast maksimal linjebredde bruges i kildeteksten. Hvis du sætter din  editor op til dynamisk kun at ombryde  lange linjer i visningen (hvilket er  muligt i &kate; editor-parten) vil virkningerne af disse indstillinger sædvanligvis ikke ses. </para
></note>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Maksimum i udsagn</guilabel
></term>
    <listitem>
    <para
>Denne indstilling begrænser den maksimalt  mulige indrykning for fortsættelsen af linjer, så der er nok plads tilbage til at teksten er læsbar. Ingen fortsættelse af linjer vil nogensinde blive indrykket udover antallet af søjler du vælger i dette felt. </para>
    <para
>Som standard er det sat til 40 tegn (det halve af en standardside på  80 tegn). Du vil måske ønske at øge denne værdi på grund af bredere papir (f.eks. hvis du bruger landskabsudskrift for dine kilder). Eller mindske værdien fordi du ønsker at have en større margin for din udskrift. </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Minimum i  betinget</guilabel
></term>
    <listitem>
    <para
>Betingede eller kilde der &eg; følger en tilknytningsoperator skal sædvanligvis have en ekstra indrykning på fortsættelseslinjer for at teksten skal være læsbar. Mængden af denne ekstra indrykning defineres her. </para>
    <para
>Standarden er sat til <quote
>To gange det nuværende</quote
> hvilket betyder at fortsatte betingede vil få et ekstra indrykningsniveau på den standard indrykningsstørrelse du valgte i  <link linkend="setup-format-indent-filling"
>Udfyldning</link
>-gruppen. Du kan ændre denne ekstra indrykning til en anden fast bredde (inklusive nul) ved brug af pilene eller ved at indtaste værdien direkte. </para>
    </listitem>
  </varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>

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

<sect3 id="setup-format-other">
<title
>Anden opsætning af formatering</title>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="SF-other.png" format="PNG"/>
    </imageobject>
<textobject
><phrase
>Anden opsætning af kildeformateringsstil</phrase
></textobject>
    <caption
><para
>Anden opsætning af kildeformateringsstil </para
></caption>
  </mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term
>Kontrol af placering af parenteser</term>
<listitem>
<para
>Radioknapperne (noget misvisende) <guilabel
>Parentes</guilabel
>-grupper kontrollerer positionen af blokafgrænsningsparenteser i en (C/C++) kildetekst. Der er tre muligheder ud fra hvilke du kan vælge.</para>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Brud</guilabel
></term>
    <listitem>
    <para
>Dette indsætter et linjebrud før hver åbningsparentes. Begge afgrænsende parenteser for en vilkårlig blok vil blive puttet på samme indrykningsniveau som blokkens hovedudsagn.</para>

<screen
>namespace foospace
{
  int Foo()
  {
    if (isBar)
    {
      bar();
      return 1;
    }
    else
      return 0;
  }
}
</screen>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Tilknyt</guilabel
></term>
    <listitem>
    <para
>Dette vil holde åbningsparentesen for en blok på linje med blokhovedets udsagn. Afsluttende parenteser vil være på samme indrykningsniveau som blokkens hovedudsagn. <token
>else</token
> for et <token
>if</token
> udsagn vil  blive holdt på linje med de afsluttende parenteser for den foregående blok. </para>
<screen
>namespace foospace {
  int Foo() {
    if (isBar) {
      bar();
      return 1;
    } else
      return 0;
  }
}
</screen>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Linux-stil</guilabel
></term>
    <listitem>
    <para
>Dette er  et kompromis mellem stilerne på listen ovenfor. Funktionelle blokafgrænsningsparenteser vil blive puttet på ekstra linjer. Parenteser der åbner en blok i et betingelses- eller løkke-udsagn vil blive holdt i linje. </para>
<screen
>namespace foospace
{
  int Foo()
  {
    if (isBar) {
      bar();
      return 1;
    } else
      return 0;
  }
}
</screen>
    </listitem>
  </varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
>Kontrol af ekstra mellemrum</term>
<listitem>
<para
>Som standard minimerer &kdevelop; brugen af mellemrum i kildetekster. </para>


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

<para
>Du vil måske øge læsbarheden hvis du tvinger kildeformateringen til at indsætte ekstra mellemrum på specielle steder.</para>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Tilføj mellemrum rundt om parenteser</guilabel
></term>
    <listitem>
    <para
>Det der rent faktisk menes er at tilføje mellemrum omkring den tekst der puttes ind i parenteserne. Dette øger læsbarheden af funktionsargumenter og betingede.</para>
<screen
>if ( isBar( fooArg )==barValue )
</screen>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Tilføj mellemrum omkring operatorer</guilabel
></term>
    <listitem>
    <para
>Dette vil putte mellemrum omkring tilknytnings- og sammenligningsoperatorer for at øge læsbarheden.</para>
<screen
>if (isBar(fooArg) == barValue)
</screen>
    </listitem>
  </varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
>Kontrol af formateringen af en-linjes konstruktor</term>
<listitem>
<para
>Der er nogle få tilfælde hvor du ikke ønsker at kildeformateringen skal opdel en lang linje. For C/C++ kode kan dette kontrolleres her.</para>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Behold en-linjes udsagn</guilabel
></term>
    <listitem
><para
>Dette holder en-linjes udsagn sammen i visse situationer, selv om de går udover en fast maksimal linjelængde. </para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Behold en-linje blokke</guilabel
></term>
    <listitem
><para
>Dette holder en-linjes blokke sammen i visse situationer, selv om de går udover en fast maksimal linjelængde. </para
></listitem>
  </varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>


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

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

<sect2 id="setup-snippets">
<title
>Opsætning af værktøjet for kodestumper</title>

<para
>Når der redigeres i &kdevelop; kan du ofte opbevare brugte dele af kode som <link linkend="editing-snippets"
>Kodestumper</link
>. For at indstille mulighederne med kodestumper vælges <menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Indstil &kdevelop;...</guimenuitem
></menuchoice
> i menulinjen. Dialogen <guilabel
>Indstil &kdevelop;</guilabel
> dukker op, hvor du skal vælge <guilabel
>Kodestumper</guilabel
> i feltet til venstre. Dette bringer dig til følgende indstillingsdialog som vises til højre: </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-snippets.png" format="PNG"/>
    </imageobject>
<textobject
><phrase
>Indstilling af værktøjet for kodestumper</phrase
></textobject>
    <caption
><para
>Indstilling af værktøjet for kodestumper </para
></caption>
  </mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term
>Aktivér forhåndsvisning af kodestump</term>
<listitem>
<para
>Markér <guilabel
>Vis kodestumpens tekst som værktøjsvink</guilabel
> hvis du ønsker at vie den opbevarede tekst som et værktøjsvink, når du holder musemarkøren titlen på kodestumpen.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Arbejde med kodestumpsvariabler</term>
<listitem>
<para
><guilabel
>Kodestumper</guilabel
>-værktøjet tillader en variabel tekst på prædefinerede steder nårsomhelst du indsætter en kodestump i en fil. For at opnå dette har <guilabel
>Kodestumper</guilabel
> sin egen variabel mekanisme. Du kan indstille dens opførsel i <guilabel
>Variabler</guilabel
>-gruppen.</para>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Afgrænser</guilabel
></term>
    <listitem
><para
><guilabel
>Kodestumper</guilabel
>-værktøjet adskiller variabler i teksten ved at omgive variabelnavnet med specielle afgrænsersymboler. For at bruge dine egne afgrænsningssymboler, kan det prædefinerede <guilabel
>$</guilabel
>-tegn ændres i <guilabel
>Afgrænser</guilabel
>-feltet. </para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Inputmetode for variabler</guilabel
></term>
    <listitem
><itemizedlist>
      <listitem
><para
><guilabel
>Enkelt dialog for hver variabel indenfor en kodestump</guilabel
> &ndash; vil få en adskilt dialog frem for hver variabel som værktøjet  finder når den valgte kodestump indsættes. </para
></listitem>
      <listitem
><para
><guilabel
>En dialog for alle variabler indefor en kodestump</guilabel
> &ndash; vil få en fælles dialog frem hvor brugeren skal udfylde værdierne for alle variabler før kodestumpen vil blive indsat </para
></listitem>
    </itemizedlist
></listitem>
  </varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>

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

<sect2 id="setup-file-list">
<title
>Filliste</title>

<para
>(... endnu ikke skrevet ...) </para>

</sect2
> <!-- setup-file-list-->

<sect2 id="setup-file-selector">
<title
>Indstilling af filvælger</title>

<para
>&kdevelop; sørger for en <guilabel
>Filvælger</guilabel
>-plugin som, når den bliver indlæst ved opstart, tillader at navigere til en vilkårlig fil eller mappe på systemer. </para>

<screenshot id="setup-fileselector-image">
  <mediaobject>
    <imageobject>
      <imagedata fileref="file-selector.png" format="PNG"/>
    </imageobject>
<textobject
><phrase
>Filvælgeren IDEAl-tilstand</phrase
></textobject>
    <caption
><para
>Filvælgeren (IDEAl-tilstand) </para
></caption>
  </mediaobject>
</screenshot>

<para
><guilabel
>Filvælgerens</guilabel
> opførsel kan indstilles.Vælg <menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Indstil &kdevelop;...</guimenuitem
></menuchoice
> i menulinjen. Dialogen <guilabel
>Indstil &kdevelop;</guilabel
> dukker op, hvor du skal vælge <guilabel
>Filvælger</guilabel
> i feltet til venstre. Dette bringer dig til følgende dialog som vises i højre side:</para>


<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-file-selector.png" format="PNG"/>
    </imageobject>
<textobject
><phrase
>Indstilling af filvælger</phrase
></textobject>
    <caption
><para
>Indstilling af filvælger </para
></caption>
  </mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term
>Indstilling af værktøjslinje</term>
<listitem>
<para
>Der er en værktøjslinje foroven i <guilabel
>Filvælgeren</guilabel
> som kan indstilles som sædvanligt i <guilabel
>Værktøjslinje</guilabel
>-gruppen.</para>

<procedure id="setup-fileselector-add-action">
  <title
>Tilføj en handling til værktøjslinjen</title>
  <step>
    <para
>Vælg et punkt i listen til højre <guilabel
>Valgte handlinger</guilabel
>  hvorefter de nye handlinger skullevære indsat. </para>
  </step>
  <step>
    <para
>Vælg den handling der skal indsættes i listen til venstre <guilabel
>Tilgængelige handlinger</guilabel
>. </para>
  </step>
  <step>
    <para
>Klik på den øverste (højre) pil  mellem de to lister. </para>
    <para
>Handlingen vil blive fjernet fra listen af<guilabel
>Tilgængelige handlinger</guilabel
> og indsat i listen af <guilabel
>Valgte handlinger</guilabel
> under det valgte punkt. </para>
  </step>
</procedure>

<procedure>
  <title
>Fjern en handling fra værktøjslinjen</title>
  <step>
    <para
>Vælg punktet der skal fjernes i listen i højre side <guilabel
>Valgte handlinger</guilabel
>. </para>
  </step>
  <step>
    <para
>Klik på den nederste (venstre) pil mellem de to lister. </para>
    <para
>Det valgte punkt vil blive fjernet fra listen af <guilabel
>Valgte handlinger</guilabel
> og puttet tilbage i listen af <guilabel
>Tilgængelige handlinger</guilabel
>. </para>
  </step>
</procedure>

<procedure>
  <title
>Omarrangér handlingerne på værktøjslinjen</title>
  <step>
    <para
>Vælg handlingen der skal flyttes i listen til højre <guilabel
>Valgte handlinger</guilabel
>. </para>
  </step>
  <step>
    <para
>Klik på op- eller ned-pilen til højre for denne liste. </para>
    <para
>Det valgte punkt vil blive flyttet op eller ned på listen af  <guilabel
>Valgte handlinger</guilabel
>. </para>
  </step>
</procedure>
</listitem>
</varlistentry>

<varlistentry>
<term id="setup-fileselector-autosync"
>Definition af hvornår indhold skal ændres</term>
<listitem>
<para
>Opdatering af indholdet i <guilabel
>Filvælger</guilabel
>-vinduet tager tid og ressourcer, især når der skiftes til en anden mappe. Derfor er <guilabel
>Filvælgeren</guilabel
> som standard sat op på en sådan måde at dens indhold kun ændres når der bedes om det, &ie; når du vælger en anden mappe eller når du eksplicit ønsker at opdatere dens indhold. </para>

<note
><para
>Klik på <guilabel
>Genindlæs</guilabel
>-knappen i værktøjslinjen for at opdatere indholdet af <guilabel
>Filvælgeren</guilabel
>. Denne værktøjslinjeknap er imidlertid ikke til stede som standard. Du skal først <link linkend="setup-fileselector-add-action"
>indsætte den der</link
>. </para
></note>

<para
>Du kan indstille <guilabel
>Filvælgeren</guilabel
> til at reflektere visse ændringer i dit arbejde med det samme. Indstillingerne i <guilabel
>Auto-synkronisering</guilabel
>-gruppen af indstillingsdialoge er ansvarlige for dette. </para>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Når et dokument bliver aktivt</guilabel
></term>
    <listitem
><para
>Hvis du afkrydser dette felt, vil indholdet i <guilabel
>Filvælger</guilabel
>-vinduet blive opdateret hver gang du går til et andet allerede åbent  dokument, &eg; når du klikker på det tilsvarende redigeringsvindue i IDEAl-tilstand. Om nødvendigt vil <guilabel
>Filbælgeren</guilabel
>  skifte til mappen som filen tilhører og opdatere visningen til at vise det egentlige indhold der. </para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Når et dokument åbnes</guilabel
></term>
    <listitem
><para
>Hvis du afkrydser dette felt, vil indholdet i <guilabel
>Filvælger</guilabel
>-vinduet blive opdateret hver gang et dokument bliver åbnet, &eg; med <menuchoice
><guimenu
>Fil</guimenu
><guimenuitem
>Åbn</guimenuitem
></menuchoice
>-menuen. Om nødvendigt vil <guilabel
>Filbælgeren</guilabel
>  skifte til mappen som filen tilhører og opdatere visningen til at vise det egentlige indhold der. </para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Når en filvælger bliver synlig</guilabel
></term>
    <listitem
><para
>Hvis du afkrydser dette felt, vil indholdet i <guilabel
>Filvælger</guilabel
>-vinduet blive opdateret når den bliver synlig igen. Om nødvendigt vil <guilabel
>Filbælgeren</guilabel
>  skifte til mappen som filen tilhører og opdatere visningen til at vise det egentlige indhold der. </para
></listitem>
  </varlistentry>
</variablelist>

<para
>Du kan frit kombinere disse indstillinger for at skræddersy aktualiseringsopførslen af <guilabel
>Filvælgeren</guilabel
> efter din smag. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
>Kontrol af historikken for kombinationsfelterne</term>
<listitem>
<para
>Der er to kombinationsfelter foroven og forneden i <guilabel
>Filvælgerens</guilabel
> indholdsvindue som kontrollerer amppen der skal vises (øverste kombinationsfelt) og filtrene der skal anvendes på filvisningen (nederste kombinationsfelt). En historik af de mest nylige indstillinger beholdes i indtastningsfeltet for hvert kombinationsfelt. Du kan indstille antallet af historik-indgange som følger.</para>

<variablelist>
  <varlistentry>
    <term
><guilabel
>Husk steder</guilabel
></term>
    <listitem
><para
>Indtast det maksimale antal mappevalg det øverste kombinationsfelt skal huske. </para
></listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Husk filtre</guilabel
></term>
    <listitem
><para
>Indtast det maksimale antal filterdefinitioner det nederste kombinationsfelt skal huske. </para
></listitem>
  </varlistentry>

<varlistentry>
<term
>Kontrol af hvad der skal huskes mellem sessioner</term>
<listitem>
<para
>Som standard er <guilabel
>Filvælgeren</guilabel
> sat op så den viser den sidste session igen ved næste opstart af &kdevelop;. Du kan ændre denne opførsel i <guilabel
>Session</guilabel
>-indstillingsgruppen. </para>

<note
><para
>Hvis &kdevelop; blev automatisk genstartet af &kde;'s sessionhåndtering vil ændringer af disse indstillinger ingen virkning have. I dette tilfælde vil sted- og filterindstillinger fra den sidste &kde;-session altid blive genoprettet. </para
></note>
</listitem>
</varlistentry>

  <varlistentry>
    <term
><guilabel
>Genopret sted</guilabel
></term>
    <listitem>
    <para
>Fjern mærket fra afkrydsningsfeltet hvis du ikke ønsker at det viste sted skal huskes mellem sessioner. </para>
    <note
><para
>Hvis du valgte en af <link linkend="setup-fileselector-autosync"
>opdatér automatisk</link
> indstillingerne vil det viste sted muligvis  blive ændret automatisk uanset hvad der er blevet husket fra nylige sessioner. </para
></note>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Genopret filtre</guilabel
></term>
    <listitem>
    <para
>Fjern mærket fra afkrydsningsfeltet hvis du ikke ønsker at de anvendte filtre skal huskes mellem sessioner. </para>
    </listitem>
  </varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>

</sect2
> <!-- setup-file-selector -->

<sect2 id="setup-cpp-generator">
<title
>Opret ny klasse i C++</title>

<para
>(... endnu ikke skrevet ...) </para>

</sect2
> <!-- setup-c++-generator-->

<sect2 id="setup-formatting">
<title
>Formatering</title>

<para
>(... endnu ikke skrevet ...) </para>

</sect2
> <!-- setup-formatting-->

<sect2 id="setup-cpp-parsing">
<title
>Tolkning af C++</title>

<para
>(... endnu ikke skrevet ...) </para>

</sect2
> <!-- setup-c++-parsing-->

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

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

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

<para
>&kdevelop; indeholder en meget kraftig dokumentationsfacilitet som sørger for adgang til adskillig slags ekstensiv dokumentation. &eg; i IDEAl-tilstand  finder du et <guilabel
>Dokumentations</guilabel
>faneblad i højre kant af arbejdsområdet. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="documents-contents.png" format="PNG"/>
    </imageobject>
<textobject
><phrase
>&kdevelop;'s dokumentationsvinduet  i IDEAl-tilstand</phrase
></textobject>
    <caption
><para
>&kdevelop;'s dokumentationsvinduet (IDEAl-tilstand) </para
></caption>
  </mediaobject>
</screenshot>

<note
><para
>&kdevelop; skal have indlæst <guilabel
>Dokumentation</guilabel
>-plugin for at kunne vise dokumentationsvinduet. Se afsnittet <link linkend="setup-plugins"
>Plugin-værktøjer</link
> for mere info. </para
></note>

<para
>Du kan indstille indholdet af dette dokumentationstræ hvis du vælger <menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Indstil &kdevelop;...</guimenuitem
></menuchoice
> i menulinjen. Dialogen <guilabel
>Indstil &kdevelop;</guilabel
> dukker op, hvor du skal vælge <guilabel
>Dokumentation</guilabel
> i feltet til venstre. </para>

<para
>Den viste <link linkend="configure-docu-general"
>indstillingsside</link
> viser en serie af indstillingsdialoger som fanebladsider, nemlig: </para>

<simplelist>
  <member
><link linkend="setup-docu-general"
>Dokumentationssamlinger</link
></member>
  <member
><link linkend="setup-docu-textsearch"
>Fuld tekstsøgning</link
></member>
  <member
><link linkend="setup-docu-other"
>Andet</link
></member>
</simplelist>

<sect2 id="setup-docu-general">
<title
>Opsætning af dokumentationssamlinger</title>

<para
>Opsætningen af dokumentationsindstillingerne er opdelt i en række af dokumentationssamlinger, der hver især giver adgang til dokumentationsfilerne i et eller andet unikt format og indholdstype. Disse opsætninger kontrollerer hvilke dokumentationsindgange der vil stå på listen i <guilabel
>Indhold</guilabel
>-siden i &kdevelop;<guilabel
>Dokumentation</guilabel
> funktionen og hvordan brugeren får adgang til dokumentationsdetaljer gennem indekserede og fuldtekstsøgninger. </para>
<para
>Fanebladet <guilabel
>Dokumentation</guilabel
> giver en række indstillingssider som er ordnet lodret som en stak af indekskort. En side ad gangen åbner efter et klik på dens indekskorttitel. </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; TOC dokumentationsamling</link
></member>
  <member
><link linkend="setup-docu-general-devhelp"
>Devhelp dokumentationssamling</link
></member>
  <member
><link linkend="setup-docu-general-custom"
>Brugerdefineret dokumentationssamling</link
></member>
</simplelist>

<para id="configure-docu-general">
<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-docu-general.png" format="PNG"/>
    </imageobject>
<textobject
><phrase
>Indstilling af dokumentationssamlinger</phrase
></textobject>
    <caption
><para
>Indstilling af dokumentationssamlinger </para
></caption>
  </mediaobject>
</screenshot>
</para>

<sect3 id="setup-docu-general-common">
<title
>Almindelig opsætning af dokumentationen</title>

<para
>Alle indstillingssiderne på <guilabel
>Dokumentation</guilabel
> fanebladet bruger et almindelig layout. Du finder den tilgængelige dokumentationsliste på den åbne side til venstre og et sæt knapper til højre. </para>

<variablelist>
<varlistentry>
<term id="setup-docu-buttons"
>Knapper til ændring af dokumentationsliste</term>
<listitem>
<para
>Der er tre knapper til rådighed til at vedligeholde indholdet af dokumentationsopsætningssiderne: </para>

<variablelist>
  <varlistentry>
    <term
><guibutton
>Tilføj</guibutton
></term>
    <listitem>
      <para
>Åbner en <guilabel
>Dokumentationssamlingsegenskaber</guilabel
>-dialog, som vist herunder, hvor du kan ændre kildeplaceringen af dokumentationen der skal tilføjes og hvor du også kan navngive den.</para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guibutton
>Redigér</guibutton
></term>
    <listitem>
      <para
>Åbner en <guilabel
>Dokumentationssamlingsegenskaber</guilabel
> dialog, som vist herunder, hvor du kan ændre kildeplaceringen af dokumentationen allerede valgt på listen og omdøbe den.</para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guibutton
>Fjern</guibutton
></term>
    <listitem>
      <para
>Fjerner den valgte dokumentationsindgang fra listen.</para>
      <note
><para
>Indgangen bliver fjernet kun fra listen. Den egentlige dokumentationskilde bevares. Du skal bruge en anden metode for at fjerne den eksplicit. </para
></note>
    </listitem>
  </varlistentry>
</variablelist>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-docu-edit.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Tilføjelse eller ændring af en indgang til dokumentationen. </para
></caption>
  </mediaobject>
</screenshot>

<para
>Knappen til højre for <guilabel
>Sted</guilabel
> feltet, åbner en mappedialog, hvis indgange normalt bliver filtreret i henhold til den valgte indstilingssides filtype. </para>
<para
><guilabel
>Titel</guilabel
>feltet er ikke altid tilgængeligt. Det afhænger af dokumentationstypen. </para>
</listitem>
</varlistentry>
<varlistentry>
<term id="setup-docu-columns"
>Dokumentationstræstruktur</term>
<listitem>
<para
>Hver dokumentationsindstillingsside viser dokumentationsindgangene i en tabel med fire søjler. </para>

<variablelist>
  <varlistentry>
    <term
><guilabel
>TOC</guilabel
></term>
    <listitem>
      <para
>Hvis dette felt er afkrydset vises dokumentationsindgangen i <guilabel
>Indhold</guilabel
>sfortegnelsen i &kdevelop;s <guilabel
>Dokumentation</guilabel
>funktion. </para>
      <note
><para
>Ved at fjerne afkrydsningen i <guilabel
>TOC</guilabel
> afkrydsningsfeltet, fjerner skiftevis afkrydsningerne i <guilabel
>Indeks</guilabel
> og <guilabel
>Søg</guilabel
>, se herunder. Derfor kan du ikke have dokumentationssamlingsindgange indekseret men ikke vist i indholdsfortegnelsen. </para
></note>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Indeks</guilabel
></term>
    <listitem>
      <para
>Hvis dette afkrydsningsfelt er afkrydset, bygges der et internt indeks af denne dokumentationsindgang. Dette medfører hurtig adgang til dokumentationen vha. <guilabel
>Indeks</guilabel
> og (valgfrit) <guilabel
>Finder</guilabel
> siderne i &kdevelop; <guilabel
>Dokumentation</guilabel
>sfunktionen. </para>
      <note>
        <para
>Det interne indeks bygges første gang brugeren vælger <guilabel
>Indeks</guilabel
>siden. Dette gør første tilgang til indekset temmelig langsom fordi indekset skal læses fra disken og derefter lægges i cache. </para>
        <para
>Alle følgende indekssøgninger derimod, vil benytte denne cache og derfor virke markant hurtigere. </para>
      </note>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Søg</guilabel
></term>
    <listitem>
      <para
>Hvis dette afkrydsningsfelt er markeret, bliver indholdet af denne dokumentationsindgang inkluderet i fuldtekstsøgestien i <guilabel
>Søg</guilabel
>esiden i &kdevelop;s <guilabel
>Dokumentation</guilabel
>funktion. </para>
      <note>
        <para
>&kdevelop; benytter htdig-programsamlingen til at udføre fuldtekstsøgninger. Denne søgning udføres i et internt indeks som htdig-maskineriet er nødt til at bygge for det kan bruges. </para>
        <para
>En ændring i <guilabel
>Søg</guilabel
>-afkrydsningsfeltet har dermed først effekt på søgninger efter du har bygget indekset på ny, i &kdevelop;s <guilabel
>Dokumentation</guilabel
>funktion. </para>
      </note>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
><guilabel
>Titel</guilabel
></term>
    <listitem
><para
>Dette er navnet på dokumentationsindgangen som den vil blive vist i <guilabel
>Indhold</guilabel
>-sfortegnelsen i &kdevelop;s <guilabel
>Dokumentation</guilabel
>funktion. </para
></listitem>
  </varlistentry>
</variablelist>

<note
><para
>I tidligere udgaver af &kdevelop; var det tilladt at vælge at dokumentationsindgange kunne vises forskelligt for hvert enkelt projekt. Dette er ikke længere muligt. </para
></note>
</listitem>
</varlistentry>
</variablelist>

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

<sect3 id="setup-docu-general-qt">
<title
>&Qt;-dokumentationssamlinger</title>

<para
>På denne indstillingsside indstilles al &Qt;-dokumentation. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-docu-general.png" format="PNG"/>
    </imageobject>
<textobject
><phrase
>Opsætning af &Qt;-dokumentationssamlinger</phrase
></textobject>
    <caption
><para
>Opsætning af &Qt;-dokumentationssamlinger </para
></caption>
  </mediaobject>
</screenshot>

<para
>Normalt vil &kdevelop; udfylde denne ved sin første opstart. Den leder efter standarddokumentationsfiler, <filename
>*.xml</filename
>, eller <filename
>*.dcf</filename
>, i &Qt;'s installationskatalog. Tabellen til venstre giver en liste af de filer &kdevelop; fandt, med deres standardtitler. </para>

<para
>Hvis du har en ikke-standardinstallation, vil der enten ingen information være overhovedet eller indgangene vil muligvis pege på forkerte steder (&eg; til en anden &Qt;-installation på dit system). Du kan justere indgangene ved brug af <link linkend="setup-docu-buttons"
>knapperne</link
> til højre for listefeltet. </para>

<note
><para
>&kdevelop; bruger titlerne fra &Qt;-dokumentationen. Derfor er <guilabel
>Titel</guilabel
>feltet i <guilabel
>Dokumentationssamlinger</guilabel
>dialogen ikke tilgængelig. </para
></note>

<para
>Som standard vises ikke al &Qt;-dokumentation i <guilabel
>Indhold</guilabel
>sfortegnelsen i &kdevelop;s <guilabel
>Dokumentation</guilabel
>funktion. Brug <guilabel
>TOC</guilabel
>-afkrydsningsfeltet i <link linkend="setup-docu-columns"
>tabelindstilling</link
> for at vælge dokumentationen der skal vises. </para>

<para
>Hvis du vil have noget specifikt &Qt;-dokumentation inkluderet i søgeindekset eller fuldtekstsøgning, så brug <guilabel
>Indeks</guilabel
> og <guilabel
>Søg</guilabel
>-afkrydsningsfeltet i <link linkend="setup-docu-columns"
>tabelindstilling</link
>. </para>

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

<sect3 id="setup-docu-general-chm">
<title
>Opsætning af CHM-dokumentationssamlinger</title>

<para
>På denne indstillingsside kan du samle dokumentation der følger &Microsoft;s CHM hjælpefilstandard. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-docu-chm.png" format="PNG"/>
    </imageobject>
<textobject
><phrase
>Opsætning af &Microsoft;s CHM dokumentationsfiler.</phrase
></textobject>
    <caption
><para
>Opsætning af &Microsoft;s CHM dokumentationsfiler. </para
></caption>
  </mediaobject>
</screenshot>

<para
>Som standard er denne indstillingsside, som vist ovenfor, tom. Du kan tilføje nye indgange ved at bruge <link linkend="setup-docu-buttons"
>knapperne</link
> til højre for listen. &kdevelop; filtrerer <filename
>*.chm</filename
>-filer i mappedialogerne der hører til <guibutton
>Tilføj</guibutton
> og <guibutton
>Redigér</guibutton
>-knapperne. </para>

<para
>For mere information om &Microsoft;s <filename
>*.chm</filename
>-filformat, se &eg; PHP: Dokumentation - Udvidet 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 genereret af doxygen</title>

<para
>På denne indstillingsside opsættes al &API;-dokumentation genereret af &doxygen;. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-docu-dox.png" format="PNG"/>
    </imageobject>
<textobject
><phrase
>Opsætning af Doxygen-genereret &API;-dokumentation</phrase
></textobject>
    <caption
><para
>Opsætning af Doxygen-genereret &API;-dokumentation </para
></caption>
  </mediaobject>
</screenshot>

<para
>Kort sagt dokumenterer en &API;-grænsefladen til visse biblioteksfunktioner. &API;-dokumentation på denne side skal laves af det eksterne <ulink url="http://www.doxygen.org"
>&doxygen;</ulink
>-værktøj. </para>
<para
>&doxygen;-generet &API;-dokumentation, består af en samling <filename
>html</filename
>-filer, der starter med <filename
>index.html</filename
>. Derudover kan der eksistere <filename
>tag</filename
>-filer som indeholder information om hvordan der linkes til eksisterende &API;-dokumentation. Derfor leder &kdevelop; efter <filename
>index.html</filename
> og <filename
>*.tag</filename
>-filer når der søges efter &doxygen;-genereret &API;-dokumentation. </para>
<para
>Der antages nogle strukturelle begrænsninger når der søges efter &doxygen;-genereret &API;-dokumentation. Kataloget hvori <filename
>index.html</filename
>-filen ligger, skal indeholde underkataloger med adskilte dokumentationssamlinger. Hver af disse underkataloger antages at indeholde en <filename
>.tag</filename
>-fil og et <filename class="directory"
>html/</filename
> underkatalog. </para>
<para
>Du kan tage et kig i <filename class="directory"
>$<envar
>KDEDIR</envar
>/share/doc/HTML/en/kdelibs-apidocs</filename
> hvor der findes et eksempel på et sådant layout for dokumentation af programmeringsgrænseflade med &doxygen;. </para>

<note
><para
>Det ældre &kde; <ulink url="http://sirtaj.net/projects/kdoc/"
>KDoc</ulink
> genererede &API;-format er ikke længere direkte understøttet. Hvis du stadig vil bruge den slags dokumentation, kan du tilføje det på <link linkend="setup-docu-general-custom"
>Brugerdefineret documentationsamlingl</link
>ssiden. </para
></note>

<para
>&kdevelop; vil have indsat et link til de nuværende &kde;-bibliotekers &API;, hvis de ellers blev fundet på installationstidspunktet. Der er flere måder for &kdevelop; at finde ud af det: </para>

<itemizedlist>
  <listitem
><para
>Enten gav du <command
>configure</command
> kommandoen <option
>--with-kdelibsdoxy-dir</option
> flaget da du kompilerede &kdevelop; (se <link linkend="make-api"
>Hvordan man får fat på en &kdevelop; &API; dokumentation</link
>-kapitlet). </para
></listitem>
  <listitem
><para
>Eller <command
>configure</command
> kommandoen fandt automatisk en &doxygen; genereret &kde;-biblioteker &API; på et af de adskillige standardsteder den kender til. </para
></listitem>
  <listitem
><para
>Eller som sen sidste udvej <filename class="directory"
>$<envar
>KDEDIR</envar
>/share/doc/HTML/en/kdelibs-apidocs/</filename
> blev fundet ved første opstart af &kdevelop;. </para
></listitem>
</itemizedlist>

<para
>Hvis &kdevelop; ikke fandt en gyldig &doxygen; genereret &kde;-&API; ved sin første opstart, vil listen med <guilabel
>Doxygendokumentationssamlingen</guilabel
> være tom. </para>

<para
>Du kan tilføje dine egne &API;-dokumentationsindgange (&eg; fra dine aktuelle projekter) ved at bruge <link linkend="setup-docu-buttons"
>knapperne</link
>  til højre. Hvis du vil inkludere dem i den indekserede og eller fuldtekstsøgning, så afkryds <guilabel
>Indeks</guilabel
> eller<guilabel
>Søg</guilabel
> afkrydsningsfeltet i <link linkend="setup-docu-columns"
>tabelindstilling</link
>. </para>

<note
><para
>&kdevelop; bruger titelinformationen fra <filename
>index.html</filename
>. Derfor er <guilabel
>Titel</guilabel
>feltet i <guilabel
>Dokumentationsamling</guilabel
>sdialogen ikke tilgængelig. </para
></note>

<tip>
  <para
>&kde;-systemet sørger for mere &API;-dokumentation end kun &kde;-bibliotekernes &API;. Du vil få brug for yderligere grænsefladeinformation hvis du ønsker &eg; at inkludere &kate;-parten i dine programmer. For denne &kate;-part-&API; for eksempel, vil du skulle kompilere og installere &kde;'s basisbibliotekernes &API; fra <ulink url="http://developer.kde.org/source/index.html"
>kilderne</ulink
> (ved brug af <command
>make apidox</command
> og <command
>make install</command
> kommandoerne i <filename class="directory"
>kdebase</filename
>s kilder) og så tilføje en indgang til <guilabel
>Doxygen dokumentationssamling</guilabel
>slisten sådan her: </para>
  <screenshot
><mediaobject>
      <imageobject>
        <imagedata fileref="configure-adddialog-baselibs.png" format="PNG"/>
      </imageobject>
<textobject
><phrase
>Tilføjelse af &kde;'s basis-&API; til listen</phrase
></textobject>
      <caption
><para
>Tilføjelse af &kde;'s basis-&API; til listen </para
></caption>
    </mediaobject
></screenshot>
  <para
>(Du skal naturligvis erstatte <filename class="directory"
>/home/dev/mitkde-system/</filename
>-kataloget i <guilabel
>Sted</guilabel
>feltet, med stien til din egen &kde;-installation.) </para>
</tip>

<note
><para
>Du er nødt til også at lægge dit nuværende projekts &API; ind i <guilabel
>Doxygendokumentationssamling</guilabel
>. I tidligere &kdevelop;udgaver lagde det ind i dokumentationen for hvert enkelt projekt. Dette er ikke længere understøttet. </para
></note>

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

<sect3 id="setup-docu-general-toc">
<title
>Håndtering af struktureret dokumentation (KDevelopTOC-filer)</title>

<para
>Hoveddelen af &kdevelop;'s dokumentationstræ sørger for umiddelbar adgang til struktureret dokumentation, lokal så vel som ekstern. Du kan indstille dette i <guilabel
>KDevelopTOC dokumentationssamling</guilabel
>-fanebladet i <guilabel
>Dokumentationsamlinger</guilabel
>-indstillingssiden. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-docu-toc.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Sørger for KDevelopTOC-struktureret dokumentationsadgang </para
></caption>
  </mediaobject>
</screenshot>

<para
>&kdevelop; kommer med en mængde foruddefinerede KDevelopTOC-filer som automatisk tilføjes i tabellen på installationstidspunktet. For at holde visningen overskuelig, er det kun de oftest brugte der makeres til visning. Hvis du vil kunne se andet dokumentation så afkryds <guilabel
>TOC</guilabel
> afkrydsningsfeltet i <link linkend="setup-docu-columns"
>tabelindstilling</link
>. </para>

<para
>KDevelopTOC-filer kan ikke indekseres så der kan udføres fuldtekstsøgning, fordi de normalt peger på en ekstern placering. På den anden side kan en <filename
>.toc</filename
>-fil få et manuelt defineret indeks, ved at bruge <computeroutput
>&lt;index&gt;</computeroutput
> mærket. Derfor vil <guilabel
>Indeks</guilabel
> afkrydsningsfeltet kun være aktiveret når &kdevelop; finder et <computeroutput
>&lt;index&gt;</computeroutput
> mærke i <filename
>.toc</filename
> -filen. (For mere information, se beskrivelsen herunder i <link linkend="setup-docu-general-toc-files"
>&kdevelop; TOC Filer</link
> sektionen.) </para>
<para
><guilabel
>Søg</guilabel
> afkrydsningsfeltet i <link linkend="setup-docu-columns"
>tabelindstilling</link
> vil altid være deaktiveret. </para>

<para
>Du kan tilføje nye indgange ved at bruge <link linkend="setup-docu-buttons"
>knapperne</link
> til højre for listen. &kdevelop; vil filtrere <filename
>*.toc</filename
>-filer i mappedialogerne der hører til <guibutton
>Tilføj</guibutton
> og <guibutton
>Redigér</guibutton
>-knapperne. </para>

<note
><para
>Kun i ældre udgaver af &kdevelop; vil <guibutton
>Fjern</guibutton
>-knappen ikke ændre <filename
>*.toc</filename
>-filer på disken, så fjern-funktionen er sikker nu. </para
></note>

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

<sect3 id="setup-docu-general-toc-files">
<title
>&kdevelop; Indholdsfortegnelsesfiler (TOC-filer)</title>

<para
>Der  er en særlig funktion knyttet til dette. For at illustrere det, følg disse skridt: I dokumentationstræet findes en indgang lige under &Qt;/&kde;-dokumentationen (&eg; <quote
>KDE2 Udviklingsbog (kde.org)</quote
>). Klik på plus-tegnet ved siden af den. Et træ vil blive åbnet hvor du hurtigt kan navigere til de følgende kapitler adskillige lag dybt, altsammen offline. Men hvis du vælger et af kapitlerne, vil &kdevelop; i mange tilfælde prøve at få adgang til en <emphasis
>ekstern</emphasis
> dokumentationsfil. </para>

<para
>Rationalet bag dette er ikke kun at navigere ekstern dokumentation lokalt uden at spilde ressourcer på adgang til nettet, men også at give udvikleren nem og struktureret adgang til den ønskede dokumentation. Med de værktøjer der er til rådighed her, kan man få adgang til næsten al lokal eller ekstern dokumentation på en struktureret måde, selvom originalen er lagt fladt ud eller struktureret på en anden måde. Det eneste der behøves, er adgang til filer og/eller dele af filer, som kan vises med Konqueror. </para>

<para
>Sådan struktureret adgang er gjort mulig ved brug af specielle <quote
>indholdsfortegnelses</quote
>filers, som er betegnet med <filename
>.toc</filename
> filnavneendelser. Enhver sådan af &kdevelop;'s TOC-filer indeholder en &XML;-struktureret beskrivelse af dokumentet der skal bruges. </para>

<variablelist>
<varlistentry>
<term
>Standardmappe for &kdevelop;'s TOC-filer</term>
<listitem>
<para
>Da &kdevelop; blev installeret blev der normalt lagt en række prædefinerede <filename
>.toc</filename
>-filer ind i mappen <filename class="directory"
>$KDEDIR/share/apps/kdevdoctreeview/tocs</filename
>. Disse er temmelig simple, strukturerede tekstfiler. Du kan studere dem med en teksteditor eller anden tekstvisningsfacilitet. </para>
</listitem>
</varlistentry
></variablelist>

<!-- FIXME: Lauri Watts (2005-05-03) This could be marked up a whole lot -->
<!-- more clearly with the sgmltags stuff.  Making a note to do that once -->
<!-- this first revision is done. -->

<variablelist id="toc-file-structure">
  <title
>Basal struktur af &kdevelop;'s TOC-filer</title>
  <varlistentry>
    <term
>header</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
>(basisadresse)</emphasis>
        </member>
        <member>
          <emphasis
>(indholdsstruktur)</emphasis>
        </member>
        <member>
          <emphasis
>(indeksstruktur)</emphasis>
        </member>
        <member>
          <computeroutput
>&lt;/kdeveloptoc&gt;</computeroutput>
        </member>
      </simplelist>
      <para
>Denne &XML;-struktur vil blive tolket af &kdevelop;'s <guilabel
>Dokumentation</guilabel
>-plugin for at indstille dokumentationstræets indhold og hjælpe brugeren med at navigere dokumentationen. Den indeholder al den nødvendige information til at vise titlet og få adgang til dokumentationsfilernes indhold. </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
>titel</term>
    <listitem>
      <simplelist>
        <member
><computeroutput
>&lt;title&gt;</computeroutput
> <emphasis
>(en titelstreng)</emphasis
> <computeroutput
>&lt;/title&gt;</computeroutput
> </member>
      </simplelist>
      <para
>Dette er den titel som &kdevelop; vil vise på de basale niveauer i dokumentationstræet. </para>
      <note
><para
>Denne viste titel kan for øjeblikket ikke ændres af brugeren. Hvis du ønsker at en anden tekst skal vises, må ændre <computeroutput
>&lt;title&gt;</computeroutput
>-indgangen i <filename
>.toc</filename
>-filen manuelt. </para
></note>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
>basisadresse</term>
    <listitem>
      <simplelist>
        <member
><computeroutput
>&lt;base href="</computeroutput
> <emphasis
>(basisdokument &URL;)</emphasis
> <computeroutput
>"/&gt;</computeroutput
> </member>
      </simplelist>
      <para
>Denne &URL; peger på stedet hvor alle filerne i denne dokumentation er. Den vil blive sat forud for hvert afsnits-&URL; i følgende indholdsstrukturliste. Så, hvis du &eg; hentede en dokumentation fra en  ekstern server, er alt du behøver for at vise filerne fra dette nye sted at ændre dets <computeroutput
>&lt;basis&gt;</computeroutput
>-&URL;. </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
>indholdsstruktur</term>
    <listitem>
      <simplelist>
        <member
><computeroutput
>&lt;tocsect1 name="</computeroutput
> <emphasis
>(afsnittets titel)</emphasis
> <computeroutput
>" url="</computeroutput
> <emphasis
>(afsnittets &URL;)</emphasis
> <computeroutput
>"&gt;</computeroutput
> </member>
        <member
>...</member>
        <member
><computeroutput
>&lt;tocsectn name="</computeroutput
> <emphasis
>(afsnittets titel)</emphasis
> <computeroutput
>" url="</computeroutput
> <emphasis
>(afsnittets &URL;)</emphasis
> <computeroutput
>"/&gt;</computeroutput
> </member>
        <member
>...</member>
        <member>
          <computeroutput
>&lt;/tocsect1&gt;</computeroutput>
        </member>
      </simplelist>
      <para
>Al øvrig navigations og adgangsinformation er opbevaret i en række indlejrede <computeroutput
>&lt;tocsecti&gt;</computeroutput
> ... <computeroutput
>&lt;/tocsecti&gt;</computeroutput
> par. Hvert <emphasis
>i</emphasis
> betegner det følgende indlejringsniveau ned til nummer <emphasis
>n</emphasis
> som vil svare til det endeligt viste dokumentationsafsnit. </para>
      <para
>Enhver <computeroutput
>&lt;tocsecti&gt;</computeroutput
>-indgang skal have en <computeroutput
>name="xxx"</computeroutput
>-attribut tilknyttet (hvor "xxx" betegner den faktiske titelstreng). Dette vil blive vist som niveautitlen i dokumentationstræet. Det skal svare til et egentligt dokumentationsafsnit. </para>
      <para
>Der kan være en <computeroutput
>url=""</computeroutput
>-attribut knyttet til ethvert <emphasis
>i</emphasis
> indlejringsniveau. Når brugeren klikker på et afsnit titel i dokumentationstræet vil &kdevelop; forsøge at få adgang til filen på det sted der peges på af den kombinerede basis- og afsnits-&URL;. </para>
      <para
><computeroutput
>&lt;tocsectn/&gt;</computeroutput
>-indgangen skal have en <computeroutput
>url=""</computeroutput
>-attribut under alle omstændigheder. Den endelige indlejrede <computeroutput
>&lt;tocsectn/&gt;</computeroutput
> kommer ikke i par men vil umiddelbart blive lukket af en <computeroutput
>/</computeroutput
> før <computeroutput
>&gt;</computeroutput
>-parentesen. </para>
      <note
><para
>Enhver adresse kombineret af basis- og afsnits-&URL; skal pege på en tekstfil der kan fremvises. Sædvanligvis vil dette være en HTML-struktureret fil. Det er muligt at linke til ankermærker indenfor sådan en HTML-fil ved brug af standard # notation i formatet: <filename
>/base-url/section-url#anker-mærke</filename
>. </para
></note>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term
>indeksstruktur</term>
    <listitem>
      <simplelist>
        <member>
          <computeroutput
>&lt;index&gt;</computeroutput>
        </member>
        <member
><computeroutput
>&lt;entry name="</computeroutput
> <emphasis
>(afsnittets titel)</emphasis
> <computeroutput
>" url="</computeroutput
> <emphasis
>(afsnittets &URL;)</emphasis
> <computeroutput
>"/&gt;</computeroutput
> </member>
        <member>
          <computeroutput
>&lt;/index&gt;</computeroutput>
        </member>
      </simplelist>
      <para
>Indeks er en enkel liste med indeksindgange, par af titler og &URL;'er. Et indeks er ikke obligatorisk. </para>
    </listitem>
  </varlistentry>
</variablelist>
<!-- FIXME: End -->

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

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

<para
>DevHelp dokumentation er en anden måde for struktureret dokumentationsadgang. Den bruger strukturerede tabeller af indholdsfiler betegnet med en <filename
>.devhelp</filename
>-endelse ligesom <link linkend="setup-docu-general-toc-files"
>&kdevelop;'s TOC-filer</link
> for at få adgang til dokumentationen for GNOME 2 desktoppen. </para>
<para
>Du kan kontrollere hvilke DevHelp-filer der skal være adgang til, på <guilabel
>DevHelp dokumentationssamling</guilabel
>indstillingssiden. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-docu-devhelp.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Sørger for DevHelp dokumentation </para
></caption>
  </mediaobject>
</screenshot>

<para
>DevHelp-filerne kunne oprindeligt nås på hjemmesiden <ulink url="http://lidn.sourceforge.net/"
>LiDN</ulink
>, men det synes ikke længere at være vedligeholdt et stykke tid nu. Mere nylig DevHelp-dokumentation er tilgængelig på hjemmesiden <ulink url="http://htmlhelp.berlios.de/books/devhelp.php"
>Download af DevHelp-bøger</ulink
>. </para>

<para
>Når &kdevelop; installeres, vil det forsøge at finde alle <filename
>.devhelp</filename
>-filer i nogle standardplaceringer i systemet, &eg; i underkatalogerne af <filename class="directory"
>/opt/gnome/share/</filename
>. Til at begynde med markeres disse filer ikke til visning. Hvis du vil se anden dokumentation skal du afkrydse <guilabel
>TOC</guilabel
>-afkrydsningsfeltet i <link linkend="setup-docu-columns"
>tabelindstilling</link
>. </para>

<para
>Du kan tilføje nye indgange ved at bruge <link linkend="setup-docu-buttons"
>knapperne</link
> til højre for listen. &kdevelop; vil filtrere <filename
>*.toc</filename
>-filer i mappedialogerne der hører til <guibutton
>Tilføj</guibutton
> og <guibutton
>Redigér</guibutton
>-knapperne. </para>

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

<sect3 id="setup-docu-general-custom">
<title
>Opsætning af brugerdefinerede dokumentationssamlinger</title>

<para
>Dette er til eget brug. Du kan tilføje stort set alle dokumentationsfiler her, forudsat at de kan vises med en &konqueror;-plugin. </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-docu-custom.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Sørger for brugerdefineret dokumentation </para
></caption>
  </mediaobject>
</screenshot>

<para
>Normalt er denne liste tom ved &kdevelop;s første opstart. Vi har lagt en indgang ind for at vise indgangsstrukturen. </para>
<para
>Håndteringen er ligeud ad landevejen her. Brug <link linkend="setup-docu-buttons"
>knapperne</link
> til højre for listen for at tilføje, redigere eller fjerne dokumentationsindgangene. &kdevelop; vil ikke filtrere noget som helst i mappedialogen der hører til <guibutton
>Tilføj</guibutton
> og <guibutton
>Redigér</guibutton
>-knapperne. </para>

<para
>Du skal eksplicit tilføje indgangene der skal vises i &kdevelop;s dokumentationsfunktion. Afkryds indgangens <guilabel
>TOC</guilabel
> afkrydsningsfeltet i <link linkend="setup-docu-columns"
>tabelindstilling</link
>. </para>

<note
><para
>Brugerdefineret dokumentation kan hverken indekseres eller søges i. Derfor er <guilabel
>Indeksx</guilabel
> og <guilabel
>Søg</guilabel
> afkrydsningsfelterne ingen effekt, som vist herover. </para
></note>

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

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

<sect2 id="setup-docu-textsearch">
<title
>Opsætning af tekstsøgningsindekser</title>

<para
>(... endnu ikke skrevet ...) </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="configure-doctree-textsearch.png" format="PNG"/>
    </imageobject>
    <caption
><para
>Opsætning af tekstsøgningsindekser </para
></caption>
  </mediaobject>
</screenshot>

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

<sect2 id="setup-docu-other">
<title
>Andre dokumentationindstillinger</title>

<para
>(... endnu ikke skrevet ...) </para>

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

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

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

<sect1 id="setup-advanced">
<title
>Avancerede indstillinger</title>

<para
>(... endnu ikke skrevet ...) </para>

<sect2 id="setup-plugins">
<title
>Pluginværktøjer</title>

<para
>(... endnu ikke skrevet ...) </para>
</sect2
> <!-- setup-plugins -->

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

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