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

<book lang="&language;">

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

<authorgroup>
<author
> <firstname
>Primoz</firstname
> <surname
>Anzur</surname
> <affiliation
> <address
><email
>zerokode@yahoo.com</email
></address
> </affiliation
> </author>
</authorgroup>

<copyright>
<year
>2001</year>
<holder
>Equipo KDE Edutainment</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2001-11-25</date>
<releaseinfo
>0.0.1</releaseinfo>

<abstract>
<para
> &kmessedwords; es un juego de entrenamiento mental con palabras </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>KMessedWords</keyword>
<keyword
>mezclar</keyword>
<keyword
>palabras</keyword>
</keywordset>

</bookinfo>

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

<para
> &kmessedwords; es el juego, basado en puzzles de letras y palabras, al que yo jugaba de niño. Es un juego de sencilla construcción, con tres niveles de dificultad, y cada nivel merece su propia valoración. Es completamente personalizable, le permite escribir sus propias palabras y establecer un <quote
>aspecto y comportamiento</quote
> personalizado. Está dirigido a niños de más de 10 años debido a su dificultad, pero... todos pueden intentarlo. Se elige una palabra aleatoriamente y se muestra con las letras desordenadas, con la dificultad dependiendo del nivel. El número de intentos es ilimitado, y se mantienen las puntuaciones. </para>
</chapter>

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

<screenshot
> <screeninfo
>Esta es una instantánea de &kmessedwords;</screeninfo
> <mediaobject
> <imageobject
><imagedata fileref="kmw1.png" format="PNG"/></imageobject
> <textobject
><phrase
>Instantánea de KMessedWords</phrase
></textobject
> </mediaobject
> </screenshot>

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

<para
>Se muestra una palabra con sus letras en orden aleatorio. Hay que tratar de adivinar toda la palabra de una vez. El juego le informará si acierta o falla. </para>
<important
> <para
> IMPORTANTE: Las palabras son sensibles a las mayúsculas, así que <quote
>michelle</quote
> NO ES <quote
>Michelle</quote
>... </para
></important>
<para
> Cada vez que se inicia el juego, el nivel predeterminado es el más fácil. </para>
<para
> Hay 3 niveles: fácil, medio y difícil: </para>
<para
> Como todos los niveles son completamente personalizables, puede establecer la dificultad de cada nivel usted mismo. Y, como el nivel de dificultad depende de la longitud de la palabra, esto es lo predeterminado:</para>
<variablelist
> <varlistentry
> <term
>Fácil</term
> <listitem
><para
>4 letras, palabras habituales</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Medio</term
> <listitem
><para
>Palabras especiales de 4 letras, y palabras habituales de hasta 7 letras.</para
></listitem
> </varlistentry
> <varlistentry
> <term
>Difícil</term
> <listitem
><para
>Palabras de al menos 6 letras, tanto habituales como especiales.</para
></listitem
> </varlistentry
> </variablelist>


<para
>Una vez que se ha adivinado una palabra, se le pedirá que indique si quiere otro, y deberá utilizar los botones <guibutton
>Sí</guibutton
> o <guibutton
>No</guibutton
>.</para>

</sect1>
</chapter>
<chapter id="commands">
<title
>Referencia del juego</title>

<screenshot
> <screeninfo
>Esta es una instantánea de &kmessedwords;</screeninfo
> <mediaobject
> <imageobject
><imagedata fileref="kmw1.png" format="PNG"/></imageobject
> <textobject
><phrase
>Instantánea de &kmessedwords;</phrase
></textobject
> </mediaobject
> </screenshot>

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

<para
>El botón <guibutton
>¡Adios!</guibutton
>, al igual que <keycombo action="simul"
>&Alt;<keycap
>F4</keycap
></keycombo
>, hace que se cierre el programa en cualquier momento.</para>

<para
>El botón <guibutton
>Ayuda</guibutton
> mostrará esta ventana, que contiene toda la ayuda disponible.</para>

<para
>El botón <guibutton
>Configurar</guibutton
> oculta dos opciones: <guilabel
>Configuración</guilabel
> abrirá la pantalla principal de configuración de &kmessedwords;, y el <guilabel
>Diccionario</guilabel
>, donde podrá escribir y borrar palabras.</para>

<para
><guibutton
>Puntuaciones</guibutton
> mostrará las 10 mejores puntuaciones.</para>

<para
>Al pulsar el botón <guibutton
>Mezclar</guibutton
> se comienza el juego.</para>

<para
>El desplegable <guimenu
>Nivel</guimenu
> establece el nivel de dificultad del juego.</para>

</sect1>
</chapter>

<chapter id="configuration">
<title
>Configuración de &kmessedwords;</title>

<screenshot
> <screeninfo
>Ventana de configuración de &kmessedwords;</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="kmw2.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Ventana de configuración de &kmessedwords;</phrase
> </textobject
> </mediaobject
> </screenshot>

<sect1 id="kmessedwords-themes">
<title
>Cambio de los temas</title>

<para
>&kmessedwords; permite cambiar el aspecto de la propia aplicación. Hacerlo es muy sencillo, basta con seleccionar el tema que desee en la lista desplegable. También puede seleccionar partes sueltas para aplicarlas al programa. Ya sean botones gráficos, fondos o ambas cosas, basta con seleccionar las opciones bajo el nombre del tema.</para>

<para
>Por defecto sólo hay un tema, llamado <quote
>default</quote
>. Más adelante es probable que haya muchos más temas disponibles, en cualquier caso creados por separado.</para>

