<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [

  <!ENTITY kabcclient "<application
>KABC-Client</application
>">
  <!ENTITY kappname "KABCClient">
  <!ENTITY package "kdepim">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % French "INCLUDE">
]>
<!-- The language must NOT be changed here. -->

<book id="kabcclient" lang="&language;">

<bookinfo id="kabcclientinfo">

<title
>Manuel de &kabcclient;</title>

<authorgroup>
  <author
><firstname
>Kevin</firstname
> <surname
>Krammer</surname
> <affiliation
> <address
> <email
>kevin.krammer@gmx.at</email>
      </address>
    </affiliation>
  </author>
  &traducteurJeanJacquesFinazzi; 
</authorgroup>

<copyright>
  <year
>2008</year>
  <holder
>Kevin Krammer</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<!-- Don't change format of date and version of the documentation -->

<date
>20/11/2008</date>
<releaseinfo
>1.1.1</releaseinfo>

<abstract>
  <para
>&kabcclient; est une interface en ligne de commande pour les carnets d'adresses de &kde;.</para>
</abstract>


<keywordset>
  <keyword
>KDE</keyword>
  <keyword
>&package;</keyword>
  <keyword
>&kappname;</keyword>
  <keyword
>KAddressBook</keyword>
</keywordset>

</bookinfo>

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

<para
>&kabcclient; est une interface en ligne de commande pour les carnets d'adresses de &kde;. Il vous permet de lister, rechercher, ajouter, supprimer ou fusionner des contacts via la ligne de commande ou à partir d'un langage de script. &kabcclient; prend en charge tout une variété de formats à la fois en entrée et en sortie, ce qui permet de l'utiliser pour l'importation et l'exportation de carnets d'adresses &kde; entiers. </para>

<para
>Lorsqu'il est invoqué sans arguments, &kabcclient; sera en mode de recherche et essaiera de faire correspondre toute saisie sur l'entrée standard aux contacts dans le carnet d'adresses de &kde;</para>

<para
>Fonctionnalités principales de &kabcclient; : <itemizedlist>
  <listitem
><para
>Lister tous les contacts du carnet d'adresses de &kde;</para
></listitem>
  <listitem
><para
>Recherche de contacts par critères</para
></listitem>
  <listitem
><para
>Ajout de contacts</para
></listitem>
  <listitem
><para
>Suppression de contacts</para
></listitem>
  <listitem
><para
>Fusion de contacts (avec les données les plus récentes)</para
></listitem>
</itemizedlist
></para>

<para
>&kabcclient; n'est <emphasis
>pas</emphasis
> une autre interface graphique pour le carnet d'adresses de &kde; (&cad; &kaddressbook;). &kabcclient; est exclusivement dédié aux situations où une interface graphique n'est pas pratique ou possible.</para>

<para
>&kabcclient; ne fournit <emphasis
>pas</emphasis
> de langage complet pour effectuer des requêtes sur le carnet d'adresses de l'utilisateur, et l'intention de ses auteurs n'est pas et ne sera jamais de développer une telle capacité. Tout traitement de ce type peut être réalisé à travers d'autres outils en ligne de commande ou les capacités propres du langage dans lequel le script est écrit. </para>

<para
>Afin de faciliter la découverte de ses capacités, toute option requérant un argument peut être appelée avec la valeur <replaceable
>help</replaceable
>. Ceci listera toutes les valeurs valables qui peuvent être transmises à cette option. </para>

</chapter>

