<?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 >2008-11-20</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 >"Іван Петрущак <ivanpetrouchtchak@yahoo.com>"</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: -->