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

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

<bookinfo id="kabcclientinfo">

<title
>De handboek van &kabcclient;</title>

<authorgroup>
  <author
><firstname
>Kevin</firstname
> <surname
>Krammer</surname
> <affiliation
> <address
> <email
>kevin.krammer@gmx.at</email>
      </address>
    </affiliation>
  </author>
  &Freek.de.Kruijf; 
</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
>2008-11-20</date>
<releaseinfo
>1.1.1</releaseinfo>

<abstract>
  <para
>&kabcclient; is een commandoregel interface tot de adresboeken van &kde;.</para>
</abstract>


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

</bookinfo>

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

<para
>&kabcclient; is een commandoregel-interface naar &kde;-adresboek. Het laat u contacten weergeven, zoeken, invoegen, verwijderen of aanvullen door middel van de commandoregel of met een scripttaal. &kabcclient; kan verschillende formaten aan invoer- en uitvoerzijde hanteren, waardoor het gebruikt kan worden voor im- en exporteren van gehele &kde;-adresboeken. </para>

<para
>Bij het aanroepen zonder argumenten wordt &kabcclient; in zoekmodus gezet en probeert elke invoer die het kan lezen van standaard invoer te laten overeenkomen met contact-items in het &kde;-adresboek</para>

<para
>De belangrijkste mogelijkheden van &kabcclient; zijn: <itemizedlist>
  <listitem
><para
>Alle contacten in het &kde;-adresboek laten zien</para
></listitem>
  <listitem
><para
>Naar contactpersonen zoeken die overeenkomen met de invoergegevens</para
></listitem>
  <listitem
><para
>Contactpersonen (toe-) invoegen</para
></listitem>
  <listitem
><para
>Contactpersonen verwijderen</para
></listitem>
  <listitem
><para
>Voeg toe (wijzig) overeenkomende contactpersonen met nieuwe gegevens</para
></listitem>
</itemizedlist
></para>

<para
>&kabcclient; is <emphasis
>geen</emphasis
> andere grafische gebruikersinterface tot het &kde;-adresboek (dwz. &kaddressbook;). &kabcclient; is alleen bedoeld voor gebruik waar een grafische gebruikersinterface niet praktisch of mogelijk is.</para>

<para
>&kabcclient; levert <emphasis
>geen</emphasis
> taal met volledige mogelijkheden voor het doen van zoekopdrachten in het adresboek van de gebruiker en ook is het niet de bedoeling van de auteurs om ooit zoiets te maken. Zoiets kan gedaan worden door andere commandoregelhulpmiddelen of de eigen mogelijkheden van de taal. </para>

<para
>Om het ontdekken van de mogelijkheden te vergemakkelijken kan bij elke optie die een argument vereist de waarde <replaceable
>help</replaceable
> gegeven worden. Dit geeft dan alle geldige waarden die aan de optie meegegeven kunnen worden. </para>

</chapter>

<chapter id="features">
<title
>Mogelijkheden</title>
<para
>In dit hoofdstuk leest u over de hoofd mogelijkheden van &kabcclient; en hoe ze te besturen met de parameters op de commandoregel (&kabcclient; is geen grafische gebruikersinterface; het is alleen een commandoregelprogramma).</para>

<para
>U leest over invoegen, verwijderen en zoeken van contactpersonen en hoe de verschillende formats voor invoer en uitvoer te gebruiken. </para>

<sect1 id="listing">
<title
>Een lijst maken van het adresboek</title>

<para
>Dit is de basis van alle bewerkingen, gestart met de optie <parameter
>--list</parameter
> of <parameter
>-L</parameter
>. &kabcclient; toont de lijst met alle contacten in het &kde; adresboek en schrijft de gegevens naar de standaard uitvoer van het programma. Hoeveelheid en formaat van de uitvoer hangt af van het gekozen uitvoerformaat.</para>

