<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
<!ENTITY kcmlirc "<application
>KDE LIRC Control Center Module</application
>">
<!ENTITY kdelirc "<application
>KDE LIRC</application
>">
<!ENTITY % Ukrainian "INCLUDE"
> <!-- change language only here -->
<!ENTITY % addindex "IGNORE">
]>
<book lang="&language;">
<bookinfo>
<title
>Налаштування інфрачервоних пультів керування у KDE</title>
<authorgroup>
<author
><firstname
>Frank</firstname
> <surname
>Scheffold</surname
> <affiliation
> <address
><email
>fscheffold@googlemail.com</email
></address>
</affiliation>
</author>
<author
><firstname
>Michael</firstname
> <surname
>Zanetti</surname
> <affiliation
> <address
><email
>michael_zanetti@gmx.net</email
></address>
</affiliation>
</author>
<author
><firstname
>Gav</firstname
> <surname
>Wood</surname
> <affiliation
> <address
><email
>gav@kde.org</email
></address>
</affiliation>
</author>
<othercredit role="translator"
><firstname
>Юрій</firstname
><surname
>Чорноіван</surname
><affiliation
><address
><email
>yurchor@ukr.net</email
></address
></affiliation
><contrib
>Переклад українською</contrib
></othercredit
>
</authorgroup>
<date
>2010-01-06</date>
<releaseinfo
>2.0</releaseinfo>
<copyright>
<year
>2004</year>
<holder
>Gav Wood</holder>
</copyright>
<copyright>
<year
>2010</year>
<holder
>Frank Scheffold</holder>
<holder
>Michael Zanetti</holder>
</copyright>
<!--
<legalnotice
>&FDLNotice;</legalnotice>
-->
<abstract
><para
>Налаштування &kdelirc;: інфраструктура функціональних можливостей &kde; з роботи з пристроями інфрачервоного керування.</para
></abstract>
<keywordset>
<keyword
>KDE</keyword>
<keyword
>irkick</keyword>
<keyword
>kdelirc</keyword>
<keyword
>kcmlirc</keyword>
<keyword
>lirc</keyword>
</keywordset>
</bookinfo>
<chapter id="introduction">
<title
>Вступ</title>
<sect1 id="requirements">
<title
>Вимоги</title>
<para
>Щоб скористатися оболонкою &kdelirc;, вам слід налаштувати систему LIRC. Якщо систему налаштовано належним чином, піктограма &kdelirc; у системному лотку набуде червоного кольору <inlinemediaobject
><imageobject
><imagedata fileref="irkick.png" format="PNG"/></imageobject
></inlinemediaobject
>. Якщо ж це не так, піктограма буде сірою і перекресленою <inlinemediaobject
><imageobject
><imagedata fileref="irkickoff.png" format="PNG"/></imageobject
></inlinemediaobject
>. </para>
<para
>Щоб дізнатися більше про LIRC та способи налаштування, відвідайте сайт програми за адресою <ulink url="http://www.lirc.org"
>http://www.lirc.org</ulink
>. </para>
<para
><emphasis role="strong"
>Зауваження:</emphasis
> під час налаштування LIRC рекомендуємо вам використовувати простори назв кнопок. </para>
</sect1>
</chapter>
<chapter id="usage">
<title
>Використання</title>
<para
>Передбачено три вкладки, поділених на розділи налаштування та додаткових відомостей. Першу вкладку з назвою <guibutton
>Функції контролера</guibutton
> призначено для налаштування режимів та дій для всіх можливих пультів керування. На вкладці <guibutton
>Огляд профілів</guibutton
> буде наведено параметри доступних профілів. На вкладці <guibutton
>Можливі пристрої</guibutton
> буде показано відомості щодо ваших пультів віддаленого керування. Вибір пункту пульта призведе до показу огляду призначення його кнопок. </para>
<sect1 id="controllerFunctions">
<title
>Функції контролера</title>
<sect2 id="modes">
<title
>Пульти керування і режими</title>
<para
>Кожен з пультів дистанційного керування може працювати у декількох режимах. Використання декількох режимів надає змогу виконувати за допомогою натискання однієї кнопки різних дій у різних обставинах. Непоганим прикладом є пульти дистанційного керування ТБ/Відео/Супутникового тюнера/DVD — замість використання різних пультів для виконання різних завдань, ви можете змінити поведінку одного пульта так, щоб за його допомогою можна було виконувати різні завдання у різних програмах: достатньо лише створити різні записи режимів, а потім перемикатися між цими режимами. </para>
<para
>Дії, визначені безпосередньо для пульта віддаленого керування, виконуються завжди, незалежно від того, у якому режимі працює пульт. Дії, визначені для режиму, буде виконано, лише якщо пульт працює у відповідному режимі. Кожен з пультів керування може одночасно перебувати лише у одному режимі. Крім того, пульт може перебувати у стані без визначеного режиму, коли у відповідь на натискання кнопок буде виконано лише загальні для пульту дані. Ви також можете визначити типовий режим, тобто режим, у якому пульт працюватиме одразу після запуску програми. </para>
<para
>У списку, наведеному ліворуч, ви побачите всі пристрої дистанційного керування, виявлені у вашій системі. Ви зможете додати або вилучити режим вибором назви бажаного пристрою зі списку з наступним натисканням кнопок, розташованих під списком. За допомогою кнопки редагування ви зможете змінювати створені раніше записи режимів </para>
</sect2>
<sect2 id="addactions">
<title
>Призначення дій до кнопок</title>
<para
>У &kdelirc; передбачено два різних типи дій: перемикання режимів та дії, які буде виконано. За допомогою перемикань режимів можна змінювати режими, у яких працює пульт, а за допомогою звичайних дій — виконувати команди &DBus;. Під час визначення нової дії ви можете скористатися одним з варіантів: використати шаблон дії або вручну визначити всі можливі параметри. Шаблони дій називаються профілями. Хоча використання профілів для створення записів дій простіше і зрозуміліше пересічному користувачеві, за допомогою профілів ви не зможете отримати доступ до всіх можливих функціональних можливостей дій. Складні дії краще визначати налаштуванням функцій та їх параметрів вручну. </para>
<para
>Щоб додати запис дії, натисніть кнопку <guibutton
>Додати...</guibutton
>, розташовану внизу праворуч. Програма відкриє вікно майстра, у якому запитає вас щодо типу дії, запис якої слід створити. За допомогою першого варіанта можна створити дію на основі профілю. За допомогою другого варіанта — ви зможете створити запис дії вручну. Не забудьте, що під час налаштування запису дії має бути запущено програму, дію у якій ви бажаєте налаштувати, інакше ви не побачите відповідного пункту у списку доступних програм. Якщо ви виберете третій варіант, ви зможете створити запис дії з перемикання режимів. Виберіть бажаний тип дії та виконуйте настанови майстра. </para>
<para
>Поля запису дії може бути заповнено у автоматичному режимі за допомогою кнопки <guibutton
>Автозаповнення...</guibutton
>. Це означає, що &kdelirc; може спробувати встановити відповідність кнопок діям у автоматичному режимі. У діалоговому вікні автоматичного заповнення буде показано всі можливі профілі з відповідним прапорцем. Колір прапорця позначатиме степінь підтримки пульта віддаленого керування профілем: повна підтримка, часткова підтримка або неможливість підтримки. Зелений прапорець означає повну підтримку, жовтий — часткову, червоний — немає підтримки. </para>
<para
><emphasis role="strong"
>Зауваження:</emphasis
> якщо ваш пульт віддаленого керування несумісний з жодним з профілів, ймовірно, ви не налаштували lirc на використання просторів назв кнопок. </para>
</sect2>
</sect1>
<sect1 id="profiles">
<title
>Огляд профілів</title>
<para
>На вкладці <guibutton
>Огляд профілів</guibutton
> буде подано дані щодо всіх можливих профілів. Після позначення вами профілю програма покаже докладні відомості щодо профілю, зокрема відомості щодо автора та список всіх визначених у профілі дій. Кожен з записів дії містить відомості щодо додаткових параметрів, коментар та ідентифікатор кнопки, який буде використано під час автоматичного заповнення полів. </para>
<para
>Якщо у вас виникло бажання поділитися власним профілем програм, ознайомтеся з вмістом глави <link linkend="advancedInformation"
>Додаткова інформація</link
>. </para>
</sect1>
<sect1 id="availableRemotes">
<title
>Можливі пристрої</title>
<para
>На цій вкладці буде наведено докладні відомості щодо ваших пультів віддаленого керування. Тут ви зможете перевірити, чи належним чином було розпізнано ваш пульт системою. </para>
</sect1>
</chapter>
<chapter id="advancedInformation">
<title
>Додаткова інформація</title>
<para
>У цій главі ми обговоримо деякі речі, які можуть зацікавити досвідчених користувачів та розробників. За її допомогою ви зможете навчитися створенню власних профілів. </para>
<sect1 id="profileCreation">
<title
>Створення профілів</title>
<sect2>
<title
>Вступ</title>
<para
>За допомогою &kdelirc; можна користуватися всіма програмами, що підтримують роботу з &DBus;, без додаткових налаштувань. Але щоб програму легше було налаштовувати і щоб пункт програми з’явився у діалоговому вікні автоматичного заповнення, вам доведеться створити профіль для програми. </para>
<para
>За допомогою профілю ви повідомите &kdelirc; (і користувачеві!) про те, які дії виконуються у відповідь на кожен з викликів &DBus;. Профіль — це різновид документації до викликів &DBus;. Вам не обов’язково описувати всі виклики &DBus; — достатньо лише тих, які будуть найкориснішими для користувачів (це зазвичай виклики «коригування інтерфейсу», а не виклики «збирання відомостей»). </para>
</sect2>
<sect2>
<title
>Створення</title>
<procedure>
<step>
<title
>&DBus;</title>
<para
>Переконайтеся, що програма, для якої ви бажаєте створити профіль, може керуватися за допомогою &DBus;. На базовому рівні це можна перевірити так: спробуйте додати дії для цієї програми за допомогою &kdelirc; вручну. Чудовим інструментом для виконання цього завдання є також програма <quote
>qdbusviewer</quote
>, яка постачається разом з бібліотекою Qt4. За допомогою цієї програми ви зможете дізнатися про можливості керування програмою за допомогою &DBus;. </para>
</step>
<step>
<title
>Створення профілю</title>
<para
>Після визначення відповідних функцій &DBus; вам слід описати їх у документі <filename
>appname.profile.xml</filename
>. Ось короткі настанови щодо створення таких документів: </para>
<substeps>
<step>
<para
>Спочатку створіть файл з наведеним нижче вмістом. Замініть <quote
>myapp</quote
> на назву виконуваного файла програми, а <quote
>My Application</quote
> на описову назву програми. </para>
<programlisting
><?xml version="1.0" ?>
<!DOCTYPE profile SYSTEM "profile.dtd">
<profile id="myapp" servicename="My Application">
</profile>
</programlisting>
</step>
<step>
<para
>У межах теґу <quote
>profile</quote
> вкажіть ім’я та відомості щодо автора. За допомогою теґу <quote
>instances</quote
> можна повідомити &kdelirc; про те, можна запускати декілька екземплярів програми чи ні. Встановіть значення <quote
>unique</quote
> у <quote
>0</quote
>, якщо можна запускати декілька екземплярів програми (типовим є значення <quote
>1</quote
>). За допомогою властивості <quote
>ifmulti</quote
> можна вказати &kdelirc;, що слід робити, якщо на час натискання кнопки виконується декілька екземплярів програми. Варіанти такі: <quote
>dontsend</quote
> (нічого не робити, якщо >1 екземпляра), <quote
>sendtoone</quote
> (надіслати виклик довільно обраному екземпляру) та <quote
>sendtoall</quote
> (надіслати всім екземплярам). Типовим є варіант <quote
>dontsend</quote
>, але у багатьох випадках найкориснішим може бути варіант <quote
>sendtoone</quote
>. </para>
<programlisting
><?xml version="1.0" ?>
<!DOCTYPE profile SYSTEM "profile.dtd">
<profile id="myapp" servicename="My Application">
<name>My Application</name>
<author>Me</author>
<instances unique="0" ifmulti="sendtoone"/>
</profile>
</programlisting>
</step>
<step>
<para
>Вкажіть у профілі теґи дій. Кожен з теґів дій має містити назву об’єкта &DBus; та прототип функції. </para>
<para
>Для правильної обробки дії &kdelirc; потрібні додаткові атрибути. Теґ <quote
>button</quote
> буде використано для автоматичного заповнення. Повний список можливих назв кнопок можна знайти у <ulink url="http://api.kde.org/4.x-api/kdebase-workspace-apidocs/libs/solid/html/classSolid_1_1Control_1_1RemoteControlButton.html"
>документації щодо програмного інтерфейсу solid</ulink
>. За допомогою теґу <quote
>repeat</quote
> можна повідомити програму, чи слід повторювати виконання дії, якщо користувач утримує кнопку на пульті натиснутою (0 = ні, 1 = так). За допомогою теґу <quote
>autostart</quote
> ви можете повідомити, чи слід запускати програму, якщо її ще не запущено. </para>
<programlisting
><?xml version="1.0" ?>
<!DOCTYPE profile SYSTEM "profile.dtd">
<profile id="myapp" servicename="My Application">
<name>My Application</name>
<author>Me</author>
<instances unique="0" ifmulti="sendtoone"/>
<action objid="MyApp" prototype="void showint(short int)"
button="Menu" repeat="0" autostart="0">
</action>
</profile>
</programlisting>
</step>
<step>
<para
>Додайте до запису дії назву і коментар. Ці дані буде показано у інтерфейсі користувача &kdelirc;. </para>
<programlisting
><?xml version="1.0" ?>
<!DOCTYPE profile SYSTEM "profile.dtd">
<profile id="myapp" servicename="My Application">
<name>My Application</name>
<author>Me</author>
<instances unique="0" ifmulti="sendtoone"/>
<action objid="MyApp" prototype="void showints(short int)"
button="Menu" repeat="0" autostart="0">
<name>Show Integers</name>
<comment>Shows a configurable integer</comment>
</action>
</profile>
</programlisting>
</step>
<step>
<para
>Опишіть кожен з аргумент за допомогою атрибутів comment (коментар) та type (тип). Список можливих типів наведено у <ulink url="http://websvn.kde.org/trunk/KDE/kdeutils/kdelirc/profiles/profile.dtd?view=markup"
>файлі описів профілів</ulink
>. Вам слід оголосити типове значення кожного з аргументів за допомогою теґів <quote
>default</quote
>: </para>
<programlisting
><?xml version="1.0" ?>
<!DOCTYPE profile SYSTEM "profile.dtd">
<profile id="myapp" servicename="My Application">
<name>My Application</name>
<author>Me</author>
<instances unique="0" ifmulti="sendtoone"/>
<action objid="MyApp" prototype="void showints(short int)"
button="Menu" repeat="0" autostart="0">
<name>Show Integers</name>
<comment>Shows a configurable integer</comment>
<argument type="int">
<default>5</default>
<comment>The integer to be shown</comment>
</argument>
</action>
</profile>
</programlisting>
</step>
</substeps>
</step>
</procedure>
</sect2>
<sect2>
<title
>Встановлення</title>
<para
>Щоб перевірити та використовувати профіль, вам слід скопіювати його до <filename
>$(kde_datadir)/profiles</filename
> і перезапустити &kdelirc;. </para>
<para
>Якщо ви бажаєте додати ваш профіль до типового пакунка &kde;, будь ласка, надішліть його команді розробки kdeutils на адресу <email
>kde-utils-devel@kde.org</email
>. </para>
</sect2>
</sect1>
</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:
// vim:ts=2:sw=2:tw=78:noet
-->
distrib
>
Mandriva
>
2010.1
>
x86_64
>
media
>
main-release
>
by-pkgid
>
a8854c35e6698068c1f67a36fcae839e
>
files
>
486
