<?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
>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>

<!-- 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
>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à été migrées vers &kde; 4. Néanmoins, avec la sortie de la version 4.5, &kappname; peut maintenant être facilement compilé et installé sur toute version de &kde; supérieure ou égale à 4.3. </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 supportés</title>
<para
>Beaucoup de distributions Linux disposent d'utilisateurs qui fournissent des dépôts non-supportés qui proposent des paquets plus à jour que ceux des dépôts oficiels 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 SVN 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 paquetée pour votre distribution, veuillez télécharger l'archive de la dernière version stable disponible. C'est la version 4.5.3 au moment où ce texte est écrit. C'est l'option de compilation recommendé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 bug récente ou une nouvelle fonctionnalité, vous pouvez télécharger une archive qui est un instantanné 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 svn de &kde; et celles de la version 1.0.x sur le CVS de SourceForge. Les instructions pour y accéder sont sur la page d'accueil du projet.) </para>
<warning>
 <para
>Le code dans les dépôts et les instantannés de développement sont en développement actif : ils peuvent contenir des bugs, 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>

<para
>&kappname; dépend de librairies des versions KDE 4.3 ou postérieures, en particulier les librairies kdelibs et kde PIM. 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. Des fonctionnalités supplémentaires peuvent être obtenues si des librairies supplémentaires sont disponibles au moment de la compilation &ndash; consultez le site web pour plus de détails. </para>

<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 suviantes : </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 svn, 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;chemin vers les sources&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
>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;chemin vers les sources&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
>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;, mais les détails n'étaient pas disponibles à temps pour être inclus ici. Vérifiez la <ulink url="http://www.kmymoney.org"
>Page d'accueil de &kappname;</ulink
> pour des informations à jour.</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>