<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY ksirk '<application
>KsirK</application
>'>
  <!ENTITY kapp "&ksirk;"
><!-- replace ksirk here -->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Spanish "INCLUDE">
]>

<book lang="&language;">

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

<authorgroup>
<author
><firstname
>Gael</firstname
> <othername
>Kleag</othername
> <surname
>de Chalendar</surname
> <affiliation
> <address
><email
>Kleag@free.fr</email
></address>
</affiliation>
</author>
<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
>2002-2008</year>
<holder
>Gael de Chalendar</holder>
</copyright>
<!-- Translators: put here the copyright notice of the translation -->
<!-- Put here the FDL notice.  Read the explanation in fdl-notice.docbook
     and in the FDL itself on how to use it. -->
<legalnotice
>&FDLNotice;</legalnotice>

<!-- Date and version information of the documentation
Don't forget to include this last date and this last revision number, we
need them for translation coordination !
Please respect the format of the date (DD/MM/YYYY) and of the version
(V.MM.LL), it could be used by automation scripts.
Do NOT change these in the translation. -->

<date
>18/08/2005</date>
<releaseinfo
>1.03.00</releaseinfo>

<!-- Abstract about this handbook -->

<abstract>
<para
>&ksirk; es una versión electrónica del conocido juego de estrategia. Existen versiones comerciales y varios clones GPL pero yo (Gael de Chalendar) cree este juego como un ejercicio de aprendizaje de C++, y por eso lo he desarrollado hasta este punto (consulte el archivo README para obtener más detalles). </para>
<para
>En la versión actual, &ksirk; es un juego multijugador que puede utilizarse en red, y que cuenta con una IA básica (consulte el archivo TODO para obtener más detalles). </para>
<para
>Esta documentación proporciona la información más importante para comenzar a jugar. Por favor, lea los consejos y los mensajes de la barra de estado para completar su información. Un capítulo explica como crear nuevas pieles para &kapp; </para>
<para
>El objetivo de esta juego es tan simple como conquistar el mundo... Ésto se consigue atacando a sus enemigos con sus ejércitos. No es muy pacífico :-) </para>
</abstract>

<!-- This is a set of Keywords for indexing by search engines.
Please at least include KDE, the KDE package it is in, the name
 of your application, and a few relevant keywords. -->

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdegames</keyword>
<keyword
>juego</keyword>
<keyword
>estrategia</keyword>
<keyword
>Risk</keyword>
<keyword
>libre</keyword>
<keyword
>GPL</keyword>
<keyword
>Red</keyword>
<keyword
>IA</keyword>
</keywordset>

</bookinfo>

<!-- The contents of the documentation begin here.  Label
each chapter so with the id attribute. This is necessary for two reasons: it
allows you to easily reference the chapter from other chapters of your
document, and if there is no ID, the name of the generated HTML files will vary
from time to time making it hard to manage for maintainers and for the CVS
system. Any chapter labelled (OPTIONAL) may be left out at the author's
discretion. Other chapters should not be left out in order to maintain a
consistent documentation style across all KDE apps. -->

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

<!-- The introduction chapter contains a brief introduction for the
application that explains what it does and where to report
problems. Basically a long version of the abstract.  Don't include a
revision history. (see installation appendix comment) -->
<para
>&ksirk; es una versión electrónica del conocido juego de estrategia. Existen versiones comerciales y varios clones GPL pero yo (Gael de Chalendar) cree este juego como un ejercicio de aprendizaje de C++, y por eso lo he desarrollado hasta este punto (consulte el archivo README para obtener más detalles). </para>
<para>
<screenshot>
  <screeninfo
>Veamos una captura de pantalla de &kapp;</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="firing-screenshot.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Captura de pantalla</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para
>En la versión actual, &ksirk; es un juego multijugador que puede utilizarse en red, y que cuenta con una IA básica (consulte el archivo TODO para obtener más detalles). </para>
<para
>Esta documentación proporciona la información más importante para comenzar a jugar. Por favor, lea los consejos y los mensajes de la barra de estado para completar su información. </para>
<para
>El objetivo de esta juego es tan simple como conquistar el mundo... Ésto se consigue atacando a sus enemigos con sus armas. No es muy pacífico ?:-) </para>
</chapter>

<chapter id="using-kapp">
<title
>Utilizar &kapp;</title>

<!-- This chapter should tell the user how to use your app. You should use as
many sections (Chapter, Sect1, Sect3, etc...) as is necessary to fully document
your application. -->



<sect1 id="playing-ksirk">
<title
>Jugar a &kapp;</title>
<para
>Nota preliminar: El mapa puede desplazarse de tres formas. Primero, puede situar el ratón cerca del borde de la ventana y el mapa se desplazará en esta dirección: Sino hay modificador, se desplazará verticalmente, cuando pulse la tecla Meta, se desplazará horizontalmente. Y por último, puede utilizar las teclas de flechas. </para>
<sect2 id="mainmenu">
<title
>Iniciar una partida</title>
<para
>Cuando se inicia &kapp;, se mostrará un menú principal. <screenshot>
  <screeninfo
>El menú principal de &kapp;</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="introscreen.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Menú principal</phrase>
    </textobject>
  </mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term>
  <menuchoice>
    <guimenu
