<chapter id="installation">
<title
>Installation </title>

<epigraph>
<attribution
>Linus Torvalds, après avoir trouvé un de ses systèmes de fichiers détruit par un nouveau noyau Beta</attribution>
<para
>Les plantages de fsck ont tendance à me rendre nerveux</para>
</epigraph>

<para
>Ne vous inquiétez pas ! Bien que l'utilisation de logiciels en version Bêta puisse causer des désagréments considérables, il est très peu probable que l'installation de KDE détruise votre disque dur. En fait, ce chapitre est destiné à vous guider tout au long du processus d'installation de telle sorte que vous puissiez regarder votre nouveau bureau aussi vite que possible (et avec le moins de désagréments possible). Comme pour toutes les installations de nouveaux gestionnaires de fenêtres, il est recommandé d'enregistrer tous vos fichiers de configuration spécifiques à X11 avant de commencer l'installation. Si vous n'en connaissez pas l'emplacement exact, essayez tous les fichiers cachés (<filename
>.*</filename
>) de votre dossier personnel et le dossier <filename
>/usr/X11/lib/X11/xdm</filename
>. </para
> 

<sect1 id="requirements">
<title
>Configuration nécessaire </title>

<para
>Avant d'installer KDE, assurez-vous que votre système satisfait aux conditions suivantes : </para>

<itemizedlist>

<listitem
><para
>Un système POSIX compatible UNIX en état de marche. Les systèmes UNIX connus pour fonctionner avec KDE comprennent : Linux, FreeBSD, Solaris, HP-UX et MkLinux. Nous travaillons à rendre KDE bientôt disponible pour plus de plates-formes. </para
></listitem>

<listitem
><para
>De l'espace disponible sur votre disque dur sur la partition où <filename
>/opt/kde</filename
> sera créé. Nous vous recommandons de réserver environ 50 Mo si votre système supporte les bibliothèques partagées et beaucoup plus sinon. Si vous devez ou si vous voulez installer KDE depuis l'arborescence source, veuillez vous rappeler de réserver environ 100 Mo dans <filename
>/usr/src</filename
>.</para
></listitem>

<listitem
><para
>Un système X11 en fonctionnement avec ou sans <application
>xdm</application
>. Si vous n'avez pas déjà installé le système X, vérifiez d'abord si votre support d'installation UNIX ne contient pas une version installable. Si vous n'en trouvez pas, visitez <ulink url="http://www.xfree86.org"
>le site web XFree86 </ulink
> pour plus d'informations sur la manière d'obtenir et installer le système X Window ou contactez le service d'aide aux utilisateurs de votre revendeur UNIX. </para
></listitem>

<listitem
><para
>The &Qt; libraries, version 3.2 or higher. You can obtain these at <ulink url="ftp://ftp.trolltech.com/qt"
>Troll Tech's FTP Server</ulink
> in tgz format. </para>
</listitem>
</itemizedlist>

<warning
><para
>A warning before you start: Before upgrading from a previous version of &kde;, we recommend that you do the following:</para>

<screen
><command
>cd <filename
>/opt/kde</filename
></command
> 
<command
>tar <option
>cfvz <replaceable
>~/KDE-old-version-backup.tar.gz</replaceable
> * </option
></command
>
</screen>
</warning>

</sect1>

<sect1 id="linux-installing-rpms">
<title
>Linux : installer des RPM pour RedHat, Caldera et SuSE.</title>

<para
>Utiliser des RPM est la méthode la plus facile pour faire fonctionner KDE. Visitez simplement votre miroir KDE favori et le dossier <filename
>/pub/kde/stable/distribution/rpm</filename
>. Vous y trouverez les dossiers relatifs à différents systèmes d'exploitation. Actuellement, les architectures i386, alpha et sparc sont reconnues. Vous pouvez aussi trouver les paquetages rpm sur les sites qui contribuent à Red Hat comme sunsite.unc.edu ou ftp.redhat.com. </para>

<para
>Le système de base comprend les fichiers <filename
>kde-<replaceable
>composant</replaceable
>.<replaceable
>architecture</replaceable
>.rpm</filename
> Vous avez au minimum besoin de kdesupport, kdelibs et kdebase. Après avoir récupéré la distribution de base, n'hésitez pas à télécharger tout autre rpm dont vous pourriez avoir besoin. </para>

<para
>Puis commencez l'installation avec le paquetage base. Si vous installez KDE pour la première fois, utilisez </para>

<screen
><userinput
><command
>rpm</command
> <option
>-i</option
> <filename
>kdesupport.arch.rpm</filename
></userinput>
<userinput
><command
>rpm</command
> <option
>-i</option
> <filename
>kdelibs.arch.rpm</filename
></userinput>
<userinput
><command
>rpm</command
> <option
>-i</option
> <filename
>kdebase.arch.rpm</filename
></userinput
>
</screen>
 
