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

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

<bookinfo id="kabcclientinfo">

<title
>Handbok &kabcclient;</title>

<authorgroup>
  <author
><firstname
>Kevin</firstname
> <surname
>Krammer</surname
> <affiliation
> <address
> <email
>kevin.krammer@gmx.at</email>
      </address>
    </affiliation>
  </author>
  <othercredit role="translator"
> <firstname
>Stefan</firstname
> <surname
>Asserhäll</surname
> <affiliation
><address
><email
>stefan.asserhall@comhem.se</email
></address
></affiliation
> <contrib
>Översättare</contrib
></othercredit
> 
</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; är ett kommandoradgränssnitt för &kde;:s adressböcker.</para>
</abstract>


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

</bookinfo>

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

<para
>&kabcclient; är ett kommandoradgränssnitt för &kde;:s adressbok. Det låter dig lista, söka, infoga, ta bort eller sammanfoga kontakter via kommandoraden eller från ett skriptspråk. &kabcclient; kan hantera ett antal olika format, både som indata och utdata, vilket gör det möjligt att använda det för import och export av hela adressböcker i &kde;. </para>

<para
>När &kabcclient; startas utan väljare hamnar det i sökläge och försöker passa ihop indata som kan läsas från standardinmatningen med kontaktposter i &kde;:s adressbok.</para>

<para
>Huvudfunktioner i &kabcclient;: <itemizedlist>
  <listitem
><para
>Lista alla kontakter i &kde;:s adressbok</para
></listitem>
  <listitem
><para
>Sökning efter kontakter som motsvarar indata</para
></listitem>
  <listitem
><para
>Infoga (lägg till) kontakter</para
></listitem>
  <listitem
><para
>Ta bort kontakter</para
></listitem>
  <listitem
><para
>Sammanfoga (ändra) hittade kontakter med ny data</para
></listitem>
</itemizedlist
></para>

<para
>&kabcclient; är <emphasis
>inte</emphasis
> ytterligare ett grafiskt användargränssnitt för &kde;:s adressbok (dvs. &kaddressbook;). &kabcclient; är bara avsett för användning där ett grafiskt användargränssnitt inte är praktiskt eller möjligt.</para>

<para
>&kabcclient; tillhandahåller <emphasis
>inte</emphasis
> ett fullständigt språk för att göra förfrågningar om användarens adressbok, det är heller inte upphovsmännens avsikt att någonsin lägga till en sådan möjlighet. All sådan behandling kan göras via andra kommandoradsverktyg eller skriptspråkets egna möjligheter. </para>

<para
>För att förenkla möjligheten att upptäcka funktioner, kan alla väljare som kräver ett argument anropas med värdet <replaceable
>help</replaceable
>. Då listas alla giltiga värden som kan anges för den väljaren. </para>

</chapter>

<chapter id="features">
<title
>Funktioner</title>
<para
>I det här kapitlet lär du dig om huvudfunktionerna i &kabcclient;, och hur du kan styra dem med kommandoradsväljare (kom ihåg att &kabcclient; inte har ett grafiskt användargränssnitt, utan bara är ett kommadoradsprogram).</para>

<para
>Du lär dig om att infoga, ta bort och söka efter kontaktdata, och hur man använder olika format för indata och utdata. </para>

<sect1 id="listing">
<title
>Lista adressboken</title>

<para
>Det här är den mest grundläggande användningen, initierad genom att använda väljaren <parameter
>--list</parameter
> eller <parameter
>-L</parameter
>. &kabcclient; listar alla kontakter i &kde;:s adressbok, och skriver data till programmets standardutmatning. Utmatningens längd och format beror på valt utmatningsformat.</para>

<para>
<informalexample
><para
>För att lista alla kontakter som vanliga vCard-poster, kör helt enkelt:</para>

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

<para>
<informalexample
><para
>För att bara få en rad per kontakt, t.ex. för att räkna antalet, kör helt enkelt:</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
>I nästa exempel listar vi alla e-postadresser:</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
>Söker efter kontakter som motsvarar indata</title>

<para
>&kabcclient; kan ta data från kommandoraden eller från programmets standardinmatning och kontrollera om det har likheter med någon av kontakterna i &kde;:s adressbok. Sökning är standardläget men det kan väljas explicitmed kommandoradsväljarna <parameter
>--search</parameter
> eller <parameter
>-S</parameter
>. </para>

<para>
<informalexample
><para
>I följande exempel skrivs alla kontakter där <replaceable
>anna</replaceable
> ingår i något namnfält eller e-postadress till programmets standardutmatning, formaterade som vCard (eftersom det är förvalt värde för väljaren <option
>--output-format</option
>):</para>

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

