1 files changed, 300 insertions, 0 deletions
diff --git a/tde-i18n-es/docs/tdeedu/kturtle/getting-started.docbook b/tde-i18n-es/docs/tdeedu/kturtle/getting-started.docbook
new file mode 100644
index 00000000000..4597c52df6a
--- /dev/null
+++ b/tde-i18n-es/docs/tdeedu/kturtle/getting-started.docbook
@@ -0,0 +1,300 @@
+<!--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</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 las órdenes en español. Si fuera necesario cambiar la configuración del idioma para las órdenes 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 las órdenes de &kturtle;.</para>
+
+<sect1 id="first-steps">
+<title
+>Los primeros pasos con &logo; ¡Le presentamos a la tortuga!</title>
+<para
+>Podemos ver que la tortuga se encuentra justo en el centro del área de dibujo. Ahora aprenderemos las órdenes necesarias 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. 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>
+Escriba o copie y pegue el texto de arriba en el editor de código y ejecútelo para ver los resultados (para ejecutar el código usamos: <link linkend="file-execute"
+><menuchoice
+><guimenu
+>Archivo</guimenu
+><guimenuitem
+>Ejecutar órdenes</guimenuitem
+></menuchoice
+></link
+>).</para>
+
+<para
+>Cuando escriba y ejecute las órdenes de la forma que se indica podrá observar una o más de las siguientes cosas:</para>
+<orderedlist>
+<listitem
+><para
+>Que &mdash;después de ejecutar las órdenes&mdash;, la tortuga se desplazó hacia arriba y giró noventa grados hacia la izquierda. Éste 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 diferentes clases de órdenes, se resalten en diferentes colores simplificando la tarea de leer bloques de código grandes.</para>
+</listitem>
+<listitem>
+<para
+>Que la tortuga dibujó una línea negra delgada.</para>
+</listitem>
+<listitem>
+<para
+>Puede que obtenga un mensaje de error. Ésto puede significar dos cosas: puede haberse producido un error al teclear las órdenes, o debería haber establecido el idioma correcto para las órdenes de &logo; (puede corregir esta situación eligiendo <menuchoice
+><guimenu
+>Preferencias</guimenu
+><guimenuitem
+>Configurar &kturtle;...</guimenuitem
+></menuchoice
+>, en 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 éstas órdenes 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: tde-i18n/language-code/data/tdeedu/kturtle/ -->
+<screen
+>tamañolienzo 200, 200
+colorlienzo 0, 0, 0
+colorpluma 255, 0, 0
+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 órdenes</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 algunas órdenes que tal vez resulten nuevas para nosotros. He aquí una breve explicación de cada uno de ellas:</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 una orden, utilizaremos el termino lienzo). En este caso definimos un ancho y un alto de 200 <glossterm linkend="pixels"
+>pixels</glossterm
+>. De este modo el área será un cuadrado.</para>
+
+<para
+><userinput
+>colorlienzo 0,0,0</userinput
+> hace que el área de dibujo se de color negro. <userinput
+>0,0,0</userinput
+> es una <glossterm linkend="rgb"
+>combinación RGB</glossterm
+> en la cual los tres valores se establecen a <userinput
+>0</userinput
+>, lo que da como resultado el color negro.</para>
+
+<para
+><userinput
+>colorpluma 255, 255, 255</userinput
+> establece el color de pluma a rojo. <userinput
+>255,0,0</userinput
+> es una <glossterm linkend="rgb"
+>Combinación RGB</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 a <userinput
+>0</userinput
+> (el mínimo posible). De esta combinación resulta un rojo oscuro.</para>
+
+<para
+>En el caso de no comprender del todo los valores de los colores, puede consultar la sección <glossterm linkend="rgb"
+>Combinaciones RGB</glossterm
+> del glosario.</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 la orden <userinput
+>grosorpluma</userinput
+>..</para>
+
+<para
+><userinput
+>limpiar</userinput
+> simplemente borra 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"
+>pixels</glossterm
+> hacia la derecha y 20 <glossterm linkend="pixels"
+>pixels</glossterm
+>hacia abajo. Tenga en cuenta que al utilizar la orden <userinput
+>ir</userinput
+>, la tortuga no dibujará una línea en su trayectoría.</para>
+
+<para
+><userinput
+>dirección 135</userinput
+> define la dirección de la tortuga. Las órdenes <userinput
+>izquierda</userinput
+> y <userinput
+>derecha</userinput
+>cambian el ángulo de la tortuga comenzando en la dirección actual. La orden dirección <userinput
+>dirección</userinput
+> cambia el ángulo de la tortuga partiendo de cero, no siendo por tanto un movimiento relativo a la dirección anterior.</para>
+
+<para
+>Después de la orden <userinput
+>dirección</userinput
+>, hay unas cuantas órdenes <userinput
+>avanzar</userinput
+> e <userinput
+>izquierda</userinput
+>. Estas órdenes son las que realizan el dibujo.</para>
+
+<para
+>Finalmente, otra orden <userinput
+>ir</userinput
+> hace que la tortuga se desplace a un lado.</para>
+
+<para
+>Para consultar explicaciones más detalladas de cada orden siga los enlaces.</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>