<?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 % Catalan  "INCLUDE">
]>
<!-- The language must NOT be changed here. -->

<book lang="&language;">

<bookinfo>

<title
>El manual de &kabcclient;</title>

<authorgroup>
  <author
><firstname
>Kevin</firstname
> <surname
>Krammer</surname
> <affiliation
> <address
> <email
>kevin.krammer@gmx.at</email>
      </address>
    </affiliation>
  </author>
  &traductor.Antoni.Bella; 
</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; és una interfície de línia d'ordres per a les llibretes d'adreces del &kde;.</para>
</abstract>


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

</bookinfo>

<chapter id="introduction">
<title
>Introducció</title>

<para
>&kabcclient; és una interfície de línia d'ordres per a la llibreta d'adreces del &kde;. Permet llistar, cercar, inserir, eliminar o fusionar els contactes a través de la línia d'ordres o des d'un llenguatge d'script. &kabcclient; pot gestionar una varietat de formats d'entrada i de sortida, permetent-vos utilitzar-lo per a la importació i exportació de totes les llibretes d'adreces del &kde;. </para>

<para
>Quan s'invoca sense arguments &kabcclient; es posarà en mode de cerca i tractarà de fer coincidir qualsevol entrada que llegeixi des de l'entrada estàndard per a les entrades de contactes a la llibreta d'adreces del &kde;.</para>

<para
>Característiques principals de &kabcclient; <itemizedlist>
  <listitem
><para
>Llista tots els contactes de la llibreta d'adreces del &kde;</para
></listitem>
  <listitem
><para
>Cerca de contactes que coincideixin amb l'entrada</para
></listitem>
  <listitem
><para
>Insereix (afegeix) contactes</para
></listitem>
  <listitem
><para
>Elimina (esborra) els contactes</para
></listitem>
  <listitem
><para
>Fusiona (canvia) els contactes que coincideixen amb les noves dades</para
></listitem>
</itemizedlist
></para>

<para
>&kabcclient; <emphasis
>no</emphasis
> és una altre interfície gràfica d'usuari de la llibreta d'adreces del &kde; (&ead;, &kaddressbook;). &kabcclient; està destinat exclusivament per a usos en què una interfície gràfica d'usuari no és pràctica ni possible.</para>

<para
>&kabcclient; <emphasis
>no</emphasis
> proporciona un llenguatge complet per a la realització de consultes de la llibreta d'adreces de l'usuari, ni és la intenció dels autors el escriure mai aquesta capacitat. Tot aquest processat es pot fer mitjançant altres eines de línia d'ordres o les pròpies capacitats del llenguatge d'script. </para>

<para
>Per facilitar l'exhibició de les de les seves possibilitats, qualsevol opció que requereixi d'un argument es pot cridar amb el valor <replaceable
>help</replaceable
>. I llavors es llistaran tots els valors vàlids que podeu passar a aquesta opció. </para>

</chapter>

<chapter id="features">
<title
>Característiques</title>
<para
>En aquest capítol aprendreu sobre les característiques principals de &kabcclient; i com controlar-lo utilitzant els paràmetres de línia d'ordres (recordeu que &kabcclient; no és una interfície gràfica d'usuari, sinó que només és un programa de línia d'ordres).</para>

<para
>Aprendreu sobre la inserció, eliminació i cerca de dades de contacte, i com utilitzar diferents formats d'entrada i de sortida. </para>

<sect1 id="listing">
<title
>Llistar la llibreta d'adreces</title>

<para
>Aquest és el mode d'operació més bàsic, iniciat amb l'opció <parameter
>--list</parameter
> o <parameter
>-L</parameter
>. &kabcclient; llistarà tots els contactes de la llibreta d'adreces del &kde;, escrivint les dades en la sortida estàndard del programa. La quantitat i el format de la sortida dependrà del format de sortida escollit.</para>

<para>
<informalexample
><para
>Per a llistar tots els contactes com entrades vCard estàndard, simplement executeu:</para>

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

<para>
<informalexample
><para
>Per obtenir només una línia per contacte, &pex;, per comptar, simplement executeu:</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
>En el següent exemple, es llisten totes les adreces de correu electrònic:</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
>Cerca de contactes que coincideixen amb les dades d'entrada</title>

<para
>&kabcclient; pot prendre dades de la línia d'ordres o des de l'entrada estàndard del programa i comprovar les similituds contra tots els contactes a la llibreta d'adreces del &kde;. La cerca és el mode per omissió però es pot escollir de forma explícita amb l'argument <parameter
>--search</parameter
> o <parameter
>-S</parameter
> de la línia d'ordres. </para>

<para>
<informalexample
><para
>En el següent exemple, tots els contactes amb <replaceable
>rosa</replaceable
> com a part de qualsevol camp de nom o adreça de correu electrònic s'escriurà a la sortida estàndard del programa, amb format vCard (ja que aquest és el valor per omissió per a l'opció <option
>--output-format</option
>):</para>

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

<para>
<informalexample
><para
>Mateixa consulta, aquesta vegada llegint la cadena de cerca des de l'entrada estàndard del programa:</para>

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

