<chapter id="getting-started">

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

<title
>Kom i gang med &kdevelop; &mdash; en guided tur</title>

<para
>Nu da du har installeret udviklingsmiljøet &kdevelop; hvordan skal du så bruge det? Eftersom dette er et temmelig komplekst program, er det ret let at løbe panden mod muren når man skal lære at bruge det, især hvis du ikke i forvejen har erfaringer med et integreret udviklingsmiljø. </para>
<para
>Vi skal forsøge at gøre det hele lidt lettere ved at gennemgå trinene i processen at lave et simpelt KDE C++ program. På den måde får vi et hurtigt blik på: </para>
<simplelist>
  <member
><link linkend="gettingstarted-overview"
>Hvad vi finder på overfladen af &kdevelop;</link
></member>
  <member
><link linkend="gettingstarted-configure"
>Nogle indledende indstillinger.</link
></member>
  <member
><link linkend="gettingstarted-new"
>Hvordan man opretter et nyt projekt.</link
></member>
  <member
><link linkend="gettingstarted-edit"
>Hvordan man arbejder med dokumentation.</link
></member>
  <member
><link linkend="gettingstarted-compile"
>Hvordan man oversætter programmet i dette eksperimentelle projekt.</link
></member>
  <member
><link linkend="gettingstarted-extend"
>Hvordan man tilføjer klasser og andre detaljer til et projekt.</link
></member>
  <member
><link linkend="gettingstarted-debug"
>Hvordan man fejlsøger i programmer.</link
></member>
  <member
><link linkend="gettingstarted-doc"
>Nogle grundlæggende værktøjer der kan bygge program- eller brugerdokumentation.</link
></member>
</simplelist>

<sect1 id="gettingstarted-overview">
<title
>Et første kig på &kdevelop;</title>

<sect2 id="gettingstarted-overview-basic">
<title
>På overfladen</title>

<para
>Når du starter &kdevelop; for første gang får du noget at se der ligner det her: </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="empty-ide.png" format="PNG"/>
    </imageobject>
    <caption
><para
>&kdevelop;s udseende ved første opstart. </para
></caption>
  </mediaobject>
</screenshot>

<formalpara>
<title
>Arbejdsområde og værktøjsvisnings-faneblade.</title>
<para
>I denne førstegangstilstand bruger &kdevelop; den såkaldte <link linkend="uimodes-survey"
>IDEAl -brugergrænseflade</link
>. Et så stort arbejdsområde som muligt er omkrandset til venstre, nederst og til højre af en en række knapper der ligner faneblade i en fanebladsvisning. Klikker du på en af knapperne åbnes en <emphasis
>værktøjsvisning</emphasis
> i et vindue så du kan arbejde på en bestemt opgave. </para>
</formalpara>

<formalpara>
<title
>Menuer og værktøjslinjer</title>
<para
>I toppen er der den sædvanlige menulinje, med selskab af flere rækker af værktøjslinjer, nogle af dem tomme til at begynde med. De fyldes op med knapper så snart et projekt åbnes. </para>
</formalpara>

<formalpara>
<title
>Statuslinje</title>
<para
>Til sidst er der en statuslinje i bunden af vinduet, der viser kort information om flere forskellige opgaver. </para>
</formalpara>
</sect2
> <!-- gettingstarted-overview-basic -->

<sect2 id="gettingstarted-overview-help">
<title
>Sådan får du hjælp</title>

<para
>Udover <guimenu
>Hjælp</guimenu
> der har svar på specifikke spørgsmål, sørger statuslinjen og to slags værktøjsvink for hurtig information. </para>

<formalpara>
<title
>Hvad gør denne menuindgang?</title>
<para
>Når du placerer musemarkøren på et menupunkt, vises der som regel lidt kort information i statuslinjen. I de fleste tilfælde er det blot samme navn som menupunktet, mens der i andre tilfælde vises yderligere information om menupunktets formål.</para>
</formalpara>

<formalpara>
<title
>Hvad hedder dette element.</title>
<para
>På mange elementer vises der et kort værktøjsvink når du placerer musemarkøren på det et par sekunder. Det er nyttigt når man hurtigt skal orientere sig i en værktøjslinje eller en værktøjsvisning i IDEAL-tilstanden når KDevelop er indstillet til kun at vise ikoner på disse knapper.</para>
</formalpara>

