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

<bookinfo>
<title
>Handbok &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
>Stefan</firstname
> <surname
>Asserhäll</surname
> <affiliation
><address
><email
>stefan.asserhall@bredband.net</email
></address
></affiliation
> <contrib
>Översättare</contrib
></othercredit
> 
</authorgroup>

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

<date
>2016-01-17</date>

<releaseinfo
>1.00.00</releaseinfo>

<abstract>
<para
>&minuet; är ett program för musikutbildning. Det innehåller ett antal gehörsövningar avseende intervall, ackord och skalor. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>musik</keyword>
<keyword
>utbildning</keyword>
<keyword
>intervall</keyword>
<keyword
>ackord</keyword>
<keyword
>skalor</keyword>
<keyword
>minuet</keyword>
</keywordset>

</bookinfo>

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

<!-- The introduction chapter contains a brief introduction for the
application that explains what it does and where to report
problems. Basically a long version of the abstract.  Don't include a
revision history. (see installation appendix comment) -->

<para
>Välkommen till &minuet;, &kde;:s programvara för musikutbildning. &minuet; har som mål att hjälpa elever och lärare i många av musikutbildningens aspekter, såsom gehörsövning, första notläsning, solmisering, skalor, rytm, harmonilära och improvisation. &minuet; använder &MIDI;-funktioner i stor utsträckning för att tillhandahålla en fullfjädrad uppsättning funktioner när det gäller volym, tempo och förändringar av tonhöjd, vilket gör &minuet; ett värdefullt verktyg för både nybörjare och erfarna musiker. </para>
<para
>&minuet; har en rik uppsättning gehörsövningar och nya kan <link linkend="creating-exercises"
>kan smidigt läggas till</link
> för att utöka funktionaliteten och anpassa den till olika musikutbildningssammanhang. </para>
<para>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="minuet-screenshot.png"/></imageobject>
<caption
><para
>Gehörsövningar för ackord i &minuet;</para
></caption>
</mediaobject>
</para>
</chapter>

<chapter id="using-minuet">
<title
>Använda &minuet;</title>

<para
>I följande tre avsnitt, <link linkend="starting-minuet"
>Starta &minuet;</link
>, <link linkend="midi-configuration-wizard"
>Inställningsguiden i &minuet;</link
> och <link linkend="minuet-exercises"
>Övningar i &minuet;</link
>, ger vi dig de nödvändiga stegen för att komma igång med &minuet;. </para>

<sect1 id="starting-minuet">
<title
>Starta &minuet;</title>
<para
>&minuet; kan startas från Starta program. Visa &kde;:s programmeny genom att klicka på ikonen för Starta program i verktygsraden längst ner till vänster på skärmen. Det visar en meny. Flytta pekaren upp i menyn till menyalternativet <menuchoice
><guimenu
>Program</guimenu
><guisubmenu
>Utbildning</guisubmenu
><guisubmenu
>Diverse</guisubmenu
> <guimenuitem
>&minuet; (Programvara för musikutbildning)</guimenuitem
></menuchoice
> </para>
</sect1>

<sect1 id="midi-configuration-wizard">
<title
>Inställningsguiden i &minuet;</title>
<para
>När &minuet; startas för första gången, visas en inställningsguide som verifierar att alla beroenden som krävs för att hantera &MIDI;-filer finns på plats i systemet. &minuet; använder <ulink url="http://timidity.sourceforge.net/"
>TiMidity++</ulink
> eller <ulink url="http://freepats.zenvoid.org/"
>Freepats</ulink
> som standardgränssnitt för &MIDI;. Därför kontrollerar inställningsguiden att dessa teknologier är riktigt installerade och inställda. </para>
<para>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="configuration-wizard.png"/></imageobject>
<caption
><para
>Inställningsguiden för första användning av &minuet;</para
></caption>
</mediaobject>
</para>
<para
>Om alla kontrollerna i inställningsguiden lyckas, startar och stoppar &minuet; automatiskt TiMidity++ när programmet startas och avslutas. Det går att visa inställningsguiden när som helst igen genom att använda <menuchoice
><guimenu
>Inställningar</guimenu
> <guimenuitem
>Visa inställningsguide </guimenuitem
></menuchoice
>. </para>
</sect1>

<sect1 id="minuet-exercises">
<title
>Övningar och arbetsflöde i &minuet;</title>

<para
>Användargränssnittet i &minuet; består av fyra huvuddelar: </para>
<para>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="minuet-ui-components.png"/></imageobject>
<caption
><para
>Delar av användargränssnittet i &minuet;</para
></caption>
</mediaobject>
</para>
<variablelist>

