<!DOCTYPE book PUBLIC  "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
  <!ENTITY appname "&ark;" -- this only *seems* redundant -->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % French "INCLUDE">
  <!ENTITY % ents PUBLIC "-//KDE//ENTITIES Application-Variable Entities V1.0//EN">
  %ents;
]>

<book lang="&language;">

<bookinfo>
<title>Le manuel de ark</title>

<authorgroup>
<author>
<firstname>Matt</firstname>
<surname>Johnston</surname>
<affiliation>
<address><email>mattj@flashmail.com</email></address>
</affiliation>
</author>



<othercredit role="reviewer">
<firstname>Lauri</firstname>
<surname>Watts</surname>
<affiliation><address><email>vampyr@atconnex.net</email></address></affiliation>
<contrib>Relecteur</contrib>
</othercredit>

<othercredit role="translator">
<firstname>Ludovic</firstname>
<surname>Grossard</surname>
<affiliation>
<address><email>ludovic.grossard@libertysurf.fr</email></address>
</affiliation>
<contrib>Traduction française</contrib>
</othercredit>

<othercredit role="reviewer">
<firstname>Patrick</firstname>
<surname>Chavas</surname>
<affiliation>
<address><email>pachavas@sun.cpe.fr</email></address>
</affiliation>
<contrib>Relecture française</contrib>
</othercredit>


</authorgroup>

<copyright>
<year>2000</year>
<holder>Matt Johnston</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>27/07/1999</date>
<releaseinfo>0.05.00</releaseinfo>

<abstract><para>Ce manuel décrit &ark; version 1.9 </para>
<para>&ark; est un gestionnaire d'archive pour KDE.</para></abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>gzip</keyword>
<keyword>gunzip</keyword>
<keyword>tar</keyword>
<keyword>archive</keyword>
<keyword>zip</keyword>
<keyword>compression</keyword>
<keyword>lha</keyword>
<keyword>kdeutils</keyword>
<keyword>ark</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title>Introduction</title>

<para>&ark; est une application destinée à gérer divers formats d'archives dans
l'environnement KDE. Les archives peuvent être visualisées, décompactées, créées
et modifiées depuis &ark;. Le programme est compatible avec plusieurs formats
comme tar, gzip, bzip2, zip et lha (si les programmes en ligne de commande
appropriés sont installés). &ark; travaille de manière étroite avec
<application>Konqueror</application> dans l'environnement KDE pour traiter les
archives.</para>

<sect1 id="ark-revhistory">
<title>Historique de la documentation de &ark;</title>

<itemizedlist>
<listitem><para>0.05.00 - Documentation originale de &ark; -
Robert Palmbos</para></listitem>
<listitem><para>0.05.00 - Documentation pour KDE2 - Matt
Johnston</para></listitem>
</itemizedlist>

</sect1>
</chapter>

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

<sect1 id="obtenir-ark">
<title>Comment obtenir &ark;</title>

<para>&ark; fait partie du projet KDE <ulink
url="http://www.kde.org">http://www.kde.org</ulink>. Il se trouve dans le
paquetage kdeutils à l'adresse <ulink
url="ftp://ftp.kde.org/pub/kde/">ftp://ftp.kde.org/pub/kde/</ulink>, le site
ftp principal du projet KDE.</para>

</sect1>

<sect1 id="prerequis">
<title>Prérequis</title>

<para>Pour utiliser &ark;, vous avez besoin de KDE 2.0. <abbrev>GNU</abbrev>
<application>Tar</application> v1.12 et une version récente de
<application>gzip</application> sont aussi nécessaires. Pour traiter d'autres
formats d'archives, vous avez besoin des programmes en ligne de commande
appropriés, comme par exemple <application>zip</application>,
<application>unzip</application>, <application>ar</application> et
<application>lha</application>. </para>

</sect1>

<sect1 id="compilation">
<title>Compilation et installation</title>

<para>Pour compiler et installer &ark; sur votre système, entrez les lignes
suivantes dans le répertoire de base de la distribution de
kdeutils&nbsp;:</para>