</sect1>

<sect1 id="kmessedwords-players">
<title
>Cambio del nombre del jugador</title>

<para
>Debido a algunos problemas en la programación, la ventana de acceso de la versión anterior ha sido sustituida por la pantalla de inicio. Pero ahora cambiar los usuarios es casi tan sencillo como antes. En la ventana de configuración basta con seleccionar la sección <guilabel
>Usuario</guilabel
>, poner su nombre encima y pulsar <guibutton
>Aceptar</guibutton
>.</para>

</sect1>
</chapter>

<chapter id="kmessedwords-dictionary">
<title
>Establecimiento de las palabras del diccionario</title>

<screenshot
> <screeninfo
>Editor de listas de palabras de &kmessedwords;</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="kmw4.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Ventana del diccionario de &kmessedwords;</phrase
> </textobject
> </mediaobject
> </screenshot>

<sect1 id="changing-words">
<title
>Cambio de palabras en &kmessedwords;</title>

<para
>Para acceder al editor de palabras, debe abrir  <menuchoice
><guimenu
>Configure</guimenu
><guimenuitem
>Dictionary</guimenuitem
></menuchoice
>. Hay una lista de palabras propia de cada nivel, fácil, medio o difícil. El editor de palabras es [¿de momento?] sólo un editor de texto plano, en el que se añaden las palabras. El separador es un divisor de línea, o pulse <keycap
>Intro</keycap
>.</para>

<para
>El editor no leerá líneas en blanco o líneas con letras y caracteres iguales. Para guardar las palabras, símplemente pulse <guibutton
>Aceptar</guibutton
> o <guibutton
>Guardar palabras</guibutton
>. <emphasis
>No es</emphasis
> necesario que sea <systemitem class="username"
>superusuario</systemitem
> para que el programa cambie las palabras, ya que los archivos de diccionario se almacenan en la configuración local del usuario.</para>

</sect1>
</chapter>

<chapter id="kmessedwords-scoring">
<title
>Previsualización de puntuaciones</title>
<para
> <screenshot
> <screeninfo
>Ventana de puntuaciones de &kmessedwords;</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="kmw3.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Ventana de puntuaciones de &kmessedwords;</phrase
> </textobject
> </mediaobject
> </screenshot
> </para>
<sect1 id="checking-scores">
<title
>Comprobación de puntuaciones en &kmessedwords;</title>

<para
>Para comprobar las puntuaciones, lo único que tiene que hacer es pinchar en el botón <guibutton
>puntuaciones</guibutton
> en la ventana no gráfica o en la imagen <guiicon
>3-1-2</guiicon
> del tema predeterminado.</para>

</sect1>
</chapter>

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

<sect1 id="interface">
<title
>Interfaz gráfico de usuario de &kmessedwords;</title>

<para
>El núcleo de &kmessedwords; ya está completamente desarrollado, para la lectura, el almacenamiento y la mezcla de las palabras. Ahora mi objetivo es conseguir un entorno gráfico agradable y sencillo de utilizar. Estoy trabajando en ello tanto como puedo, pero todo durante mi tiempo libre. Aún tengo algunas ideas, pero también me gustaría recibir otras opiniones. </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 dice que no se encuentran las imágenes.</para>
</question>
<answer>
<para
>Si ha instalado el programa desde el paquete RPM, soy yo quien debo arreglar ese archivo. Pero si ha compilado la aplicación usted mismo, tenga en cuenta que hay algún problema con el prefijo predeterminado. Este prefijo instalará la aplicación en <filename class="directory"
>/usr/local/</filename
>, así que lo único que tiene que hacer es cambiarlo con <userinput
><option
>--prefix=<replaceable
>ruta_a_su_directorio_kde</replaceable
></option
></userinput
></para>
</answer
> </qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

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

<para
> &kmessedwords; </para>
<para
> Idea, desarrollador principal, gráficos y mantenedor: Primoz Anzur<email
>zerokode@yahoo.com</email
> </para>
<para
> Contribuciones: <itemizedlist
> <listitem
><para
>Ayuda en la programación (creación del motor): Waldo Bastian <email
>bastian@kde.org</email
></para
> </listitem
> <listitem
><para
>Ayuda en la programación (includemoc y todas esas cosas...): Daniel Molkentin <email
>molkentin@kde.org</email
></para
> </listitem
> <listitem
><para
>Ayuda en la programación (ayudó a que &kmessedwords; funcionase correctamente bajo KDE2 y KDE3): Haavard Froeiland <email
>haavardf@operamail.com</email
></para
> </listitem
> <listitem
><para
>Apoyo moral: Anne-Marie Mahfouf <email
>annma@kde.org</email
></para
> </listitem
> </itemizedlist
> </para>

<para
> Copyright de la documentación 2001 Primoz Anzur y el equipo &kde; Edutainment<email
>zerokode@yahoo.com</email
> </para>


&underFDL;               <!-- FDL: do not remove -->
&underGPL;        	 <!-- GPL License -->

</chapter>

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

<sect1 id="getting-kmessedwords">
<title
>Cómo obtener &kmessedwords;</title>

&install.intro.documentation;

</sect1>

<sect1 id="requirements">
<title
>Requerimientos</title>

<para
>Para poder usar &kmessedwords; correctamente, necesita &kde; 3 y &Qt; 3 en su sistema.</para>

<para
>&kmessedwords; puede ser descargado de <ulink url="http://edu.kde.org/kmessedwords/"
>la página web de &kmessedwords;</ulink
>.</para>

</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:
-->



