<?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
>Installazione</title>

<para
>Questa appendice si riferisce in modo particolare all'installazione di &kappname; usando il sistema operativo &Linux;. L'<link linkend="installation.nonlinux"
>ultima sezione</link
> riguarda gli altri sistemi operativi. </para>

<sect1 id="installation.getting">
<title
>Come ottenere &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
>Nonostante &kappname; esista da vari anni, stiamo ancora lavorando per un'integrazione completa in &kde;. Le versioni stabili precedenti (1.0.x) richiedevano librerie di &kde; 3, e quindi non erano disponibili nelle distribuzioni Linux più recenti, che sono già migrate a &kde; 4. Invece, con il rilascio della versione 4.5, &kappname; può adesso essere compilato ed installato facilmente usando &kde; 4.3 o successivi. </para>
<para
>Il resto di questa sezione descrive l'installazione di &kappname; usando il processo standard di installazione per la tua distribuzione Linux. La sezione successiva tratta invece la compilazione dai sorgenti. </para>

<sect2 id="installation.distribution">
<title
>Pacchetti ufficiali della distribuzione</title>
<para
>Il modo migliore di installare &kappname; è di usare il gestore dei pacchetti della tua distribuzione, come apt-get, yum, portage o pacman. In questo modo verranno gestite in automatico le dipendenze e le librerie richieste. Nonostante possa passare un po' di tempo dal rilascio di questa versione all'aggiunta all'aggiunta di &kappname; nei repository ufficiali di tutte le distribuzioni, è sempre meglio controllare. </para>
</sect2>

<sect2 id="installation.unsupported">
<title
>Repository non supportati</title>
<para
>Molte distribuzioni Linux hanno repository non supportati, forniti da utenti, che offrono pacchetti più aggiornati dei repository ufficiali della distribuzione. Si può trovare una lista di questi repository nel <ulink url="http://www.kmymoney.org"
>sito di &kappname;</ulink
>. </para>
</sect2>

</sect1>

<sect1 id="installation.fromsource">
<title
>Compilazione di &kappname; dai sorgenti</title>

<para
>Si possono trovare informazioni più aggiornate sull'ultima versione disponibile e sui problemi di installazione conosciuti nel <ulink url="http://www.kmymoney.org"
>sito di &kappname;</ulink
>. Ci sono i collegamenti agli archivi con le versioni più recenti, e anche le istruzioni per ottenere i sorgenti dall'SVN di KDE, nel caso che tu voglia compilare l'ultima versione di sviluppo. </para>

<para
>Come si poteva intuire dal paragrafo precedente, ci sono due possibili ragioni per voler compilare &kappname; dai sorgenti. Se non riesci a trovare una versione pacchettizzata per la tua distribuzione, scarica l'archivio della versione stabile più recente. Al momento della scrittura di questo manuale, l'ultima versione è la 4.5.0. Questa è la versione consigliata per i normali utenti. </para>

<para
>Invece, se vuoi vedere lo stato corrente dello sviluppo, per controllare una nuova funzione o la correzione di un bug, puoi scaricare un archivio con i file del repository di sviluppo. Puoi anche ottenere i sorgenti direttamente dal repository. (I sorgenti delle versioni 4.x sono nell'svn di &kde; e i sorgenti delle versioni 1.0.x sono nel cvs di SourceForge. Puoi trovare le istruzioni di accesso sono nel sito principale.) </para>
<warning>
 <para
>Il codice nei repository e negli archivi di sviluppo è in fase di sviluppo: potrebbe contenere bug, andare in crash, e potrebbe danneggiare o perdere dati. Se lo usi, sii assolutamente sicuro di fare copie di sicurezza adeguate. A meno di non avere una buona ragione per usare questo, usa la versione stabile. </para>
</warning>

<para
>&kappname; dipende da librerie di KDE, varsione 4.3 o successiva, in particolare kdelibs e le librerie KDE PIM. Potresti dover caricare esplicitamente le versioni <quote
>-devel</quote
> per compilare &kappname;, invece di eseguire semplicemente una versione pre-compilata. Installando altre librerie si possono avere funzioni aggiuntive &ndash; visita il sito web per maggiori informazioni </para>

<para
>&kappname; usa il sistema di compilazione cmake. Si possono trovare maggiori informazioni nel file README.cmake presente nella cartella principale dei sorgenti. I comandi base sono i seguenti: </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
>Fa attenzione: l'ultimo passo è necessario. &kappname; si aspetta di trovare certe componenti in posizioni standard, e se lo si esegue dalla cartella di compilazione senza installarlo, ci possono essere icone mancanti o altre sorprese. </para
></important>

<para
>Se hai compilato i sorgenti da svn, e vuoi aggiornarli all'ultima revisione, la maggior parte delle volte puoi fare: </para>

<simplelist>
<member
><command
>$ cd &lt;cartella principale dei sorgenti&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
>Comunque, a volte i cambiamenti fatti dagli sviluppatori producono dei problemi di compilazione se non si parte con una cartella di compilazione nuova. In questi casi, è necessario eseguire i seguenti comandi: </para>

<simplelist>
<member
><command
>$ cd &lt;cartella principale dei sorgenti&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
>Installazione di &kappname; senza Linux</title>

<para
>&kappname; è stato compilato con successo per &MacOS; X ed è disponibile nel <ulink url="http://www.macports.com"
>sito MacPorts</ulink
>. </para>
<para
>Ci e stato segnalato che &kappname; è disponibile anche per &Windows; ma i dettagli non sono arrivati in tempo per essere inclusi qui. Visita il <ulink url="http://www.kmymoney.org"
>sito di &kappname;</ulink
> per informazioni più aggiornate.</para>
<para
>Se sai che &kappname; è stato compilato con successo e reso disponibile per un altro sistema operativo, faccelo sapere, così possiamo diffondere la notizia. </para>

</sect1>
</appendix>
