# Manuel de &kpackage;

Toivo Pedaste

    toivo@ucs.uwa.edu.au

Lauri Watts

    lauri@kde.org

Relecteur
&traducteurGerardDelafond; &relecteurLudovicGrossard;
2000 Toivo Pedaste
&FDLNotice;
2002-10-08
3.0.8

&kpackage; est une interface graphique aux gestionnaires de paquetages RPM, Debian, Slackware et BSD.

kpackage paquetage gestionnaire de paquetages RPM deb

## Introduction

&kpackage; est une interface graphique aux gestionnaires de paquetages RPM, Debian, Slackware et BSD. &kpackage; fait partie de l'environnement de bureau K et, par conséquent, est conçu pour s'intégrer au gestionnaire de fichiers de &kde;.

## Généralités sur la fenêtre principale

&kpackage; est constitué de deux zones. La zone de gauche affiche une arborescence des paquetages installés et disponibles, la zone de droite affiche des informations sur les paquetages.

### La fenêtre principale - Arborescence des paquetages

Quand &kpackage; démarre normalement (c'est-à-dire qu'il n'a pas été appelé par glisser-déposer et n'a pas reçu de paramètre), il affiche deux zones, avec l'arborescence des paquetages à gauche. Cette arborescence montre les paquetages installés et en option les paquetages nouveaux et mis à jour en plus.

Panneau de gauche de &kpackage;
Panneau de gauche - Arborescence des paquetages

Panneau de gauche - Arborescence des paquetages

La zone de gauche affiche la liste des paquetages, les onglets en haut déterminent les paquetages qui seront affichés.

- Installés - Montre les paquetages installés

- Mis à jour - Affiche les paquetages pour lesquels des versions plus récentes sont disponibles

- Nouveaux - Montre les paquetages non installés

- Tous - Tous les paquetages

En dessous des onglets se situe la ligne de Recherche, qui filtre l'arborescence des paquetages afin de n'afficher que les noms ou les résumés correspondant à la chaîne saisie.

L'arborescence des paquetages est basée sur les sections de la distribution et affiche les informations résumées à propos des paquetages :

- Paquetage - Nom du paquetage

- Sélectionné - Affiche une coche si le paquetage a été marqué. Le marquage permet d'installer ou de désinstaller en une seule fois de multiples paquetages en utilisant les boutons situés en dessous de l'arborescence des paquetages.

- Résumé - Une brève description du paquetage.

- Taille - La taille du paquetage

- Version - La version du paquetage

- Ancienne version - Si le paquetage met à jour un paquetage déjà installé, la version de l'ancien paquetage

Les paquetages ont des libellés graphiques pour indiquer leur état : une image représente le type de paquetage indique un paquetage installé, un N indique un paquetage disponible et un U indique un paquetage qui peut mettre à jour un paquetage déjà installé.

Un simple paquetage est sélectionné en cliquant sur le nom. Un clic sur le point dans la colonne Sélectionné marque le paquetage avec une puce, un second clic enlève la marque, alors qu'un clic &Maj;bouton gauche peut servir à ajouter et à supprimer des marques sur une plage de paquetages. et un clic &Ctrl;bouton gauche peut servir à ajouter et à supprimer des marques sur plusieurs paquetages.

La sélection d'un paquetage dans l'arborescence affiche les informations qui le concernent dans le panneau de droite.

### La fenêtre principale - Le panneau d'information sur les paquetages

Le panneau de droite a des onglets pour afficher trois types différents d'informations sur les paquetages sélectionnés

- Fenêtre de droite de &kpackage; - Les propriétés
  Fenêtre de droite - Les propriétés des paquetages

  L'onglet Propriétés, qui affiche les informations sur le paquetage sélectionné. Dans les informations de dépendance, il y a des hyperliens vers les paquetages listés ; les paquetages installés sont en polices standard, ceux non installés mais disponibles sont en italique et les dépendances qui ne sont pas disponibles sont en texte normal.

