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

<book lang="&language;">


<bookinfo>

<title>Manuel d'utilisation de &klipper;</title>

<authorgroup>
<author>
<firstname>Philip</firstname>
<surname>Rodrigues</surname>
<affiliation>
<address><email>philip.rodrigues@libertysurf.co.uk</email></address>
</affiliation>
</author>

<othercredit role="developer">
<firstname>Carsten</firstname>
<surname>Pfeiffer</surname>
<affiliation>
<address><email>pfeiffer@kde.org</email></address>
</affiliation>
<contrib>Developpeur</contrib>
</othercredit>

<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>Philip</firstname>
<surname>Ducharme</surname>
<affiliation>
<address><email>philip.ducharme@hermes.usherb.ca</email></address>
</affiliation>
<contrib>Traduction française</contrib>
</othercredit>

<othercredit role="translator">
<firstname>Gilles</firstname>
<surname>Thioliere</surname>
<affiliation>
<address><email>zhovirax@free.fr</email></address>
</affiliation>
<contrib>Traduction française</contrib>
</othercredit>
</authorgroup>

<copyright>
<year>2000</year>
<holder>Philip Rodrigues</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>28/01/2001</date>
<releaseinfo>2.0.0</releaseinfo>

<abstract>
<para>&klipper; est l'outil du presse-papiers de l'environnement de bureau KDE.
Il apporte une aide dans les opérations dites Copier/Coller.</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>Klipper</keyword>
<keyword>kdebase</keyword>
<keyword>presse-papiers</keyword>
</keywordset>

</bookinfo>


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

<para>&klipper; est l'outil du presse-papiers de l'environnement de bureau KDE.
&klipper; conserve l'historique des entrées du presse-papiers et permet de leur associer le lancement d'applications.
Pour signaler un quelconque problème ou émettre un souhait, veuillez contacter Carsten Pfeiffer <email>pfeiffer@kde.org</email>.</para>

<sect1 id="klipper-revhistory">
<title>Évolution de &klipper;</title>

<itemizedlist>
<listitem><para>2.0.1 - Ajout d'un délai après lequel les menus de &klipper; se referment si rien n'est entrepris avec le contenu du presse-papiers.</para></listitem>
<listitem><para>2.0 - Distribué avec KDE 2.0. Ajout&nbsp;: boîte de dialogue
de configuration&nbsp;; sauvegarde de l'historique à la fermeture&nbsp;;
association d'actions au contenu du presse-papiers</para></listitem>
<listitem><para>1.0 - Première diffusion publique</para></listitem>
</itemizedlist> </sect1> </chapter>


<chapter id="using-klipper">
<title>Utilisation de &klipper;</title>

<sect1 id="basic-usage">
<title>Fonctions de base</title>

<para>Pour afficher l'historique du presse-papiers, cliquez sur l'icône &klipper; ou appuyez simultanément sur <keycombo
action="simul"><keycap>Ctrl</keycap><keycap>Alt</keycap><keycap>V</keycap></keycombo>.
Les précédentes entrées du presse-papiers se trouvent dans la partie basse du
menu contextuel qui s'affiche. Le fait de sélectionner une de ces entrées la
copie dans le presse-papiers d'où elle pourra, de manière classique, être collée
dans toute application KDE ou X.</para>

</sect1>

<sect1 id="actions">
<title>Actions</title>


<para>&klipper; peut exécuter certaines actions en rapport avec les entrées du presse-papiers
dont la forme correspond à une expression régulière paticulière. Par exemple, toute entrée du presse-papiers commençant par
<quote>http://</quote> peut être envoyée à <application>Netscape</application> ou &konqueror; en tant qu'&URL; à ouvrir.</para>

<para>Pour utiliser cette fonction, copiez une &URL; dans le presse-papiers.
S'il existe une expression régulière analogue dans la liste de &klipper;, les options qui lui
sont associées apparaîtront dans un menu, dit menu Action (par exemple, Ouvrir
une &URL; dans &konqueror;, Ouvrir une &URL;  dans  &Netscape;). Une fois votre
choix effectué, au clavier ou de la souris, &klipper; lancera l'application
sélectionnée avec, comme argument, l'adresse contenue dans le
presse-papiers.</para>

