# Utilizando &kturtle;

He aquí una captura de pantalla de &kturtle; en acción Ventana principal de &kturtle;

The main window of &kturtle; has two main parts: the code editor (3) on the left where you type the &logo; commands, and the canvas (4) on the right where the instructions are visualized. The canvas is the turtle's playground: it is on the canvas that the turtle actually moves and draws. The three other places on the main window are: the menu bar (1) from where all the actions can be reached, the toolbar (4) that allows you to quickly select the most used actions, and the statusbar (5) where you will find feedback on the state of &kturtle;.

## El editor de código

En el editor de código se ingresan los comandos &logo;. Este tiene todas las características que requiere un editor moderno. La mayoría de estas características se encuentran en los menús Editar y Herramientas. El editor de código puede estar adosado a los bordes de la ventana principal, o libre sobre cualquier lugar del escritorio.

Disponemos de diferentes métodos para ingresar código en el editor. El modo más simple, es utilizar los ejemplos ya disponibles. Para esto, debemos seleccionar Archivo Abrir ejemplos... en el menú archivo, y hacer clic sobre el ejemplo que deseamos abrir. El nombre de archivo nos dará una idea acerca de lo que nos encontraremos al ejecutarlo (⪚ `cuadrado.logo` dibujará un cuadrado). El ejemplo que seleccionemos, se abrirá en el editor de código. Y una vez abierto, podemos ejecutar el código mediante Archivo Ejecutar comandos

Para abrir un archivo &logo; hay que utilizar Archivo Abrir... .

La tercera opción es escribir tu propio código en el editor o copiar y pegar desde esta guía.

La posición del cursor (números de línea y columna) se indica en la barra de estado, a la derecha.

## El área de dibujo (lienzo)

El área de dibujo es lugar en el cual la tortuga realiza los dibujos a partir de los comandos que escribimos en el editor de código. Para ejecutar nuestro código utilizamos la siguiente combinación de menues: Archivo Ejecutar comandos . Si todo resulta bien veremos el resultado en el área de dibujo. De otro modo, se nos informará de los errores correspondientes.

Este mensaje debería ayudarte a resolver el error.

El dibujo puede guardarse a una imagen (usando Archivo Guardar área de dibujo ) o impreso (utilizando Archivo Imprimir... ).

## La barra de menús

El la barra de menus encontraremos todas las funciones que &kturtle; puede cumplir. Estas, se agrupan del siguiente modo:Archivo, Editar, Ver, Herramientas, Preferencias, y Ayuda. En esta sección describiremos a todos los grupos.

### El menú Archivo

#### Nuevo

&Ctrl;N Archivo Nuevo

- Crea un archivo &logo; nuevo vacío.

#### Abrir

&Ctrl;O Archivo Abrir...

- Abre un archivo &logo;.

#### Abrir reciente

Archivo Abrir reciente

- Abre un archivo &logo; que ha sido utilizado recientemente.

#### Abrir ejemplos

&Ctrl;E Archivo Abrir ejemplos

- Muestra la carpeta con ejemplos de programas &logo;. Es posible seleccionar la idioma con el que se quiere trabajar en Configurar Configure &kturtle;... .

#### Guardar

&Ctrl;S Archivo Guardar

- Guarda el archivo &logo; abierto actualmente.

#### Guardar como

Archivo Guardar Como...

- Guarda a una ubicación especificada, los archivos &logo; abiertos.

#### Guardar área de dibujo

Archivo Guardar área de dibujo

- Guarda el dibujo actual a una archivo de imagen.

#### Velocidad de ejecución

Archivo Velocidad de ejecución

- 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 por omisión) 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 corriendo el código a velocidades más bajas. Además, podremos observar en el editor de código, como se van ejecutando nuestros comandos.

#### Ejecutar

&Alt;Intro Archivo Ejecutar Comandos

- Comienza la ejecución de los comandos en el editor de código.

#### Pausa

Pause Archivo Pausar ejecución

- Pausa la ejecución en un punto dado. Esta acción solo estará disponible mientras se esté ejecutando un programa.

#### Detener

Escapar Archivo Detener Ejecución

- Detener la ejecución. Esta acción solo estará disponible mientras se esté ejecutando un programa.

#### Imprimir

&Ctrl;P Archivo Imprimir...

- Imprime el código presente en el editor o el dibujo actual según se desee.

#### Salir

&Ctrl;Q Archivo Salir

- Sale de &kturtle;.

### El menú Editar

&Ctrl;Z Editar Deshacer

- Deshace el último cambio en el código. &kturtle; no tiene limites para las instancias de deshacer.