<formalpara>
<title
>Hvad gør denne her?</title>
<para
>Man kan få mere information gennem udvidede værktøjsvink for mange elementer i udviklingsmiljøet. Vælg <menuchoice
><guimenu
>Hjælp</guimenu
> <guimenuitem
>Hvad er dette?</guimenuitem
></menuchoice
> eller tryk på <keycombo
><keycap
>&Shift;</keycap
><keycap
>F1</keycap
></keycombo
> og vælg så med spørgsmålstegnet det element du ønsker at vide mere om. Du kan også åbne en hvilken som helst menu på denne måde og klikke på et menupunkt (aktivt som inaktivt) for at få mere information.</para>
</formalpara>

</sect2
> <!-- gettingstarted-overview-help -->

<sect2 id="gettingstarted-overview-menu">
<title
>Hvad er der i menuerne</title>

<para
>Der er ti menuer der kan vælges i menulinjen. De fleste er helt fyldt når der åbnes et projekt at arbejde på, mens andre mindst kræver et dokument åbnes. Kort fortalt, de tillader følgende handlingstyper </para>

<variablelist>
  <varlistentry>
  <term
><guimenu
>Fil</guimenu
></term>
  <listitem>
    <formalpara
><title
>Almindelige handlinger</title>
    <para
>Dette er ret grundlæggende. Det lader dig oprette, åbne, gemme, udskrive og lukke dokumentfiler, såvel som afslutte &kdevelop;-programmet som normalt.</para
></formalpara>
    <formalpara
><title
>Fortryd ændringer</title>
    <para
>Yderligere tillader det dig at fortryde ændringer, ved at genindlæse filindholdet under ordnede forhold.</para
></formalpara>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Redigér</guimenu
></term>
  <listitem>
    <para
>Denne menu er brugbar hvis kun et dokument er åbnet.</para>
    <formalpara
><title
>Almindelige handlinger</title>
    <para
>Det tilbyder den sædvanlige fortryd/annullér fortryd og klip, kopiér og indsæt-funktionalitet. Derforuden lader det dig vælge tekstblokke på forskellige vis.</para
></formalpara>
    <formalpara
><title
>Søg og erstat</title>
    <para
>Der er en meget omfattende søgefacilitet til rådighed i <guimenu
>Redigér</guimenu
>-menuen. Udover den almindelige søg og erstat-handlinger der er begrænset til det aktuelle dokument, kan du også foretage globale søg og erstat-handlinger. Dette lader dig arbejde på alle filer i projektet i en enkel omgang.</para
></formalpara>
    <formalpara
><title
>Avanceret tekstredigering</title>
    <para
>Der er mulighed for at reformatere det aktuelle dokument og automatisk fuldstændiggøre delvist indtastet tekst på forskellige måder.</para
></formalpara>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Vis</guimenu
></term>
  <listitem>
    <para
>Ligesom <guimenu
>Redigér</guimenu
>-menuen er denne menu kun brugbar hvis et projekt er åbnet. I dette tilfælde er følgende handlinger til rådighed (blandt andre).</para>
    <formalpara
><title
>Navigeringshistorik</title>
    <para
>Skift mellem dokumenterne &etc; du har besøgt.</para>
    </formalpara>
    <formalpara
><title
>Fejlsporing</title>
    <para
>Navigér til linjerne i kildekoden hvor fejlene i den seneste oversættelse skete.</para>
    </formalpara>
    <formalpara
><title
>Håndtér værktøjsvisninger</title>
    <para
>Vælg eller skjul værktøjsvisninger i vinduer eller dokker.</para>
    </formalpara>
    <formalpara
><title
>Editor-relaterede handlinger</title>
    <para
>Nogle indgane i <guimenu
>Vis</guimenu
>-menuen kontrollerer editorens udseende. Når der er tale om &kate;-parten (Embedded Advanced Text Editor) er følgende kontroller til rådighed:</para>
    </formalpara>
    <itemizedlist>
      <listitem
><para
>Kontrollér opførsel af linjeombrydning i dokumentvinduet.</para
></listitem>
      <listitem
><para
>Vis eller skjul forskellige visninger i kanten af dokumentvinduet. linjenumre, ikoner og desuden bogmærker i rullebjælken.</para
></listitem>
      <listitem
><para
>Kontrollér visningen af foldede sektioner (midlertidigt skjult) i kildekode.</para
></listitem>
    </itemizedlist>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Projekt</guimenu
></term>
  <listitem>
    <para
>Al arbejde i &kdevelop; er baseret på <emphasis
>projekter</emphasis
> der egentlig bare samler kildekoder-filer, byggehåndterings-filer og andet information i en projektmappe. i denne menu kan du kontrollere hvilket projekt du vil bruge, hvilke egenskaber det har og her er også nogle håndteringshandlinger. Specielt:</para>
    <formalpara
><title
>Åbn et projekt</title>
    <para
