<!--Dear translator: please NEVER translate the id or anything inside the tags as they are needed in english by the application
     Thanks a lot in advance.-->
<chapter id="using-kturtle">
<title
>&kturtle;'i kasutamine</title>

<screenshot>
  <screeninfo
>&kturtle; tegevuses</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="mainwindow_flower_nrs.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>&kturtle;'i peaaken</phrase>
    </textobject>
  </mediaobject>
</screenshot>

<para
>&kturtle;'i peaaken koosneb kolmest põhiosast: <link linkend="the-code-editor"
>koodiredaktor</link
> (3) vasakul, kus saab kirja panna &turtlelang;i käsud, <link linkend="the-inspector"
>inspektor</link
> (4), mis jagab teavet muutujate kohta programmi töötamise ajal, ja <link linkend="the-canvas"
>lõuend</link
> (5) paremal, kus käsud täide viiakse. <link linkend="the-canvas"
>Lõuend</link
> on kilpkonna nii-öelda liivakast, kus ta omaette askeldades sinu soovitud pildi lõpuks valmis joonistab. Peaaknal on veel kolm osa: <link linkend="the-menubar"
>menüüriba</link
> (1), mis võimaldab kasutada kõiki saadaolevaid käske, <link linkend="the-toolbar"
>tööriistariba</link
> (2), kus saab kiiresti valida sagedamini kasutatavate käskude seast, ja <link linkend="the-statusbar"
>olekuriba</link
> (5), kus näeb &kturtle;'i tagasisidena rakenduse staatust.</para>

<sect1 id="the-code-editor">
<title
>Koodiredaktor</title>
<para
>Koodiredaktor on koht, kus panna kirja &turtlelang;i käsud. See pakub kõiki võimalusi, mida üks tänapäevane redaktor ikka pakkuma peab. Enamik neist on kasutatavad menüüst <link linkend="the-edit-menu"
>Redigeerimine</link
> või <link linkend="the-tools-menu"
>Tööriistad</link
>. Koodiredaktori võib dokkida ükspuha millisele peaakna küljele või ka hoopis lahti haakida ja töölaual sootuks mujale asetada.</para>
<para
>Koodi saab redaktorisse mitmel moel sisestada. Lihtsaim meetod on kasutada juba valmis tehtud näidiseid. Selleks vali <menuchoice
><guimenu
>Fail</guimenu
><guimenuitem
>Näidised</guimenuitem
> </menuchoice
> <link linkend="the-file-menu"
>failimenüüs</link
> ja klõpsa vajalikul failil. Failinimi annab teada, mida näidis sisaldab (&eg; <filename
>ruut.logo</filename
> joonistab ruudu). Valitud fail avatakse <link linkend="the-code-editor"
>koodiredaktoris</link
>, pärast mida saab käsuga <menuchoice
><guimenu
>Fail</guimenu
><guimenuitem
>Käivita</guimenuitem
> </menuchoice
> hakata seda ellu viima.</para>
<para
>&turtlelang;i faile saab avada menüükäsuga <menuchoice
><guimenu
>Fail</guimenu
><guimenuitem
>Ava...</guimenuitem
> </menuchoice
></para>
<para
>Kolmas võimalus on kirjutada kood ise redaktorisse või kopeerida ja asetada kood kuskilt mujalt, kas või käesolevast käsiraamatust. </para>
<para
>Kursori asukohta näeb <link linkend="the-statusbar"
>olekuriba</link
> paremas ääres, see on määratud rea ja veeru numbriga. </para>
</sect1>

<sect1 id="the-inspector">
<title
>Inspektor</title>
<para
>Inspektor annab programmi töötamise ajal teata muutujatest, õpitud funktsioonidest koodipuust. </para>
<para
>Inspektori võib dokkida ükspuha millisele peaakna küljele või ka hoopis lahti haakida ja töölaual sootuks mujale asetada.</para>
</sect1>