- Fenêtre de droite de &kpackage; - Les propriétés
  Fenêtre de droite - Les fichiers du paquetage

  L'onglet Liste des fichiers affiche les fichiers du paquetage et, pour les paquetages installés (sous réserve que les informations soient disponibles) affiche l'état des fichiers. Les fichiers, qui existent, sont marqués avec une coche, ceux qui sont manquants sont marqués avec une croix.

- Fenêtre de droite de &kpackage; - Les propriétés
  Fenêtre de droite - Les fichiers du paquetage

  L'onglet Journal des modifications (Change Log) affiche le journal des changements du paquetage.

### Installation des paquetages

Pour installer un paquetage, vous pouvez

- localiser le paquetage que vous voulez installer dans &konqueror;, le déplacer et le déposer sur une copie en marche de &kpackage;

- cliquer sur un fichier de paquetage dans &konqueror; et lancer une nouvelle copie de &kpackage;

- utiliser l'élément de menu Ouvrir dans &kpackage;

- sélectionner un paquetage disponible dans l'arborescence des paquetages.

Pour un paquetage sélectionné, utilisez les boutons dans le panneau de droite. Le bouton Rechercher cherchera un paquetage dans une source distante et affichera les informations détaillées. Le bouton Installer ouvre une fenêtre d'installation.

Pour les paquetages marqués, utilisez le bouton Installer les paquetages sélectionnés dans le panneau de gauche, qui affiche une fenêtre d'installation.

Boîte de dialogue d'installation de &kpackage;
Boîte de dialogue d'installation

Boîte de dialogue d'installation

La fenêtre d'installation liste les paquetages à sélectionner à installer dans une zone en haut à gauche, si APT de Debian est utilisé, les paquetages nécessaires pour satisfaire les dépendances sont aussi affichés. En dessous, il y a un ensemble de cases à cocher qui définissent les options du programme d'installation. Pour les paquetages RPM, les options sont :

- Mise à jour - Mettra à jour tous les paquetages déjà installés.

- Remplacer les fichiers - Installera les paquetages, même s'ils remplacent des fichiers provenant d'autres paquetages déjà installés.

- Vérifier les dépendances - Vérifie les dépendances.

- Tester - N'installe pas

Pour APT Debian, les options sont :

- Télécharger uniquement - va chercher les paquetages mais ne les installe pas.

- Ne pas télécharger - Utilise uniquement les paquetages qui sont disponibles localement

- Ignorer les paquetages manquants - Installe même si certains paquetages sont manquants

- Ignorer les blocages - Ignore les blocages qui ont été placés sur ces paquetages

- Répondre toujours oui - Répond oui pour toutes les questions que le programme d'installation posera.

- Tester - N'installe pas

Le bouton Installer démarre l'installation en cours. Normalement, la fenêtre d'installation sera enlevée après une installation réussie, mais si la case Garder cette fenêtre est cochée, la fenêtre restera affichée.

La zone sur la droite est une fenêtre de terminal intégrée, terminal dans lequel les programmes d'installation s'exécuteront. Pour les programmes d'installation interactifs, les interactions se feront dans cette fenêtre.

### Désinstallation des paquetages

Un paquetage sélectionné peut être désinstallé en utilisant le bouton Désinstallation dans la zone de droite. Le bouton Désinstallation des paquetages sélectionnés dans la zone de droite peut être utilisé pour désinstaller des paquetages sélectionnés. Le bouton affiche la fenêtre de désinstallation.

Boîte de dialogue d'installation de &kpackage;
Boîte de dialogue de désinstallation

Boîte de dialogue de désinstallation

Le bouton Désinstallation dans la fenêtre provoque la désinstallation des paquetages à désinstaller et le panneau de droite fournit une fenêtre de terminal intégrée pour les programmes de désinstallation.

Pour les paquetages RPM, les options sont :

- Utiliser les scripts - Exécute tous les scripts de desinstallation

- Vérifier les dépendances - Vérifie les dépendances.

- Tester - N'installe pas

Pour APT Debian, les options sont :

- Purge les fichiers de configuration - Supprime tous les fichiers de configuration du paquetage.

- Répondre toujours oui - Répond oui pour toutes les questions que le programme d'installation posera.