>Juego nuevo</guimenu>
  </menuchoice>
</term>
<listitem>
  <para>
  <action
>Inicia una partida nueva</action>
  </para>
</listitem>
</varlistentry>
<varlistentry>
  <term>
    <menuchoice>
      <guimenu
>Unirse</guimenu>
    </menuchoice>
  </term>
  <listitem>
    <para>
      <action
>Intenta unirse a un juego de red</action>
    </para>
  </listitem>
</varlistentry>
<varlistentry>
  <term>
    <menuchoice>
      <guimenu
>Cargar</guimenu>
    </menuchoice>
  </term>
  <listitem>
    <para>
      <action
>Carga una partida guardada con anterioridad</action>
    </para>
  </listitem>
</varlistentry>
<varlistentry>
  <term>
    <menuchoice>
      <guimenu
>Salir del juego</guimenu>
    </menuchoice>
  </term>
  <listitem>
    <para>
      <action
>¿Finalmente no desea jugar?</action>
    </para>
  </listitem>
</varlistentry>
</variablelist>
</para>
<para
>Si pulsa, Nuevo juego, se mostrará el diálogo Nuevo juego en el que podrá elegir el número de jugadores, la piel (o tema), el tipo de juego (conquista el objetivo u objetivo específico) y finalmente si este juego se jugará con jugadores en línea o si será local. <screenshot>
  <screeninfo
>El diálogo Nuevo juego</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="newgamedialog.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>El diálogo Nuevo juego</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para
>Para comenzar una partida en red nueva, marque la casilla «Juego en red» situada a la derecha del número de jugadores. Después de pulsar Aceptar, podrá elegir los parámetros de red: Número de jugadores en red y puerto TCP en el que se esperarán las conexiones. <screenshot>
  <screeninfo
>Diálogo de parámetros para el juego en red</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="numnetplayersdialog.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Diálogo de parámetros para el juego en red</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para
>A continuación, los jugadores de red podrán conectarse eligiendo Unirse en la pantalla de introducción tras indicar la IP o el nombre del servidor y el número de puerto. <screenshot>
  <screeninfo
>Diálogo unirse a una partida en red</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="joinnetgame.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Diálogo unirse a una partida en red</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para
>Cada conexión se indica por el mensaje siguiente en la barra de estado. <screenshot>
  <screeninfo
>Mensaje de conexión</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="justjoined.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Mensaje de conexión</phrase>
    </textobject>
  </mediaobject>
</screenshot>

</para>
<para
>Supongamos que mantiene todas las configuraciones predeterminadas y pulsa Aceptar. Entonces configurará los dos jugadores, uno tras otro. Para cada uno, elegirá un nombre, una nacionalidad y, si lo desea, configurar una contraseña de forma que nadie más pueda utilizar este jugador cuando vuelva a cargar esta partida si la guarda. Por último, especificará si este jugador lo utilizará la máquina o una persona. <screenshot>
  <screeninfo
>El diálogo de configuración del jugador</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="playersetupdialog.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>El diálogo de configuración del jugador</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
<para
>A continuación, si elige jugar con objetivo, se mostrará el objetivo para cada jugador local, precedido de un aviso que indica a los demás jugadores que estén utilizando la misma máquina que se giren discretamente mientras se muestra el objetivo. <screenshot>
  <screeninfo
>Diálogo mostrar objetivo</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="displaygoalmessage.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Diálogo mostrar objetivo</phrase>
    </textobject>
  </mediaobject>
</screenshot>
<screenshot>
  <screeninfo
>El mensaje de aviso en Mostrar objetivo</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="displaygoalwarningmessage.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>El mensaje de aviso en Mostrar objetivo</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</para>
</sect2>

<sect2 id="distribution">
<title
>Distribución</title>
<para
>Al inicio del juego, se distribuyen los países para todos los jugadores. Cada país contiene un ejército (representado por un soldado) en este momento. Cada jugador posee varios ejercitos para distribuir por sus paises y su turno (indicado por la presencia de su nombre y su bandera en la barra de estado). Tenga en cuenta que cinco ejércitos se representan por un hombre a caballo y 10 por un cañón. </para>
<para
>Para situar un ejército en uno de sus países, pulse sobre él con el botón izquierdo del ratón. Para eliminar un ejército, pulse con el botón derecho. Tenga en cuenta, que por regla general, no podrá eliminar más ejércitos que los que tenga situados. <screenshot>
  <screeninfo
>Situar ejércitos</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="placingarmies.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Situar ejércitos</phrase>
    </textobject>
  </mediaobject>
</screenshot>

</para>
<para
>Cuando un jugador haya distribuido todos sus ejercitos, se seleccionará automáticamente el siguiente jugador para que haga lo mismo. Cuando todos los jugadores hayan terminado de distribuido sus ejércitos, habrá dos posibilidades, que se podrán seleccionar con dos botones: <variablelist>
<varlistentry>
<term>
  <menuchoice>
    <guimenu>
      <inlinemediaobject>
        <imageobject>
          <imagedata fileref="distributionArmees.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Redistribución</phrase>
        </textobject>
      </inlinemediaobject
