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

<book lang="&language;">

<bookinfo>

<title
>Підручник з &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
>Юрій</firstname
><surname
>Чорноіван</surname
><affiliation
><address
><email
>yurchor@ukr.net</email
></address
></affiliation
><contrib
>Переклад українською</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
>20 листопада 2008 року</date>
<releaseinfo
>1.1.1</releaseinfo>

<abstract>
  <para
>&kabcclient; — це інтерфейс командного рядка для адресних книг &kde;.</para>
</abstract>


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

</bookinfo>

<chapter id="introduction">
<title
>Вступ</title>

<para
>&kabcclient; — це інтерфейс командного рядка до адресної книги &kde;. За його допомогою ви можете створювати списки, шукати, додавати, вилучати або об’єднувати списки контактів за допомогою командного рядка або скриптової мови. &kabcclient; може працювати на вході і на виході з файлами у багатьох форматах, тому ним можна скористатися для імпорту і експорту цілих адресних книг &kde;. </para>

<para
>Після запуску без додаткових параметрів &kabcclient; переходить у режим пошуку і намагається знайти відповідник до будь-яких введених даних, які він читає зі стандартного вводу, у записах контактів адресної книги &kde;.</para>

<para
>Основні можливості &kabcclient;: <itemizedlist>
  <listitem
><para
>Побудова списку всіх контактів з адресної книги &kde;</para
></listitem>
  <listitem
><para
>Пошук контактів за введеними даними</para
></listitem>
  <listitem
><para
>Вставка (додавання) контактів</para
></listitem>
  <listitem
><para
>Вилучення контактів</para
></listitem>
  <listitem
><para
>Об’єднання (зміна) відповідних контактів на основі нових даних</para
></listitem>
</itemizedlist
></para>

<para
>&kabcclient; <emphasis
>не</emphasis
> є ще одним графічним інтерфейсом користувача до адресної книги &kde; (на зразок &kaddressbook;). &kabcclient; призначено лише для використання у тих випадках, коли використання графічного інтерфейсу користувача є недоцільним або неможливим.</para>

<para
>У &kabcclient; <emphasis
>не</emphasis
> передбачено повноцінної мови для створення запитів до адресної книги користувача, автори не мали і не мають намірів щодо створення такої мови. Всі подібні запити можна виконати за допомогою інструментів командного рядка або можливостей мови, якою написано скрипт, що викликає програму. </para>

<para
>Щоб полегшити вивчення можливостей програми, всі параметри, які потребують визначення значення, можна викликати зі значенням <replaceable
>help</replaceable
>. Такий виклик призведе до показу всіх можливих значень, які може надати цьому параметру. </para>

</chapter>

<chapter id="features">
<title
>Можливості</title>
<para
>У цьому розділі ви ознайомитеся з основними можливостями &kabcclient; і навчитеся керувати програмою за допомогою параметрів командного рядка (пам’ятайте, що &kabcclient; не є графічним інтерфейсом користувача, ця програма працює лише з командним рядком).</para>

<para
>Ви дізнаєтеся, як вставити, вилучити або знайти дані контакту, а також ознайомитеся з прийомами використання різних форматів для вводу і виводу даних. </para>

<sect1 id="listing">
<title
>Показ списку адресної книги</title>

<para
>Це найпростіший режим роботи, у ньому програму можна запустити за допомогою параметра командного рядка <parameter
>--list</parameter
> або <parameter
>-L</parameter
>. &kabcclient; побудує список всіх контактів з адресної книги &kde; і запише дані до стандартного виводу програми. Розмір і формат виведених даних залежатиме від обраного формату виводу.</para>

<para>
<informalexample
><para
>Щоб побудувати список всіх контактів як стандартних записів vCard, виконайте команду:</para>

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

<para>
<informalexample
><para
>Щоб кожен контакт було записано у окремому рядку, наприклад, для обліку, виконайте команду:</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
>У наступному прикладі буде виведено список всіх адрес електронної пошти:</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
>Пошук контактів за введеними даними</title>

