<chapter id="getting-started">

<!-- ToDo: 
Put the AppWizard section at the beginning.
Before anything else, let the user generate
a hello program like this:
- assumes KDevelop is properly installed,
  e.g. from a good Linux distribution
  (list those that include KDevelop?)
- start KDevelop
- if settings are needed, accept default ones
- Project - New Project
- C++ - KDE - Simple KDE application
- name: hello, location: default (/home/user). Next
- Project Options: Leave as default. Next
- .h Template: Leave as default. Next
- .cpp Template: Leave as default. Finish
- Build - Execute Program (Yes to run automake & friends)
- Messages window appears. Wait until program is compiled.
- Finally, program pops up, saying "Hello World".

After this, explore the KDevelop functionality
with the hello program as an example.

Also: Links to detailed descriptions in the main part.
Volker Paul
-->

<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 udviklingsmiljøet &kdevelop;</link
></member>
<!--  <member
><link linkend="gettingstarted-configure"
>Some initial configuration steps.</link
></member
> -->
  <member
><link linkend="gettingstarted-new"
>Hvordan man opretter et nyt projekt.</link
></member>
<!--  
  <member
><link linkend="gettingstarted-edit"
>How to work with documents.</link
></member>
  <member
><link linkend="gettingstarted-compile"
>How to compile the application in this project.</link
></member>
  <member
><link linkend="gettingstarted-extend"
>How to add classes and other detail to your project.</link
></member>
  <member
><link linkend="gettingstarted-debug"
>What to do to debug the application.</link
></member>
  <member
><link linkend="gettingstarted-doc"
>Some basic tools to build program or user documentation.</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>

<para
>Dette er kun en oversigt. For en detaljeret listning af menuerne og punkterne i dem, se <link linkend="commands"
>Kommandoreferencen</link
>.</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 udviklingsmiljøet.</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
>Sædvanligvis er der en mængde andre indgange ifølge de værktøjer som for øjeblikket er tilgængelige. Brug <keycombo
>&Shift;<keycap
>F1</keycap
></keycombo
> for at få mere information om deres formål.</para>
    </formalpara>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Opsætning</guimenu
></term>
  <listitem>
    <para
>Denne menu lader dig vise og skjule menulinjen, værktøjslinjer og statuslinjen. Desuden kan du indstille genveje, værktøjslinjer, underretninger, editoren og Kdevelops generelle opførsel.</para>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Hjælp</guimenu
></term>
  <listitem>
    <para
>Her kan du vise KDevelops håndbog, læse Qt-dokumentation, vise manualsider (det traditionelle Unix manualformat) og infosider (GNU manualformatet), rapportere fejl og få noget information om denne version af KDevelop og dets forfattere.</para>
  </listitem>
  </varlistentry>
</variablelist>

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

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

<!--
This is covered elsewhere, so unless someone convinces me that 
it is useful to have it here as well, I will eventually delete it. Volker Paul.

<sect1 id="gettingstarted-configure">
<title
>A Bit of Configuration</title>

<para
>(- to be written -)</para>

</sect1
> 

 -->

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

<para
>Dette er til for at vise dig hvor enkelt det er at få KDevelop til at oprette et kørbart program for dig.</para>

<para
><link linkend="applicationwizard"
>Programguiden</link
> kan hurtigt oprette et projekt for dig fra en liste med fordefinerede projektskabeloner. Alt du behøver at gøre er at vælge projekttypen du vil have, hvordan det skal navngives, og hvor det skal placeres. </para>

<para
>Vælg Projekt -> Nyt projekt. Vinduet Opret nyt projekt vises. Lad os antage at du vil oprette et almindeligt KDE-projekt. Vælg altså typen C++ -> KDE -> Simpelt KDE-program. Indtast navnet, f.eks. helloworld. Standardstedet er /home/hjemmemappe/helloworld. Når du er færdig med indstillingerne i vinduet, klik på Næste. I næste vindue kan du indstille nogle tilvalg, som er forudindstillede med nyttige standardværdier. Klik på Næste. Så vises skabeloner for deklarationsfiler og kildekodefiler. Igen kan du efterlade  dem med standardtekst, og klikke på Afslut. Du ser meddelelsen om at dit program er oprettet. </para>

<para
>For at køre programmet, vælges Byg -> Kør program. Du får en meddelelse om at automake og beslægtede programmer først skal køres. Klik på O.k. Programmet bygges og køres, og et vindue fra det nye program dukker op med meddelelsen "Hello World". Du kan nu redigere dit program og tilføje mere nyttige funktioner. </para>

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

<!-- 
Again, this will be deleted, if nobody complains.

<sect1 id="gettingstarted-edit">
<title
>Working With Documents</title>

<para
>(- to be written -)</para>

<sect2 id="gettingstarted-edit-codecompletion">
<title
>How to Automate Some Typing Tasks</title>

<para
>(- to be written -)</para>

</sect2
> 

</sect1
> 


<sect1 id="gettingstarted-compile">
<title
>How to Compile a Project</title>

<para
>(- to be written -)</para>

<sect2 id="gettingstarted-compile-messages">
<title
>What the Messages Tell</title>

<para
>(- to be written -)</para>

</sect2
> 

</sect1
> 


<sect1 id="gettingstarted-extend">
<title
>How to Extend a Project &mdash; the &automanag;</title>

<para
>(- to be written -)</para>

<sect2 id="gettingstarted-extend-automake">
<title
>A Short Look at the Automake Machinery</title>

<para
>(- to be written -)</para>

</sect2
> 

<sect2 id="gettingstarted-extend-pics">
<title
>How to Place Icons in a Separate Directory</title>

<para
>(- to be written -)</para>

</sect2
> 

<sect2 id="gettingstarted-extend-class">
<title
>How to Add New Classes</title>

<para
>(- to be written -)</para>

<caution
><para>
Be careful when you select your class file names. It is extremely difficult to change them later.
</para
></caution>

</sect2
> 

<sect2 id="gettingstarted-extend-subproject">
<title
>What is in a Subproject?</title>

<para
>(- to be written -)</para>

<sect3 id="gettingstarted-extend-subproject-active">
<title
>Concentrate on Your Work &mdash; the Active Target</title>

<para
>(- to be written -)</para>

</sect3
> 

</sect2
> 

<sect2 id="gettingstarted-extend-restructure">
<title
>Some Steps to Restructure a Project</title>

<para
>(- to be written -)</para>

</sect2
> 


</sect1
> 



<sect1 id="gettingstarted-debug">
<title
>How to Debug</title>

<para
>(- to be written -)</para>

</sect1>


<sect1 id="gettingstarted-doc">
<title
>A Note on Documentation</title>

<para
>(- to be written -)</para>

</sect1>
-->
</chapter>