<sect1 id="the-canvas">
<title
>Lõuend</title>
<para
>Lõuend on ala, kus käsud visualiseeritakse, kus nendega <quote
>joonistatakse</quote
> pilt. Ehk siis - see on kilpkonna mängumaa. Kui oled sisestanud mingi koodi <link linkend="the-code-editor"
>koodiredaktorisse</link
> ja selle käivitanud käsuga <menuchoice
><guimenu
>Fail</guimenu
><guimenuitem
>Käivita</guimenuitem
> </menuchoice
>, võib juhtuda üks kahest: 1) kood täidetakse edukalt ja sa näed midagi lõuendil muutumas või 2) koodis on viga ja ilmub teade, mis ütleb, millise veaga on tegemist.</para>
<para
>See teade peaks aitama probleemi lahendada.</para>
<para
>Hiirerattaga saab lõuendit suurendada ja vähendada.</para>
</sect1>

<sect1 id="the-menubar">
<title
>Menüüriba</title>
<para
>Menüüribal leiad kõik toimingud, mida &kturtle;'is on võimalik kasutada. Need on jagatud järgmistesse rühmadesse: <guimenu
>Fail</guimenu
>, <guimenu
>Redigeerimine</guimenu
>, <guimenu
>Vaade</guimenu
>, <guimenu
>Tööriistad</guimenu
>, <guimenu
>Seadistused</guimenu
> ja <guimenu
>Abi</guimenu
>. Kirjeldame siin neid kõiki.</para>

<sect2 id="the-file-menu">
<title
><guimenu
>Fail</guimenu
>imenüü</title>

  <variablelist>
    <anchor id="file-new"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Uus</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Loob uue tühja &turtlelang;i faili.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-open"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Ava...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Avab &turtlelang;i faili.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-open-recent"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Fail</guimenu
> <guisubmenu
>Ava viimati kasutatud</guisubmenu
> </menuchoice
></term>
      <listitem
><para
>Avab viimati kasutatud &turtlelang;i faili.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-open-examples"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Fail</guimenu
> <guisubmenu
>Näidised</guisubmenu
> </menuchoice
></term>
      <listitem
><para
>Avab &turtlelang;i näidisfailidega kataloogi. Need peaksid olema keeles, mis on määratud seadistustedialoogis (<menuchoice
><guimenu
>Seadistused</guimenu
><guimenuitem
>Skriptikeel</guimenuitem
> </menuchoice
>).</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-save"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Salvesta</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Salvestab parajasti avatud &turtlelang;i faili.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-save-as"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Fail</guimenu
> <guimenuitem
>Salvesta kui...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Salvestab parajasti avatud &turtlelang;i faili uude asukohta või uue nimega.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-save-as-picture"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Fail</guimenu
> <guimenuitem
>Salvesta pildina...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Salvestab aktiivse lõuendi pildina.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-execute"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
><keysym
>F5</keysym
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Käivita</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Käivitab koodiredaktoris kirja pandud käsud.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-pause"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
><keysym
>F6</keysym
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Paus</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Peatab käskude täitmise. Seda saab kasutada ainult siis, kui käske parajasti täidetakse.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-stop"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
><keysym
>F7</keysym
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Katkesta</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Katkestab käskude täitmise. Seda saab kasutada ainult siis, kui käske parajasti täidetakse.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-speed"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Fail</guimenu
> <guimenuitem
>Töökiirus</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Näitab võimalikke täitmise kiirusi: <guimenuitem
>täiskiirus</guimenuitem
>, <guimenuitem
>aeglane</guimenuitem
>, <guimenuitem
>aeglasem</guimenuitem
>, <guimenuitem
>kõige aeglasem</guimenuitem
> ja <guimenuitem
>sammhaaval</guimenuitem
>. Kui kiiruseks valida <guimenuitem
>täiskiirus</guimenuitem
> (vaikeväärtus), on vaevu võimalik jälgida, mis toimub. Sageli on see kasulik, kuid vahel võib tekkida soov käskude täitmist üksikasjalikult jälgida. Sel juhul tuleks valida kiiruseks <guimenuitem
>aeglane</guimenuitem
>, <guimenuitem
>aeglasem</guimenuitem
>, <guimenuitem
>kõige aeglasem</guimenuitem
>. Mõne aeglase kiiruse valimisel näidatakse redaktoris täitmise hetkeasukohta. <guimenuitem
>sSammhaaval</guimenuitem
> täidab korraga ühe käsu.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-print"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>P</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Trüki...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Trükib koodiredaktoris kirja pandud käsud.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="file-quit"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Välju</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Lõpetab &kturtle;'i töö.</para
></listitem>
    </varlistentry>
  </variablelist>
