<?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 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
>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
> 
</authorgroup>


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

<legalnotice
>&FDLNotice;</legalnotice>


<date
>2006-02-01</date>
<releaseinfo
>1.6</releaseinfo>

<abstract>
<para
>&khangman; es el juego clásico 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 juego del ahorcado. Está dirigido a niños de seis años o más. Tiene cuatro niveles de dificultad: Animales (palabras de animales), Fácil, Medio y Difícil. Se escoge una palabra aleatoriamente, las letras están ocultas, se debe adivinar la palabra probando una letra tras otra. Cada vez que se pulsa una letra equivocada, se va dibujando la imagen del ahorcado. Hay que adivinar la palabra antes de que le cuelguen. Hay 10 intentos. </para>

</chapter>

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

<screenshot>
<screeninfo
>Ésta es una instantánea de &khangman; al iniciarlo la primera vez</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="khangman1.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Instantánea de &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Here you can see &khangman; as it is the first time you run it. Level is Animals, language is default (English here, the default is your current KDE language if the data exists), the theme is "Sea". Any changes in level, language or theme (background) are written in the configuration file and restored in your next game. </para>

<para
>Fíjese en lo sencillo que resulta cambiar el nivel y el tema, simplemente utilizando las listas desplegables de la barra de herramientas. Jugar con una nueva palabra y salir del juego también resulta sencillo pulsando en los botones correspondientes de la misma barra. </para>

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

<!-- FIXME: A word cannot really be displayed and hidden at the same time, -->
<!-- although I cannot think of a better way to phrase this -->
<para
>Se elige una palabra y sus letras se muestra como un símbolo de subrayado (_). Sabrá cuántas letras existen en la palabra. Hay que adivinar la palabra probando una letra tras otra. Introduzca la letra en el cuadro de texto bien pulsando la tecla Entrar o el botón Adivinar 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
>No importa si las letras se introducen en mayúsculas o minúsculas. El programa convierte todas las entradas a minúsculas (excepto para las palabras alemanas que comienzan con un letra mayúscula). El programa hace esto automáticamente. </para>

<para
>The current level and current language are displayed in the status bar. </para>

<para
>Cada vez que se introduce una letra que no está en la palabra, se va completando el dibujo del ahorcado. Hay 10 intentos para completar la palabra. Después de eso se muestra la respuesta correcta. </para>

<para
>Existen cuatro niveles: fácil, medio, difícil y animales, además de niveles para otros temas en algunos idiomas. El programa explora todos los archivos de datos en todos los idiomas. </para>
 
<para
>En el nivel fácil las palabras son sencillas, relacionadas con la vida diaria. Es adecuado para niños de entre 6 y 9 años. El nivel de animales contiene únicamente nombres de animales que pueden resultar sencillos de adivinar. Algunos son fáciles y otros más difíciles. En el nivel medio las palabras son más largas y con más dificultad. Adecuado para niños mayores de 9 años. El nivel difícil es... difícil, &ie;, las palabras son complicadas de deletrear y no muy conocidas. Desafiante incluso para los adultos. </para>

<para
>Una vez que se ha adivinado una palabra (o el ahorcado se completa), se le preguntará si desea seguir jugando y podrá responder con las teclas <keycap
>S</keycap
> o <keycap
>N</keycap
> o pulsando con el ratón sobre «Sí» o «No». Si contesta <guilabel
>No</guilabel
>, terminará el juego. Si contesta <guilabel
>Sí</guilabel
>, aparecerá otra palabra lista para adivinar. </para>

<para
>Debe teclear la letra que desea probar en la casilla (el cursor del ratón ya se encuentra ahí) y pulsar la tecla &Enter;. Si la letra pertenece a la palabra, se coloca en su lugar, varias veces si es necesario. Si la letra no pertenece a la palabra, se coloca en la casilla de fallos y se dibuja una parte más del ahorcado. Tiene diez intentos y después perderá, pudiendo ver entonces la palabra correcta. </para>