> : Redistribución </guimenu>
  </menuchoice>
</term>
<listitem>
  <para>
  <action
>Un jugador desea cambiar alguna de sus elecciones. El primer jugador puede eliminar uno de los ejércitos que acaba de colocar con el botón derecho del ratón y situar otro con el botón izquierdo del ratón. Cuando haya terminado, cederá el control al siguiente jugador con el botón «Siguiente jugador». Cuando todos los jugadores hayan terminado sus distribuciones, volverán a mostrarse los dos botones. </action>
  </para>
</listitem>
</varlistentry>
<varlistentry>
<term>
  <menuchoice>
    <guimenu>
      <inlinemediaobject>
        <imageobject>
          <imagedata fileref="distributionArmeesFinie.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Fin de la redistribución</phrase>
        </textobject>
      </inlinemediaobject
> : Fin de la redistribución </guimenu>
  </menuchoice>
</term>
<listitem
><para
><action
>Finaliza la redistribución y el juego puede continuar. </action
></para
></listitem>
</varlistentry>
</variablelist>

</para>
</sect2>

<sect2 id="fight">
<title
>Luchar</title>
<para
>Después de la redistribución, comienza un turno de juego. Cada jugador juega en su turno. Puede elegir entre: <variablelist>
  <varlistentry>
    <term>
      <menuchoice>
        <guimenu>
          <inlinemediaobject>
            <imageobject>
              <imagedata fileref="joueurSuivant.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase
>Siguiente jugador</phrase>
            </textobject>
          </inlinemediaobject
> : Cede el turno al siguiente jugador </guimenu>
      </menuchoice>
    </term>
    <listitem>
      <para>
        <action
>El turno del jugador finaliza y iniciándose el turno del siguiente. </action>
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term>
      <menuchoice>
        <guimenu>
          <inlinemediaobject>
            <imageobject>
              <imagedata fileref="attackOne.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase
>Atacar 1</phrase>
            </textobject>
          </inlinemediaobject>
&nbsp;<inlinemediaobject
> <imageobject
> <imagedata fileref="attackTwo.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Atacar 2</phrase
> </textobject
> </inlinemediaobject
> &nbsp;<inlinemediaobject
> <imageobject
> <imagedata fileref="attackThree.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Atacar 3</phrase
> </textobject
> </inlinemediaobject
> : Ataca con uno, dos o tres ejércitos<inlinemediaobject>
            <imageobject>
              <imagedata fileref="autoattack.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase
>Ataque automático</phrase>
            </textobject>
          </inlinemediaobject>
        </guimenu>
      </menuchoice>
    </term>
    <listitem>
      <para
>Para atacar, arrastre con el ratón desde el país atacante y suéltelo en el atacado. Se mostrará entonces un menú contextual mostrando las entradas anteriores. <screenshot
> <screeninfo
>Menú atacar</screeninfo
> <mediaobject
> <imageobject
> <imagedata fileref="attackmenu.png" format="PNG"/> </imageobject
> <textobject
> <phrase
>Menú atacar</phrase
> </textobject
> </mediaobject
> </screenshot
> Para que un país X ataque a un país Y con x ejércitos, se deben satisfacer 2 condiciones: 1. los dos países deben ser vecinos, 2. el país X debe tener al menos x+1 ejércitos antes de atacar. Si el ataque es válido, se muestra un diálogo si es necesario para que el defensor elija si desea defender con uno o dos ejércitos o deja que la máquina decida. </para>
      <para
>Cuando finaliza la elección del defensor, se producirá la lucha. Éste punto se describe a continuación. <screenshot>
            <screeninfo
>Diálogo defensa</screeninfo>
            <mediaobject>
              <imageobject>
                <imagedata fileref="defensedialog.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase
>Diálogo defensa</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
      </para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term>
      <menuchoice>
        <guimenu>
          <inlinemediaobject>
            <imageobject>
              <imagedata fileref="moveArmies.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase
>Mover ejércitos</phrase>
            </textobject>
          </inlinemediaobject
> :Mueve ejércitos de un país a otro </guimenu>
      </menuchoice>
    </term>
    <listitem>
      <para>
        <action
>Ésta es la última acción del turno de un jugador. Proporciona la posibilidad de mover algunos ejércitos de uno de sus países a otro, vecino del primero. Para elegir los dos países, arrastre y suelte de la misma forma que para atacar. Cuando se hayan elegido ambos países, aparecerá el grupo de botones «Mover ejércitos» (continúe leyendo para obtener una descripción de su uso). Tenga en cuenta que antes de que el usuario termine su movimiento, siempre puede cancelar pulsando el botón Cancelar. </action>
      </para>
    </listitem>
  </varlistentry>
</variablelist>
</para>
</sect2>
<sect2  id="fight-solution">
  <title
>Resolver la contienda</title>
  <para
>Para cada ejército en la contienda hay una tasa de muerte. El jugador que consiga el número más alto en el dado, ya sea el atancante o el defensor, gana y el que consiga el número más pequeño en los dados pierde ejércitos de acuerdo con el número obtenido en el dado. <screenshot>
            <screeninfo
