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

<title
>Installation</title>

<para
>Cet appendice s'adresse en priorité à l'installation de &kappname; sur le système d'exploitation &Linux;. La <link linkend="installation.nonlinux"
>dernière section</link
> aborde les autres systèmes d'exploitation. </para>

<sect1 id="installation.getting">
<title
>Comment obtenir &kappname;</title>

<para
>Même si &kappname; existe depuis de nombreuses années, nous travaillons toujours sur l'intégration complète à &kde;. Les précédentes versions stables (1.0.x) nécessitaient des librairies de &kde; 3, qui n'étaient donc pas disponibles sur les distributions Linux plus récentes ayant déjàmigré vers &kde; 4. Néanmoins, avec la sortie de la version 4.5, en août 2010, &kappname; pouvait être facilement compilé et installé sur toute version de &kde; supérieure ou égale à 4.3. La version 4.6 actuelle requiert quant à elle, la version 4.6 de &kde; en particulier pour les librairies kdelibs and kdepimlibs. </para>

<para
>Le reste de cette section décrira l'installation de &kappname; en utilisant le processus d'installation standard pour votre distribution Linux. La section suivante discutera de la compilation à partir des sources. </para>

<sect2 id="installation.distribution">
<title
>Paquets de distribution officiels</title>
<para
>La meilleure façon d'installer &kappname; est d'utiliser le gestionnaire de paquets de votre distribution, à savoir apt-get, yum, portage ou pacman. Il s'occupera de toutes les dépendances et librairies nécessaires. Même si celà prendra quelques temps après la sortie de cette version pour que toutes les distributions ajoutent &kappname; à leurs dépôts officiels, veuillez commencer par essayer cette méthode. </para>
</sect2>

<sect2 id="installation.unsupported">
<title
>Dépôts non gérés</title>
<para
>Beaucoup de distributions Linux disposent d'utilisateurs qui fournissent des dépôts non gérés qui proposent des paquets plus à jour que ceux des dépôts officiels des distributions. Une liste de ceux-ci peut être trouvée sur la <ulink url="http://www.kmymoney.org"
>page d'accueil de &kappname;</ulink
>. </para>
</sect2>
</sect1>

<sect1 id="installation.fromsource">
<title
>Compiler &kappname; depuis les sources</title>

<para
>Des informations plus à jour sur la dernière version disponible et les problèmes d'installation connus sont disponibles sur la <ulink url="http://www.kmymoney.org"
>page d'accueil de &kappname;</ulink
>. Cette page contient aussi des liens vers les archives des versions récentes ainsi que des instructions pour obtenir les sources depuis le dépôt Git de &kde;, au cas où vous voudriez compiler la dernière version de développement. </para>

<para
>Comme le paragraphe précédent l'impliquait, il y a deux raisons distinctes pour vouloir compiler &kappname; depuis les sources. Si vous ne pouvez pas trouver une version spécifiquement empaquetée pour votre distribution, veuillez télécharger l'archive de la dernière version stable disponible. C'est la version 4.6.0 au moment où ce texte est écrit. C'est l'option de compilation recommandée pour la majorité des utilisateurs. </para>

<para
>Néanmoins, si vous voulez voir le stade actuel de développement, pour télécharger une correction de bogue récente ou une nouvelle fonctionnalité, vous pouvez télécharger une archive qui est un instantané du dépôt de développement.Vous pouvez aussi télécharger les sources directement depuis le dépôt. (Les sources de la version 4.x sont sur le Git de &kde; (celles de la version 1.0.x sur le CVS de SourceForge mais ne sont plus maintenues.) Les instructions pour y accéder sont sur la page d'accueil du projet. </para>

<warning>
 <para
>Le code dans les dépôts Git et les instantanés de développement sont en développement actif : ils peuvent contenir des bogues, ils peuvent planter, et ils peuvent abîmer ou causer la perte de données. Si vous l'utilisez, soyez absolument sûr d'avoir les sauvegardes adéquates. A moins d'avoir une bonne raison de l'utiliser, contentez-vous d'une version stable. </para>
</warning>

<sect2
><title
>Librairies requises</title>
<para
>&kappname; dépend de certaines librairies pour être compilé et fonctionner normalement. Il s'agit tout d'abord des versions KDE 4.3.5 ou postérieures, en particulier les librairies kdelibs et kdepimlibs. Vous devrez peut-être installer explicitement les versions <quote
>-devel</quote
> de celles-ci afin de compiler &kappname;, au lieu de vous contenter d'une version précompilée. Depuis la version 4.6.0 &kappname; dépend également de libalkimia, version 4.3.1 ou postérieures. Des dépendances supplémentaires peuvent apparaître pendant l'étape <quote
>cmake</quote
> plus bas. </para>

<para
>Des fonctionnalités supplémentaires peuvent être obtenues si des librairies additionnelles sont disponibles au moment de la compilation. Les principales sont </para>

<itemizedlist>
<listitem>
  <para
>libofx, version 0.9.4 ou postérieure pour pouvoir importer les données financières dans le format OFX, et</para>
</listitem>

<listitem>
  <para
>AqBanking, version 5.0.0 ou postérieure pour être capable d'utiliser les fonctionnalités de finances en ligne. Notez qu'une version 5.0.14 ou postérieure est fortement recommandée à cause de bogues dans les versions précédentes.</para>
</listitem>
</itemizedlist>
</sect2>

<sect2
><title
>Instructions de construction</title>
<para
>&kappname; utilise le système de compilation cmake. Plus de renseignements peuvent être trouvés dans le fichier README.cmake disponible à la racine des sources. Les étapes de base sont les suivantes : </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
>Notez que la dernière étape est nécessaire. &kappname; s'attend à trouver certains composants à certains emplacements standards, et si vous le lancez depuis le dossier de compilation sans l'étape d'installation, il manquera des icônes ou vous aurez d'autres surprises. </para
></important>

<para
>Si vous avez compilé les sources depuis le git, et souhaitez mettre à jour vers la dernière version, la plupart du temps vous pouvez effectuez les étapes suivantes : </para>

<simplelist>
<member
><command
>$ cd &lt;emplacement des sources&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
>Néanmoins, les changements effectués par les développeurs peuvent parfois causer des problèmes à la compilation si vous ne démarrez pas avec une base de code propre. Dans ces cas, vous devrez faire ce qui suit : </para>

<simplelist>
<member
><command
>$ cd &lt;emplacement des sources&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
>Installer &kappname; sans Linux</title>

<para
>&kappname; a été compilé avec succès sur &MacOS; X, et est disponible sur le <ulink url="http://www.macports.com"
>site web de MacPorts</ulink
>. </para>
<para
>&kappname; a aussi été annoncé disponible sur &Windows;. Il s'agit toujours d'une action en cours et une information plus complète peut être obtenue sur la page <ulink url="http://windows.kde.org"
>KDE on Windows Initiative</ulink
>. </para>

<para
>Si vous avez connaissance de la compilation et l'installation réussie de &kappname; sur un autre système d'exploitation, faites-le nous savoir afin que nous puissions répandre la nouvelle. </para>

</sect1>
</appendix>
