<?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
>&lt;?xml version="1.0" ?&gt;
&lt;!DOCTYPE profile SYSTEM "profile.dtd"&gt;

  &lt;profile id="myapp" servicename="My Application"&gt;
  &lt;/profile&gt;
              </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
> (нічого не робити, якщо &gt;1 екземпляра), <quote
>sendtoone</quote
> (надіслати виклик довільно обраному екземпляру) та <quote
>sendtoall</quote
> (надіслати всім екземплярам). Типовим є варіант <quote
>dontsend</quote
>, але у багатьох випадках найкориснішим може бути варіант <quote
>sendtoone</quote
>. </para>

              <programlisting
>&lt;?xml version="1.0" ?&gt;
&lt;!DOCTYPE profile SYSTEM "profile.dtd"&gt;

  &lt;profile id="myapp" servicename="My Application"&gt;
    &lt;name&gt;My Application&lt;/name&gt;
    &lt;author&gt;Me&lt;/author&gt;
    &lt;instances unique="0" ifmulti="sendtoone"/&gt;
  &lt;/profile&gt;
              </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
>&lt;?xml version="1.0" ?&gt;
&lt;!DOCTYPE profile SYSTEM "profile.dtd"&gt;

  &lt;profile id="myapp" servicename="My Application"&gt;
    &lt;name&gt;My Application&lt;/name&gt;
    &lt;author&gt;Me&lt;/author&gt;
    &lt;instances unique="0" ifmulti="sendtoone"/&gt;
    &lt;action objid="MyApp" prototype="void showint(short int)"
      button="Menu" repeat="0" autostart="0"&gt;
    &lt;/action&gt;
  &lt;/profile&gt;
              </programlisting>
            </step>

            <step>
              <para
>Додайте до запису дії назву і коментар. Ці дані буде показано у інтерфейсі користувача &kdelirc;. </para>

              <programlisting
>&lt;?xml version="1.0" ?&gt;
&lt;!DOCTYPE profile SYSTEM "profile.dtd"&gt;

  &lt;profile id="myapp" servicename="My Application"&gt;
    &lt;name&gt;My Application&lt;/name&gt;
    &lt;author&gt;Me&lt;/author&gt;
    &lt;instances unique="0" ifmulti="sendtoone"/&gt;
    &lt;action objid="MyApp" prototype="void showints(short int)"
        button="Menu" repeat="0" autostart="0"&gt;
      &lt;name&gt;Show Integers&lt;/name&gt;
      &lt;comment&gt;Shows a configurable integer&lt;/comment&gt;
    &lt;/action&gt;
  &lt;/profile&gt;
                </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
>&lt;?xml version="1.0" ?&gt;
&lt;!DOCTYPE profile SYSTEM "profile.dtd"&gt;

  &lt;profile id="myapp" servicename="My Application"&gt;
    &lt;name&gt;My Application&lt;/name&gt;
    &lt;author&gt;Me&lt;/author&gt;
    &lt;instances unique="0" ifmulti="sendtoone"/&gt;
    &lt;action objid="MyApp" prototype="void showints(short int)"
        button="Menu" repeat="0" autostart="0"&gt;
      &lt;name&gt;Show Integers&lt;/name&gt;
      &lt;comment&gt;Shows a configurable integer&lt;/comment&gt;
      &lt;argument type="int"&gt;
        &lt;default&gt;5&lt;/default&gt;
        &lt;comment&gt;The integer to be shown&lt;/comment&gt;
      &lt;/argument&gt;
    &lt;/action&gt;
  &lt;/profile&gt;
                </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
-->