</sect2>

<sect2 id="the-edit-menu">
  <title
>Menüü <guimenu
>Redigeerimine</guimenu
></title>
  <variablelist>
    <anchor id="edit-undo"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>Z</keycap
></keycombo
> </shortcut
> <guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Võta tagasi</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Tühistab viimase koodi tehtud muudatuse. &kturtle; ei tunne tagasivõtmisel piire.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-redo"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;&Shift;<keycap
>Z</keycap
></keycombo
> </shortcut
> <guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Tee uuesti</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Taastab koodis tagasivõetud muudatuse.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-cut"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>X</keycap
></keycombo
> </shortcut
> <guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Lõika</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Lõikab koodiredaktoris valitud teksti ja asetab selle lõikepuhvrisse.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-copy"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>C</keycap
></keycombo
> </shortcut
> <guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Kopeeri</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Kopeerib koodiredaktoris valitud teksti lõikepuhvrisse.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-paste"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>V</keycap
></keycombo
> </shortcut
> <guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Aseta</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Asetab teksti lõikepuhvrist redaktorisse.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-select-all"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>A</keycap
></keycombo
> </shortcut
> <guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Vali kõik</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Valib kogu redaktori teksti.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-find"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>F</keycap
></keycombo
> </shortcut
> <guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Otsi...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Selle käsuga saab koodis teatud sõna või väljendit otsida.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="edit-find-next"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
><keysym
>F3</keysym
></keycombo
> </shortcut
> <guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Otsi järgmine</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Sellega saab leida otsitava fraasi järgmise esinemiskorra.</para
></listitem>
    </varlistentry>
  </variablelist
>  
  <variablelist>
    <anchor id="edit-find-previous"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Shift;<keysym
>F3</keysym
></keycombo
> </shortcut
> <guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Otsi eelmine</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Sellega saab leida otsitava fraasi eelmise esinemiskorra.</para
></listitem>
    </varlistentry>
  </variablelist>
  <!--<variablelist>
    <anchor id="edit-replace"/>
    <varlistentry>
      <term
><menuchoice>
        <shortcut>
          <keycombo
>&Ctrl;<keycap
>R</keycap
></keycombo>
        </shortcut>
        <guimenu
>Edit</guimenu>
        <guimenuitem
>Replace...</guimenuitem>
      </menuchoice
></term>
      <listitem
><para
>With this action you can replace text in the code.</para
></listitem>
    </varlistentry>
  </variablelist
>-->
<variablelist>
    <anchor id="toggle-insert"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
><keycap
>Ins</keycap
></keycombo
> </shortcut
> <guimenu
>Redigeerimine</guimenu
> <guimenuitem
>Ülekirjutamisrežiim</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Lülitab lisamis- ja ülekirjutamisrežiimi vahel.</para
></listitem>
    </varlistentry>
  </variablelist>
</sect2>

<sect2 id="the-view-menu">
  <title
>Menüü <guimenu
>Vaade</guimenu
></title>
  <variablelist>
    <anchor id="view-codeeditor"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>E</keycap
></keycombo
> </shortcut
> <guimenu
>Vaade</guimenu
> <guimenuitem
>Näita redaktorit</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Näitab koodiredaktorit või peidab selle.</para>
</listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="view-inspector"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
>&Ctrl;<keycap
>I</keycap
></keycombo
> </shortcut
> <guimenu
>Vaade</guimenu
> <guimenuitem
>Näita inspektorit</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Näitab inspektorit või peidab selle.</para>
</listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="view-error"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Vaade</guimenu
> <guimenuitem
>Näita vigu</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Näitab koodi täitmisel tekkinud vigade nimekirja <guilabel
>vigade</guilabel
> või peidab selle. Kui see valik on sisse lülitatud, klõpsa kilpkonna taasnägemiseks <guilabel
>lõuendil</guilabel
>.</para>
      </listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="view-linenumbers"/>
    <varlistentry>
      <term