<varlistentry>
<term
><guimenuitem
>Navigeringsmeny</guimenuitem
></term>
<listitem
><para
>Gör det möjligt att navigera bland övningskategorierna i &minuet; och välja en viss övning. Navigeringsmenyn skapas dynamiskt baserat på övningsspecifikationsfiler som beskrivs i <link linkend="creating-exercises"
>Skapa övningar</link
>. Övningarna i &minuet; är grupperade enligt klasser som intervall, skalor och ackord.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>MIDI-spelarkontroller</guimenuitem
></term>
<listitem
><para
>Tillhandahåller grundfunktioner för att hantera uppspelning med &MIDI;. &minuet; kan spela upp godtyckliga &MIDI;-filer genom att välja <menuchoice
> <guimenu
>Arkiv</guimenu
> <guimenuitem
>Öppna</guimenuitem
> </menuchoice
> och därefter klicka på knappen <parameter
>Spela</parameter
><inlinemediaobject
><imageobject
><imagedata fileref="multimedia-play.png"/></imageobject
></inlinemediaobject
>. Uppspelningen kan pausas genom att klicka på knappen <parameter
>Paus</parameter
> <inlinemediaobject
><imageobject
><imagedata fileref="multimedia-pause.png"/></imageobject
></inlinemediaobject
>och återupptas genom att åter klicka på knappen <parameter
>Spela</parameter
>. Knappen <parameter
>Stopp</parameter
><inlinemediaobject
><imageobject
><imagedata fileref="multimedia-stop.png"/></imageobject
></inlinemediaobject
>avbryter uppspelning av &MIDI;. Spelarkontroller för &MIDI; erbjuder också skjutreglage för att ändra volym<inlinemediaobject
><imageobject
><imagedata fileref="multimedia-volume.png"/></imageobject
></inlinemediaobject
>, tempo<inlinemediaobject
><imageobject
><imagedata fileref="multimedia-speed.png"/></imageobject
></inlinemediaobject
> och tonhöjd<inlinemediaobject
><imageobject
><imagedata fileref="multimedia-pitch.png"/></imageobject
></inlinemediaobject
> för den &MIDI;-fil som för närvarande spelas. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Klaviatur</guimenuitem
></term>
<listitem
><para
>Visar <parameter
>note on</parameter
> &MIDI;-händelser sekvenserade av en &MIDI;-fil eller vid ett övningsutförande.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Övningsvy</guimenuitem
></term>
<listitem
><para
>Visar knappar för att kontrollera presentation av övningen och en uppsättning möjliga svar på övningen, för en given övning. En övning börjar genom att klicka på knappen <parameter
>Ny fråga</parameter
>. Ett slumpmässigt valt interval, ackord eller skala spelas upp av &minuet;, och därefter förväntas eleven välja ett svar bland de som visas i svarsfältet. &minuet; visar alltid den första tonen för det valda intervallet eller skalan, eller grundtonen för det valda ackordet, som en liten vit cirkel i svarsfältet. Genom att hålla muspekaren över ett möjligt svar, markerar &minuet; den motsvarande visuella representationen på klaviaturen. Återstående toner i svaret som hålls över visas som små cirklar vars färger är samma som knappen för svaret som hålls över. Eleven kan lyssna på övningen igen genom att klicka på knappen <parameter
>Spela upp fråga</parameter
>, klicka på den valda svarsknappen, eller få rätt svar genom att klicka på knappen <parameter
>Ge upp</parameter
>. Ett nytt försök med samma övning kan startas genom att klicka på knappen <parameter
>Ny fråga</parameter
> igen.</para
></listitem>
</varlistentry>

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

<chapter id="creating-exercises">
<title
>Skapa nya övningar för &minuet;</title>

<para
>Övningar i &minuet; är definierade i övningsspecifikationsfiler, skrivna på JSON-format: </para>
<para>
<programlisting
>{
  "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"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}
