<para>La ventana principal de &kturtle; tiene dos partes principales: <link linkend="the-code-editor">el editor de código</link> (3) donde deben introducirse las órdenes de &logo; y el <link linkend="the-canvas">lienzo</link> (4) donde se representará el dibujo, está a la derecha. El<link linkend="the-canvas">lienzo</link> es el lugar por donde se desplazará la tortuga y representará los dibujos. Además de las anteriores, la ventana principal tiene tres secciones más: <link linkend="the-menubar">la barra de menús</link> (1) , desde los cuales se puede acceder a todas las funciones, la <link linkend="the-toolbar">barra de herramintas</link> (1) donde se encuentran las funciones más utilizadas, y <link linkend="the-statusbar">la barra de estado</link> (5) que nos indicará de qué modo está funcionado &kturtle;.</para>
<para>En el editor de código se introducen las órdenes de &logo;. Éste tiene todas las características que requiere un editor moderno. La mayoría de estas características se encuentran en los menús <link linkend="the-edit-menu">Editar</link> y <link linkend="the-tools-menu">Herramientas</link>. El editor de código puede estar adosado a los bordes de la ventana principal, o libre sobre cualquier lugar del escritorio.</para>
<para>Disponemos de diferentes métodos para introducir código en el editor. El modo más simple, es utilizar los ejemplos ya disponibles. Seleccione <menuchoice><guimenu>Archivo</guimenu><guimenuitem>Abrir ejemplos</guimenuitem> </menuchoice> en el <link linkend="the-file-menu">menú archivo</link>, y pulse sobre el ejemplo que desee abrir. El nombre de archivo nos dará una idea acerca de lo que nos encontraremos al ejecutarlo (⪚ <filename>cuadrado.logo</filename> dibujará un cuadrado). El ejemplo que seleccionemos, se abrirá en el <link linkend="the-code-editor">editor de código</link>. Y una vez abierto, podemos ejecutar el código mediante <menuchoice><guimenu>Archivo</guimenu> <guimenuitem>Ejecutar órdenes</guimenuitem> </menuchoice>.</para>
<para>Puede abrir un archivo &logo; seleccionando <menuchoice><guimenu>Archivo</guimenu><guimenuitem>Abrir...</guimenuitem> </menuchoice></para>
<para>La tercera opción es escribir su propio código en el editor o copiarlo y pegarlo desde esta guía de usuario. </para>
<para>La posición del cursor (números de línea y columna) se indica en <link linkend="the-statusbar">la barra de estado</link>, a la derecha. </para>
<para>El lienzo es lugar en el cual la tortuga «realiza los dibujos» a partir de las órdenes que escribimos en el <link linkend="the-code-editor">editor de código</link>. Para ejecutar nuestro código utilizamos la siguiente opción del menú: <menuchoice><guimenu>Archivo</guimenu><guimenuitem>Ejecutar órdenes</guimenuitem> </menuchoice>. Si todo resulta bien veremos el resultado en el lienzo. De otro modo, se nos informará de los errores correspondientes.</para>
<para>Este mensaje debería ayudar a resolver el error.</para>
<para>El dibujo puede guardarse como una imagen (usando <menuchoice><guimenu>Archivo</guimenu><guimenuitem>Guardar lienzo</guimenuitem> </menuchoice>) o imprimirse (utilizando <menuchoice><guimenu>Archivo</guimenu><guimenuitem>Imprimir...</guimenuitem> </menuchoice>).</para>
<para>En la barra de menús encontraremos todas las funciones que &kturtle; puede cumplir. Éstas, se agrupan del siguiente modo: <guimenu>Archivo</guimenu>, <guimenu>Editar</guimenu>, <guimenu>Ver</guimenu>, <guimenu>Herramientas</guimenu>, <guimenu>Preferencias</guimenu>, y <guimenu>Ayuda</guimenu>. En esta sección describiremos todos los grupos.</para>
<listitem><para>Muestra la carpeta con ejemplos de programas &logo;. Es posible seleccionar el idioma con el que se quiere trabajar en <menuchoice><guimenu>Configurar</guimenu><guimenuitem>Configurar &kturtle;...</guimenuitem> </menuchoice></para></listitem>
<term><menuchoice><guimenu>Archivo</guimenu> <guimenuitem>Velocidad de ejecución</guimenuitem> </menuchoice></term>
<listitem><para>Nos muestra una lista con todas las velocidades de ejecución posibles: Rápido, Moderado, Despacio, Muy despacio. Cuando la velocidad se establece en Rápido (valor predeterminado) casi no podremos ver a la tortuga mientras está trabajando, solo veremos el resultado final. Aunque algunas veces esto es deseable, en otras ocasiones queremos observar el proceso de construcción del dibujo. Lo que será posible ejecutando el código a velocidades más bajas. Además, podremos observar en el editor de código, cómo se van ejecutando nuestras órdenes.</para></listitem>
<listitem><para>Con esta acción pasamos al modo de pantalla completa.</para>
<para>Nota: Cuando el código se ejecuta en pantalla completa, se ocultará todo excepto el lienzo. Así, con &kturtle; podremos escribir programas que realmente se ejecuten en «pantalla completa» al estilo de una presentación.</para></listitem>
<term><menuchoice><shortcut> <keycombo><keysym>F11</keysym></keycombo> </shortcut> <guimenu>Ver</guimenu> <guimenuitem>Mostrar números de línea</guimenuitem> </menuchoice></term>
<listitem><para>Con esta acción se nos mostrarán los números de línea a un lado del editor de código. Esta función es muy útil para encontrar errores.</para></listitem>
<term><menuchoice><shortcut> <keycombo>&Alt;<keycap>C</keycap></keycombo> </shortcut> <guimenu>Herramientas</guimenu> <guimenuitem>Selector de colores</guimenuitem> </menuchoice></term>
<listitem><para>Abre el selector de colores para seleccionar fácilmente una <glossterm linkend="rgb">combinación de colores</glossterm> e insertarla en el <link linkend="the-code-editor">editor de código</link>.</para></listitem>
<listitem><para>Esta acción «sangra» (añade una serie de espacios en blanco al al comienzo de) las líneas seleccionadas. Así, cuando al utilizar la «sangría» en los casos adecuados, nuestro código será mucho más fácil de leer. Todos los ejemplos hacen uso de la sangría en los lugares correspondientes.</para></listitem>
<listitem><para>Añade un carácter de comentario (#) al comienzo de la línea seleccionada. Las líneas que comiencen por un caracter de comentario, se ignorarán durante la ejecución del código. Los comentarios nos permiten tanto explicar en términos coloquiales nuestro código, como evitar momentáneamente que una parte del mismo se ejecute, sin tener que borrar las líneas definitivamente.</para></listitem>
<listitem><para>Las preferencias que pueden modificarse aquí son aquellas que probablemente nunca querremos modificar. El submenú <guisubmenu>Preferencias avanzadas</guisubmenu>, contiene tres elementos: <guimenuitem>Configurar editor...</guimenuitem> (tomado de &kate;), <guimenuitem>Configurar accesos rápidos...</guimenuitem> (el estándar de &kde;) , y <guimenuitem>Configurar barras de herramientas...</guimenuitem> (también estándar en &kde;).</para></listitem>
<listitem><para>Se utiliza para configurar &kturtle;. Aquí puede cambiar el idioma de las órdenes de &logo; o definir un nuevo tamaño inicial para el lienzo.</para></listitem>
<term><menuchoice><shortcut> <keycombo>&Shift;<keysym>F1</keysym></keycombo> </shortcut> <guimenu>Ayuda</guimenu> <guimenuitem>¿Qué es esto?</guimenuitem> </menuchoice></term>
<listitem><para>Después de activar esta acción, el puntero del ratón tomará la forma de una «flecha con un signo de interrogación a su derecha». Ahora, cuando pulsemos en alguna parte de la ventana principal de &kturtle;, observaremos un texto emergente con una descripción de la acción en cuestión.</para></listitem>
<listitem><para>Esta acción nos será de mucha utilidad ya que nos provee de ayuda directamente relacionada con el código presente en el editor de texto. ⪚, supongamos que utilizamos la órden <userinput>imprimir</userinput> en nuestro código, y queremos leer y conocer lo que el manual dice acerca de dicha orden. Solo debemos mover el cursor hasta <userinput>imprimir</userinput> y pulsar <keysym>F2</keysym>. Así, observaremos cómo el manual se abré en la sección correspondiente a la orden <userinput>imprimir</userinput>.</para>
<para>Esta función es de mucha importancia mientras se esta aprendiendo a programar.</para></listitem>
<term><menuchoice><guimenu>Ayuda</guimenu> <guimenuitem>Informar de fallo...</guimenuitem> </menuchoice></term>
<listitem><para>Utilice esta opción para informar de un fallo con &kturtle; a los desarrolladores. Estos informes harán que las futuras versiones de &kturtle; sean mejores.</para></listitem>
<term><menuchoice><guimenu>Ayuda</guimenu> <guimenuitem>Acerca de &kde;</guimenuitem> </menuchoice></term>
<listitem><para>Información referente a &kde;. En caso de que aún no conozcamos lo que es &kde;, este es un buen lugar para comenzar.</para></listitem>
<para>Aquí encontraremos las acciones más frecuentemente utilizadas. De forma predeterminada encontrará todas las órdenes prácticas importantes, finalizando con los iconos <guiicon>Ejecutar órdenes</guiicon> y <guiicon>Detener ejecución</guiicon>.</para>
<para>Puede configurar la barra de herramientas utilizando <menuchoice><guimenu>Preferencias</guimenu><guimenuitem>Preferencias avanzadas</guimenuitem><guimenuitem>Configurar barra de herramientas...</guimenuitem></menuchoice></para>
<para>Sobre la barra de estado, podremos observar datos acerca del estado de &kturtle;. Sobre el lado izquierdo, veremos información sobre la última acción efectuada. En cambio, sobre el lado derecho se nos mostrará la posición actual del cursor (número de línea y de columna). Por último, en la parte media de la barra de estado, se indicará el idioma que estamos utilizando actualmente para las órdenes.</para>
