<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Catalan  "INCLUDE">
]>
<book id="minuet" lang="&language;">

<bookinfo>
<title
>El manual del &minuet;</title>

<authorgroup>
<author
><personname
> <firstname
>Sandro</firstname
> <othername
>S.</othername
> <surname
>Andrade</surname
> </personname
> <email
>&Sandro.Andrade.mail;</email
> </author>
&traductor.Antoni.Bella; 
</authorgroup>

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

<date
>3 de juliol de 2026</date>

<releaseinfo
>Versió actual de desenvolupament</releaseinfo>

<abstract>
<para
>El &minuet; és l'aplicació d'educació musical de KDE per a l'entrenament de l'oïda, la pràctica del ritme i el cant guiat. Agrupa exercicis per tema, permet canviar entre exercicis d'escolta i interpretació, i exposa la configuració de so i micròfon per a instruments i sales diferents. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>música</keyword>
<keyword
>educació</keyword>
<keyword
>intervals</keyword>
<keyword
>acords</keyword>
<keyword
>escales</keyword>
<keyword
>ritme</keyword>
<keyword
>micròfon</keyword>
<keyword
>exercici</keyword>
<keyword
>Minuet</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introducció</title>

<para
>Us donem la benvinguda al &minuet;: el programari d'educació musical. Està construït sobre exercicis curts que permeten escoltar, respondre i posar a prova el vostre progrés sense sortir de l'aplicació. </para>
<para
>L'aplicació actualment cobreix l'entrenament melòdic de l'oïda, el reconeixement del ritme, exercicis de picar de mans i exercicis de cant. El mateix exercici sovint es pot practicar de més d'una manera, per això la interfície primer pregunta si voleu escoltar i identificar, llegir i picar de mans, o llegir i cantar. </para>

<screenshot>
  <screeninfo
>La pantalla d'inici del &minuet;</screeninfo>
  <mediaobject>
    <imageobject
><imagedata fileref="minuet-home.png" format="PNG"/></imageobject>
    <textobject
><phrase
>La pantalla d'inici del &minuet;</phrase
></textobject>
  </mediaobject>
</screenshot>

<para
>La pàgina d'inici és intencionadament mínima. Utilitzeu el calaix de navegació per a moure's a la pàgina de configuració, la pàgina quant o a una categoria d'exercicis. </para>
</chapter>

<chapter id="using-minuet">
<title
>Ús del &minuet;</title>

<para
>El flux normal és senzill: inicieu el &minuet;, trieu un exercici, trieu un mode d'exercici i, a continuació, treballeu mitjançant una pregunta o d'una prova. </para>

<sect1 id="starting-minuet">
<title
>Començar amb el &minuet;</title>

<para
>Inicieu el &minuet; des del llançador d'aplicacions o des d'un terminal executant <command
>minuet</command
>. Quan s'obri l'aplicació, la pàgina d'inici mostra una petició única: <guilabel
>Trieu un exercici</guilabel
>. </para>
</sect1>

<sect1 id="browse-exercises">
<title
>Navegueu i trieu exercicis</title>

<para
>El navegador d'exercicis agrupa temes per assumpte. Utilitzeu el calaix o la llista de categories per arribar a acords, intervals, ritme o escales. El navegador s'actualitza des dels fitxers d'especificació d'exercicis instal·lats, de manera que la jerarquia visible reflecteix els exercicis que estan disponibles actualment. </para>

<screenshot>
  <screeninfo
>Navegador d'exercicis del &minuet;</screeninfo>
  <mediaobject>
    <imageobject
><imagedata fileref="minuet-exercise-list.png" format="PNG"/></imageobject>
    <textobject
><phrase
>El navegador d'exercicis del &minuet;</phrase
></textobject>
  </mediaobject>
</screenshot>

<para
>Cada entrada d'exercici té un títol i una descripció breu. Algunes categories porten directament a un exercici, mentre que altres s'expandeixen en subcategories. La llista no es fixa en el codi: els fitxers d'exercicis nous es fusionen automàticament a la jerarquia quan s'inicia el &minuet;. </para>