<chapter id="features">
<title
>Fonctionnalités</title>
<para
>Dans ce chapitre, vous apprendrez les fonctionnalités principales de &kabcclient; et comment les contrôler en utilisant les paramètres en ligne de commande (souvenez-vous que &kabcclient; n'est pas une interface graphique ; il s'agit uniquement d'un programme en ligne de commande).</para>

<para
>Vous apprendrez comment ajouter, supprimer et rechercher des données de contacts, et comment utiliser les différents formats en entrée et en sortie. </para>

<sect1 id="listing">
<title
>Lister le carnet d'adresses</title>

<para
>Ceci est le mode de fonctionnement le plus basique, obtenu en utilisant l'option <parameter
>--list</parameter
> ou <parameter
>-L</parameter
>. &kabcclient; listera tous les contacts du carnet d'adresses de &kde;, et écrira les données sur la sortie standard du programme. La quantité et le format des données en sortie dépendront du format de sortie choisi.</para>

<para>
<informalexample
><para
>Afin de lister tous les contacts au format vCard, lancez :</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>kabcclient <option
>-L</option
></command>
</userinput
>
</screen>
</para>
</informalexample>
</para>

<para>
<informalexample
><para
>Afin d'obtenir juste une ligne par contact (par exemple pour les compter), lancez :</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>kabcclient <option
>-L</option
> <option
>-of <replaceable
>uid</replaceable
></option
></command>
</userinput
>
</screen>
</para>
</informalexample>
</para>

<para>
<informalexample
><para
>Dans l'exemple suivant, nous listons toutes les adresses de courrier électronique :</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>kabcclient</command
> <option
>--list</option
> <option
>-of <replaceable
>email</replaceable
></option>
</userinput
>
</screen>
</para>
</informalexample>
</para>

</sect1>

<sect1 id="searching">
<title
>Recherche de contacts par critères</title>

<para
>&kabcclient; peut recevoir des données depuis la ligne de commande ou depuis l'entrée standard du programme, et vérifier leurs similitudes avec tout contact dans le carnet d'adresses de &kde;. Le mode de recherche est le mode par défaut, mais il peut explicitement être sélectionné en utilisant l'argument en ligne de commande <parameter
>--search</parameter
> ou <parameter
>-S</parameter
>. </para>

<para>
<informalexample
><para
>Dans l'exemple suivant, tous les contacts ayant <replaceable
>jane</replaceable
> dans tout champ de nom ou d'adresse de courrier électronique seront écrits sur la sortie standard du programme, au format vCard (étant donné qu'il s'agit de l'option par défaut pour l'option <option
>--output-format</option
>) :</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>kabcclient</command
> <option
>--search</option
> <replaceable
>jane</replaceable
></userinput
></screen>
</para>
</informalexample>
</para>

<para>
<informalexample
><para
>La même requête, mais cette fois en lisant la chaîne de recherche depuis l'entrée standard du programme :</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>echo</command
> <replaceable
>jane</replaceable
> | <command
>kabcclient</command
> <option
>--search</option
></userinput
></screen>
</para>
</informalexample>
</para>

<para
>La prise en compte de la casse lors des recherches peut être définie avec l'option <option
>--match-case</option
>.</para>
</sect1>

<sect1 id="adding">
<title
>Ajout de contacts</title>

<para
>&kabcclient; prend en charge l'ajout de nouveaux contacts dans le carnet d'adresses de &kde; en utilisant l'argument en ligne de commande <parameter
>--add</parameter
> ou <parameter
>-A</parameter
>. Les données en entrée peuvent être transmises soit en tant qu'arguments supplémentaires en ligne de commande ou lues à partir de l'entrée standard. En cas de succès, les contacts résultants seront écrits sur la sortie standard du programme. Étant donné qu'il s'agit d'une opération qui effectue des changements dans le carnet d'adresses, elle peut être lancée en mode « essai à blanc » en utilisant l'option <option
>--nosave</option
>. </para>

<para>
<informalexample
><para
>Ajout d'un contact avec un nom et une adresse de courrier électronique, en interprétant un argument supplémentaire en ligne de commande comme donnée en entrée :</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>kabcclient</command
> <option
>--add</option
> <option
>--input-format <replaceable
>email</replaceable
> </option
><replaceable
>"John Doe &lt;j.doe@example.com&gt;"</replaceable
></userinput
></screen>
</para>
</informalexample>
</para>

<para>
<informalexample
><para
>Ajout de tous les contacts d'un fichier au format vCard transmis à l'entrée standard du programme :</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>cat <replaceable
>example-file.vcf</replaceable
></command
> | <command
>kabcclient</command
> <option
>--add</option
> <option
>--input-format <replaceable
>vcard</replaceable
> </option
></userinput
></screen>
</para>
</informalexample>
</para>
</sect1>

<sect1 id="deleting">
<title
>Suppression de contacts</title>

<para
>&kabcclient; prend en charge la suppression de contacts dans le carnet d'adresses de &kde; en utilisant l'argument en ligne de commande <parameter
>--remove</parameter
> ou <parameter
>-R</parameter
>. La donnée en entrée est basiquement une requête identique à celles utilisées lors d'une recherche dans le carnet d'adresses. En cas de succès, les contacts supprimés seront écrits sur la sortie standard du programme. Étant donné qu'il s'agit d'une opération qui effectue des changements dans le carnet d'adresses, elle peut être lancée en mode « essai à blanc » en utilisant l'option <option
>--nosave</option
>. </para>

