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

## Вступ

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

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

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

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

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

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

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

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

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

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

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

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

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

- Показує події `відтворюється нота` &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; можна встановити на загальносистемному рівні до каталогу `minuet/exercises/` або на локальному рівня (для окремого користувача) до підкаталогу `minuet/exercises/` у каталозі, що визначається командою ``qtpaths` `--paths GenericDataLocation``.

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

&minuet;

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

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

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

&underFDL; &underGPL;
&documentation.index;