<para>Si vous ne désirez pas appliquer d'actions au contenu du presse-papiers,
cliquez tout simplement en dehors du menu &klipper; après avoir choisi l'entrée
à copier&nbsp;: le menu se fermera alors automatiquement, vous laissant à votre
travail. Il est possible de paramètrer le délai durant lequel les menus Action
restent affichés si vous n'en faites rien&nbsp;: Cliquez sur
<guilabel>Préférences</guilabel>, puis sur l'onglet
<guilabel>Général</guilabel>. Les paramètres peuvent être saisis dans la
rubrique <guilabel>Délai d'ouverture des menu Action</guilabel>. </para>

<para>Pour désactiver totalement les actions associées, ouvrez le menu en
cliquant sur l'icône &klipper;, (ou <keycombo
action="simul">&Ctrl;&Alt;<keycap>V</keycap></keycombo>) puis cliquez sur
<guilabel>Actions activées</guilabel>, ou encore, pressez les touches <keycombo
action="simul">&Ctrl;&Alt;<keycap>X</keycap></keycombo>. </para>

<para>Il est possible d'éditer les entrées revêtant une expression régulière avant même d'y associer une action.
Dans le menu contextuel, choisissez <guilabel>Modifier et traiter à
nouveau</guilabel>&nbsp;: Vous pouvez modifier l'entrée choisie dans la zone
d'édition qui apparaît, avant de cliquer sur <guibutton>OK</guibutton> pour
lancer l'action associée.</para>

<para>Une pression simultanée des touches <keycombo action="simul">&Ctrl;&Alt;<keycap>R</keycap></keycombo>
affiche le menu contextuel permettant de répèter la dernière action effectuée
par &klipper;.</para>

</sect1>
</chapter>

<chapter id="configuration">
<title>Configuration de &klipper;</title>

<sect1 id="viewing-options">
<title>Préférences</title>

<para>Pour voir ou modifier les options de &klipper;, cliquez sur
<guilabel>Préférences</guilabel> dans le menu contextuel&nbsp;: Une boîte de
dialogue <guimenu>Configuration de Klipper</guimenu> s'affiche alors. Son
contenu est décrit ici.</para>


<sect2 id="general-tab">

<title>Général</title>

<variablelist>

<varlistentry>
<term><guilabel>Afficher le menu contextuel à la position de le souris ou du curseur</guilabel></term>
<listitem>
<para>Permet d'afficher le menu de &klipper; à l'emplacement du curseur de la souris plutôt
qu'à sa position par défaut, dans le tableau de bord de KDE.
Très utile si vous vous servez plus de la souris que du clavier.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Enregistrer le contenu du presse-papiers en quittant</guilabel></term>
<listitem>
<para>Active la sauvegarde automatique de l'historique à la fermeture de &klipper;.
Le contenu est restauré à l'ouverture suivante.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Délai d'ouverture des menus Action</guilabel></term>
<listitem>
<para>Détermine la durée après laquelle les menus Action disparaîssent, dès lors qu'ils ne sont pas utilisés.</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>


<sect2 id="actions-tab">
<title>Actions</title>

<variablelist>

<varlistentry>
<term><guilabel>Configuration des actions</guilabel></term>
<listitem>
<para>Sous l'onglet <guilabel>Actions</guilabel>, sélectionnez une expression régulière à éditer.
Une zone d'édition apparaît, et vous pouvez y modifier le texte selon vos souhaits.
Une fois terminé, n'oubliez pas de valider en appuyant sur la touche Entrée.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Ajouter une actions</guilabel></term>

<listitem>

<para>Cliquez sur le bouton <guibutton>Ajouter une action</guibutton> pour ajouter une expression régulière à celles que &klipper; prend en charge.
Klipper utilise <classname>QRegExp de Qt</classname>, qui traite la plupart des expressions régulières que vous pourriez utiliser
dans les commandes <application>grep</application> ou <application>egrep</application>, par exemple.
</para>

<note>
<para>Pour plus de détails concernant les expressions régulières de <classname>QRegExp</classname>,
veuillez consulter la page <ulink url="http://doc.trolltech.com/qregexp.html#details">http://doc.trolltech.com/qregexp.html#details</ulink>.
Notez toutefois que &klipper; ne gère pas le mode Wildcard mentionné sur cette page.
</para>
</note>

