<!--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="getting-started">
<title
>Comezando</title>
<para
>Cando inicie &kturtle; verá algo como isto: <screenshot
> <screeninfo
>Esta é unha imaxe de &kturtle; ao inicialo por primeira vez</screeninfo
><mediaobject
><imageobject
><imagedata fileref="mainwindow.png" format="PNG"/></imageobject
><textobject
><phrase
>Fiestra principal de &kturtle;</phrase
></textobject
></mediaobject
></screenshot
> Nesta guía de iniciación asumirase que a lingua dos comandos de &turtlelang; é o galego. Pode mudar esta lingua en <menuchoice
><guimenu
>Configuración</guimenu
><guisubmenu
>Linguaxe do script</guisubmenu
></menuchoice
>. Lembre que a lingua que lle indique aquí a &kturtle; é a que utilizará para escreber os comandos de &turtlelang;, non a lingua empregada por &kde; no ordenador e utilizada na interface e menús de &kturtle;.</para>

<sect1 id="first-steps">
<title
>Os primeiros pasos con &turtlelang;: coñeza o sapoconcho!</title>
<para
>Xa se debería ter decatado de que hai un sapoconcho no centro do lenzo: agora aprenderá a controlalo mediante comandos no editor de código.</para>

<sect2 id="the-turtle-moves">
<title
>Os movimentos do sapoconcho</title>
<para
>Comecemos facendo que se mova o sapoconcho. O noso animal pode facer 3 tipos de movimento, (1) pode ir adiante e atrás, (2) pode xirar á esquerda e á dereita e (3) pode ir directamente a unha posición na pantalla. Probe isto:</para>
<para>
<screen
>avanza 100
xiraesquerda 90 
</screen>
Escreba ou corte e apegue o código no editor de código e execúteo (empregando <link linkend="file-execute"
><menuchoice
><guimenu
>Ficheiro</guimenu
><guimenuitem
>Executar</guimenuitem
></menuchoice
></link
>) para ver o resultado.</para>

<para
>Canto teña escrito e executados os comandos como os de riba no editor do código poida que se decate dunha ou máis das seguintes cousas:</para>
<orderedlist>
<listitem
><para
>Que &mdash; tras executar os comandos &mdash; o sapoconcho rube, debuxa unha liña, e logo xira un cuarto de volta á esquerda. Isto é debido a que empregou os comandos <link linkend="forward"
><userinput
>avanza</userinput
></link
> e <link linkend="turnleft"
><userinput
>xiraesquerda</userinput
></link
>.</para>
</listitem>
<listitem>
<para
>Que se modificou a cor do código mentres a estaba a escreber: esta funcionalidade é chamara <emphasis
>realzado intuitivo</emphasis
> &mdash; diferentes tipos de comandos son realzados de xeito distinto. Isto facilita a leitura de grandes bloques de código.</para>
</listitem>
<listitem>
<para
>Que o animal debuxa unha liña branca fina.</para>
</listitem>
<listitem>
<para
>Talvez obteña unha mensaxe de erro. Isto simplesmente significará dúas cousas: ou que cometeu un erro ao copiar os comandos, ou que aínda non indicou a linguaxe correcta para os comandos de &turtlelang; (pode facelo mediante <menuchoice
><guimenu
>Configuración</guimenu
><guisubmenu
>Linguaxe do script</guisubmenu
></menuchoice
>).</para>
</listitem>
</orderedlist>

<para
>Posibelmente xa se decatase de que <userinput
>avanza 100</userinput
> ordenoulle ao sapoconcho que se mova cara diante deixando un rastro, e que <userinput
>xiraesquerda 90</userinput
> é para que o animal xire 90 <glossterm linkend="degrees"
>graus</glossterm
> á esquerda.</para>

<para
>Consulte as seguintes ligazón ao manual de referencia para ter unha explicación completa dos seguintes comandos: <link linkend="forward"
><userinput
>avanza</userinput
></link
>, <link linkend="backward"
><userinput
>recua</userinput
></link
>, <link linkend="turnleft"
><userinput
>xiraesquerda</userinput
></link
> e <link linkend="turnright"
><userinput
>xiradereita</userinput
></link
>.</para>
</sect2>

<sect2 id="more-examples">
<title
>Máis exemplos</title>
<para
>O primeiro exemplo era moi simples, continuemos!</para>

<para>

<screen
>reinicia

tamañolenzo 200,200
corlenzo 0,0,0
corlapis 255,0,0
ancholapis 5

vai 20,20
direccion 135

avanza 200
xiraesquerda 135
avanza 100
xiraesquerda 135
avanza 141
xiraesquerda 135
avanza 100
xiraesquerda 45