<warning
><para
>Lorsque vous supprimez quelque chose dans le carnet d'adresses, vous ne <emphasis
>pouvez pas</emphasis
> l'annuler ! En d'autres termes, vous ne pouvez pas annuler la suppression lorsque vous supprimez un contact. Il est supprimé pour de bon.</para
></warning>

<para>
<informalexample
><para
>Test de la suppression de tous les contacts ayant <replaceable
>jane</replaceable
> dans tout champ de nom ou toute adresse électronique :</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>kabcclient</command
> <option
>--remove</option
> <option
>--nosave</option
> <replaceable
>jane</replaceable
></userinput
></screen>
</para>
</informalexample>
</para>

</sect1>

<sect1 id="formats">
<title
>Formats de données en entrée et en sortie</title>

<para
>&kabcclient; peut interpréter les données en entrée et formater celles en sortie selon différentes règles de formatage. En fonction du scénario d'utilisation réel, certaines combinaisons offriront le résultat le plus utile. Certains des formats nécessitent des paramètres additionnels afin de mieux personnaliser leur comportement. </para>

<para
>Étant donné que les données au format texte peuvent être encodées, à la fois l'entrée et la sortie peuvent respectivement être sujettes à un décodage et un encodage supplémentaires. </para>

<para
>Toutes ces options en ligne de commande réagiront à la valeur spéciale <replaceable
>help</replaceable
> en listant les valeurs permises.</para>

<sect2 id="vcard-format">
<title
>Format vCard</title>

<para
>vCard (<acronym
>RFC</acronym
> 2426) est le format standard pour les données de contacts et, en tant que tel, peut présenter toutes les informations auxquelles les autres applications de gestion de carnet d'adresses peuvent accéder, telle que &kaddressbook;. De ce fait, c'est le format par défaut pour le formatage de la sortie. </para>
</sect2>

<sect2 id="csv-format">
<title
>Format de valeurs séparées par des virgules (format <acronym
>CSV</acronym
>)</title>

<para
>Le format de valeurs séparées par des virgules peut être utilisé comme format d'entrée pour remplir des champs spécifiques de contacts, et comme format de sortie pour réduire ou réordonner des données pour un traitement avancé. Afin de permettre suffisamment de flexibilité, il est possible de spécifier des correspondances entre des champs de contacts et des colonnes du fichier CSV en utilisant des fichiers de description de modèles CSV utilisés aussi par &kaddressbook; dans le même but. </para>
</sect2>
</sect1>
</chapter>

<chapter id="features-commandline-options">
<title
>Arguments en ligne de commande</title>

<para
>&kabcclient; prend en charge les options suivantes :</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Option</entry>
  <entry
>Description</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--help, --help-all</option
></entry>
  <entry
>Affiche l'aide sur les options du programme.</entry>
</row>
<row>
  <entry
><option
>--author</option
></entry>
  <entry
>Affiche les informations sur les auteurs du programme.</entry>
</row>
<row>
  <entry
><option
>-v, --version</option
></entry>
  <entry
>Affiche les informations sur la version du programme.</entry>
</row>
<row>
  <entry
><option
>--license</option
></entry>
  <entry
>Affiche les informations sur la licence du programme.</entry>
</row>
<row>
  <entry
><option
>--verbose</option
></entry>
  <entry
>Affiche d'utiles messages sur l'exécution du programme.</entry>
</row>
<row>
  <entry
><option
>--nosave</option
></entry>
  <entry
>Affiche ce qui aurait été fait, mais n'exécute rien. N'effectue aucune modification au carnet d'adresses de &kde; ; n'ajoute pas, ne supprime pas, ne modifie aucun contact.</entry>
</row>
<row>
  <entry
><option
>--match-case</option
></entry>
  <entry
>Effectue une recherche sans tenir compte de la casse lors de la comparaison des données en entrée avec les données de contacts présentes dans le carnet d'adresses.</entry>
</row>
<row>
  <entry
><emphasis
>Modes de fonctionnement principaux :</emphasis
></entry>
</row>
<row>
  <entry
><option
>-L, --list</option
></entry>
  <entry
>Affiche tous les contacts dans le format d'export spécifié.</entry>
</row>
<row>
  <entry
><option
>-A, --add</option
></entry>
  <entry
>Ajoute des contacts dans le carnet d'adresses.</entry>
</row>
<row>
  <entry
><option
>-R, --remove</option
></entry>
  <entry
>Supprime des contacts dans le carnet d'adresses.</entry>
</row>
<row>
  <entry
