<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
 "dtd/kdex.dtd" [
  <!ENTITY kappname "&khangman;">
  <!ENTITY package "kdeedu">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Spanish "INCLUDE"
><!-- change language only here -->
]>

<book id="khangman" lang="&language;">

<bookinfo>
<title
>El manual de &khangman;</title>

<authorgroup>
<author
><firstname
>Anne-Marie</firstname
> <surname
>Mahfouf</surname
> <affiliation
> <address
>&Anne-Marie.Mahfouf.mail;</address>
</affiliation>
</author>
<othercredit role="translator"
> <firstname
>Rocío</firstname
><surname
>Gallego</surname
><affiliation
><address
><email
>traducciones@rociogallego.com</email
></address
></affiliation
> <contrib
>Traductor</contrib
> </othercredit
><othercredit role="translator"
> <firstname
>Rafael</firstname
><surname
>Beccar</surname
><affiliation
><address
><email
>rafabeccar@speedy.com.ar</email
></address
></affiliation
> <contrib
>Traductor</contrib
> </othercredit
><othercredit role="translator"
> <firstname
>Santiago</firstname
> <surname
>Fernández Sancho</surname
><affiliation
><address
><email
>santi@kde-es.org</email
></address
></affiliation
> <contrib
>Traductor</contrib
> </othercredit
><othercredit role="translator"
> <firstname
>Leticia</firstname
> <surname
>Martín Hernández</surname
><affiliation
><address
><email
>leticia.martin@gmail.com</email
></address
></affiliation
> <contrib
>Traductor</contrib
> </othercredit
> 
</authorgroup>


<copyright>
<year
>2001</year
><year
>2009</year>
<holder
>&Anne-Marie.Mahfouf;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>


<date
>2013-05-31</date>
<releaseinfo
>2.5 (&kde; 4.11)</releaseinfo>

<abstract>
<para
>&khangman; es el clásico juego infantil del ahorcado, adaptado para &kde;. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>KHangMan</keyword>
<keyword
>ahorcado</keyword>
<keyword
>juego</keyword>
<keyword
>infantil</keyword>
<keyword
>palabras</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introducción</title>

<para
>&khangman; es un juego basado en el conocido pasatiempo del ahorcado. Está dirigido a niños de seis años o más. El juego tiene varias categorías de palabras con las que jugar, entre ellas <guimenuitem
>Animales</guimenuitem
> (palabras relacionadas con animales) y tres categorías de distinta dificultad: <guimenuitem
>Fácil</guimenuitem
>, <guimenuitem
>Media</guimenuitem
> y <guimenuitem
>Difícil</guimenuitem
>. El programa escoge una palabra de forma aleatoria, ocultando las letras, y se debe adivinar la palabra probando una letra tras otra. Cada vez que se pulsa una letra equivocada, se va dibujando una parte de la imagen del ahorcado. ¡Hay que adivinar la palabra antes de que lo cuelguen! Para ello tiene 10 intentos. </para>

</chapter>

<chapter id="using-khangman">
<title
>Uso de &khangman;</title>

<screenshot>
<screeninfo
>Esta es una captura de pantalla de &khangman; cuando lo inicia la primera vez.</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="khangman-main.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Captura de pantalla de &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Aquí puede ver el aspecto de &khangman; la primera vez que se ejecuta. La categoría es «Animales», el idioma es el predeterminado (en este caso inglés, pero el idioma predeterminado será, en caso de que existan datos, el que actualmente utilice su &kde;) y el tema es «Tema marino». Cualquier cambio que realice en cuanto a categoría, idioma o tema (de fondo) es registrado en el archivo de configuración y recuperado la próxima vez que juegue. </para>

<para
>Fíjese en lo fácil que resulta cambiar el tema; basta con solo hacer clic en la lista desplegable de la barra de herramientas. También podrá obtener una nueva palabra y salir del juego con tan solo pulsar los botones correspondientes de la barra. </para>

<sect1 id="general-usage">
<title
>Uso general</title>

<para
>El programa elige una palabra y sus letras se muestran con un símbolo de subrayado (_). Así sabrá cuántas letras tiene la palabra. Hay que adivinar la palabra probando una letra tras otra. Introduzca la letra en el cuadro de texto y a continuación pulse la tecla  &Enter; o el botón  <guibutton
>Probar esta letra</guibutton
> para ver si la letra pertenece o no a la palabra. </para>

<para
>La palabra se elige de forma aleatoria y no será la misma que la palabra anterior. </para>

<important
><para
>Todas las palabras son sustantivos (no existen verbos, adjetivos, &etc;).</para
></important>

<para
>Si necesita ayuda para adivinar la palabra, haga clic en el icono <guiicon
>Mostrar una pista</guiicon
><inlinemediaobject
><imageobject
> <imagedata fileref="games-hint.png" format="PNG"/></imageobject
></inlinemediaobject
> de la barra de herramientas y se le mostrará una pista relacionado con la palabra. Haga clic nuevamente sobre el icono <guiicon
>Mostrar una pista</guiicon
> para ocultar la pista. </para>

<para
>Las pistas no se muestran en el modo de inicio predeterminado. </para>

<para
>Normalmente, no importa si las letras se introducen en mayúsculas o minúsculas, ya que el programa convierte todas las entradas a minúsculas (excepto en el caso de las palabras en alemán que comienzan con un letra mayúscula). El programa hace esto automáticamente. </para>

