<!--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
>Comenzando a programar</title>
<para
>Al iniciarse, &kturtle; mostrará algo como esto: <screenshot
> <screeninfo
>He aquí una captura de pantalla de &kturtle; al iniciarse por primera vez</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="mainwindow.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Ventana principal de &kturtle;</phrase
> </textobject
> </mediaobject
> </screenshot
> En esta guía para principiantes, asumiremos que se está trabajando con los comandos en español. Si fuera necesario cambiar la configuración del idioma para los comandos debemos ir a:<menuchoice
><guimenu
>Preferencias</guimenu
><guimenuitem
>Configurar &kturtle;...</guimenuitem
></menuchoice
>, sección <guilabel
>Idioma</guilabel
>. Aquí podremos configurar el idioma en el cual deberán escribirse los comandos&kturtle;.</para>

<sect1 id="first-steps">
<title
>Los primeros pasos con &logo; ¡Te presentamos a la tortuga!</title>
<para
>Podemos ver que la tortuga se encuentra justo en el centro del área de dibujo. Ahora aprenderemos los comandos necesarios para controlar a la tortuga desde el editor de códigos y pedirle que se mueva de un lado a otro de la pantalla.</para>

<sect2 id="the-turtle-moves">
<title
>La tortuga se mueve</title>
<para
>Ahora empecemos a mover la tortuga de aquí para allá. Nuestra tortuga puede realizar tres tipos de movimiento: 1) Puede ir hacia atrás o hacia adelante; 2) Hacia la derecha o hacia la izquierda; y 3) Puede desplazarse directamente a un punto determinado de la pantalla. A modo de ejemplo, intentaremos lo siguiente:</para>
<para>
<screen
>avanzar 100
izquierda 90 
</screen>
Entonces, copiemos y peguemos el texto de arriba al editor de código y lo ejecutamos para ver los resultados (para ejecutar el código usamos: <link linkend="file-execute"
><menuchoice
><guimenu
>Archivo</guimenu
><guimenuitem
>Ejecutar comandos</guimenuitem
></menuchoice
></link
>).</para>

<para
>Así, al ingresar y ejecutar los comandos de la forma que indicamos en los renglones anteriores, notaremos lo siguiente:</para>
<orderedlist>
<listitem
><para
>Que &mdash; luego de ejecutar los comandos &mdash;, la tortuga se desplazó hacia arriba y giró noventa grados hacia la izquierda. Este es el resultado de aplicar las dos operaciones de nuestro ejemplo: <link linkend="forward"
><userinput
>avanzar</userinput
></link
> e <link linkend="turnleft"
><userinput
>izquierda</userinput
></link
>.</para>
</listitem>
<listitem>
<para
>Que el color del código cambia a medida que vamos escribiendo. El <emphasis
>resaltado intuitivo de sintaxis</emphasis
> permite que las &mdash; diferentes clases de comandos, se resalten en diferentes colores simplificando la tarea de leer bloques de código grandes.</para>
</listitem>
<listitem>
<para
>Que la tortuga dibujó una delgada linea negra.</para>
</listitem>
<listitem>
<para
>Si no copiamos correctamente el código del ejemplo, o si no hemos configurado KTurtle para que reconozca los comandos en castellano, habremos obtenido un mensaje de error. Si el problema estuviera en la configuración del idioma, podemos corregir esta situación con: <menuchoice
><guimenu
>Preferencias</guimenu
><guimenuitem
>Configurara  &kturtle;...</guimenuitem
></menuchoice
>, e ir al la sección <guilabel
>idioma</guilabel
>.</para>
</listitem>
</orderedlist>

<para
>Así, <userinput
>avanzar 100</userinput
> le pedirá a la tortuga que se desplace hacia adelante, e <userinput
>izquierda 90</userinput
> que rote noventa <glossterm linkend="degrees"
>grados</glossterm
> hacia la izquierda.</para>

<para
>Si queremos una explicación completa de estos comandos podemos acudir a las secciones correspondientes en el manual de referencia: <userinput
>avanzar</userinput
>, <userinput
>retroceder</userinput
>, <userinput
>izquierda</userinput
>, y <userinput
>derecha</userinput
>.</para>
</sect2>

<sect2 id="more-examples">
<title
>Más ejemplos</title>
<para
>El primer ejemplo es muy simple, ¡Comencemos!</para>