<para
>Durante el juego, puede elegir iniciar una nueva partida yendo al menú <guimenu
>Juego</guimenu
> y seleccionando <guimenuitem
>Nuevo</guimenuitem
> o pulsando el icono <guiicon
>Nuevo</guiicon
> en la barra de herramientas. También puede cambiar el nivel utilizando el botón de nivel de la barra de herramientas (ésto hará que aparezca una nueva palabra correspondiente al nuevo nivel).</para>

<para
>Futuras mejoras (en &kde; 4) le permitirán crear sus propios archivos de palabras. </para>
</sect1>

<sect1 id="languages">
<title
>Jugando en diferentes idiomas</title>
<para
>You can play &khangman; in twenty-two languages: Brazilian Portuguese, Bulgarian, Catalan, Czech, Danish, Dutch, English, Finnish, French, German, Hungarian, Irish (Gaelic), Italian, Norwegian (Bokm&#229;l), Norwegian (Nynorsk), Portuguese, Spanish, Serbian (Latin and Cyrillic), Slovenian, Tajik and Swedish. </para>

<para
>De forma predeterminada, después de la instalación de &khangman;, solo se instalarán los paquetes kde-i18n correspondientes al inglés y a su idioma de &kde; si es uno de los anteriores. Por ejemplo, si es un usuario danés y tiene el &kde; en danés, en <guimenu
>Idiomas</guimenu
> verá dos elementos: inglés y danés. </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. Pulse en el menú <guimenu
>Juego</guimenu
> y a continuación <guimenu
>Obtener palabras en un nuevo idioma...</guimenu
>. Aparecerá un diálogo, similar a este: </para>

<screenshot>
<screeninfo
>El diálogo obtener palabras nuevas para &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="getnewstuff.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>El diálogo obtener palabras nuevas para &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Click on the language name you want to install and then on the Install button. A dialog will tell you when the language is installed by displaying: Successfully installed hot new stuff. You click on <guibutton
>OK</guibutton
> to close this information dialog then on <guibutton
>Close</guibutton
> to close the Get New Words dialog (if you want another language, you get repeat these steps). The new language is now available in the <guimenu
>Languages</guimenu
> menu! </para>

<para
>You can then easily change the language by going in the <guimenu
>Languages</guimenu
> and choose another language. </para>

<para
>Tenga en cuenta que ahora puede teclear los caracteres especiales en un idioma mostrando la <interface
>Barra de herramientas de caracteres especiales</interface
>. Esta barra de herramientas mantiene botones con un icono para cada caracter especial del idioma, como &eacute; en francés, por ejemplo. Pulsando estos botones se escribirá la letra correspondiente en la línea de entrada y podrá validarla con la tecla Entrar. Por supuesto, también puede utilizar el teclado del idioma correspondiente. Esta barra de herramientas puede mostrarse u ocultarse. Las preferencias se restauran la siguiente vez que juegue con &khangman;. </para>

<important
><para
>Please note that you need Arial and URW Bookman fonts in order to display the special characters correctly in some languages. Provided you have those fonts installed, &khangman; will automatically use them. If you see small squares instead of letters, then you may not have one of these fonts installed. Type fonts:/ into the konqueror address bar to check which fonts you have installed. </para
></important>

</sect1>
<sect1 id="few-tips">
<title
>Algunos consejos</title>
<para
>Intente adivinar primero las vocales. Y después pruebe con las consonantes más comunes: l, t, r, n, s. </para>
<para
>corresponding When you see <quote
>io</quote
>, try n after that, in French and English. </para>
<para
>En catalán, español, portugués y portugués brasileño, 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». Ésto es así si no está marcada la opción <guilabel
>Distinguir letras con tilde</guilabel
> en la página <guilabel
>Idiomas</guilabel
> del diálogo de configuración de &khangman;. Cuando está marcada <guilabel
>Distinguir letras con tilde</guilabel
>, deberá teclear las letras con tilde por si mismo. Cuando teclee «a» solo se mostrará «a» y por ejemplo, deberá teclear &atilde; para que se muestre. </para>
<para
>¿Sabía que? En inglés, la letra más común es la e (12,7%), seguida por la t (9,1%), después a (8,2%), i (7,0%) y n (6,7%). </para>
</sect1>


</chapter>

<chapter id="menus">
<title
>Barra de menú y barra 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 una nueva partida, &ie;, presenta una nueva palabra para adivinar, en el mismo nivel en el que se encontrase. <guimenuitem
>Obtener palabras en un nuevo idioma</guimenuitem
> mostrará el diálogo obtener palabras para permitirle descargar datos en un idioma nuevo. <guimenuitem
>Salir</guimenuitem
> sale del juego cerrando la ventana principal y guarda las preferencias actuales en el archivo de configuración.</para>

<para
>El menú <guimenu
>Nivel</guimenu
> le permite elegir el nivel, &ie;, la dificultad de la palabra que se va a adivinar. </para>

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

<para
>The <guimenu
>Look</guimenu
> menu proposes two themes: the Sea theme and the Desert theme. The background and the font colors changes for each theme. </para>

<para
>The <guimenuitem
>Settings</guimenuitem
> menu allows you to configure &khangman; easily. First, <guimenuitem
>Toolbars</guimenuitem
> and <guimenuitem
>Show Statusbar</guimenuitem
> give you the possibility to hide/show the toolbars and status bar. </para>

<para
>Existen dos barras de herramientas: la principal que se encuentra en la parte superior con los botones y desplegables y la barra de <guilabel
>Caracteres especiales</guilabel
> que se muestra en la parte inferior. Esta barra de herramientas tiene botones con caracteres especiales para cada idioma: letras con tilde y otros caracteres especiales. Ésto permite a los usuarios jugar en otro idioma sin tener que configurar un teclado nuevo. Pulse en una letra especial y se mostrará. Pulsando &Enter; el programa comprobará si la letra está presente o no en la palabra. La barra de herramientas puede ocultarse sino la quiere. Ésta característica 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 la barra de herramientas. Sitúe el cursor del ratón en el pequeño manejador situado a la izquierda de la barra de herramientas, pulse el &LMB; y arrastre la barra a la posición de la pantalla en que desee situarla. Si se sitúa con el ratón en 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 accesos rápidos...</guimenuitem
> es un diálogo de configuración estándar de &kde; que le permite elegir diferentes 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 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="khangman2.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Tema desértico de &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Ésta es una imagen de &khangman; con el tema desértico, idioma español y nivel fácil. La barra de herramientas de <interface
>Caracteres</interface
> también se muestra.</para>

<para
>The level is chosen with a combo box in the toolbar or via the <guimenu
>Level</guimenu
> menu in the menubar. The available levels are easy, medium, animals and hard. Easy is related to common objects a child aged six or seven knows. Medium regards nouns a bit more challenging, hard is quite difficult and animals is only animals nouns. </para>

<para
>All words are nouns. No verbs, no adjectives. The chosen level is then displayed on the status bar.</para>
<para
>Solo se permite teclear letras en el cuadro de texto.</para>
</sect1>

<sect1 id="settings">
<title
>Preferencias disponibles</title>
<para
>Se proporciona una barra de herramientas para acceder rápidamente a algunas preferencias. Puede pulsar sobre un botón para tener un juego nuevo (por ejemplo, una palabra nueva), o para salir del juego. el nivel y el tema se pueden cambiar de forma sencilla a través de los 2 desplegables de la barra de herramientas. </para>
<para
>In <guimenu
>Settings</guimenu
>, <guimenu
>Configure &khangman;</guimenu
> you will find tree pages. The first one is for <guilabel
>General</guilabel
> settings. </para>

<sect2 id="general-settings">
<title
>Preferencias generales</title>

<screenshot>
<screeninfo
>Preferencias generales de &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="settings1.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Preferencias generales de &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
><guilabel
>Require more guesses for duplicate letters</guilabel
>: this is unchecked as default. When unchecked, if you try the letter "a" and the word has several as, they will be all displayed. For example if the word is "potato" and you try "o", both os will be diaplayed. If you check this option however, only the firts "o" will be displayed and you will have to try it one more time to display the second "o" in "potato". This increases the difficulty. </para>

<para
><guilabel
>No mostrar el diálogo de felicitación</guilabel
>. De forma predeterminada está sin marcar, lo que significa que cuando gane un juego, se mostrará un mensaje indicando que ha ganado preguntándole si desea jugar nuevamente. Si marca esta opción, este diálogo no se volverá a mostrar, comenzando un juego nuevo directamente después de 3 segundos. </para>

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

</sect2>
<sect2 id="languages-settings">
<title
>Preferencias de idiomas</title>
<para
>The <guilabel
>Languages</guilabel
> Settings page allows you to set some settings specific to some languages. If the settings are not available for the language you are playing in then those settings will be grayed and disabled so you cannot choose them. </para>

<screenshot>
<screeninfo
>Preferencias de idiomas de &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="settings2.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Preferencias de idiomas de &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Some languages also have hints to help you guess the word. The hint is shown by a right-click and gives a short definition of the word to guess. If this setting is enabled and if you check the option <guimenu
>Show hints</guimenu
>, you can &RMB; click anywhere on the game and get a hint shown for four seconds. This hint should help you to guess the word more easily. </para>

<para
><guimenu
>Type Accented Letters</guimenu
> is available for Brazilian Portuguese, Catalan, Portuguese and Spanish. If you check <guimenu
> Type Accented Letters</guimenu
> then you will have to type all accented vowels (like &atilde;). If this remains unchecked, when you type any vowel, all accented vowels will be displayed as well. </para>

<para
><guimenu
>Play in Uppercase Letters</guimenu
> is a setting only available for German. The user can choose to have the word all in uppercase. It does not matter how he enters the letter (lowercase or uppercase), the game converts it automatically to the choosen setting. Children for example might prefer to see uppercase letters. </para>

</sect2>

<sect2 id="timers-settings">
<title
>Preferencias de los temporizadores</title>
<para
>The Timers Settings tab allows you to set the time for displaying the hint and the Already Guessed Letter tooltip. </para>

<screenshot>
<screeninfo
>Preferencias de los temporizadores de &khangman;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="settings3.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Preferencias de los temporizadores de &khangman;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
><guilabel
>Tiempo durante el cual se mostrará la pista</guilabel
> le permite establecer un tiempo más amplio para mostrar la pista. Es necesario incrementar el tiempo para los niños pequeños por ejemplo ya que leen más despacio que los adultos. </para>

<para
><guilabel
>Tiempo para mostrar una leyenda ya adivinada</guilabel
> le permite incrementar o reducir el tiempo para mostrar un mensaje con la letra que se haya adivinado. Este mensaje es una etiqueta que aparecerá cuando se pruebe con una letra que ya se haya probado. Algunas personas no necesitarán mucho tiempo mientras que los niños necesitarán más tiempo para leerla y por eso la duración debería ser mayor. </para>

</sect2>

</sect1>

</chapter>

<chapter id="commands">
<title
>Referencia de órdenes</title>

<sect1 id="khangman-mainwindow">
<title
>Teclas de menús y accesos rápidos</title>

<sect2>
<title
>El menú <guimenu
>Juego</guimenu
></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
><action
>Juego nuevo</action
> (&ie; nueva palabra).</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 KNewStuff que listará todos 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ú <guimenu
>Nivel</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Nivel</guimenu
> <guimenuitem
>Animales</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Elige</action
> adivinar la lista de palabras de animales.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Nivel</guimenu
> <guimenuitem
>Fácil</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Elige</action
> adivinar la lista de palabras fáciles.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Nivel</guimenu
> <guimenuitem
>Medio</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Elige</action
> adivinar la lista de palabras de nivel medio.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Nivel</guimenu
> <guimenuitem
>Difícil</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Elige</action
> adivinar la lista de palabras de nivel difícil.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>El menú <guimenu
>Idioma</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Idioma</guimenu
> <guimenuitem
>Inglés</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Choose</action
> the English language for the words to guess</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>El menú <guimenu
>Aspecto</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Aspecto</guimenu
> <guimenuitem
>Tema marino</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Elige</action
> la imagen del mar como fondo y asocia los 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
> la imagen del desierto como fondo y asocia los colores de los tipos de letra.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2>
<title
>El menú <guimenu
>Preferencias</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Preferencias</guimenu
> <guisubmenu
>Barra de herramientas</guisubmenu
> <guimenuitem
>Principal (&khangman;)</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Muestra u oculta</action
> la barra de herramientas principal.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Settings</guimenu
> <guisubmenu
>Toolbars</guisubmenu
> <guimenuitem
>Special Characters</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Muestra u oculta</action
> la barra de herramientas de los caracteres.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><menuchoice
><guimenu
>Preferencias</guimenu
> <guimenuitem
>Mostrar barra de estado</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Toggle</action
> the status bar</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Preferencias</guimenu
> <guimenuitem
>Configurar accesos rápidos...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Abre</action
> el diálogo estándar de configuración de &kde; que permite elegir diferentes teclas de acceso rápido para diferentes acciones. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Preferencias</guimenu
> <guimenuitem
>Configurar barras de herramientas...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Configura</action
> los elementos que desee situar en la barra de herramientas. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Preferencias</guimenu
> <guimenuitem
>Configurar &khangman;...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Muestra</action
> el diálogo de configuración de &khangman;. </para
></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2>
<title
>El menú <guimenu
>Ayuda</guimenu
></title>
&help.menu.documentation; </sect2>
</sect1>
</chapter>

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

<sect1 id="changing-words">
<title
>Cómo añadir palabras en un nuevo idioma</title>

<para
>Gracias a Stefan Asserhäll, es muy sencillo añadir un nuevo idioma directamente en el juego. El procedimiento descrito aquí también se encuentra en un directorio del código fuente llamado <filename class="directory"
>khangman</filename
>, en el archivo <filename
>README.languages</filename
>. Por favor, siga el procedimiento y envíeme los archivos comprimidos con tar y gzip a annemarie.mahfouf@free.fr. </para>
<para
>Los veinticuatro idiomas disponibles ordenados por código son: bg ca cs da de en es fr fi ga hu it nb nl nn pt pt_BR ru sl sr sr@Ltn sv tg y tr. Si su código de idioma no se encuentra aquí, puede continuar como sigue. </para>
<para
>Most of this data should be completed to include <emphasis
>hints</emphasis
>, please see below. Complete data: bg fr en it only have hints so the other above languages must be updated as soon as possible. </para>
<para
>Asegúrese de que está trabajando con las últimas fuentes de la rama trunk del svn de &khangman; utilizando <screen
><userinput
><command>
svn up khangman
</command
></userinput
></screen
> en el módulo kdeedu. A continuación <screen
><userinput
><command>
cd kdeedu/khangman
</command
></userinput
></screen>
</para>
<para
>Las palabras están guardadas en cuatro archivos independientes, uno para cada nivel. Los archivos están en <filename class="directory"
>/khangman/data</filename
>. El archivo <filename
>easy.txt</filename
> es para el nivel fácil, el archivo <filename
>medium.txt</filename
> para el medio, el archivo <filename
>animals.txt</filename
> para el nivel de animales y el archivo <filename
>hard.txt</filename
> para el nivel difícil.</para>
<para
>English is the default and thus the only language to be shipped with &khangman;. All other languages data are put in the correct kde-i18n. </para>
<procedure>
<step
><para
>Introduzca las siguientes órdenes en &konsole; para crear el directorio y los archivos del nuevo idioma:</para>
<!-- Do not wrap or indent the next line, it's white space sensitive -->
<screen
><userinput
><command
>./add_language <replaceable
>código_del_idioma</replaceable
></command
></userinput
></screen>
<para
>Aquí debe sustituir <replaceable
>código_del_idioma</replaceable
> por el código real de su idioma.</para>
</step>
<step>
<para
>Ahora los archivos utilizan el formato kvtml. La etiqueta <sgmltag class="starttag"
>o</sgmltag
> es para la palabra y la etiqueta <sgmltag class="starttag"
>t</sgmltag
> es para la pista. Intente relacionar la pista con el nivel de dificultad. El nivel «fácil» precisará una pista fácil, pero el nivel «difícil» requiere la definición del diccionario. Intente no utilizar palabras de la misma familia en la pista, que hará una palabra más sencilla. </para>
<para
>Un ejemplo de un archivo kvtml es el siguiente:</para>
<programlisting
><markup>
        &lt;?xml version="1.0"?&gt; 
        &lt;!DOCTYPE kvtml SYSTEM "kvoctrain.dtd"&gt; 
        &lt;kvtml&gt; 
        &lt;e&gt; 
        &lt;o&gt;cane&lt;/o&gt; 
        &lt;t&gt;&egrave; il tuo animale domestico preferito&lt;/t&gt; 
        &lt;/e&gt; 
        ...
        ...
        &lt;/kvtml&gt;
</markup
></programlisting>
</step>
<step>
<para
>Edite todos los archivos de texto indicados en el campo nuevo con un editor de texto, y sustituya cada palabra dentro de la etiqueta <sgmltag class="starttag"
>o</sgmltag
> con una palabra traducida y cada pista dentro de <sgmltag class="starttag"
>t</sgmltag
> con una pista traducida. No es realmente necesario que se conserve el significado exacto, pero intente mantener la longitud y el nivel de dificultad. Puede incluir palabras con espacios en blanco o con -, que se reemplazarán con _. Por favor, contacte con &Anne-Marie.Mahfouf; <email
>annemarie.mahfouf@free.fr</email
> si existe algo especial relacionado con su idioma para que pueda adaptar el código a él (sobre todo los caracteres especiales y con tilde).</para
> 
	
<para
>Puede traducir las palabras, pero también puede adaptarlas al nivel o añadir otras nuevas si lo desea. Por ejemplo, «table» en inglés está en el nivel fácil, pero es posible que en su idioma deba estar en el medio. Tómese total libertad en la adaptación de los archivos a las necesidades de su idioma. El número de palabras del archivo no es importante, así que puede añadir cuantas quiera.</para>

<para
>Recuerde que todas las palabras son nombres.</para>

<para
>Tenga en cuenta que debe utilizar <emphasis role="bold"
>codificación UTF-8</emphasis
> al editar los archivos. Si su editor no admite esta opción, utilice &kwrite; o &kate;. Encontrará una opción en la parte superior del diálogo de apertura de archivos de ambos programas que le permitirá seleccionar la codificación utf8.</para>

<para
>Por favor, mantenga los nombres en inglés para los archivos del directorio de <replaceable
>código_de_idioma</replaceable
>.</para>
</step>

<step>
<para
>Introduzca la siguiente orden para instalar los nuevos archivos de datos:</para>
<screen
><userinput
><command
>make</command
></userinput>
<userinput
><command
>make install</command
></userinput
></screen>

<para
>Es posible que deba convertirse en usuario <systemitem class="username"
>root</systemitem
> para ejecutar <command
>make install</command
>, dependiendo de su instalación.</para>
</step>
<step>
<para
>Ejecute el juego y compruebe que su idioma se ha añadido:</para>
<screen
><userinput
><command
>khangman</command
></userinput
></screen>
</step>
<step
><para
>Instead of committing your files, please sent them to &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail; tarred and gzipped. As there are now twenty three languages, a wizard (KNewStuff) is now included in KHangMan to easily download and install new languages that are placed on the website. This is done to reduce the size of the kdeedu module and it will also be done in &klettres;, &kstars; and maybe &ktouch;. Please contact Anne-Marie by email if you need further information.</para>
<para
>Cuando me envíe los archivos, por favor no olvide mencionar cualquier <emphasis role="bold"
>caracter especial</emphasis
> utilizado en su idioma (sitúelos en un archivo de texto, uno por línea y añadalo al archivo comprimido) y mencione cualquier otro elemento específico.</para>
<para
><emphasis
>Por favor, no envíe nunca archivos a la 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 obtiene un idioma nuevo a través de <menuchoice
><guimenu
>Juego</guimenu
><guimenuitem
>Obtener palabras en un nuevo idioma...</guimenuitem
></menuchoice
>, el idioma nuevo se guardará en <filename class="directory"
>$~/.kde/share/apps/khangman/data</filename
> en la carpeta con el código del idioma. Los nombres de los directorios de los idiomas disponibles también se guardan en el archivo de configuración de &khangman; en <filename
>~/.kde/share/config/khangmanrc</filename
>. </para>
<para
>El nombre del distribuidor (p.ej. la dirección del sitio web de donde descargar idiomas nuevos) se guarda en <filename
>$KDEDIR/share/apps/khangman/khangmanrc</filename
>. </para>
<para
>El idioma inglés (predeterminado) y el del idioma del usuario de los paquetes i18n (si está disponible) se guardan en <filename class="directory"
>$KDEDIR/share/apps/khangman</filename
>. </para>
<para
>En el archivo de configuración, para cada usuario en <filename
>~/.kde/share/config/khangmanrc</filename
> se guardan todas las configuraciones del juego tales como el fondo, último nivel jugado,... además de los archivos que se descargaron con el diálogo KNewStuff. </para>
</sect1>
<sect1 id="planned-features">
<title
>Funcionalidades planeadas para &khangman;</title>
<para
>Una de las mejoras planeadas es, por supuesto, incluir más datos de idiomas así como las pistas de cada idioma. Puede ayudar a esto en su propio idioma si está todavía terminado. Por favor, contacte conmigo si desea ayudar con esto, solo tiene que traducir las palabras en inglés a su idioma (consulte <link linkend="changing-words"
>cómo añadir palabras para el juego en un idoma nuevo</link
>). </para>
<para
>What can also be done is to use other kvtml files like the ones that are on the KDE-Edu website to play &khangman;. For example, imagine you can play the capitals of the world, the hint will tell you the country and you have to guess the capital. Or learn words in another language, the hint is the word in your language, the word to guess is the translation in the new language. </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
>El juego se instala de forma predeterminada en <filename class="directory"
>/usr/local/kde</filename
>, así que añada <filename class="directory"
>/usr/local/kde/bin</filename
> a su ruta predeterminada y establezca la variable de entorno <envar
>KDEDIR</envar
> a <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 lugar en el que está instalado el resto de &kde;. Este lugar puede variar dependiendo de la distribución y el sistema operativo que utilice.</para>
</answer>
</qandaentry>
<qandaentry>
<question>
<para
>&khangman; no se inicia correctamente después de haber actualizado a una de las versiones de &kde; posteriores a la versión 3.5</para>
</question>
<answer>
<para
>Puede existir un problema debido al cambio del archivo de configuración. Por favor, elimine el archivo <filename
>khangmanrc</filename
> en su carpeta <filename class="directory"
>$HOME/.kde/share/config</filename
>. </para>
</answer>
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

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

<para
>&khangman; </para>
<para
>Derechos de autor del programa 2001-2006. &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
>Blue theme, icons and code: &Primoz.Anzur; <email
>zerokode@yahoo.com</email
></para
> </listitem>
<listitem
><para
>Archivos de información en sueco, ayuda en la programación, imágenes transparentes y correcciones en la i18n: Stefan Asserhäll <email
>stefan.asserhall@telia.com</email
>.</para
> </listitem>
<listitem
><para
>Tema naturaleza: Joe Bolin <email
>jbolin@users.sourceforge.net</email
>.</para
> </listitem>
<listitem
><para
>Dibujos del ahorcado suavizado: Matt Howe <email
>mdhowe@bigfoot.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 finé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 tajiko: 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 irlandeses (gaélico): Kevin Patrick Scannell <email
>scannell@slu.edu</email
>.</para
> </listitem>

<listitem
><para
>Coding help: &Robert.Gogolok; <email
>robertgogolok@gmx.de</email
></para
> </listitem>
<listitem
><para
>Ayuda en 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 de errores: Albert Astals Cid <email
>tsdgeos@terra.es</email
>.</para
> </listitem>
<listitem
><para
>Estudio de usabilidad: Celeste Paul <email
>seele@obso1337.org</email
>.</para
> </listitem>
</itemizedlist>
</para>

<para
>Derechos de autor de la documentación. 2001-2005. &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;. </para>

<para
>Traducido por Rafael Beccar <email
>rafabeccar@speedy.com.ar</email
> y Santiago Fernández Sancho <email
>santi@kde-es.org</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:
-->
