# El manual del &minuet;

## Introducció

Benvingut al &minuet;: el programari &kde; per a educació musical. L'objectiu del &minuet; és ajudar als estudiants i professors en molts aspectes de l'educació musical, com l'entrenament de l'oïda, la lectura a primera vista, el solfeig, les escales, el ritme, l'harmonia i la improvisació. El &minuet; fa un ampli ús de les capacitats &MIDI; per a proporcionar un conjunt complet de característiques relatives al canvi de volum, tempo i to, el qual fa del &minuet; una valuosa eina per als músics principiants i experimentats.

El &minuet; ofereix un ric conjunt d'exercicis d'entrenament de l'oïda i se n'hi poden afegir de nous de forma transparent amb la finalitat d'estendre les seves funcionalitats i adaptar-lo a diversos contextos de l'educació musical.

Exercicis d'acords per a l'entrenament de l'oïda amb el &minuet;

## Ús del &minuet;

En les següents tres seccions: Començar amb el &minuet;, Assistent de configuració del &minuet; i Exercicis i flux de treball amb el &minuet; donarem els passos necessaris per a posar el &minuet; en funcionament.

### Començar amb el &minuet;

Podeu iniciar el &minuet; des del llançador d'aplicacions. Obriu el menú de programes del &kde; fent clic a la icona del llançador d'aplicacions a la barra d'eines a la part inferior esquerra de la pantalla. Això elevarà un menú. Moveu el cursor fins a l'element Aplicacions Educació Miscel·lània &minuet; (Programari d'educació musical) del menú.

### Assistent de configuració del &minuet;

Quan executeu el &minuet; per primera vegada, apareixerà un assistent de configuració que verificarà si totes les dependències requerides per a gestionar els fitxers &MIDI; es troben al seu lloc en el sistema. El &minuet; utilitza TiMidity++/Freepats com a dorsal &MIDI; per omissió. Per tant, l'assistent de configuració avalua si aquestes tecnologies estan correctament instal·lades i configurades.

Primer inici del &minuet; amb l'Assistent de configuració

L'assistent de configuració haurà de passar amb èxit totes les proves, el &minuet; s'iniciarà automàticament i aturarà el TiMidity++ durant l'inici i finalització de l'aplicació, respectivament. Podreu executar l'assistent de configuració de nou en qualsevol moment, accedint a Arranjament Executa l'assistent de configuració .

### Exercicis i flux de treball amb el &minuet;

La interfície d'usuari del &minuet; implica quatre components principals:

Components de la IU del &minuet;

Menú de navegació

- Permet navegar per les categories d'exercicis del &minuet; i la selecció d'un exercici en particular. El menú de navegació s'ha creat de forma dinàmica en base als fitxers d'especificació dels exercicis tal com es descriu a Crear els exercicis. Els exercicis del &minuet; estan agrupats segons les classes, com ara intervals, escales i acords.

Controls del reproductor MIDI

- Proporciona les funcionalitats bàsiques per al maneig de la reproducció &MIDI;. El &minuet; és capaç de reproduir fitxers &MIDI; de forma arbitrària seleccionant Fitxer Obre i després fent clic al botó `reprodueix` . L'execució es pot pausar fent clic al botó `pausa` i reprendre de nou fent clic al botó `reprodueix`. El botó `atura` interromp la reproducció &MIDI;. Els controls del reproductor &MIDI; també proporcionen controls lliscants per a canviar el volum , temps i to de la reproducció &MIDI; actual.

Vista del teclat

- Mostra els esdeveniments de la `nota activa` del &MIDI; seqüenciats a partir d'un fitxer &MIDI; o de l'execució d'un exercici.

Vista de l'exercici

- Presenta, per a un exercici determinat, els botons per a controlar la presentació de l'exercici i un conjunt de possibles respostes a l'exercici. Un exercici comença fent clic al botó `pregunta nova`. Se selecciona un interval/acord/escala aleatòriament que serà reproduït pel &minuet; i després s'espera que l'estudiant triï una resposta entre les que es mostren a la graella de resposta. El &minuet; sempre presenta -com un petit cercle blanc a la vista del teclat- la primera nota de l'interval/escala seleccionada o la nota base de l'acord seleccionat. En passar per sobre d'una possible resposta, el &minuet; ressaltarà la seva representació visual corresponent a la vista del teclat. Les notes restants de la resposta ressaltada es presentaran com a petits cercles, on els colors seran els mateixos que el del botó de resposta ressaltat. L'estudiant pot escoltar de nou l'exercici fent clic al botó `reprodueix la pregunta`, feu clic al botó de la resposta escollida, o abasteu la resposta correcta fent clic al botó `renuncio`. Pot començar una nova execució del mateix exercici prement el botó `pregunta nova` una altra vegada.

## Crear exercicis nous per al &minuet;

Els exercicis del &minuet; es defineixen en fitxers d'especificació dels exercicis, escrits en el format 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"
                    }
                  ]
                }
              ]
            }
          ]
        }
      ]
    }