<important
><para
>Il est important que ces composants soient installés dans l'ordre indiqué et qu'ils soient installés avant tout autre composant KDE.</para
></important>

<para
>Si vous mettez à jour une version précédente, faites <screen
><userinput
><command
>rpm</command
> <option
>-Uvh</option
> <filename
>kde-<replaceable
>composant</replaceable
>.<replaceable
>arch</replaceable
>.rpm</filename
></userinput
>
</screen>
</para>

<para
>Là encore, l'ordre donné ci-dessus doit être respecté et ces composants doivent être installés avant tout autre composant KDE.</para>

<para
>Ceci va décompacter la distribution de base et l'installer dans <filename
>/opt/kde</filename
>.</para>

<para
>Si l'installation des paquetages de base a été réussie, vous pouvez installer les autres composants de façon similaire (utilisez <option
>-Uvh</option
> au lieu de <option
>-i</option
> pour mettre à jour une version existante). </para>

</sect1>

<sect1 id="installing-debian">
<title
>Linux : installer des paquetages <acronym
>DEB</acronym
> pour Debian</title>

<para
>L'installation pour un système Debian est aussi plutôt directe. Vous trouverez seulement des paquetages KDE 2.0 pour Debian 2.2 (Potato) et 3.0 (Woody). Nous décrivons ici comment installer les paquetages pour Debian 2.2, la version stable, car Debian 3.0 est encore en développement. Cependant l'installation pour les deux versions est pratiquement identique. La différence principale est que KDE est officiellement inclus dans Debian 3.0 et vous n'avez donc pas besoin d'indiquer un endroit spécifique pour trouver les paquetages deb pour KDE.</para>

<para
>La première étape est de dire à votre système où il peut trouver les paquetages deb pour KDE. Une liste des lieux avec les paquetages Debian se trouve sur votre disque dur dans <filename
>/etc/apt/sources.list</filename
>. Vous devez ajouter à ce fichier la ligne suivante : <userinput
>http://kde.tdyc.com/ stable kde2</userinput
></para>

 
<para
>Puis vous devez mettre à jour la base de données locale de vos paquetages afin que le système sache que de nouveaux paquetages sont disponibles. Tapez les commandes suivantes :</para>

<screen
><userinput
><command
>apt-get</command
> <option
>update</option
></userinput
>
</screen>
 
<para
>Enfin, installez les composants de base de KDE en saisissant :</para>

<screen
><userinput
><command
>apt-get</command
> <option
>install kdebase</option
></userinput
>
</screen>
 
<para
>Si vous souhaitez installer d'autres composants, essayez certaines ou la totalité de ces options :</para>

<screen
><userinput
><command
>apt-get</command
> <option
>install task-kdenetwork</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdeadmin</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdetoys</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdeutils</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdemultimedia</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdegraphics</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdepim</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdegames</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-koffice</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install kdebase-docs</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install kdm</option
></userinput
>
</screen>

<para
>Vous voudrez peut-être aussi installer la traduction dans votre langue.</para>

<screen
><userinput
><command
>apt-get</command
> <option
>install
kde-i18n-<replaceable
>xx</replaceable
></option
></userinput
>
 </screen>
<para
>où <replaceable
>xx</replaceable
> doit être remplacé par le code de votre pays.</para>

<para
>Les fichiers de configuration de certaines applications KDE seront placées dans <filename class="directory"
>/etc/kde2</filename
>, les exécutables iront dans <filename class="directory"
>/usr/bin</filename
> et la plupart des fichiers auxiliaire ira dans <filename class="directory"
>/usr/share</filename
> dans différents dossiers. </para>

<para
>Si vous mettez à jour une version précédente de KDE, réalisez les étapes suivantes. Tout d'abord, mettez à jour le fichier <filename
>/etc/apt/sources.list</filename
> en changeant la ligne avec l'emplacement des paquetages de KDE par la ligne : <userinput
>http://kde.tdyc.com/ stable kde2</userinput
>. Ensuite, mettez à jour votre base de donnée de paquetages : </para>

<screen
><userinput
><command
>apt-get</command
> <option
>update</option
></userinput
>
</screen>
 
<para
>Enfin, installez le système de base de KDE :</para>

<screen
><userinput
><command
>apt-get</command
> <option
>install kdebase</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>dist-upgrade</option
></userinput
>
</screen>
 
<para
>Si vous souhaitez installer d'autres composants, essayez certaines ou la totalité de ces options :</para>