<para
>&kabcclient; може отримувати дані з командного рядка або зі стандартного вводу програми і знаходити відповідник серед усіх контактів у адресній книзі &kde;. Пошуковий режим є типовим, але його можна обрати і явно, якщо скористатися параметром командного рядка <parameter
>--search</parameter
> або <parameter
>-S</parameter
>. </para>

<para>
<informalexample
><para
>У наступному прикладі у стандартний вивід програми буде записано всі записи контактів, у яких рядок <replaceable
>Тетяна</replaceable
> є частиною будь-якого поля імені або адреси електронної пошти, дані буде виведено у форматі vCard (оскільки цей формат є типовим для параметра <option
>--output-format</option
>):</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>kabcclient</command
> <option
>--search</option
> <replaceable
>Тетяна</replaceable
></userinput
></screen>
</para>
</informalexample>
</para>

<para>
<informalexample
><para
>Знову той самий запит, цього разу рядок для пошуку буде отримано зі стандартного вводу програми:</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>echo</command
> <replaceable
>Тетяна</replaceable
> | <command
>kabcclient</command
> <option
>--search</option
></userinput
></screen>
</para>
</informalexample>
</para>

<para
>Перемикати чутливість до регістру символів можна за допомогою параметра <option
>--match-case</option
>.</para>
</sect1>

<sect1 id="adding">
<title
>Додавання контактів</title>

<para
>&kabcclient; підтримує додавання нових контактів до адресної книги &kde; за допомогою параметра командного рядка <parameter
>--add</parameter
> або <parameter
>-A</parameter
>. Дані може бути передано як параметри командного рядка, або прочитано зі стандартного вводу програми. У разі успішного додавання контакти буде виведено до стандартного виводу програми. Оскільки ця дія змінює вміст адресної книги, її можна спочатку виконати у тестовому режимі за допомогою параметра <option
>--nosave</option
>. </para>

<para>
<informalexample
><para
>Додавання контакту з іменем і адресою електронної пошти визначенням вхідних даних за допомогою додаткового параметра командного рядка:</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>kabcclient</command
> <option
>--add</option
> <option
>--input-format <replaceable
>email</replaceable
> </option
><replaceable
>"Іван Петрущак &lt;ivanpetrouchtchak@yahoo.com&gt;"</replaceable
></userinput
></screen>
</para>
</informalexample>
</para>

<para>
<informalexample
><para
>Додавання всіх контактів з файла vCard потоково переданого на стандартний вхід програми:</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>cat <replaceable
>приклад-файла.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
>Вилучення контактів</title>

<para
>&kabcclient; підтримує вилучення контактів з адресної книги &kde; за допомогою параметра командного рядка <parameter
>--remove</parameter
> або <parameter
>-R</parameter
>. Вхідними даними є дані, подібні на дані потрібні для пошуку у адресній книзі. У разі успішного вилучення контакти буде виведено до стандартного виводу програми. Оскільки ця дія змінює вміст адресної книги, її можна спочатку виконати у тестовому режимі за допомогою параметра <option
>--nosave</option
>. </para>

<warning
><para
>Після вилучення записів з адресної книги ви вже <emphasis
>не</emphasis
> зможете їх відновити! Іншими словами, дія з вилучення не підлягає скасуванню. Дані буде незворотно втрачено.</para
></warning>

<para>
<informalexample
><para
>Тестова спроба вилучення всіх контактів зі словом <replaceable
>Тетяна</replaceable
> у будь-якому з полів імені контакту або адреси його електронної пошти:</para>

<para>
<screen
><prompt
>%</prompt
><userinput
> <command
>kabcclient</command
> <option
>--remove</option
> <option
>--nosave</option
> <replaceable
>Тетяна</replaceable
></userinput
></screen>
</para>
</informalexample>
</para>

</sect1>

<sect1 id="formats">
<title
>Формати вводу і виводу даних</title>

<para
>&kabcclient; може сприймати вхідні дані і виводити вихідні дані відповідно до різних правил їх форматування. Залежно від потреб, певні комбінації форматів даватимуть вам бажаний результат. Для деяких з цих форматів можна вказати додаткові параметри, які налаштують параметри цих форматів. </para>