</sect1>

<sect1 id="practice-modes">
<title
>Modes d'exercici</title>

<para
>Quan obriu un exercici, el &minuet; demana com voleu practicar-lo. </para>

<screenshot>
  <screeninfo
>Selector del mode d'exercici del &minuet;</screeninfo>
  <mediaobject>
    <imageobject
><imagedata fileref="minuet-practice-mode.png" format="PNG"/></imageobject>
    <textobject
><phrase
>El selector de mode d'exercici al &minuet;</phrase
></textobject>
  </mediaobject>
</screenshot>

<para
>Hi ha dos grans camins de pràctica: </para>

<itemizedlist>
<listitem>
<para
><guilabel
>Escoltar i identificar</guilabel
> reprodueix l'exercici i us demana que trieu la resposta d'entre les opcions disponibles. Aquest és el flux principal per a l'entrenament de l'oïda melòdica. </para>
</listitem>
<listitem>
<para
><guilabel
>Llegir i picar de mans</guilabel
> es mostra per a exercicis de ritme. <guilabel
>Llegir i cantar</guilabel
> es mostra per a exercicis melòdics que accepten l'entrada vocal, com ara intervals i escales. </para>
</listitem>
</itemizedlist>

<para
>L'elecció de la pràctica canvia el mode d'entrada, no la categoria d'exercici subjacent. Això vol dir que podeu utilitzar les mateixes dades de treball d'exercicis per escoltar, picar de mans o cantar depenent del tema. </para>
</sect1>

<sect1 id="melodic-workflow">
<title
>Entrenament melòdic de l'oïda</title>

<para
>Els exercicis melòdics segueixen el flux clàssic del Minuet: l'aplicació reprodueix una pregunta, mostra les opcions de resposta i permet reproduir la petició si cal tornar a escoltar-la. Aquest mode manual s'utilitza per a intervals, escales i acords quan trieu <guilabel
>Escoltar i identificar</guilabel
>. </para>

<screenshot>
  <screeninfo
>Exercici d'acords del &minuet; en el mode manual</screeninfo>
  <mediaobject>
    <imageobject
><imagedata fileref="minuet-chords-manual.png" format="PNG"/></imageobject>
    <textobject
><phrase
>Un exercici d'acords del &minuet; en el mode manual &minuet;</phrase
></textobject>
  </mediaobject>
</screenshot>

<para
>La pàgina d'exercicis proporciona els controls que necessiteu per a una pregunta individual o una prova més llarga: </para>

<itemizedlist>
<listitem
><para
><guibutton
>Pregunta nova</guibutton
> comença una altra pregunta.</para
></listitem>
<listitem
><para
><guibutton
>Reprodueix la pregunta</guibutton
> repeteix la petició actual.</para
></listitem>
<listitem
><para
><guibutton
>Renuncieu</guibutton
> revela la resposta.</para
></listitem>
<listitem
><para
><guibutton
>Inicia la prova</guibutton
> comença una seqüència de preguntes puntuades.</para
></listitem>
<listitem
><para
><guibutton
>Atura la prova</guibutton
> acaba la prova.</para
></listitem>
</itemizedlist>

<para
>En els exercicis melòdics, els botons de resposta i la vista del teclat o del pentagrama es mantenen alineats, de manera que podeu veure com cada candidat assigna les notes que es reprodueixen. </para>

<para
>Els exercicis d'acord utilitzen el mateix flux de treball manual, però la petició es reprodueix com un acord en lloc d'una seqüència melòdica. El &minuet; reprodueix l'acord, mostra la nota fonamental al teclat i al pentagrama, i us demana que trieu una qualitat d'acord d'entre les respostes disponibles. El catàleg d'acords inclou tríades, inversions, acords suspesos, acords de sèptima, acords de novena, acords d'onzena i conjunts d'acords mixtos com <guilabel
>Sèries d'acords</guilabel
>. </para>

