natgillin/translations-raw huggingface dataset:
& kabcclient; is not another graphical user interface to the & kde; address book (i. e. & kaddressbook;). & kabcclient; is intended solely for uses where a graphical user interface is not practical or possible.
& kabcclient; не є ще одним графічним інтерфейсом користувача до адресної книги & kde; (на зразок & kaddressbook;). & kabcclient; призначено лише для використання у тих випадках, коли використання графічного інтерфейсу користувача є недоцільним або неможливим.
& kabcclient; does not provide a full-featured language for making queries of the user's address book nor is it the intention of the authors to ever write such a capability. Any such processing can be done through other command line tools or the script's own language's capabilities.
У & kabcclient; не передбачено повноцінної мови для створення запитів до адресної книги користувача, автори не мали і не мають намірів щодо створення такої мови. Всі подібні запити можна виконати за допомогою інструментів командного рядка або можливостей мови, якою написано скрипт, що викликає програму.
To ease discoverability of its capabilities, any option requiring an argument can be called with the value help. This will then list all the valid values one can pass to that option.
Щоб полегшити вивчення можливостей програми, всі параметри, які потребують визначення значення, можна викликати зі значенням help. Такий виклик призведе до показу всіх можливих значень, які може надати цьому параметру.
In this chapter you'll learn about the main features of & kabcclient; and how to control them using the command line parameters (remember that & kabcclient; is not a graphical user interface; it is a command line program only).
У цьому розділі ви ознайомитеся з основними можливостями & kabcclient; і навчитеся керувати програмою за допомогою параметрів командного рядка (пам’ ятайте, що & kabcclient; не є графічним інтерфейсом користувача, ця програма працює лише з командним рядком).
You'll learn about inserting, deleting, and searching for contact data, and how to use different formats for input and output.
Ви дізнаєтеся, як вставити, вилучити або знайти дані контакту, а також ознайомитеся з прийомами використання різних форматів для вводу і виводу даних.
Listing the address book
Показ списку адресної книги
This is the most basic operation mode, initiated using the --list or -L option. & kabcclient; will list all contacts in the & kde; address book, writing the data to the program's standard output. Amount and format of the output will depend on the chosen output format.
Це найпростіший режим роботи, у ньому програму можна запустити за допомогою параметра командного рядка -- list або - L. & kabcclient; побудує список всіх контактів з адресної книги & kde; і запише дані до стандартного виводу програми. Розмір і формат виведених даних залежатиме від обраного формату виводу.
To list all contacts as standard vCard entries, simply run:
Щоб побудувати список всіх контактів як стандартних записів vCard, виконайте команду:
To get just one line per contact, e. g. for counting, simply run:
Щоб кожен контакт було записано у окремому рядку, наприклад, для обліку, виконайте команду:
In this next example, we list all e-mail addresses:
У наступному прикладі буде виведено список всіх адрес електронної пошти:
Searching for contacts matching the input data
Пошук контактів за введеними даними
& kabcclient; can take data from the command line or from the program's standard input and check it for similarities against all contacts in the & kde; address book. Searching is the default mode but it can be explicitly be chosen using the --search or -S command line argument.
& kabcclient; може отримувати дані з командного рядка або зі стандартного вводу програми і знаходити відповідник серед усіх контактів у адресній книзі & kde;. Пошуковий режим є типовим, але його можна обрати і явно, якщо скористатися параметром командного рядка -- search або - S.
In the following example, all contacts with jane as part of any name field or e-mail address will be written to the program's standard output, formatted as vCards (since this is the default for the --output-format option):
У наступному прикладі у стандартний вивід програми буде записано всі записи контактів, у яких рядок Тетяна є частиною будь- якого поля імені або адреси електронної пошти, дані буде виведено у форматі vCard (оскільки цей формат є типовим для параметра -- output- format):
% kabcclient --search jane
% kabcclient -- search Тетяна
Same query again, this time reading the search string from the program's standard input:
Знову той самий запит, цього разу рядок для пошуку буде отримано зі стандартного вводу програми:
% echo jane _BAR_ kabcclient --search
% echo Тетяна _BAR_ kabcclient -- search
Case sensitivity of queries can be toggled using the --match-case option.
Перемикати чутливість до регістру символів можна за допомогою параметра -- match- case.
Adding contacts
Додавання контактів
& kabcclient; supports adding new contacts to the & kde; address book using the --add or -A command line argument. The data can either be passed as additional command line arguments or read from standard input. On success the resulting contacts will be written to the program's standard output. Since this is an operation which applies changes to the address book it can be run in a "Dry run" mode using the --nosave option.
& kabcclient; підтримує додавання нових контактів до адресної книги & kde; за допомогою параметра командного рядка -- add або - A. Дані може бути передано як параметри командного рядка, або прочитано зі стандартного вводу програми. У разі успішного додавання контакти буде виведено до стандартного виводу програми. Оскільки ця дія змінює вміст адресної книги, її можна спочатку виконати у тестовому режимі за допомогою параметра -- nosave.
Add a contact with name and e-mail address by interpreting an additional command line argument as the input data:
Додавання контакту з іменем і адресою електронної пошти визначенням вхідних даних за допомогою додаткового параметра командного рядка:
% kabcclient --add --input-format email "John Doe & lt; j. doe@example. comgt;"
% kabcclient -- add -- input- format email "Іван Петрущак & lt; ivanpetrouchtchak@ yahoo. comgt;"
Add all contacts from a vCard file streamed into the program's standard input:
Додавання всіх контактів з файла vCard потоково переданого на стандартний вхід програми:
% cat example-file. vcf _BAR_ kabcclient --add --input-format vcard
% cat приклад- файла. vcf _BAR_ kabcclient -- add -- input- format vcard
Deleting contacts
Вилучення контактів
& kabcclient; supports deleting contacts from the & kde; address book using the --remove or -R command line argument. The input data is basically a query like when searching the address book. On success the removed contacts will be written to the program's standard output. Since this is an operation which applies changes to the address book it can be run in a "Dry run" mode using the --nosave option.
& kabcclient; підтримує вилучення контактів з адресної книги & kde; за допомогою параметра командного рядка -- remove або - R. Вхідними даними є дані, подібні на дані потрібні для пошуку у адресній книзі. У разі успішного вилучення контакти буде виведено до стандартного виводу програми. Оскільки ця дія змінює вміст адресної книги, її можна спочатку виконати у тестовому режимі за допомогою параметра -- nosave.
When you delete something from the address book you cannot undo it! In other words, when you delete a contact you cannot reverse the deletion. It's gone for good.
Після вилучення записів з адресної книги ви вже не зможете їх відновити! Іншими словами, дія з вилучення не підлягає скасуванню. Дані буде незворотно втрачено.
Test removing all contacts with jane in any contact name field or any e-mail address:
Тестова спроба вилучення всіх контактів зі словом Тетяна у будь- якому з полів імені контакту або адреси його електронної пошти:
% kabcclient --remove --nosave jane
% kabcclient -- remove -- nosave Тетяна
Input and Output Formats
Формати вводу і виводу даних
& kabcclient; can interpret input data and format output data according to various formatting rules. Depending on the actual usage scenario certain combinations will render the most useful result. Some of the formats understand additional parameters for further customizing their behavior.
& kabcclient; може сприймати вхідні дані і виводити вихідні дані відповідно до різних правил їх форматування. Залежно від потреб, певні комбінації форматів даватимуть вам бажаний результат. Для деяких з цих форматів можна вказати додаткові параметри, які налаштують параметри цих форматів.
Since textual data can be encoded both input and output can be subjected to additional decoding or encoding respectively.
У текстових даних може бути різне кодування як на вході, так і на виході, тому символи тексту слід декодовувати певним чином на вході і закодовувати певним чином на виході.
All those command line options will react to the special value help by listing the allowed values.
Всі ці параметри командного рядка виводять список можливих значень, якщо надати відповідному параметру значення help.
vCard Format
Формат vCard
vCard (RFC 2426) is the standard format for contact data and as such can present all information other address book applications such as & kaddressbook; can access. It is therefore the default format for output formatting.
vCard (RFC 2426) є стандартним форматом даних контактів, отже у ньому можна представити всі відомості інших адресних книг так, щоб програма & kaddressbook; могла отримувати до них доступ. Саме тому цей формат є типовим форматом для виведення інформації.
Comma-Separated Values (CSV) Format
Формат значень, відокремлених комами (CSV)
Comma-Separated Value Format can be used as input format to fill data into specific field of a contact entry and as an output format to reduce or re-order data for further processing. To allow for enough flexibility mapping of contact fields to CSV columns can be specified using CSV-template description files also used by & kaddressbook; for the same purpose.
Форматом значень, відокремлених комами, (Comma- Separated Value) можна скористатися як форматом вхідних даних для заповнення даних певного поля запису контакту і як вихідним форматом, якщо вам потрібно зменшити об’ єм даних або впорядкувати дані для наступної обробки. Щоб забезпечити достатню гнучкість відображення полів контакту у CSV, стовпчики може бути вказано за допомогою файлів опису шаблонів CSV, які також використовуються у & kaddressbook; з тією ж метою.
Command Line Arguments
Параметри командного рядка
& kabcclient; supports the following options:
& kabcclient; підтримує такі параметри командного рядка:
Shows help about the program options.
Показує довідку з параметрів програми.
Shows the program author information.
Показує відомості про авторів програми.
Shows the program version information.
Показує відомості щодо версії програми.
Shows the program license information.
Показує інформацію про ліцензування програми.
Print helpful runtime messages.
Виводить корисні повідомлення під час виконання програми.
Print what would have been done, but do not execute. Do not change anything in the & kde; address book; do not insert, remove, modify any existing contacts.
Вивести дані так, наче дію виконано, але не виконувати самої дії. Ця дія не змінює вміст адресної книги & kde;; не вставляє, не вилучає і не змінює жодного з існуючих контактів.
Use case sensitive matching when comparing input data with contact data from the address book.
Враховувати регістр символів під час порівняння вхідних даних з даними контакту з адресної книги.
Major Operation Modes:
Головні режими роботи:
Print all contacts in specified export format.
Вивести всі контакти у вказаному форматі експорту даних.
Insert contacts into the address book.
Вставити контакти до адресної книги.
Delete contacts from the address book.
Вилучити контакти з адресної книги.
Merge data from the input with matching contacts from the address book.
Об’ єднати вхідні дані з відповідними даними контактів з адресної книги.
Formatting and Encoding:
Формати і кодування:
-if, --input-format format
- if, -- input- format формат
How to interpret the input data. Use help for a list of available values.
Визначає спосіб інтерпретації вхідних даних. Скористайтеся значенням help, щоб переглянути список можливих значень.
-of, --output-format format
- of, -- output- format формат
How to format the output data. Use help for a list of available values.
Визначає формат виведених програмою даних. Скористайтеся значенням help, щоб переглянути список можливих значень.
-if-opts, --input-format-options options
- if- opts, -- input- format- options параметри
Input format specific customization options. Use help for a list of available values.
Особливі параметри налаштування формату вхідних даних. Скористайтеся значенням help, щоб переглянути список можливих значень.
-of-opts, --output-format-options options
- of- opts, -- output- format- options параметри
Output format specific customization options. Use help for a list of available values.
Особливі параметри налаштування формату вихідних даних. Скористайтеся значенням help, щоб переглянути список можливих значень.
-ic, --input-codec encoding
- ic, -- input- codec кодування
Text encoding used to present the input data. Use help for a list of available values.
Кодування символів тексту, яке буде використано для вхідних даних. Скористайтеся значенням help, щоб переглянути список можливих значень.
-oc, --output-codec encoding
- oc, -- output- codec кодування
Text encoding which should be used to present the output data. Use help for a list of available values.
Кодування символів тексту, яке буде використано для вихідних даних. Скористайтеся значенням help, щоб переглянути список можливих значень.
What configuration files does & kabcclient; use?
Які файли налаштування використовує & kabcclient;?
None.
Ніяких.
What are the application names of & kabcclient;?
Як називається програма, яка виконує дії & kabcclient;?
& kabcclient; 's application name is kabcclient.
Програма, яка виконує дії & kabcclient; називається kabcclient.
How do I have my question added to this FAQ?
Як додати своє питання до цих ЧаП?
Send your questions to kevin. krammer@gmx. at.
Надішліть ваше питання за адресою електронної пошти kevin. krammer@ gmx. at.
& kabcclient; Program copyright 2005-2008:
Авторські права на програму & kabcclient; належать (©2005– 2008):
Documentation copyright 2008:
Авторські права на документацію належать (©2008):
How to obtain & kabcclient;
Як отримати & kabcclient;
& kabcclient; comes included with & kde; 4 and is not available separately.
& kabcclient; є частиною & kde; 4, програму не можна отримати окремо.
& kabcclient; requires the standard & kde; libraries to be installed (the kdelibs package and kdepimlibs). To compile from source, you also need the & Qt;, kdelibs and kdepimlibs development packages.
Для роботи & kabcclient; потрібно встановити стандартні бібліотеки & kde; (пакунки kdelibs і kdepimlibs). Щоб зібрати програму з початкових кодів, вам також доведеться встановити пакунки для розробки & Qt;, kdelibs і kdepimlibs.
You can find a list of changes in the ChangeLog file.
Зі списком змін ви можете ознайомитися у файлі ChangeLog.
No special configuration is required to set up & kabcclient; to run on the & kde; desktop.
Для налаштування на запуск & kabcclient; у середовищі стільниці & kde; додаткове налаштування не потрібне.
commandline client for the & kde; addressbook
клієнт адресної книги & kde;, який працює з командного рядка
kabcclient -A -R -M -S -L --match-case --nosave -ic codec -if format -if-opts format-options -oc codec -of format -of-opts format-options input-data
kabcclient - A - R - M - S - L -- match- case -- nosave - ic кодек - if формат - if- opts параметри формату - oc кодек - of формат - of- opts параметри формату вхідні дані
kabcclient allows commandline access to the & kde; addressbook, for example in shell scripts. It supports input from stdin or through additional commandline arguments. Output is always written to stdout.
За допомогою kabcclient можна у командному рядку, наприклад зі скриптів оболонки, отримати доступ до адресної книги & kde;. Програма підтримує отримання вхідних відомостей з stdin або з параметрів командного рядка. Результат дій завжди виводиться до stdout.
Operation modes
Режими роботи
Add a new contact entry to the addressbook
Додати новий запис контакту до адресної книги
Removes an existing contact entry from the addressbook
Вилучає існуючий запис контакту з адресної книги
Merges input data with an existing contact entry from the addressbook. This appends any new information to the already existing one
Об’ єднує вхідні дані з існуючим записом контакту з адресної книги. За допомогою цього параметра можна додати будь- яку нову інформацію до вже існуючої.
Searches the addressbook for matching contact entries
Виконує пошук у адресній книзі відповідних записі контактів
Lists all contact entries of the addressbook
Виводить список всіх записів контактів з адресної книги.
Input options
Параметри вхідної інформації
Pass input text through a specified text encoding. See -ic help for additional information about input codecs. Default is local which will use the codec for the current locale 5 settings
Визначає кодування для вхідного тексту. Додаткові відомості щодо наявних кодеків можна отримати за допомогою параметра - ic help. Типовим значенням є local, за якого буде використано кодек, що відповідає поточним параметрам locale 5
Parses the input text according to given formatting rules. See -if help for available formats. Default is search
Обробляє вхідний текст згідно до вказаних параметрів форматування. Список доступних форматів можна переглянути за допомогою параметра - if help. Типовим є режим search
Instead of reading input text kabcclient can show a dialog for selecting contacts using the input format
Замість читання вхідного тексту kabcclient може показати діалогове повідомлення для вибору контактів на основі вхідного формату
dialog
діалогове вікно
Additional options for the chosen input format. Can be optional as well as mandatory depending on the format. See -if-opts help for available format options
Додаткові параметри для обраного вхідного формату. Можуть бути обов’ язковими або необов’ язковими, залежно від формату. Список доступних параметрів формату можна переглянути за допомогою параметра - if- opts help.
Output options
Параметри вихідних даних
Pass output text through a specified text encoding. See -oc help for additional information about output codecs. Default is local which will use the codec for the current locale 5 settings.
Визначає кодування для вихідного тексту. Додаткові відомості щодо наявних кодеків можна отримати за допомогою параметра - oc help. Типовим значенням є local, за якого буде використано кодек, що відповідає поточним параметрам locale 5
Formats the output text according to given formatting rules. See -of help for available formats. Default is vcard
Форматує вихідний текст відповідно до вказаних правил форматування. Список доступних форматів можна отримати за допомогою параметра - of help. Типовим значенням є vcard
Additional options for the chosen output format. Can be optional as well as mandatory depending on the format. See -of-opts help for available format options
Додаткові параметри для обраного формату вихідних даних. Можуть бути обов’ язковими або необов’ язковими, залежно від формату. Список доступних параметрів формату можна переглянути за допомогою параметра - of- opts help.
Additional options
Додаткові параметри
Use case sensitive text matching when comparing input text with contact entries
Враховувати регістр символів під час порівняння вхідного тексту з записами контактів.
Perform information changing operations like -A, -R or -M only in memory but do not write the changes back to the addressbook
Виконати дії зі зміни відомостей, на зразок дій, що відповідають параметрам - A, - R або - M, лише у пам’ яті комп’ ютера, без запису цих змін до адресної книги.
Diagnostics
Діагностика
As usual an exit status of zero indicates success. Depending on the chosen operation mode a non-zero exit status indicates a certain problem the application encountered
Зазвичай, нульовий стан виходу означає успіх. Залежно від обраного режиму дій, ненульовий стан виходу означає певні негаразди з програмою.
Reading the input text failed
Спроба читання вхідного тексту була невдалою
Creating a suitable contact entry from the input text failed, e. g. not data or wrongly formatted input for the chosen input format
Спроба створення відповідного запису контакту на основі вхідного тексту була невдалою, причиною може бути відсутність даних або помилковий формат даних для обраного вхідного формату.
Saving the addressbook changes failed. This can be caused for example by other applications currently locking the addressbook.
Спроба збереження адресної книги була невдалою. Причиною цього може бути те, що інші програми блокують доступ до адресної книги.
The program could not remove any contact entry from the addressbook. This can be caused by failing to parse the input text, failing to find a matching contact entry in the addressbook or finding more than one matching contact entry in the addressbook. In the latter case an error message is written to stderr
Програмі не вдалося вилучити жодного запису з адресної книги. Причиною цього може бути невдала спроба обробки вхідних даних, неможливість знаходження відповідного запису контакту у адресній книзі або знаходження декількох записів контактів у адресній книзі. У останньому випадку повідомлення про помилку буде записано до stderr.
The program could not merge the input with any contact entry from the addressbook. This can be caused by failing to parse the input text, failing to find a matching contact entry in the addressbook or finding more than one matching contact entry in the addressbook. In the latter case an error message is written to stderr
Програмі не вдалося об’ єднати вхідні дані з записом з адресної книги. Причиною цього може бути невдала спроба обробки вхідних даних, неможливість знаходження відповідного запису контакту у адресній книзі або знаходження декількох записів контактів у адресній книзі. У останньому випадку повідомлення про помилку буде записано до stderr.
The program could not find any matching contact entry in the addressbook. This can be caused by failing to parse the input text or failing to find a matching contact entry in the addressbook
Програмі не вдалося знайти відповідний запис контакту у адресній книзі. Причиною цього може бути невдала спроба обробки вхідного тексту або невдала спроба пошуку запису контакту у адресній книзі.
Look for contact entries with Joe in either name or email addresses
Знайти записи контактів з рядком « Joe » у імені або адресі електронної пошти
Do the same but use case sensitive matching
Виконати ті самі дії але з врахуванням регістру.
Do the same but read input text from stdin
Виконати ті самі дії, але прочитати вхідний текст з stdin.
Try to add a new contact entry using data from a formatted email address
Спробувати додати новий запис контакту на основі даних з форматованої адреси електронної пошти.
Do the same but this time really save the changed addressbook
Виконати ті самі дії, але цього разу насправді зберегти зміни до адресної книги.
Listing the available input formats
Вивести список доступних форматів вхідних даних.
Listing the available output formats
Вивести список всіх доступних форматів вихідної інформації.
Listing the available options for the'email 'output format
Вивести список всіх доступних параметрів для вихідного формату « email »
Listing all email addresses for all contacts containing'Marilyn '
Показати список всіх адрес електронної пошти всіх контактів, відомості яких містять слово « Marilyn »
Remove all contacts the user selected in the contact selection dialog
Вилучити всі контакти, які користувач обрав у діалозі вибору контактів.
Export selected contacts to a VCard (default output format) file
Експортувати вибрані контакти до файла VCard (типовий формат вихідної інформації)