<?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
>Dispondrá de información más actualizada sobre la última versión disponible y los problemas de instalación conocidos en la <ulink url="http://www.kmymoney.org"
>página web de &kappname;</ulink
>. Esta página también tendrá enlaces a los paquetes tar de las versiones recientes así como instrucciones para obtener el código fuente desde el repositorio Git de &kde;, en el caso de que desee compilar la versión de desarrollo más reciente. </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 del desarrollo para revisar una corrección reciente de un error o una funcionalidad nueva, puede descargar un paquete tar, que no es más que una instantánea del repositorio de desarrollo. También puede revisar directamente el código fuente del repositorio. El código fuente de la versión 4.x está en el repositorio Git de &kde;. (El código fuente de la versión 1.0.x está en el repositorio cvs de SourceForge, pero su desarrollo se encuentra descontinuado.) Las instrucciones para el acceso están en la página principal del proyecto. </para>

<warning>
 <para
>El código que se encuentra en el repositorio Git y en las instantáneas de desarrollo se encuentra bajo desarrollo activo: puede tener errores, puede fallar y puede estropear o extraviar datos. Si lo utiliza, asegúrese totalmente de hacer las copias de respaldo adecuadas. Salvo que tenga una buena razón para usar esta versión, manténgase en una versión estable. </para>
</warning>

<sect2
><title
>Librerías requeridas</title>
<para
>&kappname; depende de ciertas librerías para poder ser compilado y ejecutado correctamente. La primera es KDE versión 4.3.5 o posterior; concretamente kdelibs y kdepimlibs. Dependiendo de su distribución, puede que sea necesario cargar explícitamente las versiones <quote
>-devel</quote
> para poder compilar &kappname;, en lugar de simplemente ejecutar una versión precompilada. A partir de la versión 4.6.0, &kappname; también depende de libalkimia, version 4.3.1 o superior.Los requisitos adicionales se pueden detectar durante el siguiente paso de <quote
>cmake</quote
>. </para>

<para
>Se pueden obtener funcionalidades adicionales si ciertas librerías extra se encuentran disponibles en tiempo de compilación. Las dos más comunes son </para>

<itemizedlist>
<listitem>
  <para
>libofx, versión 0.9.4 o superior, para poder importar datos financieros en formato OFX, y</para>
</listitem>

<listitem>
  <para
>AqBanking, versión 5.0.0 o superior, para poder utilizar ciertas capacidades de banca en línea. Tenga en cuenta que se recomienda encarecidamente la versión 5.0.14 o superior, debido a errores en versiones anteriores.</para>
</listitem>
</itemizedlist>
</sect2>

<sect2
><title
>Instrucciones de construcción</title>
<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 fuente desde git, y desea actualizar a la última revisión, la mayor parte 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
>$ git pull --rebase</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
>$ git pull --rebase</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>
</sect2>
</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>