<para
>У текстових даних може бути різне кодування як на вході, так і на виході, тому символи тексту слід декодовувати певним чином на вході і закодовувати певним чином на виході. </para>

<para
>Всі ці параметри командного рядка виводять список можливих значень, якщо надати відповідному параметру значення <replaceable
>help</replaceable
>.</para>

<sect2 id="vcard-format">
<title
>Формат vCard</title>

<para
>vCard (<acronym
>RFC</acronym
> 2426) є стандартним форматом даних контактів, отже у ньому можна представити всі відомості інших адресних книг так, щоб програма &kaddressbook; могла отримувати до них доступ. Саме тому цей формат є типовим форматом для виведення інформації. </para>
</sect2>

<sect2 id="csv-format">
<title
>Формат значень, відокремлених комами (<acronym
>CSV</acronym
>)</title>

<para
>Форматом значень, відокремлених комами, (Comma-Separated Value) можна скористатися як форматом вхідних даних для заповнення даних певного поля запису контакту і як вихідним форматом, якщо вам потрібно зменшити об’єм даних або впорядкувати дані для наступної обробки. Щоб забезпечити достатню гнучкість відображення полів контакту у CSV, стовпчики може бути вказано за допомогою файлів опису шаблонів CSV, які також використовуються у &kaddressbook; з тією ж метою. </para>
</sect2>
</sect1>
</chapter>

<chapter id="features-commandline-options">
<title
>Параметри командного рядка</title>

<para
>&kabcclient; підтримує такі параметри командного рядка:</para>

<informaltable>
<tgroup cols="2">
<thead>
<row>
  <entry
>Параметр</entry>
  <entry
>Опис</entry>
</row>
</thead>
<tbody>
<row>
  <entry
><option
>--help, --help-all</option
></entry>
  <entry
>Показує довідку з параметрів програми.</entry>
</row>
<row>
  <entry
><option
>--author</option
></entry>
  <entry
>Показує відомості про авторів програми.</entry>
</row>
<row>
  <entry
><option
>-v, --version</option
></entry>
  <entry
>Показує відомості щодо версії програми.</entry>
</row>
<row>
  <entry
><option
>--license</option
></entry>
  <entry
>Показує інформацію про ліцензування програми.</entry>
</row>
<row>
  <entry
><option
>--verbose</option
></entry>
  <entry
>Виводить корисні повідомлення під час виконання програми.</entry>
</row>
<row>
  <entry
><option
>--nosave</option
></entry>
  <entry
>Вивести дані так, наче дію виконано, але не виконувати самої дії. Ця дія не змінює вміст адресної книги &kde;; не вставляє, не вилучає і не змінює жодного з існуючих контактів.</entry>
</row>
<row>
  <entry
><option
>--match-case</option
></entry>
  <entry
>Враховувати регістр символів під час порівняння вхідних даних з даними контакту з адресної книги.</entry>
</row>
<row>
  <entry
><emphasis
>Головні режими роботи:</emphasis
></entry>
</row>
<row>
  <entry
><option
>-L, --list</option
></entry>
  <entry
>Вивести всі контакти у вказаному форматі експорту даних.</entry>
</row>
<row>
  <entry
><option
>-A, --add</option
></entry>
  <entry
>Вставити контакти до адресної книги.</entry>
</row>
<row>
  <entry
><option
>-R, --remove</option
></entry>
  <entry
>Вилучити контакти з адресної книги.</entry>
</row>
<row>
  <entry
><option
>-M, --merge</option
></entry>
  <entry
>Об’єднати вхідні дані з відповідними даними контактів з адресної книги.</entry>
</row>
<row>
  <entry
><emphasis
>Формати і кодування:</emphasis
></entry>
</row>
<row>
  <entry
><option
>-if, --input-format</option
> <replaceable
>формат</replaceable
></entry>
  <entry
>Визначає спосіб інтерпретації вхідних даних. Скористайтеся значенням <replaceable
>help</replaceable
>, щоб переглянути список можливих значень.</entry>
</row>
<row>
  <entry