- Tester - N'installe pas

### Intégration des paquetages disponibles dans l'arborescence

L'accès aux paquetages disponibles est configuré par les entrées du menu Emplacement pour chaque type de paquetage sous le menu Configuration.

Boîte de dialogue d'installation de &kpackage;
Panneau de manipulation des paquetages

Panneau de manipulation des paquetages

La partie supérieure du panneau contient la zone Machine distante qui permet à &kpackage; d'agir sur un paquetage d'une machine distante, cette fonctionnalité nécessite `ssh` et n'est disponible qu'avec Debian apt. Le nom de l'ordinateur distant est saisi dans la liste combinée et &kpackage; y accédera lorsque la case à cocher Utiliser la machine distante est sélectionnée.

Le reste du panneau permet l'activation et la désactivation de diverses types de paquetage que &kpackage; peut manipuler. Si un type de paquetage est activé, le bouton Emplacement des paquetages fera apparaître une boîte de dialogue pour configurer l'emplacement des paquetages disponibles.

Boîte de dialogue d'installation de &kpackage;
Boîte de dialogue d'emplacement des RPM

Boîte de dialogue d'emplacement des RPM

Pour les paquetages RPM, &kpackage; peut lire un dossier contenant des paquetages et les ajouter à l'arborescence comme paquetages nouveaux ou mis à jour. Il est possible d'examiner ou d'installer ces paquetages depuis l'arborescence. Par défaut, les informations sur ces paquetages sont extraites dans le format standard des noms de fichiers et ainsi il est nécessaire d'utiliser le bouton Examiner pour voir sa description complète, bien qu'il soit possible de positionner une option de telle manière que pour les dossiers locaux, chaque fichier de paquetage soit lu, ce qui est plus lent, mais donne une description complète.

La boîte de dialogue des emplacements des RPM permet de spécifier les dossiers contenant les paquetages RPM. Elle est divisée en un certain nombre d'onglets pour la commodité de manipulation. Chaque ligne dans le panneau correspond à un dossier, si la case Utiliser est cochée, le dossier est utilisé, sinon il est ignoré. Le champ de saisie peut contenir soit un chemin vers un dossier, soit une URL `ftp`. La case à cocher Sous-dossiers détermine si les sous-dossiers sont analysés pour trouver les paquetages. Le bouton ... affiche une boîte de dialogue de sélection de dossier.

Boîte de dialogue d'installation de &kpackage;
Boîte de dialogue d'emplacement apt Debian

Boîte de dialogue d'emplacement apt Debian

APT : Debian signifie que des paquetages Debian sont gérés en utilisant la commande `deb-apt` qui peut aller chercher automatiquement des paquetages sur des dépôts et résoudre des dépendances.

L'emplacement des dépôts de paquetages non installés peut être configuré dans le panneau « A », qui est utilisé dans le fichier `/etc/apt/sources.list` qui contrôle les emplacements où `deb-apt` recherche les paquetages. Chaque entrée correspond à une ligne du fichier. Si la caseUtiliser n'est pas cochée, la ligne est commentée.

Le panneau « D » permet de spécifier les dossiers contenant les paquetages Debian.

Boîte de dialogue d'installation de &kpackage;
Boîte de dialogue d'emplacement de Debian DPKG : panneaux E et P

Boîte de dialogue d'emplacement de Debian DPKG : panneaux E et P

DPKG : Debian signifie que les paquetages sont manipulés par la commande `dpkg`, il y a trois manières d'accéder aux paquetages disponibles, qui peuvent être choisies dans trois types différents de panneaux de configuration d'emplacement.

- Le panneau « I » spécifie l'emplacement de l'arborescence des paquetages Debian et sélectionne la distribution et l'architecture. &kpackage; cherchera dans les emplacements standard les fichiers de paquetages qui décrivent les paquetages disponibles, ces paquetages sont alors ajoutés à l'arborescence, et peuvent être examinés ou installés

- Le panneau « P » spécifie l'emplacement de la distribution Debian avec les fichiers de `paquetages` pour les parties de la distribution qui ont un intérêt. Si le programme `dselect` est utilisé, le fichier `/var/lib/dpkg/available` peut être alors être utilisé comme un fichier de `paquetages` qui décrit la distribution que `dselect` utilise.