>Mostrando el resultado del ataque</screeninfo>
            <mediaobject>
              <imageobject>
                <imagedata fileref="shownumberofarmies.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase
>Mostrando el resultado del ataque</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
  </para>
  <para
>Si el número de ejércitos del defensor llega a ser 0, el propietario de este país cambiará para pasar al atacante: su seleccionará su bandera y uno de sus ejércitos atacantes se instalará en este nuevo país. El deslizador «Mover ejércitos» se mostrará de la misma forma que los movimientos hasta el final del turno. <screenshot>
            <screeninfo
>Deslizador invasión</screeninfo>
            <mediaobject>
              <imageobject>
                <imagedata fileref="invasionslider.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase
>Deslizador invasión</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
  </para>
</sect2>
<sect2  id="end_of_turn">
  <title
>Fin del turno</title>
  <para
>Para finalizar su turno, si no desea mover ejércitos, puede pulsar el botón «Siguiente jugador» en la barra de herramientas. </para>
  <para
>Cuando juegan todos, el turno finaliza. Se distribuyen algunos ejércitos entre los jugadores, en función de los países que posea: 1 por cada grupo de tres países, con un mínimo de 3. También existen bonificaciones para los jugadores que poseen un continente completo, diferente para cada uno de ellos. Este bono es de: <table>
      <title
>Bonificaciones debidas a los continentes</title>
      <tgroup cols="2">
        <thead>
          <row
><entry
>Continente</entry
><entry
>Bonificaciones</entry
></row>
        </thead>
        <tbody>
          <row
><entry
>Norteamérica</entry
><entry
>5</entry
></row>
          <row
><entry
>Sudamérica</entry
><entry
>2</entry
></row>
          <row
><entry
>Europa</entry
><entry
>5</entry
></row>
          <row
><entry
>África</entry
><entry
>3</entry
></row>
          <row
><entry
>Asia</entry
><entry
>7</entry
></row>
          <row
><entry
>Área pacífica</entry
><entry
>2</entry
></row>
        </tbody>
      </tgroup>
    </table>
  </para>
  <para
>Cuando un jugador haya terminado de distribuir sus ejércitos, pulsará el botón «Siguiente jugador» para que el siguiente jugador pueda distribuir sus bonificaciones. Como en el caso de la distribución inicial, cuando todos los jugadores hayan situado sus ejércitos, cuantdo todos los jugadores hayan situado sus ejércitos, pueden volver a distribuirlos de forma cíclica o iniciar un turno nuevo... </para>
</sect2>
<sect2 id="sending-messages">
<title
>Enviar mensajes a los demás jugadores</title>
<para
>Si juega una partida local y desea comunicarse con los demás jugadores, bueno, hable con ellos (suponemos que no tendrá problemas de accesibilidad)... Pero si está jugando una partida en red, puede utilizar el marco de comunicaciones de la parte inferior de la ventana (puede mostrarlo u ocultarlo utilizando las flechas). No necesita más que escribir su mensaje y pulsar Entrar. <screenshot>
            <screeninfo
>Enviar mensajes</screeninfo>
            <mediaobject>
              <imageobject>
                <imagedata fileref="messagesent.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase
>Enviar mensajes</phrase>
              </textobject>
            </mediaobject>
          </screenshot>

</para>
</sect2>
</sect1>
</chapter>

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

<sect1 id="kapp-mainwindow">
<title
>La ventana principal de &kapp;</title>
<sect2>
<title
>Los botones</title>
<para>
<variablelist>
<varlistentry>
<term>
  <menuchoice>
    <guimenu>
      <inlinemediaobject>
        <imageobject>
          <imagedata fileref="quit.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Salir del juego</phrase>
        </textobject>
      </inlinemediaobject
> : Sale del juego </guimenu>
  </menuchoice>
</term>
<listitem
><para
><action
>Permite salir del programa. </action
></para
></listitem>
</varlistentry>
<varlistentry>
<term>
  <menuchoice>
    <guimenu>
      <inlinemediaobject>
        <imageobject>
          <imagedata fileref="newGame.png" format="PNG"/>
        </imageobject>
        <textobject>
          <phrase
>Juego nuevo</phrase>
        </textobject>
      </inlinemediaobject
> : Juego nuevo </guimenu>
  </menuchoice>
</term>
<listitem
><para
><action
>Inicia un juego nuevo. Mostrará un diálogo que pregunte el número de jugadores. Después, se preguntará su nombre a cada jugador a través de otro diálogo. </action
></para
></listitem>
</varlistentry>
</variablelist>
</para>

</sect2>

</sect1>
</chapter>

<chapter id="developers">
  <title
>Guía del desarrollador de &kapp;</title>
  
  <para
>Por favor, consulte la documentación de KDoc para obtener información sobre el API. Pienso que es bastante completa. Por el contrario lo comentarios son inexistentes en los archivos de impletación <filename
>.cpp</filename
>. </para>
  <para
