<!DOCTYPE book PUBLIC  "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
  <!ENTITY kappname "&kabalone;" -- this only *seems* redundant -->
  <!ENTITY % Spanish "INCLUDE">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % ents PUBLIC "-//KDE//ENTITIES Documentation V1.0//EN">
  %ents;
]>
<book lang="&language;">
<bookinfo>
<title>Manual de &kabalone;</title>
<authorgroup>
<author>
<firstname>Josef</firstname>
<surname>Weidendorfer</surname>
<affiliation><address><email>weidendo@informatik.tu-muenchen.de</email></address>
</affiliation>
</author>

<author>
<firstname>Philip</firstname>
<surname>Rodrigues</surname>
<affiliation><address><email>philip.rodrigues@libertysurf.co.uk</email></address>
</affiliation></author>

<othercredit role="reviewer">
<firstname>Lauri</firstname>
<surname>Watts</surname>
<affiliation><address><email>vampyr@atconnex.net</email></address></affiliation>
<contrib>Revisor</contrib>
</othercredit>

<othercredit role="translator">
<firstname>Pablo</firstname>
<othername>J.</othername>
<surname>Barneo González</surname>
<affiliation><address><email>pablob@nikhef.nl</email></address></affiliation>
<contrib>Traducción al español</contrib>
</othercredit>

</authorgroup>

<copyright>
<year>2000</year>
<holder>J Weidendorfer</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>14/12/2000</date>
<releaseinfo>1.06.00</releaseinfo>

<abstract><para>&kabalone; es un juego de mesa para KDE con capacidad para 
jugar en red.</para></abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>juego</keyword>
<keyword>abalone</keyword>
<keyword>linux</keyword>
</keywordset>
</bookinfo>

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

<para>&kabalone; es un simple juego de mesa de estrategia al que juegan
dos jugadores. Hay piezas rojas y amarillas por cada jugador. Empezando desde
una posición inicial en la que cada jugador tiene 14 piezas, se obtendran
movimientos hasta que uno de ellos haya expulsado 6 piezas del oponente
fuera del tablero.</para>

<para>El programa original se desarrolló in 1993 para DOS y Xlib puro. Para KDE
se ha reescrito por completo.</para>

<note><para>La idea del juego no es mia. Es un juego de mesa real que vende una
firma productora de juegos alemana (creo).</para></note>

</chapter>

<chapter id="reglas-del-juego">
<title>Reglas del juego</title>

<para>Las rojas siempre mueven primero.</para>
<para>Se permiten dos tipos de movimientos:</para>

<variablelist>
<varlistentry>
<term>Normal</term>
<listitem><para>Una, dos o tres de sus piezas en fila pueden moverse en una de
las 6 direcciones. También se permiten movimientos laterales.</para>

<para>Presione el botón <mousebutton>izquierdo</mousebutton> del ratón sobre la
primera pieza que desea mover. Entonces la pieza se marcará. Ahora arrastre el 
ratón en la dirección deseada. Si el movimiento es válido, el cursor cambiará a
una flecha en esa dirección y todas la piezas del movimiento se marcarán. Si 
este es el movimiento que usted quiere realizar, suelte el botón del ratón.</para>

<para>Los movimientos laterales se realizan de otra forma: para dos piezas
adyacentes pulse entre ambas y arrastre; para tres piezas pulse el botón
<mousebutton>central</mousebutton> del ratón sobre la pieza central. Si se
permite un movimiento lateral las piezas se marcarán. De lo contrario sólo la
pieza central se marca y usted realiza un movimiento normal.</para></listitem>
</varlistentry>

<varlistentry>
<term>Empujar</term>
<listitem><para>Se pueden empujar hasta un máximo de dos piezas del oponente que
estén en frente de sus propias piezas mientras el número de piezas que arrastre
sea mayor que el de las piezas del oponente. Eso significa que con tres de sus
piezas usted puede empujar una o dos del oponente y con dos piezas una.</para>

<para>
</para></listitem>
</varlistentry>
</variablelist>

<para>Si todavía no sabe de que va &kabalone;, mire una partida en la que el 
ordenador juega por ambos bandos. Despues de ejecutar &kabalone;, seleccione
<menuchoice><guimenu>Opciones</guimenu> <guisubmenu>El ordenador juega</guisubmenu>
<guimenuitem>Ambos</guimenuitem> </menuchoice> y empiece una nueva partida.</para>

</chapter>

<chapter id="la-interfaz-de-usuario">
<title>La interfaz con el usuario</title>