<screen width="40">
<prompt>%</prompt> <userinput>./configure</userinput>
<prompt>%</prompt> <userinput>make</userinput>
<prompt>%</prompt> <userinput>make install</userinput>
</screen>

<para>Étant donné que &ark; utilise <application>autoconf</application> et
<application>automake</application>, vous ne devriez pas rencontrer de problèmes
pour le compiler. Si c'est le cas, veuillez les signaler aux listes de
discussions de KDE.</para>

</sect1>

</chapter>

<chapter id="utilisation-de-ark">
<title>Utilisation de ark</title>

<sect1 id="ark-ouvrir-des-archives">
<title>Ouvrir des archives</title>

<para>Pour ouvrir une archive dans &ark;, choisissez
<guimenuitem>Ouvrir</guimenuitem> dans le menu <guimenu>Fichier</guimenu>. Vous
pouvez aussi ouvrir une archive en la déposant depuis
<application>Konqueror</application>. Les fichiers d'archives devraient être
associés à &ark;, donc vous pouvez cliquer avec le bouton droit de la souris sur
un fichier dans <application>Konqueror</application> et sélectionner
<guimenuitem>Archiveur</guimenuitem> pour l'ouvrir.</para>


</sect1>
<sect1 id="ark-travailler-avec-les-fichiers">
<title>Travailler avec les fichiers</title>

<para>Une fois qu'une archive a été ouverte, vous pouvez effectuer plusieurs
type d'opérations sur les fichiers contenus dans l'archive. En cliquant avec le
bouton <mousebutton>droit</mousebutton> de la souris sur un fichier dans
l'archive, ou en sélectionnant un fichier et en utilisant le menu
<guimenu>Action</guimenu>, vous pouvez choisir ce que vous voulez
faire&nbsp;:</para>

<itemizedlist>
<listitem><para><guimenuitem>Visualiser</guimenuitem> ouvrira le fichier dans le
programme de visualisation par défaut.</para></listitem>
<listitem><para><guimenuitem>Ouvrir avec...</guimenuitem> vous permet
d'ouvrir le fichier avec le programme de votre choix.</para></listitem>
<listitem><para><guimenuitem>Éditer avec...</guimenuitem> ouvrira le fichier
avec le programme de votre choix. La différence entre ceci et
<guimenuitem>Ouvrir avec...</guimenuitem> est que toute modification effectuée
sur le fichier sera enregistrée dans l'archive.</para></listitem>
<listitem><para><guimenuitem>Supprimer</guimenuitem> enlèvera le(s)
fichier(s) sélectionné(s) de l'archive.</para></listitem>
</itemizedlist>

</sect1>
<sect1 id="ark-extraire">
<title>Extraire les archives</title>

<para>Une fois une archive ouverte dans &ark;, vous pouvez la
décompacter. Pour extraire des fichiers d'une archive, vous pouvez soit
sélectionner <guimenuitem>Extraire...</guimenuitem> dans le menu
<guimenu>Action</guimenu> ou cliquer avec le bouton
<mousebutton>droit</mousebutton> de la souris sur un fichier. Une boîte de
dialogue d'extraction vous permet de sélectionner l'endroit où vous voulez
extraire les fichiers. Vous pouvez aussi sélectionner quels fichiers vous
voulez extraire&nbsp;:</para>

<itemizedlist>
<listitem><para>"<guimenuitem>Actuel</guimenuitem>" extrait les
fichiers récemment sélectionnés. Si plusieurs fichiers ont été
sélectionnés, seuls les fichiers sélectionnés en dernier seront
extraits.</para></listitem>
<listitem><para>"<guimenuitem>Tous</guimenuitem>"
extrait tout le contenu de l'archive.</para></listitem>
<listitem><para>"<guimenuitem>Fichiers sélectionnés</guimenuitem>"
extrait tous les fichiers qui ont été sélectionnés.</para></listitem>
<listitem><para>"<guimenuitem>Format</guimenuitem>" vous permet de spécifier
quels fichiers seront extraits, correspondant à un certain format,
<abbrev>ie</abbrev> <filename>*.txt</filename> ou <filename>*.jpg</filename>.
Notez que vous ne pouvez utiliser qu'un format à la fois.</para></listitem>
</itemizedlist>