>Tillader dig at oprette nye projekter, åbne eksisterende og importere projekter fra andre miljøer.</para>
    </formalpara>
    <formalpara
><title
>Projektindstillinger</title>
    <para
>Tillader dig at definere en hel masse forskellige projektegenskaber.</para>
    </formalpara>
    <formalpara
><title
>Klassehåndtering</title>
    <para
>Tilføj nye klasser til projektet og få overblik over klassers arv-sammenhæng.</para>
    </formalpara>
    <formalpara
><title
>Distribuér projekt</title>
    <para
>Hjælper dig med at bygge distributionspakker af projektet.</para
></formalpara>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Byg</guimenu
></term>
  <listitem>
    <para
>Denne menu drejer sig om at oversætte og dokumentere projektet. Derfor er den kun mulig at bruge når et projekt er åbnet. I dette tilfælde er følgende handlinger til rådighed:</para>
    <formalpara
><title
>Oversæt, link, kør</title>
    <para
>Lader dig oversætte og linke hele projektet eller dele af det, såvel som køre programmet i KDE.</para>
    </formalpara>
    <formalpara
><title
>Forbered bygge-operationer</title>
    <para
>Dette afhænger faktisk af make-systemet du benytter til dette projekt. Når der er talte om automake-projekter, kan du køre <filename
>Makefile.cvs</filename
> og <filename
>configure</filename
> for sig selv. Der er også mulighed for, i forskellig udstrækning, at fjerne oversatte filer fra projektet.</para>
    </formalpara>
    <formalpara
><title
>Installér programmet</title>
    <para
>Lader dig installerere programmet i lokale kataloger, men også i system-kataloger hvortil kun root har adgang.</para>
    </formalpara>
    <formalpara
><title
>API-dokumentation</title>
    <para
>Byg eller eller fjern doxygen-baseret API-dokumentation fra projektet som defineret i projektindstillingerne.</para>
    </formalpara>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Fejlsøg</guimenu
></term>
  <listitem>
    <para