&Ctrl;&Shift;Z Editar Rehacer

- Rehace un cambio al código que había sido deshecho previamente.

&Ctrl;X Editar Cortar

- Corta el texto seleccionado desde el editor de texto al portapapeles.

&Ctrl;C Editar Copiar

- Copia el texto seleccionado desde el editor de texto al portapapeles.

&Ctrl;V Editar Pegar

- Pega el texto desde el portapapeles al editor de texto al .

&Ctrl;F Editar Buscar..

- Busca cadenas dentro en el código.

F3 Editar Buscar siguiente

- Busca la próxima ocurrencia de la cadena.

&Ctrl;R Editar Reemplazar...

- Reemplaza una cadena por otra dentro del código.

### El menú Ver

&Ctrl;&Shift;F Ver Modo pantalla completa

- Con esta acción pasamos al modo de pantalla completa.

  Nota: Cuando el código se ejecuta en pantalla completa, se ocultará todo excepto el área de dibujo. Así, con &kturtle; podremos escribir programas que realmente se ejecuten en pantalla completa al estilo de una presentación.

F11 Ver Mostrar números de línea

- Con esta acción se nos mostrará los números de línea a un lado del editor de código. Esta función es muy útil para encontrar errores.

### El menúHerramientas

&Alt;C Herramientas Selector de colores

- Abre el selector de colores para seleccionar fácilmente una combinación de colores e insertarla en el editor de código.

&Ctrl;I Herramientas Sangría

- Esta acción agrega una serie de espacios 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.

&Ctrl;&Shift;I Herramientas Quitar sangría

- Esta acción remueve los espacios al comienzo de las líneas seleccionadas.

Tools Limpiar sangría

- Esta acción limpia los espacios al comienzo de las líneas seleccionadas.

&Ctrl;D Herramientas Comentar

- Agrega un carácter de comentario (#) al comienzo de la línea seleccionada. Las líneas que comiencen por un carácter de comentario, serán ignoradas 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 que una parte de nuestro código se ejecute, sin tener que borrar las líneas definitivamente.

&Ctrl;&Shift;D Herramientas Descomentar

- Esta acción remueve los signos de comentario (#) de las líneas seleccionadas.

### El menú Preferencias

Preferencias Mostrar/Ocultar barra herramientas

- Activa/desactiva la barra de herramientas principal

Preferencias Mostrar/ocultar barra de estado

- Activar/desactiva la barra de estado

Preferencias Preferencias avanzadas

- Las preferencias que pueden modificarse aquí, son aquellas que probablemente nunca querremos modificar. El submenú Preferencias avanzadas, contiene tres ítems: Configurar editor... (tomado de &kate;), Configurar accesos rápidos... (el estándar de &kde;) , y Configurar barras de herramientas... (también estándar en &kde;).

Preferencias Configurar &kturtle;...

- Aquí podremos configurarse las características básicas de &kturtle;. De este modo, nos será posible seleccionar un nuevo idioma para los comandos &logo; o definir un nuevo tamaño inicial para el área de dibujo.

### El menú Ayuda

F1 Ayuda Manual de &kturtle;

- Muestra este manual

&Shift;F1 Ayuda ¿Que es esto?

- Luego de activar esta acción, el puntero del ratón tomará la forma de una flecha con un signo de pregunta a su derecha. Ahora, cuando hagamos clic en alguna parte de la ventana principal de &kturtle;, observaremos un texto emergente con una descripción de la acción en cuestión.

F2 Ayuda Ayuda sobre: ...

- 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 el comando `print` en nuestro código, y queremos leer y conocer lo que el manual dice acerca de dicho comando. Solo debemos mover el cursor hasta `print` y presionar F2. Así, observaremos como el manual se abré en la sección correspondiente al comando `print`.

  Esta función es de mucha importancia mientras se esta aprendiendo a programar.

Ayuda Informar de fallo...

- Informar (en inglés) a los desarrolladores de fallos que podamos observar en &kturtle;. Estos reportes harán que las futuras versiones de &kturtle; sean mejores.

Ayuda Acerca de &kturtle;

- Aquí encontraremos información referente a &kturtle; tal como los créditos y asuntos de licencia.

Ayuda Acerca de &kde;

- Información referente a &kde;. En caso de que aún no conozcamos lo que es &kde;, este es un buen lugar para comenzar.

## La barra de herramientas

Aquí encontraremos las acciones más frecuentemente utilizadas, finalizando con Ejecutar comandos y Detener ejecución.

Para configurar las barras de herramientas: Preferencias Configurar barras de herramientasAbrir...

## La barra de estado

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 los comandos.