vai 40, 100
</screen>
Novamente, pode escreber ou copiar e apegar o código no editor de códigos ou abrir o exemplo <filename
>frecha</filename
> no menú <guimenu
>Exemplos</guimenu
> e executalo (mediante <link linkend="file-execute"
><menuchoice
><guimenu
>Ficheiro</guimenu
><guimenuitem
>Executar</guimenuitem
></menuchoice
></link
>) para ver o resultado. Nos seguintes exemplos supónse que coñece o sistema.</para>

<para
>Posibelmente xa se decatou de que este segundo exemplo utiliza moito máis código. Tamén hai un par de comandos novos. Velaí vai unha explicación breve dos novos comandos:</para>

<para
>Tras un comando <userinput
>reinicia</userinput
> todo volta se ser como se acabase de arrincar &kturtle;.</para>

<para
><userinput
>tamañolenzo 200,200</userinput
> fai que o ancho e alto do lenzo sexa de 200 <glossterm linkend="pixels"
>píxeles</glossterm
>. O ancho e o alto son iguais, polo que o lenzo será un cadrado.</para>

<para
><userinput
>corlenzo 0,0,0</userinput
> fai que o lenzo sexa negro. <userinput
>0,0,0</userinput
> é unha <glossterm linkend="rgb"
>combinación RGB</glossterm
> onde todos os valores son <userinput
>0</userinput
>, o que dá a cor negra.</para>

<para
><userinput
>corlapis 255,0,0</userinput
> fai que a cor do lápis sexa vermella. <userinput
>255,0,0</userinput
> é unha <glossterm linkend="rgb"
>combinación RGB</glossterm
> onde só a cor vermella é <userinput
>255</userinput
> (total) mentres que as outras (verde e azul) son <userinput
>0</userinput
> (nulas). Isto resulta na cor vermella.</para>

<para
>Se non comprende os valores das cores, lea a entrada no glosario acerca das <glossterm linkend="rgb"
>combinacións RGB</glossterm
>.</para>

<para
><userinput
>ancholapis 5</userinput
> fai que o ancho (o tamaño) do trazo sexa de <userinput
>5</userinput
> <glossterm linkend="pixels"
>píxeles</glossterm
>. De agora en diante cada liña que debuxe o sapoconcho terá un gordo de <userinput
>5</userinput
>, até que modifique o <userinput
>ancholapis</userinput
>.</para>

<para
><userinput
>vai 20,20</userinput
> fai que o animal vaia a un certo lugar do lenzo. Contando desde a esquina superior esquerda, este lugar está a 20 <glossterm linkend="pixels"
>píxeles</glossterm
> da esquerda, e 20 <glossterm linkend="pixels"
>píxeles</glossterm
> para baixo do cume do lenzo. Lembre que cando se utiliza o comando <userinput
>vai</userinput
> o sapoconcho non debuxa liña nengunha.</para>

<para
><userinput
>direccion 135</userinput
> estabelece a dirección aonde mira o sapoconcho. Os comandos <userinput
>xiraesquerda</userinput
> e <userinput
>xiradereita</userinput
> mudan o ángulo do animal desde a posición actual. O comando <userinput
>direccion</userinput
> múdao desde o cero, e polo tanto non é relativo á dirección anterior do sapoconcho.</para>

<para
>Despois do comando <userinput
>direccion</userinput
> van unha morea de comandos <userinput
>avanza</userinput
> e <userinput
>xiraesquerda</userinput
>. Estes son os que fan o debuxo en si.</para>

<para
>Finalmente outro comando <userinput
>vai</userinput
> move o sapoconcho para un lado.</para>

<para
>Siga as ligazóns á referencia. Aló explícase cada comando con máis detalle.</para>


</sect2>
</sect1>



<!--        EXTRA SECTIONS CAN BE ADDED TO THE "GETTING STARTED"

<sect1 id="calculations">
<title
>Simple Calculations</title>
<para>
Not yet written
</para>
</sect1>
<sect1 id="using_variables">
<title
>Using Variables: creating 'number containers'</title>
<para>
Not yet written
</para>
</sect1>
<sect1 id="using_strings">
<title
>Using strings: creating 'text containers'</title>
<para>
Not yet written
</para>
</sect1>
<sect1 id="logic">
<title
>Logic: asking the computer simple questions</title>
<para>
Not yet written
</para>
</sect1>
<sect1 id="recursion">
<title
>Recursion: the Turtle is using itself</title>
<para>
Draw a maze for example
</para>
</sect1>
-->


</chapter>