- Le panneau « D » spécifie les dossiers qui sont gérés de la même manière que les paquetages RPM.

Boîte de dialogue d'installation de &kpackage;
Boîte de dialogue d'emplacement Slackware

Boîte de dialogue d'emplacement Slackware

Pour les paquetages Slackware, il y a peu d'informations stockées sur les paquetages installés, mais il est possible d'utiliser un fichier `PACKAGES.TXT` comme source d'informations sur les paquetages installés. Le fichier `PACKAGE.TXT` est l'équivalent d'un fichier de paquetages Debian et les distributions Slackware sont structurées avec une arborescence qui contient les paquetages `.tgz` et un fichier `PACKAGES.TXT` qui décrit les paquetages.

Comme avec les distributions Debian, les paquetages dans une distribution Slackware peuvent être intégrés dans l'arborescence. Malheureusement, les paquetages Slackware ne comportent pas d'information de version, ainsi il est impossible de dire quels paquetages sont nouveaux par rapport à ceux installés.

- Le panneau « I » est l'emplacement d'un fichier `PACKAGES.TXT` qui est utilisé pour fournir les informations sur les paquetages installés

- Les panneaux « P » peuvent être utilisés pour spécifier l'emplacement de distributions avec l'arborescence de dossiers contenant les fichiers `.tgz` et l'emplacement du fichier `PACKAGES.TXT` correspondant

- Les panneaux « D » sont pour les dossiers qui n'ont pas de fichier`PACKAGES.TXT` correspondant

Boîte de dialogue d'installation de &kpackage;
Boîte de dialogue d'emplacement BSD

Boîte de dialogue d'emplacement BSD

Pour les paquetages BSD, &kpackage; comprendra un dossier de paquetages de distribution qui contient un fichier `INDEX` (qui décrit tous les paquetages) et contient aussi un dossier `Tous` (contenant tous les fichiers de paquetages).

Le panneau « Ports » donne l'emplacement de l'arborescence des ports dans le système de fichiers

Le panneau « Paquetages » permet de spécifier l'emplacement des dossiers de paquetages, c'est-à-dire ceux qui contiennent des fichiers `INDEX`