<para>Cómo realizar movimientos se explica en <link linkend="reglas-del-juego">
Reglas del Juego</link>. Los botones en la barra de herramientas tienen el 
mismo significado que las entradas en el menu <guimenu>Partida</guimenu>.</para> 


<sect1 id="menu-jugar">
<title>El Menu <guimenu>Partida</guimenu></title>

<variablelist>
<varlistentry>
<term>
<menuchoice>
<shortcut><keycombo action="simul">
<keycap>Ctrl</keycap><keycap>N</keycap></keycombo></shortcut>
<guimenu><accel>P</accel>artida</guimenu><guimenuitem><accel>N</accel>ueva Partida</guimenuitem>
</menuchoice>
</term>
<listitem><para><action>Empieza una nueva partida</action> incluso si actualmente
se está jugando otra.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycap>S</keycap></shortcut>
<guimenu><accel>P</accel>artida</guimenu><guimenuitem>Parar la
Bú<accel>s</accel>queda</guimenuitem>
</menuchoice>
</term>
<listitem><para>Cuando el ordenador está pensando, se interrumpe su meditación
y realiza el mejor movimiento que haya encontrado.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut><keycap>Pg Up</keycap></shortcut>
<guimenu><accel>P</accel>artida</guimenu><guimenuitem><accel>H</accel>acia Atrás</guimenuitem>
</menuchoice></term>
<listitem><para>Vuelva hacia atrás al movimiento anterior. <emphasis>Dos</emphasis> movimientos se dehacen: el movimiento del oponente y su último movimiento. 
Así que es su turno otra vez. Se recuerdan 100 movimientos; así que no dude en 
ir hacia atrás en los movimientos hasta que se encuentre al principio de la
partida (es más rápido con la tecla <keycap>Pg Up</keycap>). Cuando esté en el
modo Modificar (vea el Menú <menuchoice><guimenu>Editar</guimenu>
<guimenuitem>Modificar</guimenuitem> </menuchoice> más abajo), decrementa el
número del movimiento de esta posición.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycap>Pg Down</keycap></shortcut>
<guimenu><accel>P</accel>artida</guimenu><guimenuitem>A<accel>d</accel>elante</guimenuitem>
</menuchoice></term>
<listitem><para>Sólo es útil en el modo Modificar: <action>Incrementa el número
del movimiento de esta posición.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycap>H</keycap></shortcut>
<guimenu><accel>P</accel>artida</guimenu><guimenuitem><accel>C</accel>onsejo</guimenuitem></menuchoice></term>
<listitem><para><action>Se muestra un consejo para su próximo movimiento.</action>
Sólo es posible si juega en el nivel normal o superior, el número del movimiento
es 2 o mayor y no ha deshecho su movimiento.</para> </listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycap>N</keycap></shortcut>
<guimenu><accel>P</accel>artida</guimenu><guimenuitem><accel>R</accel>ed</guimenuitem>
</menuchoice></term>
<listitem><para>Si se selecciona esta opción, la aplicación está en Modo de 
Red. Todos los programas &kabalone; en ejecución que están en Modo de Red 
retransmiten cambios de posiciones entre ellos. De este modo dos humanos pueden
jugar entre ellos en ordenadores diferentes o uno puede observar la partida de
otro programa &kabalone;.</para>

<para>Para intercambiar posiciones, los programas &kabalone; tiene que conocerse
entre ellos. Si están ejecutándose en la misma máquina, no se necesita nada
(excepto seleccionar el Modo en Red). Si están ejecutándose en diferentes
ordenadores tiene que especificar las otras máquinas en la línea de comandos con
la opción <option>-h</option>.</para>

<para>Para privilegiados: &kabalone;, cuando está en Modo de Red, escucha en un
conector <acronym>TCP</acronym> comandos de cambio de posición de otros
programas &kabalone;. Usted puede especificar el número del puerto con la opción
<option>-p</option> en la línea de comandos. Necesita esto si quiere jugar dos
partidas &kabalone; diferentes en Red.</para>

<para>Ejemplos:</para>

<itemizedlist>
<listitem><para>Cristobal en <systemitem class="systemname">maquina1</systemitem>
y María en <systemitem class="systemname">maquina2</systemitem> quieren jugar el
uno contra el otro. María simplemente comienza &kabalone;, coloca la opción del
menu <menuchoice><guimenu>Opciones</guimenu> 
<guisubmenu>El ordenador juega</guisubmenu>
</menuchoice> a <guimenuitem>Ninguno</guimenuitem> y seleciona el Modo en Red.
Cristobal comienza &kabalone; con <userinput><command>kabalone</command> <option>-h
<replaceable>maquina2</replaceable></option></userinput>, sino hace lo mismo.
Ahora uno de los dos puede empezar la partida y mover con las rojas. Cada vez que
la posición cambia en un programa, automáticamente cambia tambien en el otro.</para> </listitem>

