<?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 % Spanish "INCLUDE">
]>
<book id="minuet" lang="&language;">

<bookinfo>
<title
>Manual de &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
>Eloy</firstname
><surname
>Cuadra</surname
><affiliation
><address
><email
>ecuadra@eloihr.net</email
></address
></affiliation
><contrib
>Traductor</contrib
></othercredit
> 
</authorgroup>

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

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

<releaseinfo
>Minuet 00.01 (Aplicaciones 16.04)</releaseinfo>

<abstract>
<para
>&minuet; es una aplicación para el aprendizaje musical. Contiene un conjunto de ejercicios de entrenamiento auditivo que contemplan el uso de intervalos, acordes y escalas. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>música</keyword>
<keyword
>educativo</keyword>
<keyword
>intervalos</keyword>
<keyword
>acordes</keyword>
<keyword
>escalas</keyword>
<keyword
>minuet</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introducción</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
>Bienvenido a &minuet;: el software musical educativo de &kde;. &minuet; está pensado para ayudar a estudiantes y profesores en diversos aspectos de la educación musical, como el entrenamiento auditivo, la lectura a primera vista, el solfeo, las escalas, el ritmo, la armonía y la improvisación. &minuet; hace un amplio uso de las funcionalidades &MIDI; para proporcionar un completo conjunto de funciones sobre cambios de volumen, tempo y modulación, lo que hace de &minuet; una valiosa herramienta tanto para el principiante como para el músico experimentado. </para>
<para
>&minuet; incluye un extenso conjunto de ejercicios para entrenamiento del oído y permite <link linkend="creating-exercises"
>añadir fácilmente</link
> otros nuevos para poder extender sus funciones y adaptarlo a diversos contextos de educación musical. </para>
<para>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="minuet-screenshot.png"/></imageobject>
<caption
><para
>Ejercicios de acordes de &minuet; para entrenamiento auditivo</para
></caption>
</mediaobject>
</para>
</chapter>

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

<para
>En las tres siguientes secciones (<link linkend="starting-minuet"
>Inicio de &minuet;</link
>, <link linkend="midi-configuration-wizard"
>Asistente de configuración de &minuet;</link
> y <link linkend="minuet-exercises"
>Ejercicios de &minuet;</link
>) le proporcionaremos los pasos necesarios para empezar a usar &minuet;. </para>

<sect1 id="starting-minuet">
<title
>Inicio de &minuet;</title>
<para
>Puede iniciar &minuet; desde el lanzador de aplicaciones. Abra el menú de programas de &kde; haciendo clic en el icono del lanzador de aplicaciones que hay en la barra de herramientas de la parte inferior de su pantalla. Esto mostrará un menú. Mueva el cursor hasta la opción del menú <menuchoice
><guimenu
>Aplicaciones</guimenu
><guisubmenu
>Educación</guisubmenu
><guisubmenu
>Varios</guisubmenu
> <guimenuitem
>&minuet; (Software educativo musical)</guimenuitem
></menuchoice
>. </para>
</sect1>

<sect1 id="midi-configuration-wizard">
<title
>Asistente de configuración de &minuet;</title>
<para
>La primera vez que ejecute &minuet;, se le mostrará un asistente de configuración que verifica si su sistema dispone de todas las dependencias necesarias para manejar archivos &MIDI;. &minuet; usa <ulink url="http://timidity.sourceforge.net/"
>TiMidity++</ulink
>/<ulink url="http://freepats.zenvoid.org/"
>Freepats</ulink
> como motor &MIDI; por omisión. Por ello, el asistente de configuración evalúa si dichas tecnologías están instaladas y configuradas correctamente. </para>
<para>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="configuration-wizard.png"/></imageobject>
<caption
><para
>Asistente de configuración de la primera ejecución de &minuet;</para
></caption>
</mediaobject>
</para>
<para
>Si todas las pruebas del asistente de configuración se pasan con éxito, &minuet; iniciará y detendrá automáticamente TiMidity++ cada vez que entre o salga de la aplicación, respectivamente. Puede acceder al asistente de configuración en cualquier momento usando <menuchoice
> <guimenu
>Preferencias</guimenu
> <guimenuitem
>Ejecutar el asistente de configuración</guimenuitem
> </menuchoice
>. </para>
</sect1>

<sect1 id="minuet-exercises">
<title
>Ejercicios y flujo de trabajo en &minuet;</title>

<para
>La interfaz de usuario de &minuet; contiene cuatro componentes principales: </para>
<para>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="minuet-ui-components.png"/></imageobject>
<caption
><para
>Componentes de la interfaz de usuario de &minuet;</para
></caption>
</mediaobject>
</para>
<variablelist>