<para>
<informalexample
><para
>Om een lijst te maken van alle contacten in standaard vCard-items, voer uit:</para>

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

<para>
<informalexample
><para
>Om één regel per contactpersoon te krijgen, &eg; om te tellen, voer uit:</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
>In het volgende voorbeeld, maken we een lijst met alle e-mailadressen:</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
>Naar contactpersonen zoeken die overeenkomen met de invoergegevens</title>

<para
>&kabcclient; kan gegevens halen vanaf de commandoregel of van de standaard invoer van een programma en controleren of overeenkomsten zijn met alle contacten in het &kde; adresboek. Zoeken is de standaard manier maar het kan expliciet worden gekozen met het argument <parameter
>--search</parameter
> of <parameter
>-S</parameter
>. </para>

<para>
<informalexample
><para
>In het volgende voorbeeld zullen alle contacten met <replaceable
>jane</replaceable
> als deel van elk naamveld of e-mailadres naar standaard uitvoer van het programma worden geschreven, geformatteerd als vCards (omdat dit de standaard voor de optie <option
>--output-format</option
> is):</para>

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

<para>
<informalexample
><para
>Zelfde zoekopdracht opnieuw, nu met het lezen van de zoektekst van de standaard invoer van het programma:</para>

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

<para
>Hoofdlettergevoeligheid kan worden aan-/uitgezet met de optie <option
>--match-case</option
>.</para>
</sect1>

<sect1 id="adding">
<title
>Contactpersonen toevoegen</title>

<para
>&kabcclient; ondersteunt het toevoegen van nieuwe contactpersonen aan het &kde; adresboek met het argument <parameter
>--add</parameter
> of <parameter
>-A</parameter
>. De gegevens kunnen ofwel als extra argumenten op de commandoregel worden doorgegeven of van standaard invoer gelezen. Bij succes zullen de resulterende contacten naar de standaard uitvoer van het programma worden geschreven. Omdat dit een bewerking is die wijzigingen in het adresboek aanbrengt kan het worden uitgevoerd in een "Dry run" modus met de optie <option
>--nosave</option
>. </para>

<para>
<informalexample
><para
>Voeg een contactpersoon toe met naam en e-mailadres door een extra argument op de commando regel als invoergegeven:</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>kabcclient</command
> <option
>--add</option
> <option
>--input-format <replaceable
>email</replaceable
> </option
><replaceable
>"Jan Klaassen &lt;j.klaassen@voorbeeld.nl&gt;"</replaceable
></userinput
></screen>
</para>
</informalexample>
</para>

<para>
<informalexample
><para
>Voeg alle contactpersonen uit een vCard-bestand in die in de standaard invoer worden gestopt:</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>cat <replaceable
>voorbeeld-bestand.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
>Contactpersonen worden verwijderd</title>

<para
>&kabcclient; ondersteunt het verwijderen van contacten uit het &kde; adresboek met het argument <parameter
>--remove</parameter
> of <parameter
>-R</parameter
>. De invoergegevens zijn in basis een zoekopdracht zoals bij het zoeken in het adresboek. Bij succes zullen de verwijderde contacten naar de standaard uitvoer van het programma worden geschreven. Omdat dit een bewerking is die wijzigingen in het adresboek aanbrengt kan het worden uitgevoerd in een "Dry run" modus met de optie <option
>--nosave</option
>. </para>

<warning
><para
>Wanneer u iets uit het adresboek verwijdert kan dit <emphasis
>niet</emphasis
> ongedaan gemaakt worden! Met andere woorden, als u een contact verwijdert kan dat niet ongedaan gemaakt worden. Weg is weg, voorgoed.</para
></warning>

<para>
<informalexample
><para
>Test verwijdering van alle contacten met <replaceable
>jane</replaceable
> in elk contactnaamveld of elk e-mailadres:</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
>invoer en uitvoer formats</title>