<para
>La categoría actual, las veces que se ha ganado y las veces que se ha perdido se muestran en la barra de estado. </para>

<para
>Cada vez que se introduce una letra que no está en la palabra, se dibuja una nueva parte del ahorcado. Tiene 10 intentos para completar la palabra, tras lo cual se muestra la respuesta correcta. </para>

<para
>Existen cuatro categorías: fácil, media, difícil y animales, así como categorías para otros temas en algunos idiomas. El programa rastrea todos los archivos de datos de todos los idiomas y también usa los archivos de palabras de &kanagram;. </para>
 
<para
>En la categoría «Fácil», las palabras son sencillas y están relacionadas con el día a día. Está pensada para niños de entre 6 y 9 años. La categoría «Animales» contiene únicamente nombres de animales que pueden resultar sencillos de adivinar. Algunos son fáciles y otros más difíciles. En la categoría «Media», las palabras son más largas y más difíciles. Es adecuada para niños mayores de 9 años. La categoría «Difícil» es, simplemente, difícil, &ie;, las palabras son complicadas de deletrear y no muy conocidas. Esta categoría puede suponer un desafío incluso para los adultos. </para>

<para
>Una vez que ha acertado una palabra (o se completa la figura del ahorcado), se le felicitará y se le preguntará una nueva palabra. También puede pulsar <guilabel
>Nuevo</guilabel
> para intentar una nueva palabra o seleccionar otra <guimenu
>Categoría</guimenu
> para jugar. Para salir del juego seleccione <menuchoice
><guimenu
>Juego</guimenu
><guimenuitem
>Salir</guimenuitem
> </menuchoice
> o haga clic en el icono <guiicon
>Salir</guiicon
> de la barra de herramientas.  </para>

<para
>Usted teclea la letra con la que quiere hacer un intento en el cuadro de texto (el cursor del ratón está ya ubicado allí) y presiona la tecla &Enter; o hace clic sobre el botón <guibutton
>Probar esta letra</guibutton
>. Si la letra pertenece a la palabra, esta toma el lugar que le corresponde tantas veces como se encuentre en la misma. Si la letra no pertenece a la palabra, se coloca en el apartado  <guilabel
>Errores</guilabel
> y se dibuja una nueva sección del ahorcado. Tiene diez intentos antes de perder y de que se muestre la palabra correcta. </para>

<para
>Durante el juego, puede comenzar un nuevo juego yendo al menú <guimenu
>Juego</guimenu
> y eligiendo <guimenuitem
>Nuevo</guimenuitem
>, o haciendo clic sobre el icono <guiicon
>Nuevo</guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="document-new.png" format="PNG"/></imageobject
></inlinemediaobject
> de la barra de herramientas. También puede cambiar la categoría de las palabras usando el menú <guimenu
>Categoría</guimenu
> (esto le mostrará una nueva palabra de la categoría que haya escogido).</para>

<para
>También puede cambiar fácilmente la apariencia con la barra de herramientas  <guimenuitem
>Aspecto</guimenuitem
>, donde un menú desplegable le mostrará las distintas opciones.</para>

<para
>El botón <guiicon
>Salir</guiicon
> de la barra de herramientas <inlinemediaobject
><imageobject
> <imagedata fileref="application-exit.png" format="PNG"/></imageobject
></inlinemediaobject
> le permite salir del juego fácilmente.</para>

<para
>Puede también jugar usando un archivo local instalado en su equipo, que deberá abrir yendo al menú <guimenu
>Juego</guimenu
> y eligiendo <guimenuitem
>Abrir...</guimenuitem
></para>

</sect1>