<listitem><para>Juan quiere observar la partida: hace lo mismo que Cristobal, pero
no hace ningún movimientos.</para></listitem>

<listitem><para>Dos partidas diferentes &kabalone; en red van a ejecutarse entre
las maquinas <systemitem class="systemname">m1</systemitem> y <systemitem
class="systemname">m2</systemitem>. Para distinguir las partidas, elejimos el
puerto número 12345 para una. En <systemitem class="systemname">m1</systemitem> 
empezamos como de contumbre <userinput><command>kabalone</command></userinput> 
y (no tan de costumbre) <userinput><command>kabalone</command> <option>-p
<replaceable>12345</replaceable></option></userinput>. En <systemitem
class="systemname">m2</systemitem> comenzamos
<userinput><command>kabalone</command> <option>-h
<replaceable>m1</replaceable></option></userinput> y
<userinput><command>kabalone</command> <option>-h
<replaceable>m1:12345</replaceable></option></userinput> (Los dos puntos 
separan anfitrión y puerto como en una <acronym>URL</acronym>).</para></listitem>

</itemizedlist>
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>Q</keycap></keycombo> </shortcut>
<guimenu><accel>P</accel>artida</guimenu><guimenuitem>Abandonar</guimenuitem>
</menuchoice>
</term>
<listitem><para><action>Abandona la partida.</action></para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="menu-editar">
<title>El menú <guimenu>Editar</guimenu></title>

<variablelist>

<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul"><keycap>Ctrl</keycap><keycap>C</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>ditar</guimenu><guimenuitem><accel>C</accel>opiar</guimenuitem>
</menuchoice>
</term>
<listitem><para>Copia una representación en ASCII de la posición actual del
tablero en el portapapeles. Ahora puede pegarla en cualquier editor de textos
pulsando allí el botón central del ratón.</para></listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap><keycap>V</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>ditar</guimenu><guimenuitem><accel>P</accel>egar</guimenuitem>
</menuchoice>
</term>
<listitem><para>Interpreta el contenido del portapapeles X como una 
representación en <acronym>ASCII</acronym> de un tablero &kabalone; para
colocar en el tablero la posición que corresponda. Una representación en 
<acronym>ASCII</acronym> válida se genera con <guimenuitem>Copiar</guimenuitem>.</para>

<para>De esta forma puede intercambiar posiciones del tablero de dos programas
&kabalone; pulsando <guimenuitem>Copiar</guimenuitem> en un programa y
<guimenuitem>Pegar</guimenuitem> en el otro, pero esto es mejor hacerlo con el 
Modo en Red(vea más arriba). Otro uso sería para salvar posiciones en un archivo
de texto (usando <guimenuitem>Copiar</guimenuitem> y un editor a su elección) 
y recuperar la posición más tarde seleccionándola en el editor y pulsando
<guimenuitem>Pegar</guimenuitem> en el programa &kabalone;.</para> </listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap><keycap>Ins</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>ditar</guimenu><guimenuitem><accel>M</accel>odificar</guimenuitem>
</menuchoice>
</term>
<listitem><para>Coloca &kabalone; en Modo de Modificación. Ahora puede editar
la posición actual del tablero añadiendo piezas rojas y amarillas o borrándolas.
La línea de estado muestra el número de piezas rojas y amarillas, el número de
movimientos, el bando que debe hacer el siguiente movimiento y si la posición es
válida: un signo de exclamación significa no, un símbolo de comprobación sí. ¡Si
la posición no es válida y vuelve al Modo de Juego normal, usted no puede jugar!.
Sólo se pueden usar posiciones válidas como posición inicial de una partida.
Comentario: si cambia a Modo en Red, la posición se retransmite cuando se vuelve
al Mode de Juego. <guimenuitem>Hacia atrás</guimenuitem> y
<guimenuitem>Adelante</guimenuitem> (en el menú <guimenu>Partida</guimenu>),
sólo incrementan o decrementan el número de movimientos, pero no cambian ninguna
pieza.</para>
	    