<para>Vous pouvez spécifier le répertoire d'extraction des fichiers dans la zone
de texte "<guilabel>Extraire dans&nbsp;:</guilabel>". Si vous voulez changer
le répertoire par défaut, dans la fenêtre principale de l'application,
choisissez <guimenuitem>Répertoires...</guimenuitem> dans le menu
<guimenu>Configuration</guimenu>. Dans l'onglet "Avancé", vous pouvez
choisir quelques options spécifiques dépendantes du format de l'archive.</para>

</sect1>
<sect1 id="ark-creer">
<title>Création d'une archive et ajout de fichiers</title>

<para>Pour créer une archive dans &ark;, choisissez
<guimenuitem>Nouveau</guimenuitem> dans le menu <guimenu>Fichier</guimenu>.
</para>

<para>Vous pouvez alors saisir le nom de l'archive, avec l'extension appropriée
(<filename>tar.gz</filename>, <filename>zip</filename>, <filename>bz2</filename>
<abbrev>etc</abbrev>). Pour ajouter des fichiers à l'archive, choisissez
<guimenuitem>Ajouter des fichiers...</guimenuitem> dans le
menu <guimenu>Action</guimenu>. Si vous voulez ajouter un répertoire entier à
une archive, sélectionnez <guimenuitem>Ajouter un répertoire...</guimenuitem>
dans le menu <guimenu>Action</guimenu>.</para>

<para>Une autre façon de procéder pour ajouter des fichiers à l'archive consiste
à les déposer depuis <application>Konqueror</application> ou depuis le bureau
dans la fenêtre principale de &ark;, et ils seront ajoutés à l'archive
actuelle.</para>

</sect1>

</chapter>

<chapter id="commandes">
<title>Liste des commandes</title>

<sect1 id="menufichier">
<title>Le menu <guimenu>Fichier</guimenu></title>

<variablelist>
<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>n</keycap></keycombo>
</shortcut>
<guimenu>Fichier</guimenu>
<guimenuitem>Nouveau</guimenuitem>
</menuchoice></term>
<listitem><para><action>Créé une nouvelle archive.</action></para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo><keycap>Ctrl</keycap><keycap>o</keycap></keycombo>
</shortcut>
<guimenu>Fichier</guimenu>
<guimenuitem>Ouvrir</guimenuitem>
</menuchoice></term>
<listitem><para><action>Ouvre une archive.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Fichier</guimenu>
<guimenuitem>Récemment ouvert(s)</guimenuitem>
</menuchoice></term>
<listitem><para><action>Affiche une liste des archives récentes pour en
ouvrir une.</action></para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Fichier</guimenu>
<guimenuitem>Enregistrer sous</guimenuitem>
</menuchoice></term>
<listitem><para><action>Vous permet d'enregistrer l'archive actuelle sous
un nouveau nom.</action></para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Fichier</guimenu>
<guimenuitem>Nouvelle vue</guimenuitem>
</menuchoice></term>
<listitem><para><action>Ouvre une nouvelle fenêtre de &ark;.
</action></para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Fichier</guimenu>
<guimenuitem>Recharger</guimenuitem>
</menuchoice></term>
<listitem><para><action>Recharge l'archive en cours. Ceci rafraîchit la fenêtre
de &ark; si un autre programme a effectué des modifications sur
l'archive</action></para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Fichier</guimenu>
<guimenuitem>Fermer l'archive</guimenuitem>
</menuchoice></term>
<listitem><para><action>Ferme l'archive actuelle.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Fichier</guimenu>
<guimenuitem>Quitter</guimenuitem>
</menuchoice></term>
<listitem><para><action>Ferme &ark;</action></para>
</listitem></varlistentry>
</variablelist>

</sect1>
<sect1 id="menuedition">
<title>Le menu Édition</title>

<variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>Édition</guimenu>
<guimenuitem>Sélectionner...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Vous permet de sélectionner des fichiers en fonction de
leurs noms. Par exemple, vous pouvez utiliser <filename>*.txt</filename> pour
sélectionner tous les fichiers texte. Notez que vous ne pouvez utiliser qu'un
filtre à la fois.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Édition</guimenu>
<guimenuitem>Tout sélectionner</guimenuitem>
</menuchoice></term>
<listitem><para><action>Sélectionne tous les fichiers de
l'archive.</action></para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Édition</guimenu>
<guimenuitem>Tout désélectionner</guimenuitem>
</menuchoice></term>
<listitem><para><action>Désélectionne tous les fichiers de
l'archive.</action></para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Édition</guimenu>
<guimenuitem>Inverser la sélection</guimenuitem>
</menuchoice></term>
<listitem><para><action>Inverse la sélection des fichiers. Les fichiers
sélectionnés ne le sont plus, et ceux qui ne l'étaient pas le
deviennent</action></para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Édition</guimenu>
<guimenuitem>Visualiser la dernière sortie console</guimenuitem> </menuchoice></term>
<listitem><para><action>Affiche la boîte "<guilabel>sortie console</guilabel>",
qui affiche la sortie de la ou des commandes les plus récentes exécutées par
&ark;. C'est quelquefois utile si vous avez des problèmes que vous souhaitez
résoudre.</action></para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="menuaction">
<title>Le menu <guimenu>Action</guimenu></title>

<variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>Action</guimenu>
<guimenuitem>Ajouter des fichiers...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Affiche la boîte de dialogue
"<guilabel>Ajouter</guilabel>", où vous pouvez sélectionner des fichiers.
Maintenez enfoncée la touche "<keycap>Ctrl</keycap>" et cliquez pour
sélectionner plusieurs fichiers. Pour aller dans le répertoire parent, cliquez
sur le bouton <mousebutton>droit</mousebutton> de la souris dans la boîte des
répertoires, et choisissez "<guimenuitem>Haut</guimenuitem>" (ceci sera
probablement amélioré bientôt). L'onglet "<guilabel>Avancé</guilabel>"
contient des options qui sont spécifiques au type de l'archive sur laquelle vous
travaillez.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Action</guimenu>
<guimenuitem>Ajouter un répertoire...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Affiche la boîte de dialogue dans laquelle vous
pouvez choisir un répertoire à ajouter. Sélectionnez simplement un répertoire
et choisissez "<guibutton>OK</guibutton>".
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Action</guimenu>
<guimenuitem>Supprimer</guimenuitem>
</menuchoice></term>
<listitem><para><action>Enlève de l'archive les fichiers actuellement
sélectionnés.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Action</guimenu>
<guimenuitem>Extraire</guimenuitem>
</menuchoice></term>
<listitem><para><action>Affiche la boîte de dialogue
"<guilabel>Extraire</guilabel>", qui vous permet de sélectionner où vous voulez
extraire les fichiers.</action> Vous pouvez aussi sélectionner quels fichiers
vous voulez extraire&nbsp;:</para> <itemizedlist>
<listitem><para>"<guilabel>Actuel</guilabel>" extrait les fichiers sélectionnés
en dernier. Si plusieurs fichiers ont été sélectionnés, seul ceux sélectionnés
en dernier seront extraits.</para></listitem>
<listitem><para>"<guilabel>Tous</guilabel>" extrait tout le contenu de
l'archive.</para></listitem>
<listitem><para>"<guilabel>Fichiers sélectionnés</guilabel>"
extrait tous les fichiers qui ont été sélectionnés.</para></listitem>
<listitem><para>"<guilabel>Format</guilabel>" vous permet de spécifier quels
fichiers seront extraits, en fonction d'un certain format, <abbrev>i.e.</abbrev>
<filename>*.txt</filename> ou <filename>*.jpg</filename>. Notez que vous ne
pouvez utiliser qu'un format à la fois.</para></listitem> </itemizedlist>