<para
>Utilitzeu <guibutton
>Reprodueix la pregunta</guibutton
> per escoltar l'acord de nou abans de respondre. En el mode de prova, el &minuet; puntua la seqüència utilitzant el nombre configurat d'exercicis a la pàgina de configuració. </para>
</sect1>

<sect1 id="rhythm-workflow">
<title
>Ritme i picar de mans</title>

<para
>Els exercicis de ritme se centren en el temps en lloc del to. En el mode de picar de mans, el &minuet; escolta l'entrada del micròfon i compara els inicis amb el patró objectiu. </para>

<para
>Les categories <guilabel
>Fàcil amb pauses</guilabel
> i <guilabel
>Mitjà amb pauses</guilabel
> afegeixen posicions de silenci als corresponents patrons de només notes. Els exercicis d'escolta eviten seleccions que sonin idèntiques, mentre que <guilabel
>Llegir i picar de mans</guilabel
> inclou tots els patrons barrejats de nota i pausa. </para>

<screenshot>
  <screeninfo
>Exercici de picar de mans del &minuet;</screeninfo>
  <mediaobject>
    <imageobject
><imagedata fileref="minuet-clapping.png" format="PNG"/></imageobject>
    <textobject
><phrase
>Un exercici de picar de mans amb ritme al &minuet;</phrase
></textobject>
  </mediaobject>
</screenshot>

<para
>La vista de picar de mans mostra les targetes de patrons de ritmes, un mesurador de nivell d'entrada i una acció <guibutton
>Calibra el silenci</guibutton
>. El comptador passa abans d'iniciar l'enregistrament, de manera que podeu ajustar-vos al tempo abans que l'exercici escolti el picar de mans. </para>

<para
>Utilitzeu la pràctica del ritme per treballar: </para>

<itemizedlist>
<listitem
><para
>el reconeixement de les figures de ritme individuals per l'oïda;</para
></listitem>
<listitem
><para
>l'aparellament de picar de mans al ritme;</para
></listitem>
<listitem
><para
>el mantenir-se dins de la tolerància de temps configurada.</para
></listitem>
</itemizedlist>
</sect1>

<sect1 id="singing-workflow">
<title
>Exercicis de cant</title>

<para
>Els exercicis de cant utilitzen el micròfon per comparar el que canteu amb el contingut del to objectiu. La mateixa pantalla de pràctica s'utilitza tant per als treballs d'interval com d'escala, però l'objectiu i la retroalimentació canvien amb l'exercici escollit. </para>

<para
>Per als exercicis d'interval, el &minuet; reprodueix la nota fonamental i demana que canteu l'interval sol·licitat en relació amb ella. Per als exercicis d'escala, l'aplicació presenta una escala o mode i espera que canteu les notes en seqüència mentre manteniu el to i el ritme. </para>

<screenshot>
  <screeninfo
>Exercici d'interval de cant del &minuet;</screeninfo>
  <mediaobject>
    <imageobject
><imagedata fileref="minuet-singing-interval.png" format="PNG"/></imageobject>
    <textobject
><phrase
>Un exercici d'interval de cant al &minuet;</phrase
></textobject>
  </mediaobject>
</screenshot>

<screenshot>
  <screeninfo
>Exercicis d'escala cantant del &minuet;</screeninfo>
  <mediaobject>
    <imageobject
><imagedata fileref="minuet-singing-scale.png" format="PNG"/></imageobject>
    <textobject
><phrase
>Un exercici d'escala de cant al &minuet;</phrase
></textobject>
  </mediaobject>
</screenshot>

<para
>La vista de cant mostra els objectius de notes, la retroalimentació del to i l'inici, un comptador d'entrada en directe i una acció <guibutton
>Calibra el silenci</guibutton
>. El &minuet; també compta abans de la primera nota, de manera que podreu començar amb el ritme correcte. La vista d'escala estén la mateixa retroalimentació a seqüències més llargues, el que fa que sigui útil per a la pràctica de memòria melòdica, a més de la coincidència de tons. </para>