<varlistentry>
<term
><guimenuitem
>Menú de navegación</guimenuitem
></term>
<listitem
><para
>Le permite desplazarse por las categorías de ejercicios de &minuet; y seleccionar un determinado ejercicio. El menú de navegación se crea de forma dinámica según los archivos de especificación de ejercicios, como se describe en <link linkend="creating-exercises"
>Creación de ejercicios</link
>. Los ejercicios de &minuet; se agrupan según su clase, como intervalos, escalas y acordes.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Controles de reproducción MIDI</guimenuitem
></term>
<listitem
><para
>Proporcionan las funciones básicas para la reproducción &MIDI; &minuet; puede reproducir archivos &MIDI; al azar seleccionando <menuchoice
> <guimenu
>Archivo</guimenu
> <guimenuitem
>Abrir</guimenuitem
> </menuchoice
> y pulsando a continuación el botón <parameter
>reproducir</parameter
><inlinemediaobject
><imageobject
><imagedata fileref="multimedia-play.png"/></imageobject
></inlinemediaobject
>. Puede pausar la reproducción pulsando el botón <parameter
>pausa</parameter
><inlinemediaobject
><imageobject
><imagedata fileref="multimedia-pause.png"/></imageobject
></inlinemediaobject
> y reanudarla pulsando de nuevo el botón <parameter
>reproducir</parameter
>. El botón <parameter
>detener</parameter
><inlinemediaobject
><imageobject
><imagedata fileref="multimedia-stop.png"/></imageobject
></inlinemediaobject
> interrumpe la reproducción &MIDI;. Los controles de reproducción &MIDI; también proporcionan mandos para cambiar el volumen<inlinemediaobject
><imageobject
><imagedata fileref="multimedia-volume.png"/></imageobject
></inlinemediaobject
>, el tempo<inlinemediaobject
><imageobject
><imagedata fileref="multimedia-speed.png"/></imageobject
></inlinemediaobject
> y el tono<inlinemediaobject
><imageobject
><imagedata fileref="multimedia-pitch.png"/></imageobject
></inlinemediaobject
> de la reproducción &MIDI; actual. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Vista del teclado</guimenuitem
></term>
<listitem
><para
>Expone los eventos &MIDI; <parameter
>note on</parameter
> secuenciados por la ejecución de un archivo &MIDI; o de un ejercicio.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Vista de ejercicios</guimenuitem
></term>
<listitem
><para
>Muestra, para un determinado ejercicio, botones para controlar la presentación del ejercicio y un conjunto de posibles respuestas para el ejercicio. La ejecución de un ejercicio comienza al pulsar el botón <parameter
>nueva pregunta</parameter
>. &minuet; reproduce un intervalo, un acorde o una escala al azar y el estudiante debe seleccionar una respuesta de entre las posibles que se muestran. &minuet; siempre presenta (como un pequeño círculo blanco en la vista del teclado) la primera nota del intervalo o escala seleccionado, o la nota raíz del acorde seleccionado. Al situar el cursor sobre una posible respuesta, &minuet; resalta su correspondiente representación visual en el visor del teclado. Las notas restantes de la respuesta se muestran como pequeños círculos cuyo color es idéntico al del botón de la respuesta sobre el que se ha situado el cursor. El estudiante puede escuchar el ejercicio de nuevo pulsando el botón <parameter
>reproducir la pregunta</parameter
>, pulsar el botón de la respuesta escogida u obtener la respuesta correcta pulsando el botón <parameter
>me rindo</parameter
>. Se puede volver a ejecutar el mismo ejercicio pulsando otra vez el botón <parameter
>nueva pregunta</parameter
>.</para
></listitem>
</varlistentry>

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

<chapter id="creating-exercises">
<title
>Creación de nuevos ejercicios de &minuet;</title>

