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

<title
>Instalação</title>

<para
>Este apêndice descreve principalmente a instalação do &kappname; no sistema operativo  &Linux;. A <link linkend="installation.nonlinux"
>secção final</link
> fala sobre os outros sistemas operativos. </para>

<sect1 id="installation.getting">
<title
>Como obter o &kappname;</title>

<!-- This first entity contains boiler plate for applications that are part of
     KDE CVS.  You should remove it if you are releasing your application.
     &install.intro.documentation; I don't think this will be correct until we
     move from extragear to the main section of KDE in the future. -->

<para
>Although &kappname; has existed for a number of years, we are still working on full integration into &kde;. Previous stable versions (1.0.x) required libraries from &kde; 3, and so were not available in most recent Linux distributions, which had already migrated to &kde; 4. However, with the release of version 4.5, &kappname; can now be easily compiled and installed on any version of &kde; 4.3 or higher. </para>
<para
>O resto desta secção irá descrever a instalação do &kappname; com o processo normal de instalação de aplicações na sua distribuição de Linux. A seguinte secção irá discutir a compilação a partir do código-fonte. </para>

<sect2 id="installation.distribution">
<title
>Pacotes de Distribuições Oficiais</title>
<para
>The best way to install &kappname; is to use the package manager of your distribution, such as apt-get, yum, portage, or pacman. This will take care of all the dependencies and required libraries. Although it will take some time after the release of this version for all the distributions to add &kappname; to their official repositories, please check there first. </para>
</sect2>

<sect2 id="installation.unsupported">
<title
>Repositórios Não-Suportados</title>
<para
>Muitas distribuições de Linux têm utilizadores que fornecem repositórios não-suportados mas que têm pacotes mais actualizados que os repositórios oficiais. Poderá encontrar uma lista destes na <ulink url="http://www.kmymoney.org"
>página Web do &kappname;</ulink
>. </para>
</sect2>

</sect1>

<sect1 id="installation.fromsource">
<title
>Compilar o &kappname; a Partir do Código</title>

<para
>Poderá encontrar informações mais actualizadas sobre a última versão disponível e sobre outros problemas de instalação na <ulink url="http://www.kmymoney.org"
>página Web do &kappname;</ulink
>. Essa página terá também referências para pacotes TAR de versões mais recentes, assim como instruções para obter o código a partir do SVN do KDE, no caso de querer compilar a última versão em desenvolvimento. </para>

<para
>As the previous paragraph implied, there are two distinct reasons to compile &kappname; from source. If you cannot find a version specifically packaged for your distribution, please download the tarball of the most recent stable release. This is version 4.5.0 as of the time this is being written. This is the compile option recommended for normal users. </para>

<para
>On the other hand, if you want to see the current state of development, to check out a recent bug fix or new feature, you can download a tarball which is a snapshot of the development repository. You can also check the source directly out of the repository. (The version 4.x source is in &kde; svn and the version 1.0.x source is in SourceForge cvs. Instructions for access are on the project home page.) </para>
<warning>
 <para
>The code in the repositories and in development snapshots is under active development: it may have bugs, it may crash, and it may mess up or lose data. If you use it, be absolutely sure to make adequate backups. Unless you have a good reason to use this, stick to a stable released version. </para>
</warning>

<para
>&kappname; depends on libraries from KDE version 4.3 or later, specifically kdelibs and kde PIM libs. You may need to explicitly load the <quote
>-devel</quote
> versions in order to compile &kappname;, rather then just running a pre-compiled version. Additional functionality can be obtained if extra libraries are available at compile time &ndash; see the web site for details. </para>

<para
>O &kappname; usa o sistema de compilação 'cmake'. Poderá encontrar mais informações no ficheiro 'README.cmake' na pasta de topo do código. Os passos básicos são os seguintes: </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
>Repare que o último passo é obrigatório. O &kappname; espera encontrar determinados componentes nas localizações-padrão e, caso execute o programa a partir da pasta de compilação, irá ter ícones em falta ou outras surpresas. </para
></important>

<para
>Se tiver compilado o código a partir do SVN, e quiser fiar com a última versão actualizada, na maior parte dos casos poderá fazer o seguinte: </para>

<simplelist>
<member
><command
>$ cd &lt;pasta de topo do código&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
>Contudo, as alterações feitas pelos programadores poderão provocar alguns problemas de compilação, caso não comece com uma base de código limpa. Nesses casos, irá querer fazer o seguinte: </para>

<simplelist>
<member
><command
>$ cd &lt;pasta de topo do código&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 o &kappname; sem o Linux</title>

<para
>O &kappname; foi compilado com sucesso no &MacOS; X e está disponível na <ulink url="http://www.macports.com"
>página Web MacPorts</ulink
>. </para>
<para
>&kappname; has also been reported to be available for &Windows;, but details were not available in time to include here. Please check the <ulink url="http://www.kmymoney.org"
>&kappname; home page</ulink
> for updated information.</para>
<para
>Se souber que o  &kappname; está a ser compilado com sucesso e disponibilizado noutro sistema operativo, comunique-nos, para que possamos passar a palavra. </para>

</sect1>
</appendix>