>Tenga en cuenta que originalmente desarrollé este juego bajo Windows con Borland C++ y WinG. Lo porté a &Java; antes de volver a convertirlo a C++ y &kde;. Al principio utilicé el francés o una mezcla de francés e inglés para dar nombre a los identificadores (nombres de clases, métodos, miembros, &etc;). También utilicé el francés para los comentarios. Cuando decidí distribuir este juego, lo convertí todo al inglés... pero como se puede ver no soy inglés nativo: haga sugerencias y correcciones tanto de los comentarios del código como de su documentación y envíelas. </para>
  
</chapter>

<chapter id="skins">
  <title
>Crear pieles nuevas</title>
  <para
>Es posible cambiar totalmente la piel de KsirK. Para aquellos que tengan capacidades gráficas, crear una piel nueva le resultará sencillo ya que es tan sencilla como copiar una existente, editar o cambiar los gráficos y actualizar los datos en un archivo de configuración XML. El último paso es editar el archivo describiendo cómo instalarlo. </para>
  <para
>Todos los ejemplos (texto e imágenes) están tomados de la piel predeterminada de KsirK</para>
  <sect1 id="sdf">
    <title
>Estructura de carpetas y archivos</title>
    <para>
      <itemizedlist>
        <listitem>
          <para
>Data/ : Datos usados por el programa para manejar las imágenes de la piel. <itemizedlist>
              <listitem
><para
>Makefile.am : Describe como realizar la instalación.</para
></listitem>
              <listitem
><para
>onu.xml : Archivo principal que describe la piel. Consulte su descripción a continuación.</para
></listitem>
            </itemizedlist>
          </para>
        </listitem>
        <listitem>
          <para
>Images/ : Las imágenes de la piel (mapa, imágenes, etc.). <itemizedlist>
              <listitem
><para
>Makefile.am : Describe como realizar la instalación.</para
></listitem>
              <listitem
><para
>pool.svg: el mapa y todos los elementos gráficos utilizados en esta piel.</para
></listitem>
              <listitem
><para
>map-mask.png : La imagen que permite al programa encontrar el país sobre el que está el ratón durante el juego (continúe leyendo).</para
></listitem>
              <listitem
><para
>*.png : el resto de las imágenes son las de los botones.</para
></listitem>
            </itemizedlist>
          </para>
        </listitem>
        <listitem
><para
>Makefile.am/ : Describe cómo realizar la instalación.</para
></listitem>
        <listitem
><para
>Sons/ : archivos de sonido para la piel.</para
></listitem>
      </itemizedlist>
    </para>
  </sect1>
  <sect1 id="tdd">
    <title
>La carpeta de datos</title>
    <sect2>
      <title
>El archivo onu.xml</title>
      <para
>Éste archivo contiene una descripción del contenido de la piel. Se utiliza para describir la organización del mundo y cómo mostrarlo. Tiene la siguiente estructura: </para>
      <para
>Un grupo onu contiene un número de entradas de países, un número de entradas de nacionalidades y finalmente un número de entradas de continentes. Los diferentes grupos contienen la descripción de las diferentes elementos gráficos, la descripción de los diferentes países, continentes, nacionalidades y objetivos. </para>
      <para
>La siguiente sección describe el contenido de cada grupo. </para>
      <sect3>
        <title
>El grupo onu</title>
        <para>
          <table>
            <title
>Las entradas del grupo onu</title>
            <tgroup cols="2">
              <thead
><row
><entry
>Nombre de la entrada</entry
><entry
>Significado</entry
></row
></thead>
              <tbody>
                <row
><entry
>ancho</entry
><entry
>La anchura del mapa de la piel</entry
></row>
                <row
><entry
>height</entry
><entry
>La altura del mapa de la piel</entry
></row>
                <row
><entry
>ruta a la piel</entry
><entry
>La ruta de la piel respecto a la ruta de datos de la aplicación (p.ejem. skins/default)</entry
></row>
                <row
><entry
>nº países</entry
><entry
>El número de países (42 en la piel predeterminada). Debería ser igual que el número de etiquetas «country»</entry
></row>
                <row
><entry
>nº nacionalidades</entry
><entry
>El número de nacionalidades (6 en la piel predeterminada). Debería ser igual que el número de etiquetas «nationality»</entry
></row>
                <row
><entry
>nº continentes</entry
><entry
>El número de continentes (6 en la piel predeterminada). Debería ser igual que el número de etiquetas «continent»</entry
></row>
                <row
><entry
>pool</entry
><entry
>La ruta y el nombre del archivo «pool» respecto de la ruta de la piel (p. ejem. Imagenes/pool.svg)</entry
></row>
                <row
><entry
>máscara de mapa</entry
><entry
>La ruta y el nombre del archivo de la máscara del mapa respecto de la ruta de la piel (p. ejem. Images/map-mask.png)</entry
></row>
                <row
><entry
>versión del formato</entry
><entry
>La versión del formato del archivo de la piel (2.0)</entry
></row>
                <row
><entry
>name</entry
><entry
>El nombre que se muestra para la piel</entry
></row>
                <row
><entry
>descripción</entry
><entry
>La descripción larga de la piel</entry
></row>
                <row
><entry
>diferencia luchadores-bandera</entry
><entry
>La diferencia de altura entre las banderas y los elementos gráficos de los cañones</entry
></row>
                <row