<para>L'édition des expressions régulières est décrite ci-dessous.</para>
<para>Pour associer une commande supplémentaire, faites un <mousebutton>clique droit</mousebutton> (sur l'expression régulière choisie), sélectionnez
<guimenuitem>Ajouter une commande</guimenuitem>, puis éditez la commande dans l'arborescence apparue sous l'expression régulière.
</para>

<para>Notez qu'un <token>%s</token> placé dans une ligne de commande sera remplacé par le contenu courant du presse-papiers.
Par exemple&nbsp;: Si vous inscrivez <userinput><command>kedit</command>
<token>%s</token></userinput> alors que le presse-papier contient
<filename>/home/phil/textfile</filename>, la commande lancée sera&nbsp;:
<userinput><command>kedit</command><filename>/home/phil/textfile</filename>
</userinput>. Dans une ligne de commande, <token>%s</token> doit être précédé d'une
barre oblique inversée (backslash), comme suit&nbsp;: <userinput>\%s</userinput>
</para>

</listitem>

</varlistentry>
</variablelist>

</sect2>

<sect2 id="shortcuts-tab">
<title>Raccourcis</title>

<para>L'onglet Raccourci vous permet de modifier les raccoucis clavier utilisés pour accéder aux fonctions de &klipper;.
Trois options s'offrent à vous&nbsp;: </para>

<variablelist>

<varlistentry>
<term><guilabel>Aucun raccourci</guilabel></term>
<listitem>
<para>Aucun raccourci ne sera assigné à l'action sélectionnée.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Raccourci par défaut</guilabel></term>
<listitem>
<para>L'action sélectionnée est associée au raccourci par défaut de &klipper;.
Les raccourcis par défaut sont ceux mentionnés tout au long de ce manuel.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Raccourci personnalisé</guilabel></term>
<listitem>
<para>C'est vous qui définissez le raccourci pour l'action sélectionée.</para>
<para>Pour choisir la touche qui servira de raccourci à l'action sélectionnée, cliquez tout d'abord sur le
bouton représentant une touche de clavier, en bas de la fenêtre, afin de la mettre en surbrillance.
Ceci étant fait, enregistrez la touche désirée en appuyant dessus, sur votre 
clavier. On peut combiner ce choix (NdT&nbsp;: c'est même très
préférable&nbsp;!&nbsp;) avec au moins une des touches <keycap>Shift</keycap>,
&Ctrl; ou &Alt; en cochant la ou les case(s) correspondante(s).</para>
</listitem> </varlistentry>

</variablelist>

</sect2>
</sect1>
</chapter>

<chapter id="credits">
<title>Remerciements et licence</title>

<para>&klipper;</para>
<para>Copyright de programme 1998 Andrew Stanley-Jones <email>asj@cban.com</email>.</para>
<para>Copyright de programme 1998-2000 Carsten Pfeiffer <email>pfeiffer@kde.org</email>.</para>
<para>Maintenance actuellement assurée par Carsten Pfeiffer.</para>

<para>
Copyright de documentation 2000 Philip Rodrigues
<email>philip.rodrigues@libertysurf.co.uk</email> </para>

&underFDL;
&underGPL;

</chapter>

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

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

<para>&klipper; fait partie du projet KDE <ulink url="http://www.kde.org">http://www.kde.org</ulink>.
Il est inclus dans le paquetage kdebase, disponible sur <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="requirements">
<title>Pré-Requis</title>
<para>L'utilisation &klipper; nécessite d'avoir installé KDE 2.0.</para>
<para>Toutes les librairies nécessaires sont disponibles <ulink url="ftp://ftp.kde.org">sur le site ftp de KDE</ulink>. </para>
</sect1>

<sect1 id="compilation">
<title>Compilation et installation</title>
<para>L'installation et la compilation de &klipper; sont incluses dans celles du paquetage kdebase.
Ceci place une icône &klipper; dans le tableau de bord (aussi appelé Kicker) de l'environnement de bureau KDE.</para>

<screenshot>
<screeninfo>Icône &klipper;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="screenshot.png" format="PNG">
	  </imageobject>
	  <textobject>
	    <phrase>Capture d'écran</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para>Pour désactiver &klipper;, supprimez la ligne y faisant référence dans le fichier <filename>$KDEDIR/bin/startkde</filename></para>

</sect1>
</appendix>



<![ %addindex; [ &kdedocindex; ]]>

</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
End:
-->