<screen
><userinput
><command
>apt-get</command
> <option
>install task-kdenetwork</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdeadmin</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdetoys</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdeutils</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdemultimedia</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdegraphics</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdepim</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-kdegames</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install task-koffice</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install kdebase-docs</option
></userinput>
<userinput
><command
>apt-get</command
> <option
>install kdm</option
></userinput
>
</screen>

</sect1>

<sect1 id="source-distribution">
<title
>Compiler les sources pour une installation optimale sur d'autres systèmes </title>

<para
>Si votre distribution ne fournit pas d'archives RMP ou DEB, ou si vous n'utilisez pas Linux du tout, vous devez compiler vous-même KDE. À l'avenir, nous pensons fournir une distribution de binaires qui contient son propre système d'installation. </para>

<para
>De façon à compiler et installer KDE proprement, les éléments suivants doivent être installés sur votre système : </para>

<itemizedlist>
<listitem
><para
>Un compilateur ANSI-C, par exemple le compilateur C <abbrev
>GNU</abbrev
>. </para
></listitem>
<listitem
><para
>Un compilateur ANSI-C++, par exemple <abbrev
>GNU</abbrev
> C++. </para
></listitem>
<listitem
><para
>L'utilitaire <application
>make</application
>. </para
></listitem>
<listitem
><para
>La version 2.2 de développement de Qt ou plus haut.</para
></listitem>
<listitem
><para
>La version de développement de X11 (les fichiers en-tête manquent souvent). </para
></listitem>
</itemizedlist>

<para
>Une fois que toutes les applications annexes sont disponibles, allez sur votre site miroir KDE préféré et récupérez les fichiers suivants dans le dossier <filename
>/pub/kde/stable/<replaceable
>(dernière version)</replaceable
></filename
> :</para>

<itemizedlist>
<listitem
><para
><filename
>kdesupport-<replaceable
>version</replaceable
>.tar.gz</filename
></para
></listitem>
<listitem
><para
><filename
>kdelibs-<replaceable
>version</replaceable
>.tar.gz</filename>
</para
></listitem>
<listitem
><para
><filename
>kdebase-<replaceable
>version</replaceable
>.tar.gz</filename
></para
></listitem>
<listitem
><para
>tout autre paquetage que vous souhaitez installer. Nous vous conseillons de prendre au moins kdeutils. </para
></listitem>
</itemizedlist>

<para
>Dans tous les cas, <replaceable
>version</replaceable
> remplace le numéro de la version courante. Une fois que vous avez téléchargé tout ce dont vous avez besoin, décompactez ces fichiers dans <filename
>/usr/src</filename
>. Ce processus doit conduire à l'arborescence de dossiers suivante :</para>

<itemizedlist>
<listitem
><para
><filename
>/usr/src/kdesupport</filename
></para
></listitem>
<listitem
><para
><filename
>/usr/src/kdelibs</filename
></para
></listitem>
<listitem
><para
><filename
>/usr/src/kdebase</filename
></para
></listitem>
<listitem
><para
><filename
>/usr/src/...</filename
> (tout autre paquetage)</para
></listitem>
</itemizedlist>

<para
>Assurez-vous d'avoir les droits en écriture dans <filename
>/opt/kde</filename
>.</para>

<para
>Ensuite, vous devez compiler et installer les paquetages en utilisant les commandes suivantes : </para>

<procedure>
<step
><para
><command
>cd</command
> dans le dossier du paquetage que vous voulez installer (voir ci-dessus)</para
></step>
<step
><para
><command
>./configure</command
> (avec les options que vous désirez appliquer)</para
></step>
<step
><para
><command
>make</command
></para
></step>
<step
><para
><command
>make install</command
></para
></step>
</procedure>

<para
>Appliquez les étapes ci-dessus à chaque paquetage que vous désirez installer.</para>

<note
><para
>Ces instructions peuvent être utilisées pour n'importe quel paquetage de fichiers sources existant, pas uniquement les paquetages KDE. </para
></note>

<para
>Every configure script has several options available. Some are common between the packages while others are specific to an individual package. The following is a small part of the result of <command
>configure <option
>--help</option
></command
> in kdelibs:</para>

<screen
><computeroutput>
 Installation directories:
  --prefix=PREFIX         install architecture-independent files in PREFIX
                          [/usr/local/kde-cvs]
...
Optional Features:
  --disable-FEATURE       do not include FEATURE (same as --enable-FEATURE=no)
  --enable-FEATURE[=ARG]  include FEATURE [ARG=yes]
  --disable-fast-perl     disable fast Makefile generation (needs perl)
  --enable-debug=ARG    enables debug symbols (yes|no|full) default=no
  --disable-debug         disables debug output and debug symbols default=no
  --enable-strict         compiles with strict compiler options (may not work!)
  --disable-warnings      disables compilation with -Wall and similiar