><entry
>diferencia de anchura luchadores-bandera</entry
><entry
>El número de puntos entre el punto de la bandera situado más a la izquierda y el punto de un cañón simple situado más a la derecha (cuando no está disparando o explotando)</entry
></row>
              </tbody>
            </tgroup>
          </table>
        </para>
      </sect3>

      <sect3>
        <title
>Los grupos de descripción de los elementos gráficos</title>
        <para
>Cada tipo de elemento gráfico (bandera, infantería, caballería, cañón, cañón disparando y cañón explotando) se define en un grupo. Solo algunos elementos gráficos tienen una entrada anchura. Esta entrada se utiliza para realizar el posicionamiento relativo durante las animaciones, los cañones, disparando o explosionando no deberían «moverse» alrededor de la bandera del país durante la contienda. <table>
            <title
>Entradas del grupo de descripción del elemento gráfico</title>
            <tgroup cols="2">
              <thead
><row
><entry
>Entrada</entry
><entry
>Significado</entry
></row
></thead>
              <tbody>
                <row
><entry
>ancho</entry
><entry
>La anchura de referencia de los fotogramas del elemento gráfico de la bandera</entry
></row>
                <row
><entry
>height</entry
><entry
>La altura de referencia de los fotogramas del elemento gráfico de la bandera</entry
></row>
                <row
><entry
>fotogramas</entry
><entry
>El número de fotogramas del elemento gráfico</entry
></row>
                <row
><entry
>versiones</entry
><entry
>El número de versiones del elemento gráfico de la bandera</entry
></row>
              </tbody>
            </tgroup>
          </table>
        </para>
      </sect3>

      <sect3>
        <title
>Los grupos de descripción de los países</title>
        <para
>Cada país que se encuentra en el grupo onu, tiene su propio grupo cuya etiqueta es el nombre del país. La siguiente tabla lista las entradas de estos grupos. </para>
        <para>
          <table>
            <title
>Entradas del país</title>
            <tgroup cols="2">
              <thead
><row
><entry
>Nombre de la entrada</entry
><entry
>Significado</entry
></row
></thead>
              <tbody>
                <row
><entry
>id</entry
><entry
>El número entero de identificación único para el país, debería comenzar en cero (0)</entry
></row>
                <row
><entry
>name</entry
><entry
>El nombre mostrado para el país</entry
></row>
                <row
><entry
>&lt;elemento gráfico&gt;-punto</entry
><entry
>Cada tipo de elemento gráfico (bandera, infantería, etc.) en el país se muestra en una determinada posición definida en esta entrada formada par dos enteros separados por una coma</entry
></row>
                <row
><entry
>vecinos</entry
><entry
>La lista con los identificadores de los vecinos del país actual</entry
></row>
              </tbody>
            </tgroup>
          </table>
        </para>
      </sect3>

      <sect3>
        <title
>Los grupos de descripción de las nacionalidades</title>
        <para
>Cada nacionalidad listada en el grupo onu, tiene su propio grupo cuya etiqueta es el nombre de la nacionalidad. La siguiente tabla lista las entradas de estos grupos. </para>
        <para>
          <table>
            <title
>Entradas de nacionalidad</title>
            <tgroup cols="2">
              <thead
><row
><entry
>Nombre de la entrada</entry
><entry
>Significado</entry
></row
></thead>
              <tbody>
                <row
><entry
>name</entry
><entry
>El nombre de la nacionalidad (por ejem. Japón)</entry
></row>
                <row
><entry
>líder</entry
><entry
>El nombre que se propondrá para el jugador que elija esta nacionalidad</entry
></row>
                <row
><entry
>bandera</entry
><entry
>El nombre del elemento gráfico de la bandera del país en el archivo SVG de onu</entry
></row>
              </tbody>
            </tgroup>
          </table>
        </para>
      </sect3>

      <sect3>
        <title
>Los grupos de descripción de los continentes</title>
        <para
>Cada continente listada en el grupo onu, tiene su propio grupo cuya etiqueta es el nombre del continente. La siguiente tabla lista las entradas de estos grupos. </para>
        <para>
          <table>
            <title
>Entradas del continente</title>
            <tgroup cols="2">
              <thead
><row
><entry
>Nombre de la entrada</entry
><entry
>Significado</entry
></row
></thead>
              <tbody>
                <row
><entry
>name</entry
><entry
>El nombre del continente (por ejem. África)</entry
></row>
                <row
><entry
>id</entry
><entry
>El número entero de identificación única del continente</entry
></row>
                <row
><entry
>bonos</entry
><entry
>El número de ejércitos obtenidos al final del turno por el jugador propietario de todos los países de este continente</entry
></row>
                <row
><entry
>continente-países</entry
><entry
>La lista de todos los identificadores de los países dentro del continente actual</entry
></row>
              </tbody>
            </tgroup>
          </table>
        </para>
      </sect3>

      <sect3>
        <title
>Los grupos de descripción de los objetivos</title>
        <para
>Cada objetivo listado en el grupo onu, tiene su propio grupo cuya etiqueta es el nombre del objetivo. La siguiente tabla lista las entradas de estos grupos. </para>
        <para>
          <table>
            <title
>Entradas de objetivo</title>
            <tgroup cols="2">
              <thead