<para
>Los ejercicios de &minuet; se definen en archivos de especificación de ejercicios, escritos en formato JSON: </para>
<para>
<programlisting
>{
  "exercises": [
    {
      "name": "Intervalos",
      "root": "21..104",
      "playMode": "scale",
      "children": [
        {
          "name": "Intervalos melódicos ascendentes",
          "children": [
            {
              "name": "Segundas",
              "options": [
                {
                  "name": "Segunda menor",
                  "sequenceFromRoot": "1"
                },
                {
                  "name": "Segunda mayor",
                  "sequenceFromRoot": "2"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}
</programlisting>
</para>
<para
>Los archivos de especificación de ejercicios de &minuet; contienen un objeto JSON de nivel superior que incluye la tabla de <parameter
>ejercicios</parameter
>. Esta tabla define una estructura jerárquica de ejercicios, agrupados por categorías. Cada categoría o ejercicio posee un nombre. Los objetos JSON de categorías contienen una propiedad llamada <parameter
>children</parameter
> que describe las subcategorías o ejercicios que contiene dicha categoría. Los objetos JSON de ejercicios contienen una propiedad llamada <parameter
>options</parameter
> que define las posibles respuestas para dicho ejercicio. Cada vez que se ejecuta un ejercicio, &minuet; selecciona al azar una respuesta entre las posibles y se espera que el estudiante pulse el botón de la respuesta que se corresponda con la respuesta seleccionada. </para>
<para
>Cualquier (sub)categoría puede definir un parámetro <parameter
>root</parameter
> para indicar el intervalo del que se escogerá al azar la nota inicial del intervalo, acorde o escala para todos los ejercicios de dicha categoría. Este intervalo corresponde a los números de notas &MIDI; estándares y sigue el formato <parameter
>&lt;valor-mín&gt;..&lt;valor-máx&gt;</parameter
>. El ejemplo mostrado anteriormente usa todo el intervalo del teclado como posibles notas raíz (21..104). El parámetro <parameter
>playMode</parameter
> indica cómo se deben reproducir las posibles respuestas: como una <parameter
>escala</parameter
> (una nota tras otra) o como un <parameter
>acorde</parameter
> (todas las notas sonando simultáneamente). </para>
<para
>Cada opción del ejercicio define un nombre y una secuencia de notas que se deben reproducir desde la nota raíz seleccionada al azar cada vez que se ejecuta el ejercicio. Dicha secuencia de notas se define como distancias relativas desde la nota raíz, describiendo el intervalo que forma cada nota en conjunción con la nota raíz. Por ejemplo, para una escala mayor, la secuencia de notas es «2 4 5 7 9 11 12», que representa respectivamente la estructura de la escala mayor «entera entera media entera entera entera media». El parámetro <parameter
>sequenceFromRoot</parameter
> puede contener notas de cualquier longitud. Además, el núcleo de &minuet; se asegura de que solo se seleccionen al azar las respuestas cuyas notas caigan dentro del intervalo del teclado. </para>
<para
>Para proporcionar una mejor infraestructura para organizar un gran conjunto de archivos de especificación de ejercicios, el núcleo de &minuet; permite el uso de varios archivos de especificación, que se fusionan automáticamente para componer la jerarquía de ejercicios final que se muestra en el menú de navegación. Los ejercicios se fusionan correctamente siempre y cuando los distintos archivos de especificación usen el mismo nombre de (sub)categoría para definir los ejercicios. Hasta ahora, &minuet; no proporciona ninguna &GUI; para crear especificaciones de ejercicios, por lo que usted deberá crear manualmente estos archivos JSON. Los archivos de especificación de ejercicios de &minuet; se pueden instalar para todo el sistema en el directorio <filename
>/usr/share/minuet/exercises/</filename
>, o de forma local en el directorio <filename
>/~/.local/share/minuet/exercises/</filename
>. </para>

</chapter>

<chapter id="minuet-configuration">
<title
>Configuración de &minuet;</title>

<para
>Puede configurar algunas preferencias &MIDI; de &minuet; en <menuchoice
> <guimenu
>Preferencias</guimenu
> <guimenuitem
>Configurar Minuet</guimenuitem
> </menuchoice
>: </para>
<para>
<mediaobject>
<imageobject
><imagedata format="PNG" fileref="minuet-configuration.png"/></imageobject>
<caption
><para
>Preferencias de &minuet;</para
></caption>
</mediaobject>
</para>
<para
>El parámetro <parameter
>TiMidity++</parameter
> contiene la ruta absoluta al programa TiMidity++. Esta ruta se ajusta automáticamente por el asistente de configuración de &minuet; si su entorno es correcto, aunque usted puede proporcionar sus propios ajustes, si así lo desea. </para>
<para
>Los <parameter
>parámetros de TiMidity++</parameter
> indican los parámetros a usar cuando se inicie el servicio TiMidity++. Debería usar el valor proporcionado por el asistente de configuración de &minuet; a menos que tenga un buen motivo para cambiarlo. </para>
<para
>Por último, el parámetro <parameter
>Puerto de salida MIDI</parameter
> indica el puerto que debe usar &minuet; para reproducir eventos &MIDI;. De nuevo, el asistente de configuración de &minuet; le proporciona valores adecuados para él, aunque usted tiene libertad para cambiarlo si está usando otro secuenciador &MIDI; como, por ejemplo, fluidsynth. </para>

</chapter>

<chapter id="credits">

<title
>Créditos y licencia</title>

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

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

<para
>Traducido por Eloy Cuadra <email
>ecuadra@eloihr.net</email
>.</para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Instalación</title>

<sect1 id="requirements">
<title
>Requisitos</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
>Para poder usar &minuet; con éxito, necesita algunas bibliotecas de &kf5; 5.18 (CoreAddons, I18n, XmlGui, ConfigWidgets, DocTools, KIO). Además, &minuet; depende de la <ulink url="http://drumstick.sourceforge.net/"
>biblioteca Drumstick</ulink
> para las funciones &MIDI;. </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;
-->
