<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
  <!ENTITY minuet "<application
>Minuet</application
>">
  <!ENTITY Sandro.Andrade '<personname
><firstname
>Sandro</firstname
><surname
>Andrade</surname
></personname
>'>
  <!ENTITY Sandro.Andrade.mail '<email
>sandroandrade@kde.org</email
>'>
  <!ENTITY kappname "&minuet;">
  <!ENTITY package "kdeedu">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Ukrainian "INCLUDE">
]>
<book id="minuet" lang="&language;">

<bookinfo>
<title
>Підручник з &minuet;</title>

<authorgroup>
<author
><personname
> <firstname
>Sandro</firstname
> <othername
>S.</othername
> <surname
>Andrade</surname
> </personname
> <email
>&Sandro.Andrade.mail;</email
> </author>
<othercredit role="translator"
><firstname
>Юрій</firstname
><surname
>Чорноіван</surname
><affiliation
><address
><email
>yurchor@ukr.net</email
></address
></affiliation
><contrib
>Переклад українською</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2016</year>
<holder
>&Sandro.Andrade;</holder>
</copyright>
<legalnotice
>&FDLNotice;</legalnotice>

<date
>17 січна 2016 року</date>

<releaseinfo
>Minuet 00.01 (Програми 16.04)</releaseinfo>

<abstract>
<para
>&minuet; — програма для навчання музиці. У ній передбачено набір вправ для розвитку слуху, зокрема вивчення інтервалів, акордів та гами. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>музика</keyword>
<keyword
>освіта</keyword>
<keyword
>інтервали</keyword>
<keyword
>акорди</keyword>
<keyword
>гами</keyword>
<keyword
>minuet</keyword>
</keywordset>

</bookinfo>

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

<!-- The introduction chapter contains a brief introduction for the
application that explains what it does and where to report
problems. Basically a long version of the abstract.  Don't include a
revision history. (see installation appendix comment) -->

<para
>Вітаємо у &minuet;, програмі &kde; для навчання музиці. &minuet; призначено для допомоги учням і вчителям у багатьох аспектах вивчення музики, зокрема тренуванні слуху, швидкого читання нотних записів, сольфеджіо, вивченні гами, ритму, гармонії та імпровізації. &minuet; широко використовує можливості &MIDI; для доступу до усього спектру можливостей щодо визначення гучності, ритму та тону, що робить &minuet; цінним інструментом для початківців і досвідчених музикантів. </para>
<para
>У &minuet; передбачено широкий набір вправ із удосконалення слуху. З метою розширення функціональних можливостей програми та адаптування її до контекстів музичної освіти можна <link linkend="creating-exercises"
>без зайвих проблем додати нові вправи</link
>. </para>
<para>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="minuet-screenshot.png"/></imageobject>
<caption
><para
>Вправи &minuet; для тренування слуху</para
></caption>
</mediaobject>
</para>
</chapter>

<chapter id="using-minuet">
<title
>Користування &minuet;</title>

<para
>У наступних трьох розділах — <link linkend="starting-minuet"
>Як запустити &minuet;</link
>, <link linkend="midi-configuration-wizard"
>Майстер налаштовування &minuet;</link
> та <link linkend="minuet-exercises"
>Вправи &minuet;</link
> — наведено настанови щодо дій, за допомогою яких можна запустити та користуватися &minuet;. </para>

<sect1 id="starting-minuet">
<title
>Як запустити &minuet;</title>
<para
>Запустити &minuet; можна за допомогою меню запуску програм. Відкрийте меню програм &kde; натисканням на піктограмі запуску програм на панелі у нижньому лівому куті екрана. У відповідь буде відкрито меню. Виберіть послідовно пункти <menuchoice
><guimenu
>Програми</guimenu
><guisubmenu
>Навчання</guisubmenu
><guisubmenu
>Інше</guisubmenu
> <guimenuitem
>&minuet; (Програмне забезпечення для навчання музики)</guimenuitem
></menuchoice
>. </para>
</sect1>