<para
>La funció sensible a caixa de les consultes es pot activar amb l'opció <option
>--match-case</option
>.</para>
</sect1>

<sect1 id="adding">
<title
>Afegir contactes</title>

<para
>&kabcclient; permet afegir nous contactes a la llibreta d'adreces del &kde; utilitzant l'argument <parameter
>--add</parameter
> o <parameter
>-A</parameter
> de la línia d'ordres. Les dades es poden passar com a arguments addicionals de la línia d'ordres o llegides des de l'entrada estàndard. En cas d'èxit els contactes resultants s'escriuran a la sortida estàndard del programa. Atès que aquesta és una operació que aplica canvis a la llibreta d'adreces es pot executar en el mode «assaig» utilitzant l'opció <option
>--nosave</option
>. </para>

<para>
<informalexample
><para
>Afegir un contacte amb nom i adreça de correu electrònic mitjançant la interpretació d'un argument de la línia d'ordres addicional com a dada d'entrada:</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>kabcclient</command
> <option
>--add</option
> <option
>--input-format <replaceable
>email</replaceable
> </option
><replaceable
>"Jordi Fal &lt;j.fal@exemple.cat&gt;"</replaceable
></userinput
></screen>
</para>
</informalexample>
</para>

<para>
<informalexample
><para
>Afegir tots els contactes d'un fitxer vCard llegit des de l'entrada estàndard del programa:</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>cat <replaceable
>fitxer_exemple.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
>Eliminar contactes</title>

<para
>&kabcclient; permet eliminar contactes de la llibreta d'adreces del &kde; utilitzant l'argument <parameter
>--remove</parameter
> o <parameter
>-R</parameter
> de la línia d'ordres. Les dades d'entrada seran bàsicament una consulta com quan se cerca a la llibreta d'adreces. En cas d'èxit els contactes extrets s'escriuran a la sortida estàndard del programa. Atès que aquesta és una operació que aplica canvis a la llibreta d'adreces es pot executar en el mode «assaig» utilitzant l'opció <option
>--nosave</option
>. </para>

<warning
><para
>Quan s'elimina quelcom de la llibreta d'adreces no es podrà desfer! En altres paraules, quan elimineu un contacte <emphasis
>no podreu</emphasis
> desfer l'acció! S'ha perdut per sempre.</para
></warning>

<para>
<informalexample
><para
>Proveu eliminant tots els contactes amb <replaceable
>rosa</replaceable
> en qualsevol camp de nom de contacte o adreça de correu electrònic:</para>

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

</sect1>

<sect1 id="formats">
<title
>Formats d'entrada i de sortida</title>

<para
>&kabcclient; pot interpretar les dades d'entrada i de sortida d'acord amb diferents regles de format. Depenent de l'escenari realment utilitzat algunes combinacions fan el resultat més útil. Alguns dels formats entenen paràmetres addicionals per personalitzar encara més el seu comportament. </para>

<para
>Com que les dades de text es poden codificar tant d'entrada com de sortida es poden sotmetre a una descodificació o codificació addicional, respectivament. </para>

<para
>Totes les opcions de la línia d'ordres reaccionen amb el valor especial <replaceable
>help</replaceable
> per llistar els valors permesos.</para>

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

<para
>vCard (<acronym
>RFC </acronym
>2426) és el format estàndard per a les dades de contacte i com a tal pot presentar tota la informació d'altres aplicacions, com ara pot accedir a la llibreta d'adreces &kaddressbook;. Per tant, el format per omissió per al format de sortida. </para>
</sect2>

<sect2 id="csv-format">
<title
>Format amb els valors separats per comes (<acronym
>CSV</acronym
>)</title>

<para
>El format de valors separats per comes es pot utilitzar com a format d'entrada per omplir les dades en el camp específic d'una entrada de contacte i com a format de sortida per reduir o canviar l'ordre de les dades per al seu posterior processament. Per permetre la suficient flexibilitat per a l'assignació de camps de contactes a les columnes CSV es pot especificar utilitzant fitxers de descripció de plantilla CSV també utilitzats per &kaddressbook; amb el mateix propòsit. </para>
</sect2>
</sect1>
</chapter>

<chapter id="features-commandline-options">
<title
>Arguments de la línia d'ordres</title>

<para
>&kabcclient; suporta les següents opcions:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Opció</entry>
  <entry
>Descripció</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--help, --help-all</option
></entry>
  <entry
>Mostra ajuda quant a les opcions del programa.</entry>
</row>
<row>
  <entry
><option
>--author</option
></entry>
  <entry
>Mostra informació sobre l'autor del programa.</entry>
</row>
<row>
  <entry
><option
>-v, --version</option
></entry>
  <entry
>Mostra informació sobre la versió del programa.</entry>
</row>
<row>
  <entry
><option
>--license</option
></entry>
  <entry
>Mostra informació sobre la llicència del programa.</entry>
</row>
<row>
  <entry
><option
>--verbose</option
></entry>
  <entry
>Imprimeix missatges d'utilitat en temps d'execució.</entry>
</row>
<row>
  <entry
><option
>--nosave</option
></entry>
  <entry
