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

<bookinfo>
<title
>Il manuale di &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
>Vincenzo</firstname
> <surname
>Reale</surname
> <affiliation
><address
><email
>smart2128@baslug.org</email
></address
></affiliation
> <contrib
>Traduzione del documento</contrib
></othercredit
> 
</authorgroup>

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

<date
>9/12/2016</date>

<releaseinfo
>Applications 16.12</releaseinfo>

<abstract>
<para
>&minuet; è un'applicazione per l'educazione musicale. Fornisce un insieme di esercizi per allenare l'orecchio relativi a intervalli, accordi, scale e altro. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>musica</keyword>
<keyword
>educazione</keyword>
<keyword
>intervalli</keyword>
<keyword
>accordi</keyword>
<keyword
>scale</keyword>
<keyword
>minuet</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introduzione</title>

<para
>Benvenuti in &minuet;: il programma di educazione musicale di &kde;. &minuet; nasce con l'intento di supportare studenti e insegnanti in molti aspetti dell'educazione musicale, come l'allenamento dell'orecchio, lettura a prima vista, solfeggio, ritmo, armonia e improvvisazione. &minuet; fa ampio uso delle capacità &MIDI; per fornire un insieme completo di funzionalità relative a volume, tempo e cambi di tonalità, che rendono &minuet; uno strumento prezioso sia per i principianti che per i musicisti esperti. </para>
<para
>&minuet; fornisce un insieme ampio di esercizi di allenamento dell'orecchio ed è possibile <link linkend="creating-exercises"
>aggiungere in modo trasparente</link
> nuovi esercizi per estendere le sue funzionalità e adattarlo a numerosi contesti di educazione musicale. </para>
<para>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="minuet-screenshot.png"/></imageobject>
<caption
><para
>Esercizi sugli accordi di &minuet; per l'allenamento dell'orecchio</para
></caption>
</mediaobject>
</para>
</chapter>

<chapter id="using-minuet">
<title
>Utilizzare &minuet;</title>

<para
>Nelle due sezioni successive - <link linkend="starting-minuet"
>Avviare &minuet;</link
> e <link linkend="minuet-exercises"
>Esercizi di &minuet;</link
> - forniremo i passaggi necessari per il funzionamento di &minuet;. </para>

<sect1 id="starting-minuet">
<title
>Avviare &minuet;</title>
<para
>È possibile avviare &minuet; dall'esecutore delle applicazioni. Aprire il menu dei programmi di &kde; facendo clic sull'icona dell'esecutore delle applicazioni sulla barra degli strumenti, in basso a sinistra dello schermo. Questo farà apparire un menu. Spostare il puntatore sul menu fino alla voce <menuchoice
><guimenu
>Applicazioni</guimenu
><guisubmenu
>Didattica</guisubmenu
><guisubmenu
>Varie</guisubmenu
> <guimenuitem
>&minuet; (Programma di educazione musciale)</guimenuitem
></menuchoice
>. </para>
</sect1>

<sect1 id="minuet-exercises">
<title
>Esercizi e flusso di lavoro di &minuet;</title>

<para
>L'interfaccia utente di &minuet; prevede tre componenti principali: </para>
<para>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="minuet-ui-components.png"/></imageobject>
<caption
><para
>Componenti UI di &minuet;</para
></caption>
</mediaobject>
</para>
<variablelist>

<varlistentry>
<term
><guimenuitem
>Menu di navigazione</guimenuitem
></term>
<listitem
><para
>Consente di navigare nelle categorie di esercizi di &minuet; e selezionare un esercizio specifico. Il menu di navigazione è creato dinamicamente sulla base dei file di specifica degli esercizi descritti in <link linkend="creating-exercises"
>Creare esercizi</link
>. Glli esercizi di &minuet; sono raggruppati in classi come intervalli, scale e accordi.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Vista Tastiera</guimenuitem
></term>
<listitem
><para
>Mostra gli eventi &MIDI; <parameter
>note on</parameter
> sequenziati da un file &MIDI; o dall'esecuzione di un esercizio.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Vista Esercizi</guimenuitem
></term>
<listitem
><para
>Presenta, per un dato esercizio, i pulsanti per controllare la presentazione dell'esercizio e un insieme delle possibili risposte dell'esercizio. L'esecuzione di un esercizio inizia facendo clic sul pulsante <parameter
>nuova domanda</parameter
>. Un intervallo/accordo/scala selezionata casualmente è riprodotta da &minuet; e lo studente deve scegliere tra una delle risposte mostrate nella griglia. &minuet; presenta sempre - come un piccolo cerchio bianco nella vista Tastiera - la prima nota dell'intervallo/scala selezionato o la nota radice dell'accordo selezionato. Passando con il puntatore su una possibile risposta, &minuet; evidenzia la rappresentazione visuale corrispondente nella vista Tastiera. Le note rimanenti della risposta mostrata sono presentate come piccoli cerchi il cui colore è lo stesso del pulsante del risposta sulla quale passa il puntatore. Lo studente può ascoltare nuovamente l'esercizio facendo clic sul pulsante <parameter
>ascolta la domanda</parameter
>, fare clic sul pulsante della risposta scelta, o ottenere la risposta corretta facendo clic sul pulsante <parameter
>rinuncia</parameter
>. Una nuova esecuzione dello stesso esercizio può essere iniziata facendo clic nuovamente sul pulsante <parameter
>nuova domanda</parameter
>.</para
></listitem>
</varlistentry>

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