<para
>Els exercicis de cant estan influenciats per diversos paràmetres: </para>

<itemizedlist>
<listitem
><para
>La <guilabel
>Classe de veu</guilabel
> selecciona l'interval vocal esperat.</para
></listitem>
<listitem
><para
>La <guilabel
>Tolerància del to</guilabel
> controla fins a quin punt pot estar lluny del to objectiu una nota cantada.</para
></listitem>
<listitem
><para
>La <guilabel
>Tolerància de temps</guilabel
> controla la quantitat de deriva rítmica que s'accepta en picar de mans.</para
></listitem>
</itemizedlist>
</sect1>

</chapter>

<chapter id="settings">
<title
>Configuració</title>

<para
>La pàgina de configuració es divideix en quatre seccions: <guilabel
>Pràctica</guilabel
>, <guilabel
>So</guilabel
>, <guilabel
>Micròfon</guilabel
> i <guilabel
>Avançat</guilabel
>. Les tres primeres seccions mantenen visibles els controls de principiants. La secció avançada es manté reduïda fins que l'obriu. </para>

<screenshot>
  <screeninfo
>Configuració bàsica del &minuet;</screeninfo>
  <mediaobject>
    <imageobject
><imagedata fileref="minuet-settings-basic.png" format="PNG"/></imageobject>
    <textobject
><phrase
>La pàgina de configuració bàsica al &minuet;</phrase
></textobject>
  </mediaobject>
</screenshot>

<para
>La configuració visible cobreix els controls que la majoria d'usuaris necessiten en el dia a dia: </para>

<itemizedlist>
<listitem
><para
>La <guilabel
>Velocitat de l'exercici</guilabel
> estableix el tempo en pulsacions per minut.</para
></listitem>
<listitem
><para
>El <guilabel
>Nombre de patrons de ritme</guilabel
> controla la mida dels conjunts d'exercicis de ritme.</para
></listitem>
<listitem
><para
>El <guilabel
>Nombre d'exercicis</guilabel
> estableix la durada d'una prova.</para
></listitem>
<listitem
><para
>El <guilabel
>Volum</guilabel
> ajusta la sonoritat de la reproducció.</para
></listitem>
<listitem
><para
>L'<guilabel
>Instrument</guilabel
> selecciona el so melòdic utilitzat a l'entrenament de l'oïda.</para
></listitem>
<listitem
><para
>La <guilabel
>Classe de veu</guilabel
> selecciona l'interval objectiu de cant.</para
></listitem>
</itemizedlist>

<para
>La secció de micròfon també inclou descripcions curtes d'ajuda per als controls de tolerància i calibratge. Aquestes descripcions expliquen quan enfortir la tolerància i quan recalibrar el silenci. </para>

<screenshot>
  <screeninfo
>Configuració avançada del &minuet;</screeninfo>
  <mediaobject>
    <imageobject
><imagedata fileref="minuet-settings-advanced.png" format="PNG"/></imageobject>
    <textobject
><phrase
>La secció de configuració avançada al &minuet;</phrase
></textobject>
  </mediaobject>
</screenshot>

<para
>La configuració avançada exposa algorismes de detecció i llindars per a micròfons difícils o sales sorolloses. Utilitzeu-los quan el comportament de detecció predeterminat no sigui suficient. La secció està reduïda de manera predeterminada i inclou un botó <guibutton
>Restaura els valors predeterminats</guibutton
> perquè pugueu restaurar els valors de fàbrica després d'experimentar. </para>

<para
>La secció avançada inclou grups separats per a la detecció de picar de mans i la detecció del cant. Els controls típics inclouen el mètode d'inici, el llindar d'inici, la porta d'entrada, la intensitat mínima d'inici, el nivell de silenci, el mètode de to, el mode de puntuació, la confiança del to i els marcs de to estables. </para>
</chapter>