><menuchoice
><shortcut
> <keycombo
><keysym
>F11</keysym
></keycombo
> </shortcut
> <guimenu
>Vaade</guimenu
> <guimenuitem
>Näita reanumbreid</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Sellega saab lasta koodiredaktoris reanumbreid näidata. See on kasulik näiteks vigade leidmiseks.</para
></listitem>
    </varlistentry>
  </variablelist>
</sect2>

<sect2 id="the-tools-menu">
  <title
><guimenu
>Tööriistad</guimenu
>e menüü</title>
  <variablelist>
    <anchor id="tools-direction-chooser"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Tööriistad</guimenu
> <guimenuitem
>Suunavalija...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Avab suunavalija dialoogi.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="tools-color-chooser"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Tööriistad</guimenu
> <guimenuitem
>värvivalija...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>Avab värvivalija dialoogi.</para
></listitem>
    </varlistentry>
  </variablelist>
</sect2>

<sect2 id="the-setting-menu">
  <title
>Menüü <guimenu
>Seadistused</guimenu
></title>
    <variablelist>
    <anchor id="script-language"/>
    <varlistentry>
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Skriptikeel</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Valib</action
> koodi keele.</para
></listitem>
</varlistentry>
  </variablelist
>  
<variablelist>
    <anchor id="toggle-toolbar"/>
    <varlistentry>
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Tööriistariba näitamine</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Lülitab</action
> peamise tööriistariba näitamise sisse-välja.</para
></listitem>
</varlistentry>
  </variablelist
>  
  <variablelist>
      <anchor id="toggle-statusbar"/>
   <varlistentry>
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Olekuriba näitamine</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Lülitab</action
> olekuriba näitamise sisse-välja.</para
></listitem>
</varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="settings-configure-shortcuts"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Kiirklahvide seadistamine...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>&kde; tavapärane kiirklahvide seadistamise dialoog.</para
></listitem>
    </varlistentry>
  </variablelist>
  <variablelist>
    <anchor id="settings-configure-toolbars"/>
    <varlistentry>
      <term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Tööriistaribade seadistamine...</guimenuitem
> </menuchoice
></term>
      <listitem
><para
>&kde; tavapärane tööriistaribade seadistamise dialoog.</para
></listitem>
    </varlistentry>
  </variablelist>
</sect2>

<sect2 id="the-help-menu">
  <title
><guimenu
>Abi</guimenu
>menüü</title>
&help.menu.documentation; </sect2>

</sect1>

<sect1 id="the-toolbar">
<title
>Tööriistariba</title>
<para
>Siin saab kiiresti valida kõige sagedamini vajaminevaid toiminguid. Vaikimisi ongi siin just käsud, mida kõige enam vaja läheb, sealhulgas <guiicon
>Käivita</guiicon
>, <guiicon
>Paus</guiicon
> ja <guiicon
>Katkesta</guiicon
>. Tööriistariba viimane element on <guilabel
>Konsool</guilabel
>, mida saab kasutada üherealise käsu sisestamiseks ja testimiseks.</para>
<para
>Tööriistariba saab oma maitse järgi kohandada menüükäsuga <menuchoice
><guimenu
>Seadistused</guimenu
><guimenuitem
>Tööriistaribade seadistamine...</guimenuitem
></menuchoice
></para>
</sect1>

<sect1 id="the-statusbar">
<title
>Olekuriba</title>
<para
>Olekuribal annab &kturtle; sulle tagasisidet oma oleku kohta. Vasakul on näha viimane toiming. Paremal näeb kursori hetkeasukohta (rea ja veeru number). Keskel näeb, millist keelt käskude puhul parajasti kasutatakse.</para>
</sect1>

</chapter>
