<?xml version="1.0" encoding="UTF-8"?>
<appendix id="installation">
<appendixinfo>
  <authorgroup>
    <author
>&Jack.H.Ostroff; &Jack.H.Ostroff.mail;</author>
  </authorgroup>
  <date
>2011-07-20</date>
  <releaseinfo
>4.6</releaseinfo>
</appendixinfo>

<title
>Instalación</title>

<para
>Este apéndice está enfocado principalmente a la instalación de &kappname; bajo el sistema operativo &Linux;. La <link linkend="installation.nonlinux"
>sección final</link
> trata de otros sistemas operativos. </para>

<sect1 id="installation.getting">
<title
>Cómo obtener &kappname;</title>

<para
>Aunque &kappname; existe desde hace algunos años, aún estamos trabajando en la integración completa con &kde;. Las versiones estables anteriores (1.0.x) requerían librerías de &kde; 3, y ya no estaban disponibles en las versiones de Linux más recientes, que habían migrado a &kde; 4. Sin embargo, con el lanzamiento de la versión 4.5 en agosto de 2010, &kappname; se puede compilar e instalar fácilmente en cualquier versión de &kde; 4.3 o superior.La versión actual, 4.6, requiere &kde; 4.3, específicamente kdelibs y kdepimlibs. </para>

<para
>El resto de esta sección describirá la instalación de &kappname; usando el proceso estándar de instalación de software para su distribución Linux. La siguiente sección tratará de la compilación desde las fuentes. </para>

<sect2 id="installation.distribution">
<title
>Paquetes oficiales de la distribución</title>
<para
>La mejor manera de instalar &kappname; es usar el gestor de paquetes de su distribución, como apt-get, yum, portage o pacman. Esto se encargará de todas las dependencias y librerías requeridas. Aunque añadir &kappname; a los repositorios oficiales de todas las distribuciones llevará algún tiempo, por favor compruebe esto primero. </para>
</sect2>

<sect2 id="installation.unsupported">
<title
>Repositorios no admitidos</title>
<para
>Muchas distribuciones Linux tienen usuarios que proporcionan repositorios sin supervisar que ofrecen paquetes más actualizados que los de los repositorios oficiales de la distribución. Se puede encontrar una lista de éstos en la <ulink url="http://www.kmymoney.org"
>&kappname; home page</ulink
>. </para>
</sect2>
</sect1>

<sect1 id="installation.fromsource">
<title
>Compilar &kappname; desde las fuentes</title>

<para
>Está disponible una información más actualizada de la última versión disponible y de problemas de instalación conocidos en la <ulink url="http://www.kmymoney.org"
>página principal de &kappname;</ulink
>. Esta página también tendrá enlaces a tarballs de versiones recientes, además de instrucciones para obtener el código fuente desde KDE SVN, en el caso de que quiera compilar la versión más reciente en desarrollo. </para>

<para
>Como da a entender el párrafo anterior, hay dos razones distintas para compilar &kappname; desde las fuentes. Si no puede encontrar una versión de los paquetes específica para su distribución, por favor descargue el tarball de la versión estable más reciente. Éste es la versión 4.6.0 en el momento de escribir esto. Es la opción de compilación recomendada para los usuarios normales. </para>

<para
>Por otra parte, si desea ver el estado actual de desarrollo para comprobar la solución de un problema o alguna característica nueva, puede descargarse un tarball que es una instantánea del repositorio de desarrollo. También puede comprobar la fuente directamente del repositorio. (El código fuente de la versión 4.x está en &kde; svn, y el código fuente de la versión 1.0.x está en SourceForge cvs. Las instrucciones para el acceso están en la página principal del proyecto). </para>

<warning>
 <para
>El código de los repositorios svn y en las instantáneas de desarrollo están bajo un desarrollo activo; puede tener errores, puede fallar y puede trastocar o perder datos. Si lo utiliza, asegúrese totalmente de hacer copias de respaldo adecuadas. Salvo que tenga una buena razón para usar esto, manténgase en una versión estable. </para>
</warning>

<para
>&kappname; depende de librerías de KDE versión 4.3 o superior; específicamente kdelibs y kdepimlibs. Puede necesitar descargar explícitamente las versiones <quote
>-devel</quote
> para compilar &kappname;, más que hacer funcionar una versión precompilada. Se pueden obtener funciones adicionales hay disponibles librerías extra en el momento de compilar &ndash; vea la página web para más detalles. </para>

<para
>&kappname; usa el sistema cmake. Se puede encontrar más información en el archivo README.cmake en la carpeta raíz de la fuente. Los pasos básicos son los siguientes: </para>

<simplelist>
<member
><command
>$ mkdir build</command
></member>
<member
><command
>$ cd build</command
></member>
<member
><command
>$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr/</command
></member>
<member
><command
>$ make</command
></member>
<member
><command
>$ sudo make install/fast</command
></member>
</simplelist>

<important
><para
>Tenga en cuenta que se requiere el último paso. &kappname; espera encontrar ciertos componentes en ubicaciones estándar, y si lo hace funcionar desde el directorio de compilación sin el paso de instalación, tendrá iconos que faltan u otras sorpresas. </para
></important>

<para
>Si ha compilado el código desde svn y desea actualizarlo a la última revisión, la mayoría de las veces puede hacer lo siguiente: </para>

<simplelist>
<member
><command
>$ cd &lt;ruta hacia la raíz de la fuente&gt;</command
></member>
<member
><command
>$ svn update</command
></member>
<member
><command
>$ cd build</command
></member>
<member
><command
>$ make</command
></member>
<member
><command
>$ sudo make install/fast</command
></member>
</simplelist>

<para
>Sin embargo, los cambios hechos por los desarrolladores a veces causan problemas de compilación si usted no empieza con una base de código limpia. En estos casos, necesitará hacer lo siguiente: </para>

<simplelist>
<member
><command
>$ cd &lt;ruta hacia la raíz de la fuente&gt;</command
></member>
<member
><command
>$ svn update</command
></member>
<member
><command
>$ rm -r build</command
></member>
<member
><command
>$ mkdir build</command
></member>
<member
><command
>$ cd build</command
></member>
<member
><command
>$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr/</command
></member>
<member
><command
>$ make</command
></member>
<member
><command
>$ sudo make install/fast</command
></member>
</simplelist>
</sect1>

<sect1 id="installation.nonlinux">
<title
>Instalar &kappname; sin Linux</title>

<para
>&kappname; se ha compilado con éxito para &MacOS; X y está disponible en la <ulink url="http://www.macports.com"
>web de MacPorts</ulink
>. </para>
<para
>Se ha informado de que &kappname; también está disponible para &Windows;. Esta iniciativa todavía está en desarrollo, y se puede encontrar más información en la página <ulink url="http://windows.kde.org"
>Iniciativa KDE en Windows</ulink
>. </para>

<para
>Si sabe si &kappname; ha sido compilado con éxito y está disponible para cualquier otro sistema operativo, por favor háganoslo saber para que podamos comunicarlo. </para>

</sect1>
</appendix>