<chapter id="creating-exercises">
<title
>Crear exercicis nous del &minuet;</title>

<para
>Els exercicis del &minuet; es defineixen en fitxers d'especificació &JSON;. L'aplicació carrega tots els fitxers disponibles a l'inici i els fusiona a l'arbre d'exercicis visibles. </para>

<para>
<programlisting
>{
  "exercises": [
    {
      "name": "Intervals",
      "root": "29..69",
      "playMode": "scale",
      "userMessage": "Escolteu l'interval i trieu la resposta",
      "numberOfSelectedOptions": 1,
      "_icon": "minuet-intervals-symbolic.svg",
      "children": [
        {
          "name": "Intervals melòdics ascendents",
          "and-tags": ["interval", "ascending"],
          "children": [
            {
              "name": "Segons",
              "or-tags": ["2"],
              "description": "Practica la identificació dels segons melòdics ascendents per l'oïda."
            }
          ]
        }
      ]
    }
  ]
}
</programlisting>
</para>

<para
>L'objecte de nivell superior conté una matriu <parameter
>exercises</parameter
> matriu. Cada element d'aquesta matriu és una categoria o una fulla d'exercici. Les categories utilitzen <parameter
>children</parameter
> per definir el nivell següent de l'arbre. </para>

<para
>Els camps útils inclouen: </para>

<itemizedlist>
<listitem
><para
>El <parameter
>name</parameter
> dona a cada node la seva etiqueta visible.</para
></listitem>
<listitem
><para
><parameter
>root</parameter
> limita l'interval de notes utilitzat per generar la petició.</para
></listitem>
<listitem
><para
><parameter
>playMode</parameter
> selecciona l'escala, l'acord o la reproducció del ritme.</para
></listitem>
<listitem
><para
><parameter
>userMessage</parameter
> personalitza la instrucció que es mostra a l'usuari.</para
></listitem>
<listitem
><para
><parameter
>numberOfSelectedOptions</parameter
> controla quantes respostes poden ser correctes.</para
></listitem>
<listitem
><para
><parameter
>_icona</parameter
> estableix la icona que es mostra al calaix i al navegador d'exercicis.</para
></listitem>
<listitem
><para
><parameter
>and-tags</parameter
> i <parameter
>or-tags</parameter
> ajuden a agrupar i filtrar els nodes relacionats.</para
></listitem>
<listitem
><para
><parameter
>description</parameter
> dona al navegador una explicació breu del node.</para
></listitem>
<listitem
><para
><parameter
>options</parameter
> descriu les opcions de resposta per a un exercici de fulla.</para
></listitem>
<listitem
><para
><parameter
>sequenceFromRoot</parameter
> defineix els desplaçaments de la nota per a les respostes melòdiques.</para
></listitem>
<listitem
><para
><parameter
>template</parameter
> s'utilitza per exercicis de ritme per renderitzar la notació.</para
></listitem>
</itemizedlist>

<para
>L'aplicació fusiona fitxers que comparteixen els mateixos noms de categoria, de manera que fitxers d'especificació separats poden contribuir a una jerarquia visible. Instal·leu-los a tot el sistema o situeu-los a <filename class="directory"
>minuet/exercises/</filename
> dins la ubicació de dades genèriques retornada per <userinput
><command
>qtpaths</command
> <option
>--paths GenericDataLocation</option
></userinput
>. </para>

</chapter>

<chapter id="credits">

<title
>Crèdits i llicència</title>

<para
>&minuet; </para>
<para
>Copyright del programa 2016 &Sandro.Andrade; &Sandro.Andrade.mail; </para>

<para
>Copyright de la documentació &copy; 2026 &Sandro.Andrade; &Sandro.Andrade.mail; </para>

<para
>Traductor de la documentació: &credits.Antoni.Bella;</para
> &underFDL; &underGPL; </chapter>

&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;
-->