<chapter id="creating-exercises">
<title
>Creare nuovi esercizi di &minuet;</title>

<para
>Gli esercizi di &minuet; sono definiti in file delle specifiche degli esercizi, scritti in formato JSON: </para>
<para>
<programlisting
>{
  "exercises": [
    {
      "name": "Intervalli",
      "root": "21..104",
      "playMode": "scala",
      "children": [
        {
          "name": "Intervalli melodici ascendenti",
          "children": [
            {
              "name": "Seconde",
              "options": [
                {
                  "name": "Seconda minore",
                  "sequenceFromRoot": "1"
                },
                {
                  "name": "Seconda maggiore",
                  "sequenceFromRoot": "2"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}
</programlisting>
</para>
<para
>I file di specifica degli esercizi di &minuet; contengono un oggetto JSON di primo livello che fornisce il vettore degli <parameter
>esercizi</parameter
>. Questo vettore definisce una struttura gerarchica di esercizi, raggruppati per categorie. Ogni categoria/esercizio ha un nome. Gli oggetti JSON delle categorie contengono una proprietà con nome <parameter
>children</parameter
>, che descrive le sottocategorie/esercizi contenuti in tale categoria. Gli oggetti JSON degli esercizi contengono una proprietà con nome <parameter
> options</parameter
>, che definisce le possibili risposte per un esercizio. In ogni esecuzione dell'esercizio, &minuet; seleziona in modo casuale una risposta tra le possibili e lo studente deve fare clic  sul pulsante della risposta che corrisponde alla risposta selezionata. </para>
<para
>Ogni (sotto)categoria dovrebbe definire un parametro <parameter
>root</parameter
> per specificare l'intervallo dal quale sarà scelta casualmente la prima nota dell'intervallo/accordo/scala per tutti gli esercizi in questa categoria. Tale intervallo corrisponde ai numeri standard delle note &MIDI; e segue il formato <parameter
>&lt;min-value&gt;..&lt;max-value&gt;</parameter
>. L'esempio presentato sopra utilizza tutto l'intervallo della tastiera come possibili note radice (21..104). Il parametro <parameter
>playMode</parameter
> indica come dovrebbero riprodotte le risposte possibili: come una <parameter
>scala</parameter
> (una nota dopo l'altra) o come <parameter
>accordo</parameter
> (tutte le note suonano contemporaneamente). </para>
<para
>Ogni opzione dell'esercizio definisce un nome e la sequenza di note che dovrebbe essere riprodotta dalla nota radice selezionata casualmente in ogni esecuzione dell'esercizio. Tale sequenza di note è definita con distanze relative dalla nota radice, che descrive l'intervallo che ogni nota forma in congiunzione con la nota radice. Ad esempio, per una scala maggiore, la sequenza di note è «2 4 5 7 9 11 12», che indica rispettivamente la struttura della scala maggiore «intero intero metà intero intero intero metà». Il parametro <parameter
>sequenceFromRoot</parameter
> potrebbe contenere qualsiasi nota in durata. Inoltre, il nucleo di &minuet; assicura che siano selezionate casualmente solo le risposte in cui tutte le note si trovino nell'intervallo della tastiera. </para>
<para
>Per fornire un'infrastruttura migliore per organizzare un vasto insieme di file di specifica degli esercizi, il nucleo di &minuet; supporta l'utilizzo di numero file di specifica, che sono uniti automaticamente per comporre la gerarchia finale dell'esercizio presentata nel menu di navigazione. Gli esercizi sono uniti correttamente fintanto che file di specifica diversi utilizzano lo stesso nome di (sotto)categoria quando si definiscono gli esercizi. Per ora, &minuet; non fornisce una &GUI; per creare specifiche di esercizi, per cui è necessario creare manualmente i file JSON. I file di specifica degli esercizi di &minuet; possono essere installati a livello di sistema o localmente nella cartella <filename class="directory"
>minuet/exercises/</filename
> posizionata in <userinput
><command
>qtpaths</command
> <option
>--path GenericDataLocation</option
></userinput
> </para>

</chapter>

<chapter id="credits">

<title
>Riconoscimenti e licenza</title>

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

<para
>Copyright della documentazione &copy; 2016 &Sandro.Andrade; &Sandro.Andrade.mail; </para>

<para
>Traduzione italiana di Vincenzo Reale <email
>smart2128@baslug.org</email
></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;
-->