<para>Pulsando el botón <mousebutton>izquierdo</mousebutton> del ratón en una 
casilla amarilla o vacía, entra en modo <quote>Añadir pieza Roja</quote>;
pulsando el botón <mousebutton>central</mousebutton> en una casilla roja o vacía,
entra en modo <quote>Añadir pieza Amarilla</quote>. Finalmente pulsando el botón
<mousebutton>izquierdo</mousebutton> en una pieza roja o el botón
<mousebutton>central</mousebutton> en una pieza amarilla, entra en modo
<quote>Borrar Pieza</quote>. Mientras mantenga pulsado el botón del ratón y lo 
arrastre, usted actuará en todas y cada una de las casillas sobre las que pasa el
ratón. Termine la modificación soltando el botón del ratón.</para></listitem>
</varlistentry>


<varlistentry>
<term>
<menuchoice>
<shortcut><keycombo action="simul">
<keycap>Ctrl</keycap><keycap>S</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>ditar</guimenu><guimenuitem><accel>G</accel>uardar
Posición</guimenuitem>
</menuchoice></term>
<listitem><para>Puede guardar la posición actual y recuperarla más tarde con
<guimenuitem>Restaurar posición</guimenuitem>.</para></listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice>
<shortcut><keycombo action="simul"><keycap>Ctrl</keycap><keycap>O</keycap></keycombo></shortcut>
<guimenu><accel>E</accel>ditar</guimenu><guimenuitem><accel>R</accel>estaurar
Posición</guimenuitem>
</menuchoice></term>
<listitem><para>La posición es almacenada en el archivo de Configuración de
Abalone.</para></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="menu-configuracion">
<title>El Menú <guimenu>Configurar</guimenu></title>

<variablelist>
<varlistentry>
<term>
<menuchoice>
<guimenu><accel>M</accel>ostrar</guimenu><guimenuitem>Configurar
 Barra de <accel>M</accel>enús</guimenuitem>
</menuchoice></term>
<listitem><para>Muestra o esconde la Barra de Menús. La barra de menús se puede
retirar pulsando el botón <mousebutton>derecho</mousebutton> del ratón en la 
pantalla de juego y eligiendo <guisubmenu>Configuración</guisubmenu>.</para>
</listitem></varlistentry>

<varlistentry>
<term><menuchoice><guimenu><accel>M</accel>ostrar</guimenu><guimenuitem>
Configurar
Barra  de Herramientas</guimenuitem></menuchoice></term>
<listitem><para>Muestra o esconde el icono de la Barra de Herramientas.</para>
</listitem></varlistentry>

<varlistentry>
<term><menuchoice><guimenu><accel>M</accel>ostrar</guimenu><guimenuitem>
Configurar
Barra de Est<accel>a</accel>do</guimenuitem></menuchoice></term>
<listitem><para>Muestra o esconde la Barra de Estado.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu><accel>C</accel>onfigurar</guimenu><guimenuitem>
<accel>G</accel>uardar Configuración</guimenuitem></menuchoice></term>
<listitem><para>Guarda todas las opciones con su configuración actual.</para>
</listitem></varlistentry>

<varlistentry>
<term><menuchoice><guimenu><accel>C</accel>onfigurar</guimenu><guimenuitem>
Configurar Asociaciones de Teclas</guimenuitem></menuchoice></term>
<listitem><para>Abre un cuadro de diálogo &kde; estandar que le permite cambiar
las asociaciones de teclas de &kabalone;.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu><accel>C</accel>onfiguración</guimenu><guimenuitem>
Configurar Barra de Herramientas</guimenuitem></menuchoice></term>
<listitem><para>Abre un cuadro de diálogo &kde; estandar que le permite cambiar
la barra de herramientas de &kabalone;.</para></listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu><accel>C</accel>onfiguración</guimenu>
<guisubmenu><accel>N</accel>ivel</guisubmenu></menuchoice>
</term>
<listitem><para>El ordenador puede jugar a cuatro niveles diferentes. Esto 
influye en el número de movimientos que él busca por anticipado para calcular
el mejor movimiento. Usted puede interrumpir la búsqueda pulsando la tecla
<keycombo action="simul"><keycap>P</keycap></keycombo>. </para></listitem>
</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu><accel>C</accel>onfiguración</guimenu><guisubmenu>
El <accel>O</accel>rdenador Juega</guisubmenu></menuchoice>
</term>
<listitem><para>Usted puede hacer que el ordenador juegue con las 
<guimenuitem><accel>R</accel>ojas</guimenuitem>, las
<guimenuitem><accel>A</accel>marillas</guimenuitem> o por
<guimenuitem>A<accel>m</accel>bos</guimenuitem> bandos. Elija una de estas
opciones antes de empezar una nueva partida. Por supuesto, también funciona
en una partida si usted quiere intercambiar los bandos. Elija
<guimenuitem><accel>N</accel>inguno</guimenuitem> para jugar contra otro humano. 
Esto es muy útil en Modo de Red.</para></listitem>