</programlisting>
</para>
<para
>Övningsspecifikationsfilerna i &minuet; innehåller ett JSON-objekt på toppnivån, som innehåller fältet <parameter
>exercises</parameter
>. Ett sådant fält definierar en hierarkisk struktur av övningar, grupperade enligt kategorier. Varje kategori och övning har ett namn. JSON-objekt för kategorier innehåller en egenskap benämnd <parameter
>children</parameter
>, som beskriver delkategorierna eller övningarna som är förenade med en sådan kategori. JSON-objekt för övningar innehåller en egenskap benämnd <parameter
>options</parameter
>, som definiera möjliga svar för en sådan övning. Vid varje övningstillfälle, väljer &minuet; slumpmässigt ett svar bland de möjliga, och eleven förväntas klicka på svarsknappen som motsvarar det valda svaret. </para>
<para
>Alla (del)kategorier kan definiera parametern <parameter
>root</parameter
> för att ange omfång som grundtonen i intervallet, ackordet eller skalan kommer att väljas slumpmässigt från för alla övningar i kategorin. Sådana omfång motsvarar vanliga tonnummer i &MIDI; och har formatet <parameter
>&lt;minvärde&gt;..&lt;maxvärde&gt;</parameter
>. Exemplet som visas ovan använder hela klaviaturens omfång som möjliga grundtoner (21..104). Parametern <parameter
>playMode</parameter
> anger hur möjliga svar ska spelas upp: som en skala, <parameter
>scale</parameter
> (en ton i taget), eller som ett ackord, <parameter
>chord</parameter
> (alla toner ljuder samtidigt). </para>
<para
>Alternativet för varje övning definierar ett namn och en tonföljd som ska spelas från grundtonen som väljes slumpmässigt vid varje övningstillfälle. En sådan tonföljd definieras som relativt avstånd från grundtonen, och beskriver intervallet som varje ton utgör i förhållande till grundtonen. Exempelvis för en durskala är tonföljden "2 4 5 7 9 11 12", vilket anger durskalans struktur "hel hel halv hel hel hel halv". Parametern <parameter
>sequenceFromRoot</parameter
> kan innehålla vilka toner som helst i längd. Dessutom försäkrar kärnan i &minuet; att bara svar vars toner befinner sig inom klaviaturens omfång väljes slumpmässigt. </para>
<para
>För att skapa en bättre infrastruktur för att organisera en stor mängd övningsspecifikationsfiler, stöder kärnan i &minuet; användning av flera specifikationsfiler, som automatiskt sammanfogas för att skapa den slutliga övningshierarkin som visas i Navigeringsmeny. Övningar sammanfogas på ett riktigt sätt, under förutsättning att olika specifikationsfiler använder samma (del)kategorinamn när övningar definieras. För närvarande erbjuder inte &minuet; något grafiskt gränssnitt för att skapa övningsspecifikationer, och sådana JSON-filer måste alltså skapas för hand. Övningsspecifikationsfiler i &minuet; kan installeras för hela systemet i katalogen <filename
>/usr/share/minuet/exercises/</filename
> eller lokalt i katalogen <filename
>~/.local/share/minuet/exercises/</filename
>. </para>

</chapter>

<chapter id="minuet-configuration">
<title
>Inställning av &minuet;</title>

<para
>Vissa av &MIDI;-inställningarna i &minuet; kan ställas in med <menuchoice
> <guimenu
>Inställningar</guimenu
> <guimenuitem
>Anpassa Minuet</guimenuitem
> </menuchoice
>: </para>
<para>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="minuet-configuration.png"/></imageobject>
<caption
><para
>Inställningarna i &minuet;</para
></caption>
</mediaobject>
</para>
<para
>Parametern <parameter
>TiMidity++</parameter
> innehåller den absoluta sökvägen till programmet TiMidity++. En sådan sökväg ställs automatiskt in av inställningsguiden i &minuet; om miljön är rimlig, men det går att ange en egen inställning om man vill. </para>
<para
><parameter
>TiMidity++ parametrar</parameter
> anger parametrarna som ska användas när tjänsten TiMidity++ startas. Värdet som tillhandahålls av inställningsguiden i &minuet; bör användas, om det inte finns en god anledning att ändra det. </para>
<para
>Slutligen anger parametern <parameter
>MIDI-utgång</parameter
> utgången som &minuet; ska använda för att spela upp &MIDI;-händelser. Återigen, ger inställningsguiden i &minuet; redan bra värden för den, men man har möjlighet att använda andra &MIDI;-sekvensenheter, exempelvis fluidsynth. </para>

</chapter>

<chapter id="credits">

<title
>Tack till och licens</title>

<para
>&minuet; </para>
<para
>Program copyright 2016 &Sandro.Andrade; <email
>&Sandro.Andrade.mail;</email
> </para>

<para
>Dokumentation Copyright &copy; 2016 &Sandro.Andrade; <email
>&Sandro.Andrade.mail;</email
> </para>

<para
>Översättning Stefan Asserhäll <email
>stefan.asserhall@bredband.net</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Installation</title>

<sect1 id="requirements">
<title
>Krav</title>

<!--
List any special requirements for your application here. This should include:
.Libraries or other software that is not included in kdesupport or kf5
.Hardware requirements like amount of RAM, disk space, graphics card
capabilities, screen resolution, special expansion cards, etc.
.Operating systems the app will run on. If your app is designed only for a
specific OS, (you wrote a graphical LILO configurator for example) put this
information here.
-->

<para
>För att använda &minuet; med lyckat resultat behövs några få bibliotek från KF5 5.18 (CoreAddons, I18n, XmlGui, ConfigWidgets, DocTools, KIO). Dessutom förlitar sig &minuet; på <ulink url="http://drumstick.sourceforge.net/"
> biblioteket Drumstick</ulink
> för &MIDI;-funktioner. </para>

</sect1>

</appendix>

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