<para>
<!--translators: if it's not already there, you can copy/paste the translated code below and save it in arrow.logo in your examples folder: kde-i18n/language-code/data/kdeedu/kturtle/ -->
<screen
>restaurartamañolienzo 200, 200
colorlienzo 0, 0, 0
colorpluma 255, 255,255
grosorpluma 5
limpiar
ir 20,20
dirección 135
avanzar 200
izquierda 135
avanzar 100
izquierda 135
avanzar 141
izquierda 135
avanzar 100
izquierda 45
ir 40,100
</screen>
Ya sabemos que podemos optar por copiar y pegar las líneas de arriba en el editor de código o abrir el ejemplo <filename
>flecha.logo</filename
> que se encuentra en la carpeta <guimenu
>Abrir ejemplos...</guimenu
>, y luego ejecutar (utilizando <link linkend="file-execute"
><menuchoice
><guimenu
>Archivo</guimenu
> <guimenuitem
>Ejecutar comandos</guimenuitem
></menuchoice
></link
>) para ver los resutados.</para>

<para
>Es evidente que el segundo ejemplo fue bastante más complejo que el primero. De este modo, hemos visto algunos comandos que tal vez resulten nuevos para nosotros. He aquí una breve explicación de cada uno de ellos:</para>

<para
><userinput
>tamañolienzo 200,200</userinput
> define el tamaño del área de dibujo (cuando tengamos que referirnos a algo relativo al área de dibujo mediante un comando, utilizaremos el termino lienzo). En este caso definimos un ancho y un alto de 200 <glossterm linkend="pixels"
>pixeles</glossterm
>. De este modo el área será un cuadrado.</para>

<para
><userinput
>colorlienzo 0,0,0</userinput
> torna el área de dibujo de color negro.<userinput
>0,0,0</userinput
> es una <glossterm linkend="rgb"
>combinación RVA (RGB)</glossterm
> en la cual los tres valores se establecen a <userinput
>0</userinput
>, lo que resulta en el color negro.</para>

<para
><userinput
>colorpluma 255,255,255</userinput
> establece el color de pluma a rojo. <userinput
>255,255,255</userinput
> es una <glossterm linkend="rgb"
>Combinación RGB (RVA)</glossterm
> en la cual el valor para el rojo es <userinput
>255</userinput
> (el máximo valor posible) mientras que los demás (el verde y el azul) están en <userinput
>0</userinput
> (el mínimo posible). De esta combinación resulta un rojo profundo.</para>

<para
>En el caso de no comprender del todo las reglas de los colores, podemos consultar información más detallada en el glosario bajo la sección denominada<glossterm linkend="rgb"
>Combinaciones RVA (RGB)</glossterm
></para>

<para
><userinput
>grosorpluma 5</userinput
> establece el ancho para el trazo de nuestra pluma a <userinput
>5</userinput
> <glossterm linkend="pixels"
>pixels</glossterm
> A partir de ahora, cada línea que la tortuga dibuje tendrá un ancho de <userinput
>5</userinput
> pixeles. Si luego quisiéramos cambiar este valor, deberemos volver a utilizar el comando <userinput
>grosorpluma</userinput
>.</para>

<para
><userinput
>limpiar</userinput
> simplemente limpia la pantalla.</para>

<para
><userinput
>ir 20,20</userinput
> le indica a la tortuga que debe ir a al lugar 20,20 del área de dibujo (lienzo). Esto significa, contando a partir del la esquina superior izquierda , 20 <glossterm linkend="pixels"
>pixeles</glossterm
> hacia la derecha y 20 <glossterm linkend="pixels"
>pixeles</glossterm
>hacia abajo. Vale aclarar que al utilizar el comando <userinput
>ir</userinput
>, la tortuga no dibujará una línea en su trayectoría.</para>

<para
><userinput
>dirección 135</userinput
> define el ángulo de dirección para el movimiento de la tortuga. En este sentido actúa de manera similar a los comandos <userinput
>izquierda</userinput
> y <userinput
>derecha</userinput
>, aunque con la siguiente salvedad: mientras que los dos comandos anteriores son relativos a la posición de la tortuga, el comando <userinput
>dirección</userinput
> no lo es ya que considera siempre a la posición 0 como punto de partida.</para>

<para
>Luego del comando <userinput
>dirección</userinput
>, hay unos cuantos <userinput
>avanzar</userinput
> e <userinput
>izquierda</userinput
>. Estos últimos comandos son los que verdaderamente realizan el dibujo.</para>

<para
>Finalmente, otro comando <userinput
>go</userinput
> hace que la tortuga se haga a un lado.</para>

<para
>Finalmente, recordemos que para conocer más acerca de cada comandos, podemos utilizar los enlaces correspondientes en este manual, los que nos llevarán a explicaciones más detalladas.</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>
