# Підручник з &minuet;

## Вступ

Вітаємо у &minuet;, програмі &kde; для навчання музиці. &minuet; призначено для допомоги учням і вчителям у багатьох аспектах вивчення музики, зокрема тренуванні слуху, швидкого читання нотних записів, сольфеджіо, вивченні гами, ритму, гармонії та імпровізації. &minuet; широко використовує можливості &MIDI; для доступу до усього спектру можливостей щодо визначення гучності, ритму та тону, що робить &minuet; цінним інструментом для початківців і досвідчених музикантів.

У &minuet; передбачено широкий набір вправ із удосконалення слуху. З метою розширення функціональних можливостей програми та адаптування її до контекстів музичної освіти можна без зайвих проблем додати нові вправи.

Вправи &minuet; для тренування слуху

## Користування &minuet;

У наступних трьох розділах — Як запустити &minuet;, Майстер налаштовування &minuet; та Вправи &minuet; — наведено настанови щодо дій, за допомогою яких можна запустити та користуватися &minuet;.

### Як запустити &minuet;

Запустити &minuet; можна за допомогою меню запуску програм. Відкрийте меню програм &kde; натисканням на піктограмі запуску програм на панелі у нижньому лівому куті екрана. У відповідь буде відкрито меню. Виберіть послідовно пункти Програми Навчання Інше &minuet; (Програмне забезпечення для навчання музики).

### Майстер налаштовування &minuet;

Після першого запуску &minuet; буде відкрито діалогове вікно майстра налаштовування, програми, яка виконає пошук у системі усіх компонентів, які потрібні для роботи із файлами &MIDI;. Типовим модулем обробки &MIDI; у &minuet; є TiMidity++/Freepats. Через це майстер налаштовування виконає перевірку, чи встановлено і налаштовано ці програми відповідним чином.

Майстер налаштовування &minuet; під час першого запуску

Якщо усі перевірки майстра налаштовування буде успішно пройдено, &minuet; автоматично запускатиме TiMidity++ під час запуску програми і завершуватиме його роботу під час виходу із програми. Запустити майстер налаштовування знову можна за допомогою пункту меню Параметри Запустити майстер налаштовування .

### Вправи і робота у &minuet;

Інтерфейс користувача &minuet; складається з чотирьох основних компонентів:

Компоненти графічного інтерфейсу &minuet;

Меню навігації

- Надає змогу здійснювати навігацію категоріями вправ &minuet; і вибирати певну вправу. Меню навігації буде динамічно створено на основі файлів специфікації, які описано у розділі Створення вправ. Вправи &minuet; згруповано за класами, зокрема на основі даних щодо інтервалів, гам та акордів.

Засобів керування відтворенням MIDI

- Надає доступ до основних функціональних можливостей для керування відтворенням &MIDI;. &minuet; може відтворювати довільні файли &MIDI; у відповідь на вибір пункту меню Файл Відкрити з наступним натисканням кнопки `Пуск`. Відтворення можна призупинити за допомогою натискання кнопки `Пауза` і відновити повторним натисканням кнопки `Пуск`. Натисканням кнопки `Стоп` можна перервати відтворення &MIDI;. На панелі керування відтворенням &MIDI; також передбачено повзунки для зміни гучності, ритму та тону поточного звуку &MIDI;.

Панелі клавіш

- Показує події `відтворюється нота` &MIDI;, які синтезуються із файла &MIDI; або під час виконання вправи.

Панелі вправи

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

## Створення нових вправ &minuet;

Вправи &minuet; визначаються у файлах специфікацій вправ, записаних у форматі JSON:

    {
      "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"
                    }
                  ]
                }
              ]
            }
          ]
        }
      ]
    }

У файлах специфікації вправ &minuet; має міститися один об’єкт найвищого рівня JSON, що міститиме масив `exercises`. Цей масив визначає ієрархічну структуру вправ, згруповану за категоріями. Кожна категорія або вправа має свою назву. Об’єкти категорій JSON мають містити властивість із назвою `children`, яка описуватиме підкатегорії або вправи, що містяться у категорії. Об’єкти вправ JSON мають містити властивість із назвою `options`, яка визначає можливі відповіді у вправі. Під час кожного виконання вправи &minuet; вибирає серед можливих відповідей одну випадковим чином. Учень має натиснути кнопку вибраної програмою відповіді.