><option
>-of, --output-format</option
> <replaceable
>формат</replaceable
></entry>
  <entry
>Визначає формат виведених програмою даних. Скористайтеся значенням <replaceable
>help</replaceable
>, щоб переглянути список можливих значень.</entry>
</row>
<row>
  <entry
><option
>-if-opts, --input-format-options</option
> <replaceable
>параметри</replaceable
></entry>
  <entry
>Особливі параметри налаштування формату вхідних даних. Скористайтеся значенням <replaceable
>help</replaceable
>, щоб переглянути список можливих значень.</entry>
</row>
<row>
  <entry
><option
>-of-opts, --output-format-options</option
> <replaceable
>параметри</replaceable
></entry>
  <entry
>Особливі параметри налаштування формату вихідних даних. Скористайтеся значенням <replaceable
>help</replaceable
>, щоб переглянути список можливих значень.</entry>
</row>
<row>
  <entry
><option
>-ic, --input-codec</option
> <replaceable
>кодування</replaceable
></entry>
  <entry
>Кодування символів тексту, яке буде використано для вхідних даних. Скористайтеся значенням <replaceable
>help</replaceable
>, щоб переглянути список можливих значень.</entry>
</row>
<row>
  <entry
><option
>-oc, --output-codec</option
> <replaceable
>кодування</replaceable
></entry>
  <entry
>Кодування символів тексту, яке буде використано для вихідних даних. Скористайтеся значенням <replaceable
>help</replaceable
>, щоб переглянути список можливих значень.</entry>
</row>

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

</chapter>

<chapter id="faq">
<title
>Запитання і відповіді</title>
&reporting.bugs; &updating.documentation; <qandaset id="faqlist">
<qandaentry>
<question>
<para
>Які файли налаштування використовує &kabcclient;?</para>
</question>
<answer>
<para
>Ніяких.</para>
</answer>
</qandaentry>


<qandaentry>
<question>
<para
>Як називається програма, яка виконує дії &kabcclient;?</para>
</question>
<answer>
<para
>Програма, яка виконує дії &kabcclient; називається <application
>kabcclient</application
>.</para>
</answer>
</qandaentry>

<qandaentry>
<question>
<para
>Як додати своє питання до цих <acronym
>ЧаП</acronym
>?</para>
</question>
<answer>
<para
>Надішліть ваше питання за адресою електронної пошти <email
>kevin.krammer@gmx.at</email
>.</para>
</answer>
</qandaentry>

</qandaset>
</chapter>


<chapter id="credits">

<title
>Подяки і ліцензія</title>

<para
>Авторські права на програму &kabcclient; належать (©2005–2008):</para>

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

<para
>Авторські права на документацію належать (©2008):</para>
<itemizedlist>
<listitem
><para
>Kevin Krammer <email
>kevin.krammer@gmx.at</email
></para
></listitem>
</itemizedlist>

<para
>Переклад українською: Юрій Чорноіван <email
>yurchor@ukr.net</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Встановлення</title>

<sect1 id="obtaining-application">
<title
>Як отримати &kabcclient;</title>
&install.intro.documentation; <para
>&kabcclient; є частиною &kde;4, програму не можна отримати окремо. </para>

</sect1>

<sect1 id="requirements">
<title
>Вимоги</title>

<para
>Для роботи &kabcclient; потрібно встановити стандартні бібліотеки &kde; (пакунки <filename
>kdelibs</filename
> і <filename
>kdepimlibs</filename
>). Щоб зібрати програму з початкових кодів, вам також доведеться встановити пакунки для розробки &Qt;, <filename
>kdelibs</filename
> і <filename
>kdepimlibs</filename
>.</para>

<para
>Зі списком змін ви можете ознайомитися у файлі <filename
>ChangeLog</filename
>.</para>
</sect1>

<sect1 id="configuration">
<title
>Налаштування</title>

<para
>Для налаштування на запуск &kabcclient; у середовищі стільниці &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:
-->