Pour les dossiers distants et les fichiers de paquetages (c'est-à-dire ceux cherchés par &FTP;), &kpackage; utilise un cache, les paquetages étant mis en cache dans `~/.kpackage` et les dossiers dans `~/.kpackage/dir`.

Pour que la manipulation des dossiers distants (&FTP;) fonctionne, il peut être nécessaire de ne pas avoir le Proxy FTP positionné dans la configuration du navigateur.

### Chercher

#### Ligne de recherche de paquetage

Ligne de recherche de &kpackage;
Ligne de recherche de paquetage

Ligne de recherche

La ligne de recherche filtre l'arborescence des paquetages afin que seuls ceux dont le nom ou le résumé contient la chaîne de recherche soient affichés.

#### Chercher un paquetage

Chercher un paquetage avec &kpackage;
Chercher un paquetage

Chercher un paquetage

La boîte de dialogue Chercher un paquetage cherche le nom des paquetages dans l'arborescence des paquetages et se déplace sur le paquetage correspondant suivant. Si Sous-chaîne n'est pas coché, il ne cherchera que les correspondances exactes des noms des paquetages. Si Recherche cyclique n'est pas coché, la recherche ne reprendra pas au début de l'arborescence des paquets lorsque la fin sera atteinte.

#### Chercher un fichier

Cherche un fichier avec &kpackage;
Chercher un fichier

Chercher un fichier

La boîte de dialogue Cherche un fichier permet de chercher des fichiers dont le nom contient la chaîne cherchée. Les colonnes de l'affichage sont :

- Installés - coché s'il s'agit d'un paquetage installé.

- Paquetage - le type du paquetage

- Paquetage - le nom du paquetage

- Nom du fichier - le nom du fichier correspondant

Seuls les fichiers dans les paquetages installés sont montrés, à moins que Chercher aussi dans les paquetages désinstallés (apt-file doit être installé) ne soit coché. Ceci ne fonctionnera qu'avec les paquetages Debian APT, et uniquement s la commande `apt-file` est installée. La base de donnée utilisée par la commande `apt-file` est mise à jour à partir de l'élément de menu Mettre à jour Apt-file.

### Divers

#### Accès root

&kpackage; a besoin d'un accès root pour installer et désinstaller les paquetages, ce qui peut être fait en lançant &kpackage; en tant que root, par exemple en utilisant &kdesu;.

Alternativement, si &kpackage; est lancé en tant qu'utilisateur normal, il essayera de lancer les programmes d'installation / désinstallation comme root en ouvrant un pseudoterminal utilisant soit `su`, soit `ssh` pour faire ceci et, si besoin, il ouvrira une fenêtre de terminal où l'on peut saisir le mot de passe root. Pour que ceci fonctionne, l'invite de root doit avoir la terminaison #.

#### Glisser - déposer

&kpackage; utilise le protocole de glisser-déposer de &kde;. Cela veut dire que vous pouvez tirer des paquetages vers &kpackage; pour les ouvrir. En relâchant un fichier sur la boîte de dialogue Rechercher un fichier, vous lancerez une recherche du paquetage qui contient ce fichier.

## Menus

Ceci décrit les menus de &kpackage;.

### Menu Fichier

Les éléments du menu Fichier sont :

&Ctrl;O Fichier Ouvrir

  Ouvre un sélecteur de fichiers pour les fichiers locaux et &FTP;

Fichier Récemment ouvert(s)

  Une liste des fichiers de paquetages les plus récemment ouverts

&Ctrl;F Fichier Rechercher un Paquetage...

  Cherche un paquetage dans la liste des paquetages installés contenant la chaîne saisie

Fichier Rechercher un Fichier...

  Produit une liste de paquetages qui contiennent le nom du fichier saisi. La sélection d'une ligne affichera les informations sur ce paquetage. Le comportement est légèrement différent pour RPM (où vous devez écrire le nom exact du fichier) et DEB (où vous pouvez saisir une expression rationnelle).

F5 Fichier Recharger

  Relit les données des paquetages et en reconstruit l'arborescence

&Ctrl;Q Fichier Quitter

  Ferme &kpackage;

### Menu Paquetages

Les éléments du menu Paquetages sont :

&Alt;gauche Paquetages Précédent

  Bouton de retour arrière pour la navigation en utilisant les liens dans les entrées de Propriétés du panneau de droite.

&Alt;droite Paquetages Suivant

  Bouton d'avance rapide pour la navigation en utilisant les liens dans les entrées de Propriétés du panneau de droite.

Paquetages Développer l'arborescence

  Développe complètement l'arborescence des paquetages

Paquetages Refermer l'arborescence

  Replie l'arborescence des paquetages de manière à ne montrer que la structure de l'arborescence.

Paquetages Effacer la sélection

  Démarque tous les paquetages

Paquetages Tout sélectionner

  Sélectionne tous les paquetages qui font partie de la vue sélectionnée

Paquetages Installer

  Installe le paquetage en cours de sélection

Paquetages Installer les paquetages sélectionnés

  Installation de tous les paquetages sélectionnés

Paquetages Désinstaller

  Désinstalle le paquetage en cours de sélection

Paquetages Désinstaller les paquetages sélectionnés

  Désinstallation de tous les paquetages sélectionnés

### Menu Cache

Les éléments du menu Cache sont :

Cache Vider le dossier de cache pour les paquetages

  Supprime les copies en cache des dossiers de paquetages distants et des fichiers de paquetages

Cache Vider le cache pour les paquetages

  Supprime les copies en cache des fichiers de paquetages distants qui ont été cherchés

### Menu Spécial

Le menu Spécial contient des actions relatives à des types de paquetages spécifiques :

Spécial Debian apt
  Actualiser

    Met à jour les index d'`apt` du référentiel des paquetages.

  Mise à jour

    Mettre à jour l'installation de Debian vers la dernière version de tous les paquetages

  Réparations

    `apt` est très strict à propos des dépendances et tente de les corriger

  Actualisation avec « apt-file »

    La recherche de fichiers à désinstaller utilise la commande `apt-file`, et actualise la base de données utilisée par `apt-file`.

### Menu configuration

Les éléments du menu Configuration sont :

Configuration Afficher la barre d'outils

  Afficher ou non la barre d'outils

Configuration Enregistrer la configuration...

  Enregistrer les options immédiatement

Configuration Configurer les raccourcis claviers...

  Appelle la boîte de dialogue standard de &kde; pour configurer les raccourcis clavier

Configuration Configurer les barres d'outils...

  Appelle la boîte de dialogue standard de &kde; pour configurer les barres d'outils

Configuration Configurer KPackage...
  Types

    Quels types de paquetages manipuler, Debian utilisant DPKG et Debian utilisant APT sont listés séparément. Ce n'est pas une bonne idée de les activer en même temps. Il détermine aussi l'accès à une machine distante pour apt Debian.

  Met en cache

    Contrôle le cache des dossiers distants (&FTP;) et les fichiers de paquetages.

    Met en cache les dossiers de paquetages distants

      S'il faut mettre en cache les dossiers distants (&FTP;) et les fichiers de paquetages.

    Met en cache les fichiers de paquetages distants

      S'il faut mettre en cache les fichiers de paquetages distants qui ont été cherchés

    Dossier de cache

      Où mettre en cache les fichiers et les dossiers de paquetages

  divers
    Utiliser SSH pour les commandes nécessitant des privilèges

      Utiliser `ssh` au lieu de `su` pour lancer les commandes avec privilèges

    Vérification de la liste des fichiers

      Si positionné, la liste des fichiers dans le paquetage est vérifiée pour voir s'ils sont vraiment installés

    Lire les informations de tous les paquetages locaux

      Si positionné, tous les fichiers d'un dossier (local) de paquetages sont lus au lieu de simplement utiliser les noms des fichiers. C'est plus lent, mais ceci montre plus d'informations.

### Menu Aide

Les éléments du menu Aide sont :

&help.menu.documentation;

### Barre d'outils

- Ouvrir

- Précédent (historique)

- Suivant

- Développer l'arborescence

- Refermer l'arborescence

- Chercher un paquetage

- Chercher un fichier

- Recharger

- Quitter

## Remerciements et licences

&kpackage;

Programme copyright 1999-2000 Damyan Pepper, Toivo Pedaste

Documentation copyright 2000 Toivo Pedaste toivo@ucs.uwa.edu.au

Traduction française par &GerardDelafond;.

Relecture par &LudovicGrossard;.

&underFDL; &underGPL;

## Installation

### Comment obtenir &kpackage;

&install.intro.documentation;

Pour les informations sur la manière de l'obtenir et le compiler, voyez http://www.kde.org/install-source.html

Il y a d'autres informations sur la compilation sur http://www.kde.org/compilationfaq.html

Il y a une page web à http://www.general.uwa.edu.au/u/toivo/kpackage

### Configuration nécessaire

Pour installer &kpackage;, vous avez besoin de :

- &Qt; 3 et &kde; 3

Pour lister les paquetages Debian, aucun autre logiciel n'est nécessaire, mais pour installer et désinstaller les paquetages, vous avez besoin :

- du gestionnaire de paquetages `dpkg` ou

- de `apt-get` et `apt-cache`

Pour les paquetages BSD, vous avez besoin des programmes de gestion des paquetages :

- `pkg_info`

- `pkg_add`

- `pkg_delete`

Pour les paquetages Slackware, vous avez besoin de :

- `installpkg`

- `removepkg`

Pour gérer les paquetages de Redhat, vous avez besoin de :

- `rpm`

Pour que &kpackage; fonctionne correctement avec les paquetages RPM, la base de données de RPM doit être initialisée. Si la commande ``rpm` `-qa`` renvoie une erreur comme `incapable d'ouvrir...`, essayez ``rpm` `--rebuilddb``.