<para>
<informalexample
><para
>Samma fråga igen, men den här gången läses söksträngen från programmets standardinmatning:</para>

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

<para
>Frågornas känslighet för skifläget kan ändras med alternativet <option
>--match-case</option
>.</para>
</sect1>

<sect1 id="adding">
<title
>Lägga till kontakter</title>

<para
>&kabcclient; stöder tillägg av nya kontakter i &kde;:s adressbok genom att använda kommandoradsväljaren <parameter
>--add</parameter
> eller <parameter
>-A</parameter
>. Data kan antingen skickas som ytterligare kommandoradsväljare eller läsas från standardinmatningen. Om det lyckas, skrivs resultatets kontakter till programmets standardutmatning. Eftersom det här är en åtgärd som förändrar adressboken kan det köras "på försök" med väljaren <option
>--nosave</option
>. </para>

<para>
<informalexample
><para
>Lägg till en kontakt med namn och e-postadress genom att tolka ytterligare en kommandoradsväljare som indata:</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>kabcclient</command
> <option
>--add</option
> <option
>--input-format <replaceable
>email</replaceable
> </option
><replaceable
>"Anna Johansson &lt;a.johansson@exempel.se&gt;"</replaceable
></userinput
></screen>
</para>
</informalexample>
</para>

<para>
<informalexample
><para
>Lägg till alla kontakter från en vCard-fil inskickade till programmets standardinmatning:</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>cat <replaceable
>exempelfil.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
>Ta bort kontakter</title>

<para
>&kabcclient; stöder att ta bort kontakter från &kde;:s adressbok genom att använda kommandoradsväljaren <parameter
>--remove</parameter
> eller <parameter
>-R</parameter
>. Indata är egentligen en förfrågan, som vid en sökning i adressboken. Om det lyckas, skrivs de borttagna kontakterna till programmets standardutmatning. Eftersom det här är en åtgärd som förändrar adressboken kan det köras "på försök" med väljaren <option
>--nosave</option
>. </para>

<warning
><para
>När du tar bort något från adressboken kan du <emphasis
>inte</emphasis
> ångra det! Med andra ord, när du tar bort en kontakt kan du inte återställa den igen. Den är borta för alltid.</para
></warning>

<para>
<informalexample
><para
>Prova att ta bort alla kontakter med <replaceable
>anna</replaceable
> i något kontaktnamnsfält eller någon e-postadress:</para>

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

</sect1>

<sect1 id="formats">
<title
>Indata- och utdataformat</title>

<para
>&kabcclient; kan tolka indata och formatera utdata enligt diverse formateringsregler. Beroende på det verkliga användningsfallet, ger vissa kombinationer det mest användbara resultatet. Vissa format accepterar ytterligare väljare för att ytterligare anpassa deras beteende. </para>

<para
>Eftersom textdata kan vara kodat, kan både indata och utdata utsättas för ytterligare avkodning respektive kodning. </para>

<para
>Alla kommandoradsväljarna reagerar på specialvärdet <replaceable
>help</replaceable
> med att lista tillåtna värden.</para>

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

<para
>Standardformatet för kontaktdata är vCard (<acronym
>RFC</acronym
> 2426), och som sådant kan det presentera all information som andra adressboksprogram såsom &kaddressbook; kan komma åt. Det är därför standardformat för utdataformatering. </para>
</sect2>

<sect2 id="csv-format">
<title
>Format med värden åtskilda av kommatecken (<acronym
>CSV</acronym
>)</title>

<para
>Format med värden åtskilda av kommatecken kan användas som indataformat för att fylla i data i specifika fält av en kontaktpost, och som utdataformat för att minska eller ordna om data vid ytterligare behandling. För att ge tillräckligt flexibilitet, kan avbildningen av kontaktfält till CSV-kolumner specificeras med CSV-mallbeskrivningsfiler, vilka också används av &kaddressbook; i samma syfte. </para>
</sect2>
</sect1>
</chapter>

<chapter id="features-commandline-options">
<title
>Kommandoradsväljare</title>

<para
>&kabcclient; stöder följande väljare:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Väljare</entry>
  <entry
>Beskrivning</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--help, --help-all</option
></entry>
  <entry
>Visar hjälp om programmets väljare.</entry>
</row>
<row>
  <entry
><option
>--author</option
></entry>
  <entry
>Visar information om programmets upphovsmän.</entry>
</row>
<row>
  <entry
><option
>-v, --version</option
></entry>
  <entry
>Visar programmets versionsinformation.</entry>
</row>
<row>
  <entry
><option
>--license</option
></entry>
  <entry
>Visar programmets licensinformation.</entry>
</row>
<row>
  <entry
><option
>--verbose</option
></entry>
  <entry
>Skriver ut hjälpsamma meddelanden under körning.</entry>
</row>
<row>
  <entry