><option
>-M, --merge</option
></entry>
  <entry
>Fusionne les données en entrée avec les contacts correspondants présents dans le carnet d'adresses.</entry>
</row>
<row>
  <entry
><emphasis
>Formatage et encodage :</emphasis
></entry>
</row>
<row>
  <entry
><option
>-if, --input-format</option
> <replaceable
>format</replaceable
></entry>
  <entry
>Façon d'interpréter les données en entrée. Utilisez <replaceable
>help</replaceable
> afin d'obtenir une liste des valeurs disponibles.</entry>
</row>
<row>
  <entry
><option
>-of, --output-format</option
> <replaceable
>format</replaceable
></entry>
  <entry
>Façon de formater les données en sortie. Utilisez <replaceable
>help</replaceable
> afin d'obtenir une liste des valeurs disponibles.</entry>
</row>
<row>
  <entry
><option
>-if-opts, --input-format-options</option
> <replaceable
>options</replaceable
></entry>
  <entry
>Options de personnalisation spécifiques au format d'entrée. Utilisez <replaceable
>help</replaceable
> afin d'obtenir une liste des valeurs disponibles.</entry>
</row>
<row>
  <entry
><option
>-of-opts, --output-format-options</option
> <replaceable
>options</replaceable
></entry>
  <entry
>Options de personnalisation spécifiques au format de sortie. Utilisez <replaceable
>help</replaceable
> afin d'obtenir une liste des valeurs disponibles.</entry>
</row>
<row>
  <entry
><option
>-ic, --input-codec</option
> <replaceable
>encodage</replaceable
></entry>
  <entry
>Encodage de texte utilisé pour présenter les données en entrée. Utilisez <replaceable
>help</replaceable
> afin d'obtenir une liste de valeurs disponibles.</entry>
</row>
<row>
  <entry
><option
>-oc, --output-codec</option
> <replaceable
>encodage</replaceable
></entry>
  <entry
>Encodage de texte qui devrait être utilisé pour présenter les données en sortie. Utilisez <replaceable
>help</replaceable
> afin d'obtenir une liste de valeurs disponibles.</entry>
</row>

</tbody>
</tgroup>
</informaltable>

</chapter>

<chapter id="faq">
<title
>Questions et réponses</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
>Quels fichiers de configuration sont utilisés par &kabcclient; ?</para>
</question>
<answer>
<para
>Aucun.</para>
</answer>
</qandaentry>


<qandaentry>
<question>
<para
>Quels sont les noms d'application de &kabcclient; ?</para>
</question>
<answer>
<para
>Le nom d'application de &kabcclient; est <application
>kabcclient</application
>.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Comment ajouter une question à cette <acronym
>FAQ</acronym
> ?</para>
</question>
<answer>
<para
>Envoyez vos questions à <email
>kevin.krammer@gmx.at</email
>.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title
>Remerciements et licence</title>

<para
>Copyright 2005-2008 pour le programme &kabcclient; :</para>

<itemizedlist>
<listitem
><para
>Kevin Krammer <email
>kevin.krammer@gmx.at</email
></para
></listitem>
</itemizedlist>

<para
>Copyright 2008 pour la documentation :</para>
<itemizedlist>
<listitem
><para
>Kevin Krammer <email
>kevin.krammer@gmx.at</email
></para
></listitem>
</itemizedlist>

<para
>Traduction française par &JeanJacquesFinazzi;.</para
> 
&underFDL; &underGPL; </chapter>

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

<sect1 id="obtaining-application">
<title
>Comment obtenir &kabcclient;</title>
&install.intro.documentation; <para
>&kabcclient; est inclus dans &kde;4 et n'est pas disponible séparément. </para>

</sect1>

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

<para
>&kabcclient; requiert que les bibliothèques standard de &kde; soient installées (les paquetages <filename
>kdelibs</filename
> et <filename
>kdepimlibs</filename
>). Pour compiler le programme à partir des sources, vous aurez aussi besoin de &Qt; et des paquetages de développement de <filename
>kdelibs</filename
> et <filename
>kdepimlibs</filename
>.</para>

<para
>Vous trouverez le journal des modifications dans le fichier <filename
>ChangeLog</filename
>.</para>
</sect1>

<sect1 id="configuration">
<title
>Configuration</title>

<para
>Aucune configuration spéciale n'est requise pour configurer &kabcclient; afin qu'il fonctionne dans l'environnement &kde;.</para>

</sect1>

</appendix>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->