... 
</computeroutput
>
</screen>

<para
>Several options are not required and are only useful as work arounds for known problems (&eg; <option
>--disable-FEATURE</option
>). Since some are important options, for instance <emphasis
>--with-shadow</emphasis
>, you should always check the available options.</para>

<para
>An important option is <option
>--prefix</option
>. This option specifies the path where configure should install (for kdesupport and kdelibs) or where to look for libraries (for the other packages). By default, configure will look in <filename
>/usr/local/kde</filename
> . If you want to install &kde; into <filename
>/opt/kde</filename
>, you have to use <command
>configure <option
>--prefix /opt/kde</option
></command
>.</para>

<para
>If you have installed the &Qt; libraries in an uncommon place, for instance in <filename
>$HOME/src/qt</filename
>, you must use <command
>configure <option
>--with-qt-dir=$HOME/src/qt</option
></command
>. By default configure looks in the most common places for &Qt; before it gives up.</para>

<para
>Si vous avez des problèmes que vous ne réussissez pas à résoudre, envoyez une copie du fichier <filename
>config.log</filename
> à l'adresse se trouvant dans le fichier <filename
>README</filename
> dans le paquetage incriminé.</para>

<para
>You must install KDE in the following order: arts, kdelibs, then the application packages (for example kdebase). All the application packages should only depend on kdelibs, so you can compile them at the same time (if you have a powerful machine).</para>

<para
>Si vous voulez profiter de systèmes multiprocesseurs, essayez <command
>make <option
>-j<replaceable
>nombre de processeurs</replaceable
></option
></command
> à la place de <command
>make</command
>. </para>

<sect2>
<title
>Notes de construction spécifiques à chaque plate-forme. </title>

<sect3>
<title
>Linux </title>

<para
>For &Linux;, most of the utilities needed to build &kde; can be found either at <ulink url="ftp://sunsite.unc.edu/pub/Linux/GCC"
>ftp://sunsite.unc.edu/pub/Linux/GCC</ulink
> or <ulink url="ftp://sunsite.unc.edu/pub/GNU"
>ftp://sunsite.unc.edu/pub/GNU</ulink
>. The Qt libraries can be found at <ulink url="ftp://ftp.troll.no/pub/qt/source"
>ftp://ftp.troll.no/pub/qt/source</ulink
>, available as source code. Detailed instructions on how to install them are provided. Include files for X11 programs should be available at <ulink url="ftp://ftp.xfree86.org"
>ftp://ftp.xfree86.org</ulink
> in the xdevel section. </para>

</sect3>
</sect2>
</sect1>

<sect1 id="suse-install">
<title
>Changements nécessaires à vos fichiers de configuration </title>
<para
>Après avoir placé les exécutables KDE dans leur dossier de destination, il est nécessaire d'effectuer quelques modifications dans vos scripts de démarrage. </para>
<para
>La procédure suivante a été testée sur SuSE Linux 5.0, et devrait aussi être compatible avec les autres UNIX populaires. <emphasis
>Faites toujours des sauvegardes de vos fichiers de configuration avant de les modifier !</emphasis
> Ajoutez les lignes suivantes à la fin de votre /etc/profile : </para>
<para
> 
<screen
>export PATH=$PATH:/opt/kde/bin
export KDEDIR=/opt/kde
</screen>
 </para>
<para
>Puis éditez le fichier .xinitrc dans votre dossier personnel. Cherchez la ligne qui appelle votre gestionnaire de fenêtres et remplacez-la par <literal
>startkde</literal
>.</para>
<para
>Maintenant que tout ce qui est nécessaire à KDE a été installé, vous pouvez aller au chapitre 4 où vous démarrerez KDE pour la première fois. Si quelque chose ne va pas, vous devrez compiler KDE vous-même. Lisez <emphasis
><link linkend="source-distribution"
>Utiliser les sources pour installer sur d'autres systèmes</link
></emphasis
> pour plus d'informations. </para>
<para
>Nous avons fait passer autant que possible l'installation à l'épreuve des balles, vous ne devriez donc pas rencontrer de problème sérieux sauf si vous avez une configuration exotique. Si vous rencontrez des difficultés, n'hésitez pas à utiliser <link linkend="mailing-lists"
>les listes de diffusion KDE </link
>. </para>
</sect1>
</chapter>
<!--
Local Variables:
mode: sgml
sgml-omittag:nil
sgml-shorttag:t
sgml-namecase-general:t
sgml-general-insert-case:lower
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:0
sgml-indent-data:nil
sgml-parent-document:("index.docbook" "book" "chapter")
End:
-->