<para
>&kabcclient; kan invoergegevens interpreteren en uitvoergegevens formatteren volgens verschillende formatteringsregels. Afhankelijk van het actuele gebruik zullen bepaalde combinaties tot het meest succesvolle resultaat leiden. Sommige van de formats begrijpen extra parameters voor verdere aanpassing van hun gedrag. </para>

<para
>Omdat tekstuele gegevens gecodeerd kunnen zijn kan invoer en uitvoer onderworpen zijn respectievelijk aan extra decodering of codering. </para>

<para
>Al deze opties voor de commandoregel reageren op de speciale waarde <replaceable
>help</replaceable
> bij het tonen van de toegestane waarden.</para>

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

<para
>vCard (<acronym
>RFC</acronym
> 2426) is de standaard indeling voor contactgegevens en kan alle informatie tonen die andere adresboektoepssingen zoals &kaddressbook; kan lezen. Het is daarom de standaard indeling voor uitvoerformattering. </para>
</sect2>

<sect2 id="csv-format">
<title
>Door komma's gescheiden (<acronym
>CSV</acronym
>) formaat</title>

<para
>De indeling met komma-gescheiden-waarden kan als invoerindeling worden gebruikt om gegevens in te vullen in specifieke velden van een contactpersoon-item en als uitvoerindeling om hersortering van gegevens voor verdere verwerking te verminderen. Om genoeg flexibiliteit te bieden in het laten overeenkomen van contactpersoonvelden met CSV(kgw)-kolommmen kunnen de gegevens gespecificeerd worden met gebruik van de CSV-sjabloonbeschrijvingsbestanden die ook door &kaddressbook; voor hetzelfde doel worden gebruikt. </para>
</sect2>
</sect1>
</chapter>

<chapter id="features-commandline-options">
<title
>Commandoregel-parameters</title>

<para
>&kabcclient; ondersteunt de volgende parameters:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Optie</entry>
  <entry
>Beschrijving</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--help, --help-all</option
></entry>
  <entry
>Toont informatie over de mogelijke parameters.</entry>
</row>
<row>
  <entry
><option
>--author</option
></entry>
  <entry
>Toont gegevens over de auteur van dit programma.</entry>
</row>
<row>
  <entry
><option
>-v, --version</option
></entry>
  <entry
>Toont het versienummer van dit programma.</entry>
</row>
<row>
  <entry
><option
>--license</option
></entry>
  <entry
>Toont de licentie van dit programma.</entry>
</row>
<row>
  <entry
><option
>--verbose</option
></entry>
  <entry
>Geeft meer informatie tijdens het uitvoeren van commando's.</entry>
</row>
<row>
  <entry
><option
>--nosave</option
></entry>
  <entry
>Laat zien wat er gedaan zou worden zonder het daadwerkelijk uit te voeren. Wijzigt niets in het &kde;-adresboek; voegt niets in, verwijdert niets en wijzigt niets in bestaande contactpersonen.</entry>
</row>
<row>
  <entry
><option
>--match-case</option
></entry>
  <entry
>Gebruikt hoofdlettergevoelige overeenkomsten bij het vergelijken van ingevoerde gegevens met gegevens in het adresboek.</entry>
</row>
<row>
  <entry
><emphasis
>Hoofdhandelingen:</emphasis
></entry>
</row>
<row>
  <entry
><option
>-L, --list</option
></entry>
  <entry
>Toon alle contactpersonen in het opgegeven exportformaat.</entry>
</row>
<row>
  <entry
><option
>-A, --add</option
></entry>
  <entry
>Voeg contactpersonen toe aan het adresboek.</entry>
</row>
<row>
  <entry
><option
>-R, --remove</option
></entry>
  <entry
>Verwijder contactpersonen uit het adresboek.</entry>
</row>
<row>
  <entry
><option
>-M, --merge</option
></entry>
  <entry
>Voeg ingevoerde gegevens toe aan overeenkomende contactpersonen uit het adresboek.</entry>
</row>
<row>
  <entry