</varlistentry>
<varlistentry>
<term>
<menuchoice>
<guimenu><accel>C</accel>onfiguración</guimenu><guimenuitem><accel>M</accel>over
Despacio</guimenuitem></menuchoice>
</term>
<listitem><para>Normalmente los movimientos realizados por el ordenador (cuando
esta opción está elegida) se muestran con un parpadeo y marcado de las piezas
usadas en ese movimiento. No elija esta opción si no quiere esperar a esta
animación: entonces sólo se hará un rápido marcado.</para> 
</listitem>
</varlistentry>

<varlistentry>
<term>
<menuchoice><guimenu><accel>C</accel>onfiguración</guimenu>
<guimenuitem><accel>R</accel>enderizar Bolas</guimenuitem>
</menuchoice></term>
<listitem><para>Si está elegida, las piezas son renderizadas in situ por un
simple trazador de líneas cuando sea necesario (<acronym>por ejemplo</acronym> 
cuando se reajusta el tamaño de la ventana).</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu><accel>C</accel>onfiguración</guimenu>
<guimenuitem>E<accel>s</accel>piar</guimenuitem>
</menuchoice></term>
<listitem><para>Si la opción <guimenuitem>Espiar</guimenuitem> está elegida: 
si es su turno, puede ver el tanteo del ordenador en el movimiento que quiere
jugar en la barra de estado. Si es el turno del ordenador puede ver 
(en la barra de estado y las piezas resaltadas) el movimiento que él piensa que
es el mejor. Por supuesto, esto cambia durante su búsqueda.</para> </listitem>
</varlistentry>
</variablelist>
</sect1>

<!-- This needs a help menu added at some stage -->

</chapter>

<chapter id="opciones-linea-comandos">
<title>Opciones en línea de comandos</title>

    <cmdsynopsis>
      <command>kabalone</command>
      <arg>-p MyNúmeroDePuerto</arg>
      <arg>-h anfitrión<arg>:Puerto</arg></arg>
    </cmdsynopsis>

<para>Con la opción <option>-p</option> se especifica el número del puerto del
conector TCP para escuchar en el Modo de Red.</para> 
<para>Con la opción <option>-h</option> se especifica un proceso &kabalone;
remoto (con número del puerto opcional, cuando no se usa el puerto predeterminado
en la máquina remota) con el que comunicar en Modo de Red. Se pueden especificar
múltiples procesos remotos.</para>

</chapter>

<chapter id="creditos-licencias">
<title>Créditos y Licencias</title>

<para>&kabalone;</para>

<para>Copyright del programa 1997-2000 Josef Weidendorfer
<email>weidendo@informatik.tu-muenchen.de</email></para>

<para>Documentation Original de Robert Williams
<email>rwilliams@kde.org</email> y Josef Weidendorfer</para>

<para>Documentación actualizada para KDE 2.0 por Philip Rodrigues <email>philip.rodrigues@libertysurf.co.uk</email></para>

<para>Traducción al español de Pablo J. Barneo González <email>pablob@nikhef.nl</email></para>


&underFDL;
&underGPL;

</chapter>

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

<sect1 id="consegir-kabalone">
<title>Cómo obtener &kabalone;</title>

<para>&kabalone; es parte del proyecto KDE <ulink
url="http://www.kde.org">http://www.kde.org</ulink>. Kabalone se puede encontrar
en el paquete kdegames en <ulink
url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, 
el principal servidor ftp del proyecto KDE.</para>

<para>Todas las librerías necesarias también se pueden encontrar en <ulink
url="ftp://ftp.kde.org">El servidor FTP de KDE</ulink>.</para>

<sect2 id="compilacion">
<title>Compilación e Instalación</title>

<para>Para poder compilar e instalar &kabalone; en su sistema, escriba lo
siguiente en el directorio &kabalone; en la distribución kdegames:</para>

<screen width="40">
<prompt>%</prompt> <command>./configure</command> 
<prompt>%</prompt> <command>make</command> 
<prompt>%</prompt> <command>make <option>install</option></command> </screen>

<para>Como &kabalone; usa <application>autoconf</application> y
<application>automake</application> no debería tener problemas compilándolo.
En caso de que se vea en problemas, por favor informe de ellos al <ulink
url="mailto:weidendo@informatik.tu-muenchen.de">autor</ulink>.</para>

</sect2>
</sect1>
</appendix>


</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