<sect1 id="midi-configuration-wizard">
<title
>Майстер налаштовування &minuet;</title>
<para
>Після першого запуску &minuet; буде відкрито діалогове вікно майстра налаштовування, програми, яка виконає пошук у системі усіх компонентів, які потрібні для роботи із файлами &MIDI;. Типовим модулем обробки &MIDI; у &minuet; є <ulink url="http://timidity.sourceforge.net/"
>TiMidity++</ulink
>/<ulink url="http://freepats.zenvoid.org/"
>Freepats</ulink
>. Через це майстер налаштовування виконає перевірку, чи встановлено і налаштовано ці програми відповідним чином. </para>
<para>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="configuration-wizard.png"/></imageobject>
<caption
><para
>Майстер налаштовування &minuet; під час першого запуску</para
></caption>
</mediaobject>
</para>
<para
>Якщо усі перевірки майстра налаштовування буде успішно пройдено, &minuet; автоматично запускатиме TiMidity++ під час запуску програми і завершуватиме його роботу під час виходу із програми. Запустити майстер налаштовування знову можна за допомогою пункту меню <menuchoice
> <guimenu
>Параметри</guimenu
> <guimenuitem
>Запустити майстер налаштовування</guimenuitem
> </menuchoice
>. </para>
</sect1>

<sect1 id="minuet-exercises">
<title
>Вправи і робота у &minuet;</title>

<para
>Інтерфейс користувача &minuet; складається з чотирьох основних компонентів: </para>
<para>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="minuet-ui-components.png"/></imageobject>
<caption
><para
>Компоненти графічного інтерфейсу &minuet;</para
></caption>
</mediaobject>
</para>
<variablelist>

<varlistentry>
<term
><guimenuitem
>Меню навігації</guimenuitem
></term>
<listitem
><para
>Надає змогу здійснювати навігацію категоріями вправ &minuet; і вибирати певну вправу. Меню навігації буде динамічно створено на основі файлів специфікації, які описано у розділі <link linkend="creating-exercises"
>Створення вправ</link
>. Вправи &minuet; згруповано за класами, зокрема на основі даних щодо інтервалів, гам та акордів.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Засобів керування відтворенням MIDI</guimenuitem
></term>
<listitem
><para
>Надає доступ до основних функціональних можливостей для керування відтворенням &MIDI;. &minuet; може відтворювати довільні файли &MIDI; у відповідь на вибір пункту меню <menuchoice
> <guimenu
>Файл</guimenu
> <guimenuitem
>Відкрити</guimenuitem
> </menuchoice
> з наступним натисканням кнопки <parameter
>Пуск</parameter
><inlinemediaobject
><imageobject
><imagedata fileref="multimedia-play.png"/></imageobject
></inlinemediaobject
>. Відтворення можна призупинити за допомогою натискання кнопки <parameter
>Пауза</parameter
> <inlinemediaobject
><imageobject
><imagedata fileref="multimedia-pause.png"/></imageobject
></inlinemediaobject
> і відновити повторним натисканням кнопки <parameter
>Пуск</parameter
>. Натисканням кнопки <parameter
>Стоп</parameter
><inlinemediaobject
><imageobject
><imagedata fileref="multimedia-stop.png"/></imageobject
></inlinemediaobject
> можна перервати відтворення &MIDI;. На панелі керування відтворенням &MIDI; також передбачено повзунки для зміни гучності<inlinemediaobject
><imageobject
><imagedata fileref="multimedia-volume.png"/></imageobject
></inlinemediaobject
>, ритму<inlinemediaobject
><imageobject
><imagedata fileref="multimedia-speed.png"/></imageobject
></inlinemediaobject
> та тону<inlinemediaobject
><imageobject
><imagedata fileref="multimedia-pitch.png"/></imageobject
></inlinemediaobject
> поточного звуку &MIDI;. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Панелі клавіш</guimenuitem
></term>
<listitem
><para
>Показує події <parameter
>відтворюється нота</parameter
> &MIDI;, які синтезуються із файла &MIDI; або під час виконання вправи.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Панелі вправи</guimenuitem
></term>
<listitem
><para
>Тут для вказаної користувачем вправи буде показано кнопки керування представленням вправи та набір можливих відповідей. Розпочати виконання вправи можна натисканням кнопки <parameter
>Нове питання</parameter
>. У відповідь &minuet; відтворить випадково вибраний інтервал, акорд або гаму. Студент же має вибрати правильну відповідь із показаних варіантів. &minuet; завжди показуватиме невеличким білим кружечком на панелі клавіш першу ноту вибраного інтервалу або гами чи основну ноту вибраного акорду. Якщо користувач наведе вказівник на варіант відповіді, &minuet; підсвітить візуальний відповідник на панелі клавіш. Решту нот підсвіченої відповіді буде представлено невеличкими кружечками кольору, який збігається із кольором підсвіченої кнопки відповіді. Прослухати завдання ще раз можна натисканням кнопки <parameter
>Відтворити питання</parameter
>. Відповісти на питання можна натисканням кнопки відповіді. Отримати правильну відповідь можна натисканням кнопки <parameter
>Здатися</parameter
>. Новий варіант тієї самої вправи можна отримати у відповідь на натискання кнопки <parameter
>Нове питання</parameter
>.</para
></listitem>
</varlistentry>