>Selvom denne menu fyldes med punkter så snart et projekt er aktivt, er den naturligvis kun brugbar hvis dette projekt i forvejen er oversat med fejlsøgningsinformation (dette sættes op i <menuchoice
><guimenu
>Projekt</guimenu
> <guimenuitem
>Projektindstillinger</guimenuitem
></menuchoice
>. Dermed er følgende handlinger til rådighed:</para>
    <formalpara
><title
>Almindelige fejlsøgerhandlinger</title>
    <para
>Første sektion i <guimenu
>Fejlsøg</guimenu
>-menuen sørger for en grafisk brugergrænseflade til GDB &GNU; symbolsk fejlsøger. Den lader dig starte og stoppe dit program i fejlsøgeren og trinvis gennemgå det på forskellige måder.</para>
    </formalpara>
    <formalpara
><title
>Stoppunkter</title>
    <para
>&kdevelop; lader dig sætte stoppunkter i dit programs kildekode på flere måder. En af dem er at bruge <guimenuitem
>Slå stoppunkt til/fra</guimenuitem
>-menupunktet.</para>
    </formalpara>
    <formalpara
><title
>Avanceret fejlsøgning</title>
    <para
>Andre <guimenu
>Fejlsøg</guimenu
>-menuindgange tillader mere sofistikeret programanalyse. Brug <keycombo
><keycap
>&Shift;</keycap
><keycap
> F1</keycap
></keycombo
> for at få mere information om deres formål.</para>
    </formalpara>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Vindue</guimenu
></term>
  <listitem>
    <para
>Dette er ret almindeligt. Du kan vælge et hvilket som helst åbent dokumentvindue såvel som lukke et eller flere dokumentvinduer derinde. Du kan endda vælge en samling af vinduer der skal lukkes med en enkel handling.</para>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Værktøjer</guimenu
></term>
  <listitem>
    <para
>&kdevelop; kan tilpasses på mange områder. Du kan vælge din favorit-editor til dine dokumenter såvel som udvide udviklingsmiljøets funktionalitet med eksterne værktøjer og plugin. Menuen <guimenu
>Værktøjer</guimenu
> afspejler det meste af disse mulige indstillinger.</para>
    <formalpara
><title
>Avanceret redigering</title>
    <para
>Den øvre del af <guimenu
>Værktøjer</guimenu
>-menuindgangene sørges der for af det valgte editor-plugin. Du kan vælge din favorit-editor gennem <menuchoice
><guimenu
>Opsætning</guimenu
> <guimenuitem
>Indstil KDevelop...</guimenuitem
> <guilabel
>Editor</guilabel
></menuchoice
> Så snart et redigerbart dokumenter markeret, vil den øvre del af <guimenu
>Værktøjer</guimenu
>-menuen sørge for avancerede redigeringskommandoer, specifik for den aktuelle editor.</para>
    </formalpara>
    <formalpara
><title
>Webside-håndtering</title>
    <para
>Hvis det aktive dokumentvindue indeholder en HTML-side, (&eg; vist fra udvalget i <guilabel
> Dokumentation</guilabel
>, vil <guimenu
>Værktøjer</guimenu
> vise ekstra menuindgange som giver diverse måder at håndtere websiden på.</para>
    </formalpara>
    <formalpara
><title
>Andre værktøjer</title>
    <para
>Normalt vil der være en masse andre indgange i henhold til de ril rådighed værende værktøjer. Brug <keycombo
><keycap
>&Shift;</keycap
><keycap
>F1</keycap
></keycombo
> til at få mere information om deres formål.</para>
    </formalpara>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Opsætning</guimenu
></term>
  <listitem>
    <para
></para>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Hjælp</guimenu
></term>
  <listitem>
    <para
></para>
  </listitem>
  </varlistentry>
</variablelist>

</sect2
> <!--gettingstarted-overview-menu-->

</sect1
> <!-- gettingstarted-overview -->

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

<sect1 id="gettingstarted-configure">
<title
>En smule om indstillinger</title>

<para
>(--- skal skrives ---)</para>

</sect1
> <!-- gettingstarted-configure -->

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

<sect1 id="gettingstarted-new">
<title
>Sådan starter man et nyt projekt &mdash; &appwizard;</title>

<para
>(--- skal skrives ---)</para>

</sect1
> <!-- gettingstarted-new -->

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

<sect1 id="gettingstarted-edit">
<title
>Arbejde med dokumenter</title>

<para
>(--- skal skrives ---)</para>

<sect2 id="gettingstarted-edit-codecompletion">
<title
>Automatisering af indtastningsopgaver</title>

<para
>(--- skal skrives ---)</para>

</sect2
> <!-- gettingstarted-edit-codecompletion -->

</sect1
> <!-- gettingstarted-edit -->

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

<sect1 id="gettingstarted-compile">
<title
>Oversættelse af et projekt</title>

<para
>(--- skal skrives ---)</para>

<sect2 id="gettingstarted-compile-messages">
<title
>Hvad beskederne fortæller</title>

<para
>(--- skal skrives ---)</para>

</sect2
> <!-- gettingstarted-compile-messages -->

</sect1
> <!-- gettingstarted-compile -->

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

<sect1 id="gettingstarted-extend">
<title
>Hvordan man udvider et projekt &mdash; &automanag;</title>

<para
>(--- skal skrives ---)</para>

<sect2 id="gettingstarted-extend-automake">
<title
>Et kort blik på automake-maskineriet</title>

<para
>(--- skal skrives ---)</para>

</sect2
> <!-- gettingstarted-extend-automake -->

<sect2 id="gettingstarted-extend-pics">
<title
>Sådan placerers ikoner i et separat katalog</title>

<para
>(--- skal skrives ---)</para>

</sect2
> <!-- gettingstarted-extend-pics -->

<sect2 id="gettingstarted-extend-class">
<title
>Sådan tilføjes nye klasser</title>

<para
>(--- skal skrives ---)</para>

<caution
><para
>Vær påpasselig når du vælger klassernes filnavne. Det er ekstremt svært at ændre dem senere. </para
></caution>

</sect2
> <!-- gettingstarted-extend-class -->

<sect2 id="gettingstarted-extend-subproject">
<title
>Hvad er et delprojekt?</title>

<para
>(--- skal skrives ---)</para>

<sect3 id="gettingstarted-extend-subproject-active">
<title
>Koncentrér dig om dit arbejde &mdash; det aktive mål</title>

<para
>(--- skal skrives ---)</para>

</sect3
> <!-- gettingstarted-extend-subproject-active -->

</sect2
> <!-- gettingstarted-extend-subproject -->

<sect2 id="gettingstarted-extend-restructure">
<title
>Sådan restruktureres et projekt</title>

<para
>(--- skal skrives ---)</para>

</sect2
> <!-- gettingstarted-extend-restructure -->


</sect1
> <!-- gettingstarted-extend -->

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

<sect1 id="gettingstarted-debug">
<title
>Sådan fejlsøger mand</title>

<para
>(--- skal skrives ---)</para>

</sect1
> <!-- gettingstarted-debug -->

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

<sect1 id="gettingstarted-doc">
<title
>Lidt om dokumentation</title>

<para
>(--- skal skrives ---)</para>

</sect1
> <!-- gettingstarted-doc -->

</chapter>