Els fitxers d'especificació dels exercicis del &minuet; contenen un objecte JSON de nivell superior que ofereix la matriu dels `exercicis`. Aquesta matriu defineix una estructura jeràrquica pels exercicis, agrupats per categories. Cada categoria/exercici té un nom. Els objectes JSON de la categoria contenen una propietat anomenada `children` (filla), que descriu les subcategories/exercicis que conté aquesta categoria. Els objectes JSON de l'exercici contenen una propietat anomenada `options` (opcions), la qual defineix les possibles respostes per a aquest exercici. En cada execució dels exercicis, el &minuet; selecciona aleatòriament una resposta entre totes les possibles, i s'espera que l'alumne faci clic al botó de la resposta que correspongui amb la resposta seleccionada.

Qualsevol sub/categoria pot definir un paràmetre `root` (base) que defineix l'interval des del qual la nota inicial de l'interval/acord/escala serà escollit aleatòriament per a tots els exercicis en aquesta categoria. Aquest interval es correspon amb els estàndards números de nota &MIDI; i segueix el format `<min-value>..<max-value>`. L'exemple presentat anteriorment utilitza tot l'interval del teclat com a possibles notes base (21..104). El paràmetre `playMode` indica com s'han de reproduir les possibles respostes: com una `scale` (-escala- una nota després de l'altra) o com una `chord` (-acord- totes les notes sonant simultàniament).

Cada opció de l'exercici defineix un nom i la seqüència de notes que s'han de reproduir a partir de la nota base seleccionada aleatòriament en cada exercici executat. Aquesta seqüència de notes es defineix com a distàncies relatives a partir de la nota base, descrivint l'interval que cada nota forma en conjunció amb la nota base. Per exemple, per a una escala major, la seqüència de notes és 2 4 5 7 9 11 12, el que denota respectivament un estructura de l'escala major completa completa mitja completa completa completa mitja. El paràmetre `sequenceFromRoot` pot contenir qualsevol nombre de notes en longitud. També, el nucli del &minuet; garanteix que només les respostes en que totes les notes es troben dins de l'interval del teclat són seleccionades aleatòriament.

Per a proporcionar una millor infraestructura per a l'organització d'un gran conjunt de fitxers d'especificació dels exercicis, el nucli del &minuet; utilitza diversos fitxers d'especificació, els quals es fusionen de forma automàtica per a compondre la jerarquia final de l'exercici presentada al menú de navegació. Els exercicis es fusionen correctament ja que els diferents fitxers d'especificació utilitzen el mateix nom de la sub/categoria en la definició dels exercicis. Per ara, el &minuet; no proporciona cap &IGU; per a la creació d'especificacions dels exercicis, de manera que haureu de crear manualment aquests fitxers JSON. Els fitxers d'especificació dels exercicis del &minuet; es poden instal·lar a tot el sistema en el directori `/usr/share/minuet/exercises/` o localment al directori `~/.local/share/minuet/exercises/`.

## Configuració del &minuet;

Alguns ajustaments &MIDI; del &minuet; es poden configurar a Arranjament Configura el &minuet; :

Ajustaments del &minuet;

El paràmetre `TiMidity++` conté el camí absolut al programa TiMidity++. Aquest camí es pot ser ajustat automàticament per l'assistent de configuració del &minuet; si el vostre entorn està sa, però si ho voleu, podeu proporcionar la vostra pròpia configuració.

Els `paràmetres del TiMidity++` especifiquen els que s'utilitzaran quan s'inicia el servei TiMidity++. Haureu d'utilitzar el valor proporcionat per l'assistent de configuració del &minuet;, llevat que tingueu una bona raó per canviar-lo.

Finalment, el paràmetre `port de sortida MIDI` indica el port que haurà d'utilitzar el &minuet; per a reproduir els esdeveniments &MIDI;. Un cop més, l'assistent de configuració del &minuet; dóna millors valors, però sou lliure de canviar-ho si s'utilitza un altra seqüenciador &MIDI; com, per exemple, fluidsynth.

## Crèdits i llicència

&minuet;

Copyright del programa 2016 &Sandro.Andrade; &Sandro.Andrade.mail;

Copyright de la documentació © 2016 &Sandro.Andrade; &Sandro.Andrade.mail;

Traductor de la documentació: &credits.Antoni.Bella;

&underFDL; &underGPL;

## Instal·lació

### Requeriments

Per tal d'utilitzar amb èxit el &minuet;, necessitareu unes poques biblioteques de les &kf5; 5.18 (CoreAddons, I18n, XmlGui, ConfigWidgets, DocTools, KIO). A més, el &minuet; es basa en la biblioteca Drumstick per a les capacitats &MIDI;.

&documentation.index;