</variablelist>
</sect1>
</chapter>

<chapter id="creating-exercises">
<title
>Створення нових вправ &minuet;</title>

<para
>Вправи &minuet; визначаються у файлах специфікацій вправ, записаних у форматі JSON: </para>
<para>
<programlisting
>{
  "exercises": [
    {
      "name": "Intervals",
      "root": "21..104",
      "playMode": "scale",
      "children": [
        {
          "name": "Ascending Melodic Intervals",
          "children": [
            {
              "name": "Seconds",
              "options": [
                {
                  "name": "Minor Second",
                  "sequenceFromRoot": "1"
                },
                {
                  "name": "Major Second",
                  "sequenceFromRoot": "2"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}
</programlisting>
</para>
<para
>У файлах специфікації вправ &minuet; має міститися один об’єкт найвищого рівня JSON, що міститиме масив <parameter
>exercises</parameter
>. Цей масив визначає ієрархічну структуру вправ, згруповану за категоріями. Кожна категорія або вправа має свою назву. Об’єкти категорій JSON мають містити властивість із назвою <parameter
>children</parameter
>, яка описуватиме підкатегорії або вправи, що містяться у категорії. Об’єкти вправ JSON мають містити властивість із назвою <parameter
>options</parameter
>, яка визначає можливі відповіді у вправі. Під час кожного виконання вправи &minuet; вибирає серед можливих відповідей одну випадковим чином. Учень має натиснути кнопку вибраної програмою відповіді. </para>
<para
>У кожній (під)категорії може визначатися параметр <parameter
>root</parameter
>, який вказує діапазон початкової ноти інтервалу, акорду або гами, з якого буде вибрано випадковим чином вибрано цю ноту для усіх вправ у категорії. Такий діапазон відповідає стандартним номерам нот &MIDI; і визначається у форматі <parameter
>&lt;мінімальне значення&gt;..&lt;максимальне значення&gt;</parameter
>. У наведеному вище прикладі використано увесь діапазон клавіш для основних нот (21..104). Параметр <parameter
>playMode</parameter
> вказує на спосіб відтворення можливих відповідей: як <parameter
>scale</parameter
> (гама, ноти одна за одною) або як <parameter
>chord</parameter
> (акорд, усі ноти одночасно). </para>
<para
>Кожен із варіантів у вправі визначає назву і послідовність нот, які слід відтворити на основі основної ноти, яку програма вибирає випадковим чином на початку вправи. Така послідовність нот визначається як відносна відстань від основної ноти і описує інтервал, який кожна нота формує у поєднанні із основною нотою. Наприклад, для основної гами послідовність нот така: «2 4 5 7 9 11 12», що відповідно позначає структуру основної гами «ціла ціла половинна ціла ціла ціла половинна. Параметр <parameter
>sequenceFromRoot</parameter
> може містити дані щодо тривалості кожної з нот. Крім того, у ядрі обробки даних &minuet; передбачено, що буде показано лише відповіді, усі ноти яких лежать у межах клавіатури. </para>
<para
>Для забезпечення кращої інфраструктури для упорядковування великого набору файлів специфікацій вправ у ядрі обробки даних &minuet; передбачено використання декількох файлів специфікацій, які автоматично об’єднуються для створення остаточної ієрархії вправ, які буде показано у меню навігації. Вправи буде об’єднано належним чином, якщо у файлах специфікацій використано під час визначення вправ однакові назви категорій або підкатегорій. У поточній версії &minuet; не передбачено графічного інтерфейсу для створення специфікацій вправ, отже файли JSON вам доведеться створювати у сторонньому текстовому редакторі. Файли специфікацій вправ &minuet; можна встановити на загальносистемному рівні до каталогу <filename
>/usr/share/minuet/exercises/</filename
> або на локальному рівня (для окремого користувача) до каталогу <filename
>~/.local/share/minuet/exercises/</filename
>. </para>

</chapter>

<chapter id="minuet-configuration">
<title
>Налаштовування &minuet;</title>

<para
>Деякі із параметрів &minuet;, пов’язаних і обробкою &MIDI;, можна налаштувати за допомогою пункту меню <menuchoice
> <guimenu
>Параметри</guimenu
> <guimenuitem
>Налаштувати Minuet</guimenuitem
> </menuchoice
>: </para>
<para>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="minuet-configuration.png"/></imageobject>
<caption
><para
>Параметри роботи &minuet;</para
></caption>
</mediaobject>
</para>
<para
>Параметр <parameter
>TiMidity++</parameter
> містить дані щодо абсолютного шляху до програми TiMidity++. Якщо ви працюєте у стандартному комп’ютерному середовищі, цей шлях буде автоматично визначено під час роботи майстра з налаштовування &minuet;. Втім, ви можете змінити його на бажаний для вас, якщо середовище не є стандартним. </para>
<para
>За допомогою параметра <parameter
>Параметри TiMidity++</parameter
> можна вказати параметри, які буде використано під час запуску служби TiMidity++. Варто використовувати саме параметри, які було визначено майстром налаштовування &minuet;, якщо у вас немає якоїсь вагомої причини використати інші параметри. </para>
<para
>Нарешті, за допомогою параметра <parameter
>Порт виведення MIDI</parameter
> можна вказати порт, за допомогою якого &minuet; має відтворювати події &MIDI;. Знову ж таки, майстер налаштовування &minuet; має визначити правильне значення цього параметра, але ви можете змінити його, якщо використовуєте інші синтезатори &MIDI;, зокрема fluidsynth. </para>

</chapter>

<chapter id="credits">

<title
>Авторські права та ліцензування</title>

<para
>&minuet; </para>
<para
>Авторські права на програму належать &Sandro.Andrade; <email
>&Sandro.Andrade.mail;</email
>, 2016 </para>

<para
>Авторські права на документацію до програми належать &Sandro.Andrade; <email
>&Sandro.Andrade.mail;</email
>, 2016 </para>

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

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

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

<!--
List any special requirements for your application here. This should include:
.Libraries or other software that is not included in kdesupport or kf5
.Hardware requirements like amount of RAM, disk space, graphics card
capabilities, screen resolution, special expansion cards, etc.
.Operating systems the app will run on. If your app is designed only for a
specific OS, (you wrote a graphical LILO configurator for example) put this
information here.
-->

<para
>Для користування &minuet; вам знадобляться деякі бібліотеки з &kf5; 5.18 (CoreAddons, I18n, XmlGui, ConfigWidgets, DocTools, KIO). Крім того, для роботи &minuet; з &MIDI; потрібна <ulink url="http://drumstick.sourceforge.net/"
>бібліотека Drumstick</ulink
>. </para>

</sect1>

</appendix>

&documentation.index;
</book>

<!--
Local Variables:
mode: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=2:shiftwidth=2:expandtab
kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
-->