>Imprimeix el que faria, però no ho executa. No canvia res a la llibreta d'adreces del &kde;, no insereix, elimina, modifica cap contacte existent.</entry>
</row>
<row>
  <entry
><option
>--match-case</option
></entry>
  <entry
>Utilitza la coincidència sensible en comparar les dades d'entrada amb les dades de contacte a la llibreta d'adreces.</entry>
</row>
<row>
  <entry
><emphasis
>Modes principals d'operació:</emphasis
></entry>
</row>
<row>
  <entry
><option
>-L, --list</option
></entry>
  <entry
>Imprimeix tots els contactes en el format d'exportació especificat.</entry>
</row>
<row>
  <entry
><option
>-A, --add</option
></entry>
  <entry
>Insereix els contactes a la llibreta d'adreces.</entry>
</row>
<row>
  <entry
><option
>-R, --remove</option
></entry>
  <entry
>Elimina els contactes de la llibreta d'adreces.</entry>
</row>
<row>
  <entry
><option
>-M, --merge</option
></entry>
  <entry
>Fusiona les dades de l'entrada amb els contactes que coincideixen a la llibreta d'adreces.</entry>
</row>
<row>
  <entry
><emphasis
>Format i codificació:</emphasis
></entry>
</row>
<row>
  <entry
><option
>-if, --input-format</option
> <replaceable
>format</replaceable
></entry>
  <entry
>Com interpretar les dades d'entrada. Utilitzeu <replaceable
>help</replaceable
> per obtenir una llista de valors disponibles.</entry>
</row>
<row>
  <entry
><option
>-of, --output-format</option
> <replaceable
>format</replaceable
></entry>
  <entry
>Com donar format a les dades de sortida. Utilitza <replaceable
>help</replaceable
> per obtenir una llista de valors disponibles.</entry>
</row>
<row>
  <entry
><option
>-if-opts, --input-format-options</option
> <replaceable
>opcions</replaceable
></entry>
  <entry
>Opcions de personalització específiques del format d'entrada. Utilitza <replaceable
>help</replaceable
> per obtenir una llista de valors disponibles.</entry>
</row>
<row>
  <entry
><option
>-of-opts, --output-format-options</option
> <replaceable
>opcions</replaceable
></entry>
  <entry
>Opcions de personalització específiques del format de sortida. Utilitza <replaceable
>help</replaceable
> per obtenir una llista de valors disponibles.</entry>
</row>
<row>
  <entry
><option
>-ic, --input-codec</option
> <replaceable
>codificació</replaceable
></entry>
  <entry
>La codificació de text utilitzada per presentar les dades d'entrada. Utilitza <replaceable
>help</replaceable
> per obtenir una llista de valors disponibles.</entry>
</row>
<row>
  <entry
><option
>-oc, --output-codec</option
> <replaceable
>codificació</replaceable
></entry>
  <entry
>La codificació de text utilitzada per presentar les dades de sortida. Utilitza <replaceable
>help</replaceable
> per obtenir una llista de valors disponibles.</entry>
</row>

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

</chapter>

<chapter id="faq">
<title
>Preguntes i respostes</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
>Quin tipus de fitxers de configuració utilitza &kabcclient;?</para>
</question>
<answer>
<para
>Cap.</para>
</answer>
</qandaentry>


<qandaentry>
<question>
<para
>Quins són els noms de les aplicacions de &kabcclient;?</para>
</question>
<answer>
<para
>El nom de l'aplicació de &kabcclient; és <application
>kabcclient</application
>.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Com puc afegir la meva pregunta a aquesta &PMF;?</para>
</question>
<answer>
<para
>Envieu les vostres preguntes a <email
>kevin.krammer@gmx.at</email
>.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title
>Crèdits i llicència</title>

<para
>&kabcclient; copyright del programa 2005-2008:</para>

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

<para
>Copyright de la documentació 2008:</para>
<itemizedlist>
<listitem
><para
>Kevin Krammer <email
>kevin.krammer@gmx.at</email
></para
></listitem>
</itemizedlist>

<para
>Traductor de la documentació: &credits.Antoni.Bella;</para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Instal·lació</title>

<sect1 id="obtaining-application">
<title
>Com obtenir &kabcclient;</title>
&install.intro.documentation; <para
>&kabcclient; ve inclòs amb el &kde; 4 i no està disponible per separat. </para>

</sect1>

<sect1 id="requirements">
<title
>Requeriments</title>

<para
>&kabcclient; requereix la instal·lació de les biblioteques estàndard de &kde; (els paquets <filename
>kdelibs</filename
> i <filename
>kdepimlibs</filename
>). Per compilar el codi font, també són necessaris els paquets de desenvolupament de &Qt;, <filename
>kdelibs</filename
> i <filename
>kdepimlibs</filename
>.</para>

<para
>Podeu trobar una llista de canvis en el fitxer <filename
>ChangeLog</filename
>.</para>
</sect1>

<sect1 id="configuration">
<title
>Configuració</title>

<para
>No es requereix cap configuració especial per executar &kabcclient; a l'escriptori &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:
-->