У кожній (під)категорії може визначатися параметр `root`, який вказує діапазон початкової ноти інтервалу, акорду або гами, з якого буде вибрано випадковим чином вибрано цю ноту для усіх вправ у категорії. Такий діапазон відповідає стандартним номерам нот &MIDI; і визначається у форматі `<мінімальне значення>..<максимальне значення>`. У наведеному вище прикладі використано увесь діапазон клавіш для основних нот (21..104). Параметр `playMode` вказує на спосіб відтворення можливих відповідей: як `scale` (гама, ноти одна за одною) або як `chord` (акорд, усі ноти одночасно).

Кожен із варіантів у вправі визначає назву і послідовність нот, які слід відтворити на основі основної ноти, яку програма вибирає випадковим чином на початку вправи. Така послідовність нот визначається як відносна відстань від основної ноти і описує інтервал, який кожна нота формує у поєднанні із основною нотою. Наприклад, для основної гами послідовність нот така: «2 4 5 7 9 11 12», що відповідно позначає структуру основної гами «ціла ціла половинна ціла ціла ціла половинна. Параметр `sequenceFromRoot` може містити дані щодо тривалості кожної з нот. Крім того, у ядрі обробки даних &minuet; передбачено, що буде показано лише відповіді, усі ноти яких лежать у межах клавіатури.

Для забезпечення кращої інфраструктури для упорядковування великого набору файлів специфікацій вправ у ядрі обробки даних &minuet; передбачено використання декількох файлів специфікацій, які автоматично об’єднуються для створення остаточної ієрархії вправ, які буде показано у меню навігації. Вправи буде об’єднано належним чином, якщо у файлах специфікацій використано під час визначення вправ однакові назви категорій або підкатегорій. У поточній версії &minuet; не передбачено графічного інтерфейсу для створення специфікацій вправ, отже файли JSON вам доведеться створювати у сторонньому текстовому редакторі. Файли специфікацій вправ &minuet; можна встановити на загальносистемному рівні до каталогу `/usr/share/minuet/exercises/` або на локальному рівня (для окремого користувача) до каталогу `~/.local/share/minuet/exercises/`.

## Налаштовування &minuet;

Деякі із параметрів &minuet;, пов’язаних і обробкою &MIDI;, можна налаштувати за допомогою пункту меню Параметри Налаштувати Minuet :

Параметри роботи &minuet;

Параметр `TiMidity++` містить дані щодо абсолютного шляху до програми TiMidity++. Якщо ви працюєте у стандартному комп’ютерному середовищі, цей шлях буде автоматично визначено під час роботи майстра з налаштовування &minuet;. Втім, ви можете змінити його на бажаний для вас, якщо середовище не є стандартним.

За допомогою параметра `Параметри TiMidity++` можна вказати параметри, які буде використано під час запуску служби TiMidity++. Варто використовувати саме параметри, які було визначено майстром налаштовування &minuet;, якщо у вас немає якоїсь вагомої причини використати інші параметри.

Нарешті, за допомогою параметра `Порт виведення MIDI` можна вказати порт, за допомогою якого &minuet; має відтворювати події &MIDI;. Знову ж таки, майстер налаштовування &minuet; має визначити правильне значення цього параметра, але ви можете змінити його, якщо використовуєте інші синтезатори &MIDI;, зокрема fluidsynth.

## Авторські права та ліцензування

&minuet;

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

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

Переклад українською: Юрій Чорноіван yurchor@ukr.net

&underFDL; &underGPL;

## Встановлення

### Вимоги

Для користування &minuet; вам знадобляться деякі бібліотеки з &kf5; 5.18 (CoreAddons, I18n, XmlGui, ConfigWidgets, DocTools, KIO). Крім того, для роботи &minuet; з &MIDI; потрібна бібліотека Drumstick.

&documentation.index;