><row
><entry
>Nombre de la entrada</entry
><entry
>Significado</entry
></row
></thead>
              <tbody>
                <row
><entry
>tipo</entry
><entry
>El tipo de objetivo. Pueden ser continentes, países o un jugador</entry
></row>
                <row
><entry
>nºEjercitosPorPaís</entry
><entry
>establece el número mínimo de ejércitos que el jugador puede situar en cada país</entry
></row>
                <row
><entry
>nºPaíses</entry
><entry
>establece el número de países que el jugador debe poseer</entry
></row>
                <row
><entry
>nºPaísesAlternativos</entry
><entry
>Para un objetivo de tipo jugador, si el jugador objetivo es destruido por otro, establece el número de países que el jugador debe conquistar en su lugar</entry
></row>
                <row
><entry
>descripción</entry
><entry
>Una descripción de texto completa del objetivo con los correspondientes modificadores (se necesita más documentación aquí)</entry
></row>
                <row
><entry
>continentes</entry
><entry
>La lista de los identificadores de los continentes que el jugador tendrá que conquistar</entry
></row>
              </tbody>
            </tgroup>
          </table>
        </para>
      </sect3>

    </sect2>
  </sect1>
  <sect1 id="tid">
    <title
>La carpeta de las imágenes</title>
    <para
>Esta carpeta contiene los botones específicos para &kapp; y el archivo SVG pool que contiene el mapa y todos los elementos gráficos. </para>
    <sect2>
      <title
>El archivo pool.svg</title>
      <para
>Este archivo SVG contiene el mapa y todos los elementos gráficos del juego. Cada elemento tiene un nombre de forma que el juego puede seleccionar y presentar cada uno de ellos de forma separada. </para>
      <para
>En la piel predeterminada, los elementos gráficos son banderas, infantería, caballería y cañones. La infantería representa a un ejercito, cinco para la caballería y diez para los cañones. Los cañones también se utilizan para mostrar la contienda de los ejércitos. Esta es la razón por la que hay tres tipos de elementos gráficos de los cañones. normal estático o cañón moviéndose, disparando y explotando. </para>
      <para
>Cada imagen del elemento gráfico es la concatenación de varias vistas del objeto y para cada vista, de sus fotogramas. Las vistas se organizan verticalmente y los fotogramas horizontalmente. Para cortar la imagen en fotogramas individuales, ésta se divide por la altura de la imagen y el número de vistas, y la anchura por el número de fotogramas. Estos datos se encuentran en el archivo onu.desktop. <mediaobject
><imageobject
><imagedata fileref="cannon.png" format="PNG"/></imageobject
><caption
><para
>Un ejemplo de una imagen de un elemento gráfico: cannon.png</para
></caption
></mediaobject>
      </para>
      <para
>Para los elementos gráficos de los ejercitos, hay tres vistas diferentes, de arriba a abajo: vista a la derecha, vista a la izquierda y frente. Para las banderas, solo hay una vista. Todos los fondos de los elementos gráficos deberían ser transparentes. <mediaobject
><imageobject
><imagedata fileref="italy.png" format="PNG"/></imageobject
><caption
><para
>Un ejemplo de una imagen de un elemento gráfico de bandera: italy.png</para
></caption
></mediaobject>
      </para>
      <para>
      <table>
      <title
>Los elementos del «pool»</title>
      <tgroup cols="3">
      <thead
><row
><entry
>Nombre del elemento</entry
><entry
>Imagen de muestra</entry
><entry
>Significado</entry
></row
></thead>
      <tbody>
        <row>
          <entry
>map</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="map.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>Mapa del mundo de las pieles. Los países pueden tener formas arbitrarias, pero deben agruparse en continentes reconocibles a simple vista, por ubicación o por color</entry>
  </row>
        <row>
          <entry
>Italia</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="italy.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>La bandera de Italia. Hay una entrada para cada nación</entry>
  </row>
        <row>
          <entry
>infantería</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>caballería</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>cañón</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>disparando</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>explotando</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>Alaska</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>reddices</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
  </row>
        <row>
          <entry
>marca1</entry
><entry
><mediaobject
><imageobject
><imagedata fileref="" format="PNG"/></imageobject
></mediaobject
></entry
><entry
></entry>
        </row>
      </tbody>
      </tgroup>
      </table>
      </para>
    </sect2>
    <sect2>
      <title
>El archivo map-mask.png</title>
      <para
>Es un archivo png que representa también el mapa del mundo de las pieles, pero con códigos de color que permiten identificar de forma única cada país. Los paises deben tener al menos las mismas formas que los correspondientes países del archivo map.png de forma que los usuarios puedan pulsar en cualquier país visible y seleccionar el correcto. Los paises similares a las islitas de Indonesia en el mapa predeterminado pueden ser mayores que en el archivo equivalente map.png para facilitar la selección del país. <mediaobject>
          <imageobject
><imagedata fileref="map-mask.png" format="PNG"/></imageobject>
          <textobject
><phrase
>Un map-mask sencillo</phrase
></textobject>
        </mediaobject>
      </para>
      <para