<para>Vous pouvez spécifier le répertoire d'extraction des fichiers dans la zone
de texte "<guilabel>Extraire dans&nbsp;:</guilabel>". Si vous voulez modifier le
répertoire par défaut, dans la fenêtre principale de l'application,
choisissez <guimenuitem>Répertoires...</guimenuitem> dans le menu
<guimenu>Configuration</guimenu>. Dans l'onglet
"<guilabel>Avancé</guilabel>", vous pouvez choisir quelques options
spécifiques dépendantes du format de l'archive.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Action</guimenu>
<guimenuitem>Visualiser</guimenuitem>
</menuchoice></term>
<listitem><para><action>Ouvre le fichier sélectionné dans le programme de
visualisation associé.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Action</guimenu>
<guimenuitem>Ouvrir avec...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Ouvre le fichier sélectionné avec le programme de votre
choix. La boîte de dialogue "<guilabel>Ouvrir avec...</guilabel>" vous permet de
choisir le programme à utiliser.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Action</guimenu>
<guimenuitem>Éditer avec...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Ouvre le fichier sélectionné avec le programme de votre
choix. Toutes les modifications qui seront effectuées avec le programme
d'édition se répercuteront dans l'archive, puisque celle-ci sera mise à
jour.</action></para></listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="settingsmenu">
<title>Le menu <guimenu>Configuration</guimenu></title>

<variablelist>

<varlistentry>
<term><menuchoice>
<guimenu>Configuration</guimenu>
<guimenuitem>Afficher la barre d'outils</guimenuitem>
</menuchoice></term>
<listitem><para><action>Affiche ou non la barre
d'outils.</action></para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Configuration</guimenu>
<guimenuitem>Afficher la barre d'état</guimenuitem>
</menuchoice></term>
<listitem><para><action>Affiche ou non la barre d'état.
</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Configuration</guimenu>
<guimenuitem>Enregistrer les options</guimenuitem>
</menuchoice></term>
<listitem><para><action>Enregistre les options de configuration actuelles. Ceci
signifie qu'elles seront réutilisées la prochaine fois que vous exécuterez
&ark;.</action></para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Configuration</guimenu>
<guimenuitem>Raccourcis clavier...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Affiche la boîte de dialogue "<guilabel>Raccourcis
clavier</guilabel>". Ceci vous permet de choisir les touches de raccourcis pour
plusieurs éléments des menus. Pour modifier un raccourci, sélectionnez une
action dans la liste, puis choisissez la combinaison de touches à utiliser. En
cliquant sur la "<guibutton>touche de clavier</guibutton>" qui se situe en bas à
droite, vous pouvez choisir la touche spécifique à utiliser. Appuyez simplement
sur une touche.</action></para></listitem> </varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Configuration</guimenu>
<guimenuitem>Répertoires...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Ceci affiche la boîte de dialogue
"<guilabel>Préférences de répertoires</guilabel>", afin de choisir les
répertoires par défaut. Le "<guilabel>dernier répertoire de
démarrage</guilabel>" est le dernier répertoire que vous avez utilisé pour cette
option particulière.
</action></para></listitem>
</varlistentry>

</variablelist>

</sect1>


</chapter>

<chapter id="credits">

<title>Remerciements et Licence</title>

<para>
&ark; est sous Copyright 1997-2000, il a plusieurs développeurs
</para>
<para>Auteurs&nbsp;:</para>
<itemizedlist>
<listitem><para>Robert Palmbos
<email>palm9744@kettering.edu</email></para></listitem>
<listitem><para>Francois-Xavier Duranceau
<email>duranceau@kde.org</email></para></listitem>
<listitem><para>Corel Corporation (author: Emily Ezust)
<email>emilye@corel.com</email></para></listitem>
</itemizedlist>

<para>Documentation copyright 2000 Matt Johnston
<email>mattj@flashmail.com</email></para>

&underFDL;
&underGPL;

</chapter>

<![ %addindex; [ &kdedocindex; ]]>
</book>
<!--
Local Variables:
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
End:
-->