><emphasis
>Formattering en codering:</emphasis
></entry>
</row>
<row>
  <entry
><option
>-if, --input-format</option
> <replaceable
>format</replaceable
></entry>
  <entry
>Hoe invoergegevens worden geïnterpreteerd. Gebruik <replaceable
>help</replaceable
> for a lijst met beschikbare waarden.</entry>
</row>
<row>
  <entry
><option
>-of, --output-format</option
> <replaceable
>format</replaceable
></entry>
  <entry
>Hoe uitvoergegevens worden geformatteerd. Gebruik <replaceable
>help</replaceable
> for a lijst met beschikbare waarden.</entry>
</row>
<row>
  <entry
><option
>-if-opts, --input-format-options</option
> <replaceable
>opties</replaceable
></entry>
  <entry
>Specifieke opties voor formattering van invoergegevens. Gebruik <replaceable
>help</replaceable
> for a lijst met beschikbare waarden.</entry>
</row>
<row>
  <entry
><option
>-of-opts, --output-format-options</option
> <replaceable
>opties</replaceable
></entry>
  <entry
>Specifieke opties voor formattering van uitvoergegevens. Gebruik <replaceable
>help</replaceable
> for a lijst met beschikbare waarden.</entry>
</row>
<row>
  <entry
><option
>-ic, --input-codec</option
> <replaceable
>codering</replaceable
></entry>
  <entry
>Gebruikte tekstcodering voor invoergegevens. Gebruik <replaceable
>help</replaceable
> for a lijst met beschikbare waarden.</entry>
</row>
<row>
  <entry
><option
>-oc, --output-codec</option
> <replaceable
>codering</replaceable
></entry>
  <entry
>Te gebruiken tekstcodering voor uitvoergegevens. Gebruik <replaceable
>help</replaceable
> for a lijst met beschikbare waarden.</entry>
</row>

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

</chapter>

<chapter id="faq">
<title
>Vragen en antwoorden</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
>Welk configuratiebestand wordt door &kabcclient; gebruikt?</para>
</question>
<answer>
<para
>Geen.</para>
</answer>
</qandaentry>


<qandaentry>
<question>
<para
>Wat zijn de toepassingsnamen van &kabcclient;?</para>
</question>
<answer>
<para
>&kabcclient;'s application name is <application
>kabcclient</application
>.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Hoe kan ik mijn vraag toevoegen aan deze <acronym
>FAQ</acronym
>?</para>
</question>
<answer>
<para
>Zend uw vragen aan <email
>kevin.krammer@gmx.at</email
>.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title
>Dankbetuiging en licentie</title>

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

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

<para
>Documentatie copyright 2008:</para>
<itemizedlist>
<listitem
><para
>Kevin Krammer <email
>kevin.krammer@gmx.at</email
></para
></listitem>
</itemizedlist>

&meld.fouten;&vertaling.freek; 
&underFDL; &underGPL; </chapter>

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

<sect1 id="obtaining-application">
<title
>Hoe &kabcclient; te verkrijgen</title>
&install.intro.documentation; <para
>&kabcclient; komt met &kde;4 en is niet apart beschikbaar. </para>

</sect1>

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

<para
>&kabcclient; vereist de standaard &kde;-bibliotheken. Deze zijn te vinden in het <filename
>kdelibs</filename
>- en <filename
>kdepimlibs</filename
>-pakket. Om vanuit de broncode te compileren zijn ook &Qt;, de ontwikkelpakketten van <filename
>kdelibs</filename
> en <filename
>kdepimlibs</filename
> nodig.</para>

<para
>Een lijst van verbeteringen en aanpassingen is te vinden in het <filename
>ChangeLog</filename
>-bestand.</para>
</sect1>

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

<para
>Er is geen speciale configuratie vereist om &kabcclient; te gebruiken op het &kde;-bureaublad.</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:
-->