><option
>--nosave</option
></entry>
  <entry
>Skriv ut vad som skulle ha gjorts, men utför det inte. Ändra ingenting i &kde;:s adressbok. Infoga, ta bort eller ändra inte några befintliga kontakter.</entry>
</row>
<row>
  <entry
><option
>--match-case</option
></entry>
  <entry
>Använd skiftlägeskänslig jämförelse när indata jämförs med kontaktdata från adressboken.</entry>
</row>
<row>
  <entry
><emphasis
>Huvudkommandolägen:</emphasis
></entry>
</row>
<row>
  <entry
><option
>-L, --list</option
></entry>
  <entry
>Skriv ut alla kontakter med angivet exportformat.</entry>
</row>
<row>
  <entry
><option
>-A, --add</option
></entry>
  <entry
>Infoga kontakter i adressboken.</entry>
</row>
<row>
  <entry
><option
>-R, --remove</option
></entry>
  <entry
>Ta bort kontakter från adressboken.</entry>
</row>
<row>
  <entry
><option
>-M, --merge</option
></entry>
  <entry
>Sammanfoga indata med motsvarande kontakter i adressboken.</entry>
</row>
<row>
  <entry
><emphasis
>Formatering och kodning:</emphasis
></entry>
</row>
<row>
  <entry
><option
>-if, --input-format</option
> <replaceable
>format</replaceable
></entry>
  <entry
>Hur indata ska tolkas. Använd <replaceable
>help</replaceable
> för att få en lista med tillgängliga värden.</entry>
</row>
<row>
  <entry
><option
>-of, --output-format</option
> <replaceable
>format</replaceable
></entry>
  <entry
>Hur utdata ska formateras. Använd <replaceable
>help</replaceable
> för att få en lista med tillgängliga värden.</entry>
</row>
<row>
  <entry
><option
>-if-opts, --input-format-options</option
> <replaceable
>alternativ</replaceable
></entry>
  <entry
>Inställningsalternativ specifika för indataformatet. Använd <replaceable
>help</replaceable
> för att få en lista med tillgängliga värden.</entry>
</row>
<row>
  <entry
><option
>-of-opts, --output-format-options</option
> <replaceable
>alternativ</replaceable
></entry>
  <entry
>Inställningsalternativ specifika för utdataformatet. Använd <replaceable
>help</replaceable
> för att få en lista med tillgängliga värden.</entry>
</row>
<row>
  <entry
><option
>-ic, --input-codec</option
> <replaceable
>kodning</replaceable
></entry>
  <entry
>Textkodning som ska användas för att visa indata. Använd <replaceable
>help</replaceable
> för att få en lista med tillgängliga värden.</entry>
</row>
<row>
  <entry
><option
>-oc, --output-codec</option
> <replaceable
>kodning</replaceable
></entry>
  <entry
>Textkodning som ska användas för att visa utdata. Använd <replaceable
>help</replaceable
> för att få en lista med tillgängliga värden.</entry>
</row>

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

</chapter>

<chapter id="faq">
<title
>Vanliga frågor</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
>Vilka inställningsfiler använder &kabcclient;?</para>
</question>
<answer>
<para
>Inga.</para>
</answer>
</qandaentry>


<qandaentry>
<question>
<para
>Vad är programnamn för &kabcclient;?</para>
</question>
<answer>
<para
>&kabcclient;s programnamn är <application
>kabcclient</application
>.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Hur kan jag få en fråga tillagd bland de här vanliga frågorna?</para>
</question>
<answer>
<para
>Skicka dina frågor till <email
>kevin.krammer@gmx.at</email
>.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title
>Tack till och licens</title>

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

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

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

<para
>Översättning Stefan Asserhäll <email
>stefan.asserhall@comhem.se</email
></para
> 
&underFDL; &underGPL; </chapter>

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

<sect1 id="obtaining-application">
<title
>Hur man skaffar &kabcclient;</title>
&install.intro.documentation; <para
>&kabcclient; levereras inkluderat i &kde;4 och är inte separat tillgängligt. </para>

</sect1>

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

<para
>&kabcclient; kräver att &kde;:s standardbibliotek är installerade (paketen <filename
>kdelibs</filename
> och <filename
>kdepimlibs</filename
>). För att kompilera från källkod, behöver du också &Qt; och utvecklingspaketen för <filename
>kdelibs</filename
> och <filename
>kdepimlibs</filename
>.</para>

<para
>Du hittar en lista över ändringar i filen <filename
>ChangeLog</filename
>.</para>
</sect1>

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

<para
>Det krävs ingen särskild anpassning för att ställa in &kabcclient; att köra på &kde;-skrivbordet.</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:
-->