>El componente azul (en el modelo RGB) del color de un país identifica el país: el índice 0 es el color 0 en el archivo onu.xml, el índice 1 es el país 1, &etc;. El color blanco (0xFFFFFF en RGB) identifica la ausencia de país (mares, o por que no, tierras de nadie). </para>
    </sect2>
    <sect2>
      <title
>Las imágenes de los botones</title>
      <para
>Los nombre de los archivos están incluidos directamente en el código y por eso no pueden modificarse. La tabla siguiente muestra todos los botones que debería proporcionarse.</para>
      <table>
      <title
>Los botones del &GUI;</title>
      <tgroup cols="3">
      <thead
><row
><entry
>Imagen</entry
><entry
>Nombre de archivo</entry
><entry
>Significado</entry
></row
></thead>
      <tbody>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="newNetGame.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>newNetGame.png</entry
><entry
>Intenta unirse a una partida en red</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="recycling.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>distributionArmees.png</entry
><entry
>Después de que todos los jugadores tenga situados sus ejércitos, es posible modificar las distribuciones (se llama reciclaje). Este botón pide que haga una redistribución</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="recyclingFinished.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>distributionArmeesFinie.png</entry
><entry
>Elije no redistribuir. Todas las ventanas de los clientes deberían tener este botón pulsado para finalizar realmente la distribución</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="nextPlayer.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>joueurSuivant.png</entry
><entry
>Finaliza el turno del jugador actual y cambia al siguiente o al siguiente turno si el jugador actual era el último</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="attackOne.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>attackOne.png</entry
><entry
>Elije iniciar un ataque con un ejército</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="attackTwo.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>attackTwo.png</entry
><entry
>Elije iniciar un ataque con dos ejércitos</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="attackThree.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>attackThree.png</entry
><entry
>Elije iniciar un ataque con tres ejércitos</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="defendOne.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>defendOne.png</entry
><entry
>Elije defender con un ejército un país atacado </entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="defendTwo.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>defendTwo.png</entry
><entry
>Elije defender con dos ejércitos un país atacado</entry>
        </row>
        <row>
          <entry
><mediaobject
><imageobject
><imagedata fileref="moveArmies.png" format="PNG"/></imageobject
></mediaobject
></entry
><entry
>moveArmies.png</entry
><entry
>Comienza el movimiento de los ejércitos entre dos países (última acción del turno)</entry>
        </row>
      </tbody>
      </tgroup>
      </table>
    </sect2>
  </sect1>
  <sect1 id="tsd">
    <title
>Las carpetas de sonidos</title>
    <para
>Esta carpeta contiene tres archivos de sonido: roll.wav jugado cuando los ejércitos se están moviendo, cannon.wav jugado cuando se está disparando y crash.wav cuando explosiona un cañón.</para>
  </sect1>
</chapter>

<chapter id="faq">
<title
>Preguntas y respuestas</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist"
> <qandaentry>
<question>
<para
>¿Cuál debería ser la primera pregunta referente a &ksirk;?</para>
</question>
 
</qandaentry>
</qandaset>
</chapter>

<chapter id="credits">

<!-- Include credits for the programmers, documentation writers, and
contributors here. The license for your software should then be included below
the credits with a reference to the appropriate license file included in the KDE
distribution. -->

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

<para
>&kapp; </para>
<para
>Derechos de autos del programa. 2002-2008 Gael de Chalendar <email
>kleag@free.fr</email
>. </para>
<para
>Colaboradores: Robin Doer, Albert Astals Cid, Michal Golunski (traducción al polaco). </para>

<para
>Derechos de autor de la documentación. 2002-2008 Gael de Chalendar <email
>kleag@free.fr</email
>. </para>

<para
>Traducido por Santiago Fernández Sancho <email
>santi@kde-es.org</email
>.</para
> 
&underFDL; &underGPL; </chapter>

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

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

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

<sect1 id="configuration">
<title
>Configuración</title>

<para
>La entrada del menú de preferencias abre un diálogo que le permite &nbsp;: <screenshot>
            <screeninfo
>Diálogo de preferencias</screeninfo>
            <mediaobject>
              <imageobject>
                <imagedata fileref="preferences.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase
>Diálogo de preferencias</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
</para>
      <itemizedlist>
        <listitem>
          <para
>activar o desactivar los sonidos&nbsp;, </para>
        </listitem>
        <listitem>
          <para
>establecer la velocidad de la animación (desde lenta hasta inmediata)&nbsp;, </para>
        </listitem>
        <listitem>
          <para
>activar o desactivar la ayuda contextual que se muestra en los menús emergentes&nbsp;, </para>
        </listitem>
        <listitem>
          <para
>Mostrar u ocultar el número de ejércitos de cada país. La siguiente captura de pantalla muestra el mapa en el se muestra el número de ejércitos. <screenshot>
              <screeninfo
>Muestra el número de ejércitos</screeninfo>
              <mediaobject>
                <imageobject>
                  <imagedata fileref="shownumberofarmies.png" format="PNG"/>
                </imageobject>
                <textobject>
                  <phrase
>Muestra el número de ejércitos</phrase>
                </textobject>
              </mediaobject>
            </screenshot>

          </para>
        </listitem>
      </itemizedlist>

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