<sect1 id="languages">
<title
>Cómo jugar en diferentes idiomas</title>
<para
>Puede jugar con &khangman; en muchos idiomas: portugués de Brasil, búlgaro, catalán, checo, danés, holandés, inglés (de Estados Unidos y de Reino Unido), finlandés, francés, alemán, húngaro, irlandés (o gaélico), italiano, noruego (bokm&#229;l), noruego (nynorsk), polaco, portugués, rumano, español, serbio (latino y cirílico), esloveno, tayiko, sueco, ruso y turco. ¡Puede incluso jugarlo en chino si instala los archivos necesarios desde &kanagram;! </para>

<para
>De manera predeterminada, después de la primera instalación de &khangman;, solo se instalará el idioma inglés y el de su &kde;, esto último si el idioma de su &kde; es uno de los mencionados anteriormente y si además tiene instalado el correspondiente paquete kde-i18n. Por ejemplo, si usted es un usuario danés y tiene su &kde; en danés, en <guimenu
>Idioma</guimenu
> verá dos elementos: inglés y danés, y el danés será el idioma predeterminado. </para>

<para
>No obstante, puede jugar con &khangman; en otros idiomas. Es muy sencillo añadir datos nuevos en &khangman;. Todo lo que necesita es una conexión a Internet. Haga clic en el menú <guimenu
>Juego</guimenu
> y a continuación en <guimenu
>Obtener palabras en un nuevo idioma...</guimenu
> Aparecerá un diálogo similar a este: </para>

<screenshot>
<screeninfo
>El diálogo «Obtener novedades» de &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="getnewstuff.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>El diálogo «Obtener novedades» de &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Haga clic en el nombre del idioma que desee instalar y a continuación pulse el botón <guibutton
>Instalar</guibutton
>. Si el idioma se instala correctamente, se mostrará una marca verde delante del nombre del idioma e <guibutton
>Instalar</guibutton
> cambiará a <guibutton
>Desinstalar</guibutton
>. Los datos se instalan inmediatamente y estarán enseguida disponibles en &khangman;. Haga clic en el botón <guibutton
>Cerrar</guibutton
> para cerrar el diálogo «Obtener novedades» (si desea otro archivo de datos, debe repetir estos pasos). </para>

<para
>Puede cambiar con facilidad el idioma yendo a <guimenu
>Idioma</guimenu
> y seleccionando uno nuevo. </para>

<para
>Tenga en cuenta que ahora puede teclear los caracteres especiales de un idioma mediante la barra de herramientas <interface
>Caracteres especiales</interface
>. Esta barra de herramientas contiene botones con un icono distinto para cada carácter especial del idioma, por ejemplo, &eacute; en francés. Si pulsa uno de estos botones se escribirá la letra correspondiente en la línea de entrada, que podrá validar con la tecla &Enter;. Por supuesto, también puede utilizar la distribución del teclado que corresponda a su idioma. Esta barra de herramientas puede mostrarse u ocultarse. Sus preferencias se restaurarán la siguiente vez que juegue con &khangman;. </para>

<important
><para
>Observe que necesita los tipos de letra Arial y URW para mostrar correctamente los caracteres especiales en algunos idiomas. Si los tiene instalados, &khangman; los utilizará de forma automática. Si ve cuadrados en lugar de letras, significa que no tiene instalados estos tipos de letra. Teclee <command
>fonts:/</command
> en la barra de direcciones de &konqueror; para comprobar los tipos de letra que tiene instalados. </para
></important>

</sect1>
<sect1 id="few-tips">
<title
>Algunos consejos</title>
<para
>En inglés, trate de adivinar primero las vocales. Luego inténtelo con la consonantes más comunes: l, t, r, n, s. </para>
<para
>En francés e inglés, cuando vea «io», pruebe la «n» a continuación. </para>
<para
>En portugués brasileño, catalán, español y portugués, la vocales con tilde aparecerán al introducir la vocal correspondiente no acentuada. Por ejemplo, se mostrarán todas las «a» con tilde de la palabra al teclear «a». Esto es así si no está marcada la opción <guilabel
>Teclear las letras con tilde</guilabel
> en la página <guilabel
>Idiomas</guilabel
> del diálogo de configuración de &khangman;. Cuando la opción <guilabel
>Teclear las letras con tilde</guilabel
> está marcada, usted mismo deberá teclear las letras con tilde. Así, cuando teclee «a», solo se mostrará «a» y, por ejemplo, deberá teclear «&atilde;» para que esta letra se muestre. </para>
<para
>¿Sabía que?: en inglés, la letra más común es la «e» (12,7%), seguida de la «t» (9,1%), la «a» (8,2%), la «i» (7,0%) y la «n» (6,7%). </para>
</sect1>


</chapter>

<chapter id="menus">
<title
>Barra de menús y barras de herramientas</title>

<sect1 id="mainwindow">
<title
>La ventana principal de &khangman;</title>

<para
>El menú <guimenu
>Juego</guimenu
> tiene 3 elementos: <guimenuitem
>Nuevo</guimenuitem
>, <guimenuitem
>Obtener palabras en un nuevo idioma...</guimenuitem
> y <guimenuitem
>Salir</guimenuitem
>.</para>

<para
><guimenuitem
>Nuevo</guimenuitem
> inicia un nuevo juego, &ie;, presenta, para la categoría en la que se encuentra, una nueva palabra que deberá adivinar. <guimenuitem
>Obtener palabras en un nuevo idioma...</guimenuitem
> muestra el diálogo «Obtener novedades» que le permite descargar datos en un nuevo idioma. <guimenuitem
>Salir</guimenuitem
> sale del juego cerrando la ventana principal y guardando los ajustes actuales en el archivo de configuración.</para>

<para
>El menú <guimenu
>Categoría</guimenu
> le permite escoger la categoría de las palabras con las que quiere jugar y tres niveles de dificultad. </para>

<para
>El menú <guimenu
>Idioma</guimenu
> le permite cambiar el idioma de las palabras que se muestran. </para>

<para
>El menú <guimenu
>Aspecto</guimenu
> ofrece tres temas: el <guimenuitem
>Tema marino</guimenuitem
>, el <guimenu
>Tema de invierno</guimenu
> , el <guimenu
> Tema de abejas</guimenu
>y el <guimenuitem
>Tema desértico</guimenuitem
>. El fondo y el color de los tipos de letra son diferentes para cada tema. </para>

<para
>El menú <guimenuitem
>Ajustes</guimenuitem
> permite configurar &khangman; de forma sencilla. En primer lugar, <guimenuitem
>Barras de herramientas mostradas</guimenuitem
> y <guimenuitem
>Mostrar barra de estado</guimenuitem
> le brindan la oportunidad de ocultar o mostrar las barras de herramientas y de estado. </para>

<para
>Existen cuatro barras de herramientas: la barra de herramientas <guimenuitem
>Principal</guimenuitem
>, las barras de herramientas <guimenuitem
>Aspecto</guimenuitem
> e <guimenuitem
>Idioma</guimenuitem
>, que se muestran en la parte superior con los botones y las listas desplegables, y la barra de herramientas <guilabel
>Caracteres especiales</guilabel
> que, cuando se muestra, aparece en la parte inferior. Esta barra de herramientas tiene botones con caracteres especiales para cada idioma: letras con tilde y otros caracteres especiales. Esto permite a los usuarios jugar en otro idioma sin tener que configurar una nueva distribución del teclado. Haga clic sobre una letra especial si quiere hacer un intento con ella. Si pulsa &Enter;, el programa comprobará si la letra está presente o no en la palabra. La barra de herramientas puede ocultarse si así lo desea. Este ajuste se guarda en el archivo de configuración, de forma que si la barra de herramientas se oculta, continuará oculta la siguiente vez que ejecute &khangman;. </para>

<tip>
<para
>Por supuesto, también es posible mover las barra de herramientas. Sitúe el cursor del ratón en la pequeña asa situada a la izquierda de la barra de herramientas, pulse el &LMB; y arrastre la barra a la posición de la pantalla donde desee situarla. Si se sitúa con el ratón sobre una de las barras de herramientas y pulsa el botón izquierdo, aparecerá un menú contextual que le permitirá elegir diferentes opciones para la barra de herramientas. </para>
</tip>

<para
><guimenuitem
>Configurar los accesos rápidos...</guimenuitem
> es un diálogo de configuración estándar de &kde; que le permite elegir teclas de acceso rápido para diferentes acciones. Por ejemplo, <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> es el acceso rápido estándar para <guimenuitem
>Salir</guimenuitem
>.</para>
<para
><guimenuitem
>Configurar las barras de herramientas...</guimenuitem
> es también un elemento estándar del menú de &kde; que le permite añadir o eliminar elementos de la barra de herramientas. </para>

<screenshot>
<screeninfo
>Tema desértico de &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="khangman-desert.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Tema desértico de &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Esta es una captura de pantalla de &khangman; con el tema desértico, el idioma español y la categoría fácil. Se muestra la barra de herramientas <interface
>Caracteres especiales</interface
>.</para>

<para
>Puede elegirse la categoría mediante una lista desplegable de la barra de herramientas o a través del menú <guimenu
>Categoría</guimenu
> de la barra de menús. Las categorías disponibles son <guimenuitem
>Fácil</guimenuitem
>, <guimenuitem
>Media</guimenuitem
>, <guimenuitem
>Animales</guimenuitem
>, <guimenuitem
>Difícil</guimenuitem
> y alguna otra. <guimenuitem
>Fácil</guimenuitem
> está relacionado con objetos comunes que un niño de seis o siete años conoce; <guimenuitem
>Media</guimenuitem
> incluye sustantivos que suponen un mayor desafío; <guimenuitem
>Difícil</guimenuitem
> es bastante complicada, y la categoria <guimenuitem
>Animales</guimenuitem
> incluye solamente nombres de animales. Existen otras categorías de palabras, dependiendo del idioma. </para>

<para
>Todas las palabras son sustantivos. No hay verbos ni adjetivos. El nombre de la categoría seleccionada se muestra en la barra de estado.</para>
<para
>Solo se permite teclear letras en el cuadro de texto.</para>
</sect1>

<sect1 id="settings">
<title
>Ajustes disponibles</title>
<para
>Existe una barra de herramientas con la que se puede acceder rápidamente a algunas opciones de la configuración. Puede hacer clic sobre un botón para comenzar un nuevo juego (por ejemplo, para obtener una palabra nueva), para ver una pista o para salir del juego. El tema se puede cambiar con facilidad mediante una lista desplegable disponible en la barra de herramientas. </para>
<para
>En <menuchoice
><guimenu
>Ajustes</guimenu
> <guimenuitem
>Configurar &khangman;...</guimenuitem
> </menuchoice
> encontrará tres páginas. La primera es para la configuración <guilabel
>General</guilabel
>. </para>

<sect2 id="general-settings">
<title
>Configuración general</title>

<screenshot>
<screeninfo
>Configuración general de &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="settings-general.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Configuración general de &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
><guilabel
>Requerir varios intentos para las letras repetidas</guilabel
>: esta opción no está seleccionada de forma predeterminada. Cuando no está seleccionada, si prueba con la letra «a» y la palabra tiene varias «aes», se mostrarán todas. Por ejemplo, si la palabra es «patata» y prueba con la «a», se mostrarán las tres «aes». Sin embargo, si selecciona esta opción, solo se mostrará la primera «a» y deberá probar dos «aes» más para que aparezcan la segunda y tercera «a» en «patata». Con esto se incrementa la dificultad. </para>

<para
><guilabel
>Habilitar las animaciones</guilabel
>: no está seleccionada de manera predetermina, lo que significa que cuando gane un juego se mostrará un mensaje indicándole que ha ganado y preguntándole si desea jugar de nuevo. Si selecciona esta opción, no se volverá a mostrar este mensaje y, transcurridos 3 segundos, comenzará un juego nuevo. </para>

<para
><guilabel
>Habilitar pistas globalmente</guilabel
>: no está seleccionada de manera predeterminada, por lo que no se muestran las pistas. Si selecciona esta opción (también puede pulsar el icono <guilabel
>Mostrar una pista</guilabel
>, ir a <menuchoice
><guimenu
>Ajustes</guimenu
><guimenuitem
>Mostrar una pista</guimenuitem
></menuchoice
> o usar el acceso rápido <keycombo action="simul"
>&Ctrl;<keycap
>H</keycap
></keycombo
>), se mostrará una pista sobre la palabra que tiene que adivinar, lo que le ayudará a averiguarla con más rapidez . </para>

<para
>En la sección <guilabel
>Sonidos</guilabel
>, si selecciona <guilabel
>Habilitar los sonidos</guilabel
>, se reproducirá un sonido al comenzar un juego nuevo, y otro cuando gane un juego. </para>

</sect2>
<sect2 id="languages-settings">
<title
>Configuración de los idiomas</title>
<para
>La pestaña de configuración <guilabel
>Idiomas</guilabel
> le permite establecer ajustes específicos para algunos idiomas. Si estos ajustes no están disponible para el idioma con el que esté jugando, esta pestaña aparecerá de color gris indicándole que no está activada, por lo que no podrá usarla. </para>

<screenshot>
<screeninfo
>Configuración de idiomas de &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="settings-languages.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Configuración de idiomas de &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>La opción <guilabel
>Teclear las letras con tilde</guilabel
> está disponible, en el diálogo de configuración de  &khangman;, para el español, portugués y catalán. Si selecciona <guilabel
>Teclear letras con tilde</guilabel
> tendrá que teclear todas las vocales acentuadas (por ejemplo, &atilde;). Si no está seleccionada, cuando teclee cualquier vocal, se mostrarán todas las vocales, estén o no acentuadas. </para>

</sect2>

<sect2 id="timers-settings">
<title
>Configuración de los temporizadores</title>
<para
>La pestaña de configuración <guilabel
>Temporizadores</guilabel
> le permite establecer el <guilabel
>Tiempo durante el que se muestra el aviso de «Letra ya probada»</guilabel
>. </para>

<screenshot>
<screeninfo
>Configuración de los temporizadores de &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="settings-timers.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Configuración de los temporizadores de &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
><guilabel
>Tiempo durante el que se muestra el aviso de «Letra ya probada»</guilabel
> le permite incrementar o reducir el tiempo para mostrar el aviso de  «Letra ya probada». Este mensaje aparece cuando se introduce una letra que ya ha sido probado anteriormente. Muchas personas no necesitarán mucho tiempo para leer este mensaje,  pero los niños requerirán más tiempo para comprenderlo, por lo que para ellos este intervarlo de tiempo debe ser mayor.   </para>

</sect2>

</sect1>

</chapter>

<chapter id="commands">
<title
>Guía de órdenes</title>

<sect1 id="khangman-mainwindow">
<title
>Menús y teclas de acceso rápido</title>

<sect2>
<title
>Menú «Partida»</title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Juego</guimenu
> <guimenuitem
>Nuevo</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Comienza un juego <action
>nuevo</action
> (&ie;, proporciona una palabra nueva).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>O</keycap
></keycombo
> </shortcut
> <guimenu
>Juego</guimenu
> <guimenuitem
>Abrir...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Abre</action
> un archivo local con palabras para jugar.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>G</keycap
></keycombo
> </shortcut
> <guimenu
>Juego</guimenu
> <guimenuitem
>Obtener palabras en un nuevo idioma...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Muestra</action
> el diálogo <guilabel
>Obtener novedades</guilabel
> con una lista de los datos disponibles para los diferentes idiomas. </para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Juego</guimenu
> <guimenuitem
>Salir</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Sale</action
> de &khangman;.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>El menú «Categoría»</title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Categoría</guimenu
> <guimenuitem
>Animales</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Permite</action
> jugar con una lista de nombres de animales.</para>
<para
>Todas las categorías instaladas aparecerán como elementos de este menú.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Categoría</guimenu
> <guimenuitem
>Fácil</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Permite</action
> jugar con una lista de nombres fáciles.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Categoría</guimenu
> <guimenuitem
>Media</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Permite</action
> jugar con una lista de nombres de dificultad media.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Categoría</guimenu
> <guimenuitem
>Difícil</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Permite</action
> jugar con una lista de nombres difíciles.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>El menú «Idioma»</title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Idioma</guimenu
> <guimenuitem
>Inglés</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Elige</action
> el idioma inglés para las palabras que tiene que adivinar.</para>
<para
>Todos los idiomas instalados se mostrarán como elementos de este menú.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>Menú «Apariencia»</title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Aspecto</guimenu
> <guimenuitem
>Tema marino</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Elige</action
> como fondo una imagen del mar, así como los correspodientes colores de los tipos de letra.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Aspecto</guimenu
> <guimenuitem
>Tema de invierno</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Elige</action
> como fondo una imagen de invierno, así como los correspondientes colores de los tipos de letra.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Aspecto</guimenu
> <guimenuitem
>Tema de abejas</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Elige</action
> como fondo una imagen de abejas, así como los correspondientes colores de los tipos de letra.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Aspecto</guimenu
> <guimenuitem
>Tema desértico</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Elige</action
> como fondo una imagen del desierto, así como los correspodientes colores de los tipos de letra.</para
></listitem>
</varlistentry>
</variablelist>

<para
>Además, &khangman; tiene las opciones de menú <guimenu
>Preferencias</guimenu
> y <guimenu
>Ayuda</guimenu
> comunes de &kde;. Para obtener más información, consulte las secciones sobre el <ulink url="help:/fundamentals/ui.html#menus-settings"
>Menú «Preferencias»</ulink
> y <ulink url="help:/fundamentals/ui.html#menus-help"
>Menú «Ayuda»</ulink
> de «Aspectos básicos de &kde;». </para>

</sect2>

</sect1>
</chapter>

<chapter id="developers">
<title
>Guía del programador de &khangman;</title>

<sect1 id="changing-words">
<title
>Cómo traducir palabras en un nuevo idioma para el juego</title>

<para
>Por favor, siga este procedimiento y envíeme  los archivos comprimidos con tar y gzip a &Anne-Marie.Mahfouf.mail;. </para>
<para
>Puede echarle un vistazo a <guimenuitem
>Obtener palabras en un nuevo idioma...</guimenuitem
> dentro del menú <guimenu
>Juego</guimenu
> para comprobar si su idioma está disponible. Si lo está, puede verificar si este archivo contiene <emphasis
>pistas</emphasis
>. </para>
<para
>Las palabras de la lista estándar están guardadas en cuatro archivos independientes que dan lugar a las distintas categorías. Los archivos se encuentran en <filename class="directory"
>/khangman/data</filename
>. El archivo <filename
>easy.kvtml</filename
> es para la categoría «Fácil», el archivo <filename
>medium.kvtml</filename
> para la categoría «Media», el archivo <filename
>animals.kvtml</filename
> para la categoría «Animales» y el archivo <filename
>hard.kvtml</filename
> para la categoría «Difícil».</para>
<para
>El inglés es el idioma predeterminado y es el único idioma que se suministra con &khangman;. Los datos de los demás idiomas  están incluidos en los módulos kde-l10n correspondientes. </para>
<procedure>
<step>
<para
>Los archivos utilizan el formato kvtml. La etiqueta <sgmltag class="starttag"
>text</sgmltag
> es para la palabra y la etiqueta <sgmltag class="starttag"
>comment</sgmltag
> es para la pista. Ambos están dentro de una etiqueta  <sgmltag class="starttag"
>entry</sgmltag
>. Intente relacionar la pista con la categoría o nivel de dificultad. La categoría «Fácil» requerirá una pista sencilla, pero la categoría «Difícil» requerirá la definición del diccionario. Intente no utilizar palabras de la misma familia en la pista, ¡o hará que el usuario adivine la palabra con facilidad!</para>

<para
>Tenga en cuenta que debe utilizar la <emphasis role="bold"
>codificación UTF-8</emphasis
> al editar los archivos. Si su editor no admite esta opción, utilice &kwrite; o &kate;. Cuando abra un archivo con &kwrite; or &kate;, encontrará una lista desplegable que se encuentra en la parte superior del diálogo de apertura que le permitirá seleccionar la codificación utf8.</para>

<para
>Un ejemplo de un archivo kvtml es el siguiente:</para>
<programlisting
><markup>
&lt;?xml version="1.0"?&gt; 
&lt;DOCTYPE kvtml PUBLIC "kvtml2.dtd"
"http://edu.kde.org/kanagram/kvtml2.dtd"&gt; 
&lt;kvtml version="2.0"&gt; 
&lt;information&gt;
    &lt;generator&gt;converter&lt;/generator&gt;
    &lt;title&gt;Animales&lt;/title&gt;&lt;!--Traduzca el contenido de esta etiqueta--&gt;
    &lt;comment&gt;Animales de todo el
mundo&lt;/comment&gt;&lt;!--Traduzca el contenido de esta etiqueta--&gt;
  &lt;/information&gt;
  &lt;identifiers&gt;
    &lt;identifier id="0" &gt;
      &lt;locale&gt;es&lt;/locale&gt;
    &lt;/identifier&gt;
  &lt;/identifiers&gt;
...
&lt;entry id="0" &gt;
      &lt;inactive&gt;false&lt;/inactive&gt;
      &lt;inquery&gt;false&lt;/inquery&gt;
      &lt;translation id="0" &gt;
        &lt;text&gt;oso&lt;/text&gt;&lt;!--Traduzca el contenido de todas las etiquetas
con texto--&gt;
        &lt;comment&gt;Animal grande y pesado con mucho
pelo&lt;/comment&gt;&lt;!--Traduzca el contenido de todas las etiquetas con comentarios--&gt;
      &lt;/translation&gt;
    &lt;/entry&gt;
...
&lt;/kvtml&gt;
</markup
></programlisting>
</step>
<step>
<para
>Al comienzo del archivo, debe traducir el contenido de las etiquetas <sgmltag class="starttag"
>title</sgmltag
> y <sgmltag class="starttag"
>comment</sgmltag
>; ambas  se encuentran dentro de la etiqueta <sgmltag class="starttag"
>information</sgmltag
>. Este título será el que aparezca en el menú Categoría (donde el usuario escoge el archivo con el que quiere jugar). </para>
</step>
<step>
<para
>A continuación, dentro de la etiqueta <sgmltag class="starttag"
>identifier</sgmltag
> introduzca, en lugar de «es», el código de su idioma en <sgmltag class="starttag"
>locale</sgmltag
>.</para>

<para
>No traduzca el nombre del propio archivo ya que los nombres de archivo no deben contener ningún carácter especial. Guarde por lo tanto su archivo con el nombre en inglés.</para>
</step>
<step>
<para
>Edite los archivos kvtml con un editor de textos (le resultará más fácil si usa el resaltado de sintaxis XML) y reemplace cada palabra dentro de la etiqueta <sgmltag class="starttag"
>text</sgmltag
> con una palabra traducida, y cada pista dentro de la etiqueta <sgmltag class="starttag"
>comment</sgmltag
> con una pista traducida. No es realmente importante preservar el significado exacto de la palabra, pero intente mantener aproximadamente su longitud y su nivel de dificultad. </para
> 

<para
>Puede incluir palabras con espacios en blanco o guiones (-); en este caso, se mostrará el espacio en blanco o el guion en vez del símbolo de subrayado (_). Por favor, póngase en contacto conmigo si hubiera algún problema con su idioma; así podré realizar los ajustes necesarios en el código (en particular, aquellos relacionados con los caracteres especiales y los caracteres acentuados). </para>
</step
>	

<step>
<para
>Puede simplemente traducir las palabras, pero también puede adaptarlas a la categoría o añadir otras nuevas si así lo desea. Por ejemplo, «table» (que quiere decir «mesa») está incluida en la categoría «Fácil» en inglés, pero en su idioma podría estar en la categoría «Media». Tiene libertad para adaptar los archivos a las necesidades de su idioma. El número de palabras en un archivo no es importante, por lo que puede añadir tantas como quiera.</para>

<para
>Recuerde que todas las palabras deben ser sustantivos.</para>

</step>

<step>
<para
>Puede subir sus archivos a <emphasis
>l10n-kde4/&lt;lang_code&gt;/data/kdeedu/khangman</emphasis
>. No olvide que debe también actualizar el archivo CMakeLists.txt . Por favor, pónganse en contacto conmigo por correo electrónico si necesita más información al respecto. Cuando me envíe los archivos, no olvide mencionar los <emphasis role="bold"
>caracteres especiales</emphasis
> usados en su idioma (póngalos en un archivo de texto, uno por línea, y a continuación incluya este archivo en el tar) así como cualquier otra especificidad.</para>
<para
><emphasis
>Por favor, no suba nunca archivos a una RAMA ya que puede colgar el juego.</emphasis
></para>
</step>
</procedure>
<para
>¡Muchas gracias por su colaboración!</para>
</sect1>

<sect1 id="internal">
<title
>Qué guarda &khangman; y dónde</title>
<para
>Cuando instale un nuevo idioma a través de <menuchoice
><guimenu
>Juego</guimenu
> <guimenuitem
>Obtener palabras en un  nuevo idioma...</guimenuitem
></menuchoice
>, los datos de este nuevo idioma se guardan en una carpeta (cuyo nombre es el código del idioma) que se encuentra en <filename class="directory"
>$KDEHOME/share/apps/kvtml/</filename
>. Los nombres de los directorios de los idiomas disponibles también se guardan en el archivo de configuración de &khangman;, que se encuentra en <filename
>$KDEHOME/share/config/khangmanrc</filename
>. </para>
<para
>El nombre del distribuidor (es decir, la dirección del sitio web de donde se han descargado los nuevos idiomas) se guarda en <filename
>$KDEDIR/share/apps/khangman/khangmanrc</filename
>. </para>
<para
>El idioma inglés (predeterminado) y el idioma del usuario, tomado de su correspondiente paquete i18n (si es que está disponible), se guardan en <filename class="directory"
>$KDEDIR/share/apps/kvtml</filename
>. </para>
<para
>En el archivo de configuración, que se encuentra en <filename
>$KDEHOME/share/config/khangmanrc</filename
>, se guardan, para cada usuario, todas las configuraciones del juego, como el fondo, la última categoría jugada, etc., así como los archivos descargados mediante el diálogo <guilabel
>Obtener novedades</guilabel
>. </para>
</sect1>
</chapter>

<chapter id="faq">
<title
>Preguntas y respuestas</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
>Un mensaje de error me informa de que no se encuentran las imágenes.</para>
</question>
<answer>
<para
>De manera predeterminada, el juego se instala en <filename class="directory"
>/usr/local/kde</filename
>, por lo que debe anadir <filename class="directory"
>/usr/local/kde/bin</filename
> a su ruta  y definir la variable <envar
>KDEDIR</envar
> como <filename class="directory"
>/usr/local/kde</filename
> antes de ejecutar el juego. Una forma sencilla es configurar &khangman; con la opción <option
>--prefix</option
>=$<envar
>KDEDIR</envar
>, donde $<envar
>KDEDIR</envar
> es el directorio donde está instalado el resto de &kde;. Esto puede variar dependiendo de la distribución y del sistema operativo que tenga. ¡Lo mejor es que instale &khangman; desde su propia distribución!</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>&khangman; no se inicia correctamente después de haberlo actualizado desde una versión anterior a la nueva versión de &kde; 4.</para>
</question>
<answer>
<para
>Pueden existir problemas debido a un cambio en el archivo de configuración. Elimine el archivo <filename
>khangmanrc</filename
> de su carpeta <filename class="directory"
>$KDEHOME/share/config</filename
>. </para>
</answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

<title
>Créditos y licencia</title>

<para
>&khangman; </para>
<para
>Copyright del programa © 2001-2007 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;. </para>
<para
>Colaboradores: <itemizedlist>
<listitem
><para
>Gráficos del ahorcado: Renaud Blanchard <email
>kisukuma@chez.com</email
>.</para
> </listitem>
<listitem
><para
>Sonidos: Ludovic Grossard <email
>ludovic.grossard@libertysurf.fr</email
>.</para
> </listitem>
<listitem
><para
>Responsable anterior: &Primoz.Anzur; &Primoz.Anzur.mail;</para
> </listitem>
<listitem
><para
>Archivos de datos en sueco, ayuda con la programación, imágenes transparentes y correcciones en la i18n: Stefan Asserhäll <email
>stefan.asserhall@telia.com</email
>.</para
> </listitem>
<listitem
><para
>Archivos de datos en español: eXParTaKus <email
>expartakus@expartakus.com</email
>.</para
> </listitem>
<listitem
><para
>Archivos de pistas en español: Rafael Beccar <email
>rafael.beccar@kdemail.net </email
>.</para
> </listitem>
<listitem
><para
>Archivos de datos en danés: Erik Kjaer Pedersen <email
>erik@mpim-bonn.mpg.de </email
>.</para
> </listitem>
<listitem
><para
>Archivos de datos en finlandés: Niko Lewman <email
>niko.lewman@edu.hel.fi </email
>.</para
> </listitem>
<listitem
><para
>Archivos de datos en portugués brasileño: João Sebastião de Oliveira Bueno <email
>gwidion@mpc.com.br</email
>.</para
> </listitem>
<listitem
><para
>Archivos de datos en catalán: Antoni Bella <email
>bella5@teleline.es</email
>.</para
> </listitem>
<listitem
><para
>Archivos de datos en italiano: Giovanni Venturi <email
>jumpyj@tiscali.it</email
>.</para
> </listitem>
<listitem
><para
>Archivos de datos en holandés: Rinse <email
>rinse@kde.nl</email
>.</para
> </listitem>
<listitem
><para
>Archivos de datos en portugués: Pedro Morais <email
>morais@kde.org</email
>.</para
> </listitem>
<listitem
><para
>Archivos de datos en serbio (cirílico y latino): Chusslove Illich <email
>chaslav@sezampro.yu</email
>.</para
> </listitem>
<listitem
><para
>Archivos de datos en esloveno: Jure Repinc <email
>jlp@holodeck1.com</email
>.</para
> </listitem>
<listitem
><para
>Archivos de datos en checo: Luk&aacute;&scaron; Tinkl <email
>lukas@kde.org</email
>.</para
> </listitem>
<listitem
><para
>Archivos de datos en tayiko: Roger Kovacs <email
>rkovacs@khujand.org</email
>.</para
> </listitem>
<listitem
><para
>Archivos de datos en noruego (bokm&#229;l): Torger &#197;ge Sinnes <email
>torg-a-s@online.no</email
>.</para
> </listitem>
<listitem
><para
>Archivos de datos en húngaro: Tamas Szanto <email
>tszanto@mol.hu</email
>.</para
> </listitem>
<listitem
><para
>Archivos de datos en noruego (nynorsk): Gaute Hvoslef Kvalnes <email
>gaute@verdsveven.com</email
>.</para
> </listitem>
<listitem
><para
>Archivos de datos en turco: Mehmet &Ouml;zel <email
>mehmet_ozel2003@hotmail.com</email
>.</para
> </listitem>
<listitem
><para
>Archivos de datos en búlgaro: Radostin Radnev <email
>radnev@yahoo.com</email
>.</para
> </listitem>
<listitem
><para
>Archivos de datos en irlandés (gaélico): Kevin Patrick Scannell <email
>scannell@slu.edu</email
>.</para
> </listitem>
<listitem
><para
>Ayuda con la programación: &Robert.Gogolok; &Robert.Gogolok.mail;.</para
> </listitem>
<listitem
><para
>Ayuda con la programación: Benjamin Meyer <email
>ben@meyerhome.net</email
>.</para
> </listitem>
<listitem
><para
>Corrección de errores: Lubos Lun&agrave;k <email
>l.lunak@kde.org</email
>.</para
> </listitem>
<listitem
><para
>Corrección del código: Albert Astals Cid &Albert.Astals.Cid.mail;</para
> </listitem>
<listitem
><para
>Estudio de usabilidad: Celeste Paul <email
>seele@obso1337.org</email
>.</para
> </listitem>
</itemizedlist>
</para>

<para
>Copyright de la documentación © 2001-2007 &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;. </para>

<para
>Traducido por Rocío Gallego <email
>traducciones@rociogallego.com</email
>, Rafael Beccar <email
>rafabeccar@speedy.com.ar</email
>, Santiago Fernández Sancho <email
>santi@kde-es.org</email
> y Leticia Martín Hernández <email
>leticia.martin@gmail.com</email
>.</para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Instalación</title>

<sect1 id="getting-khangman">
<title
>Cómo obtener &khangman;</title>
&install.intro.documentation; </sect1>

<sect1 id="compilation">
<title
>Compilación e instalación</title>
&install.compile.documentation; </sect1>
</appendix>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->
