Warning, /education/minuet/po/pt_BR/docs/minuet/index.docbook is written in an unsupported language. File is not indexed.

 <?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 % Brazilian-Portuguese "INCLUDE">
 ]>
 <book id="minuet" lang="&language;">
 
 <bookinfo>
 <title
 >Manual do &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
 >André Marcelo</firstname
 ><surname
 >Alvarenga</surname
 ><affiliation
 ><address
 ><email
 >alvarenga@kde.org</email
 ></address
 ></affiliation
 ><contrib
 >Tradução</contrib
 ></othercredit
 > 
 </authorgroup>
 
 <copyright>
 <year
 >2016</year>
 <holder
 >&Sandro.Andrade;</holder>
 </copyright>
 <legalnotice
 >&FDLNotice;</legalnotice>
 
 <date
 >19/10/2021</date>
 
 <releaseinfo
 >0.4 (KDE Gear 21.08)</releaseinfo>
 
 <abstract>
 <para
 >&minuet; é um aplicativo para ensino de música. Ele oferece um conjunto de exercícios para treinamento de ouvido, incluindo intervalos, acordes e escalas musicais. </para>
 </abstract>
 
 <keywordset>
 <keyword
 >KDE</keyword>
 <keyword
 >kdeedu</keyword>
 <keyword
 >música</keyword>
 <keyword
 >educação</keyword>
 <keyword
 >intervalos</keyword>
 <keyword
 >acordes</keyword>
 <keyword
 >escalas</keyword>
 <keyword
 >Minuet</keyword>
 </keywordset>
 
 </bookinfo>
 
 <chapter id="introduction">
 <title
 >Introdução</title>
 
 <para
 >Bem-vindo ao &minuet;: o aplicativo para ensino de música. O &minuet; tem como objetivo ajudar alunos e professores em diversos aspectos da educação musical, tais como treinamento de ouvido, leitura à primeira vista, solfejo, escalas, ritmo, harmonia e improvisação. O &minuet; faz uso intenso de recursos &MIDI; para oferecer um conjunto completo de funcionalidades referentes a alterações de volume, tempo e afinação, o que o torna uma ferramenta valiosa tanto para músicos amadores como para profissionais. </para>
 <para
 >O &minuet; oferece um conjunto amplo de exercícios para treinamento de ouvido e novos exercícios poderão ser <link linkend="creating-exercises"
 >facilmente adicionados</link
 > para ampliar suas funcionalidades e adaptá-lo a diversos contextos de educação musical. </para>
 
 <screenshot>
   <screeninfo
 >Janela principal do &minuet;</screeninfo>
   <mediaobject>
     <imageobject
 ><imagedata fileref="minuet-screenshot.png" format="PNG"/></imageobject>
     <textobject
 ><phrase
 >Exercícios do &minuet; para treinamento de ouvido com o uso de acordes</phrase
 ></textobject>
   </mediaobject>
 </screenshot>
 </chapter>
 
 <chapter id="using-minuet">
 <title
 >Usando o &minuet;</title>
 
 <para
 >Nas próximas duas seções - <link linkend="starting-minuet"
 >Iniciando o &minuet;</link
 > e <link linkend="minuet-exercises"
 >Exercícios do &minuet;</link
 > - apresentaremos os passos necessários para deixar o &minuet; pronto para execução. </para>
 
 <sect1 id="starting-minuet">
 <title
 >Iniciando o &minuet;</title>
 
 <para
 >Você pode iniciar o &minuet; a partir do lançador de aplicativos. Abra o menu global clicando no ícone do lançador de aplicativos na área de notificação, localizado no canto inferior esquerdo da sua tela. Com o menu aberto, mova o ponteiro do mouse para o item de menu <menuchoice
 ><guimenu
 >Aplicativos</guimenu
 ><guisubmenu
 >Educação</guisubmenu
 ><guisubmenu
 >Diversos</guisubmenu
 > <guimenuitem
 >&minuet; (Software para Ensino de Música)</guimenuitem
 ></menuchoice
 > a partir do menu global ou com <keycombo action="simul"
 >&Alt;<keycap
 >F2</keycap
 ></keycombo
 > e digitando <command
 >minuet</command
 > no campo de entrada. </para>
 </sect1>
 
 <sect1 id="minuet-exercises">
 <title
 >Exercícios e fluxo de trabalho do &minuet;</title>
 
 <para
 >A interface de usuário do &minuet; é composta de quatro componentes principais: </para>
 
 <screenshot>
   <screeninfo
 >Janela principal do &minuet;</screeninfo>
   <mediaobject>
     <imageobject
 ><imagedata fileref="minuet-ui-components.png" format="PNG"/></imageobject>
     <textobject
 ><phrase
 >Componentes da interface do &minuet;</phrase
 ></textobject>
   </mediaobject>
 </screenshot>
 
 <variablelist>
 
 <varlistentry>
 <term
 ><guilabel
 >Menu de navegação</guilabel
 ></term>
 <listitem
 ><para
 >Permite a navegação pelas categorias de exercícios do &minuet; e a seleção de um exercício em particular. O menu de navegação é criado dinamicamente, a partir de arquivos de especificação de exercícios descritos em <link linkend="creating-exercises"
 >Criar exercícios</link
 >. Os exercícios do &minuet; são agrupados de acordo com classes como, por exemplo, intervalos, escalas e acordes.</para
 ></listitem>
 </varlistentry>
 
 <varlistentry>
 <term
 ><guilabel
 >Área de Teclado</guilabel
 ></term>
 <listitem
 ><para
 >Exibe os eventos de <parameter
 >note on</parameter
 > do &MIDI; lidos a partir de um arquivo &MIDI; ou da execução de um exercício.</para
 ></listitem>
 </varlistentry>
 
 <varlistentry>
 <term
 ><guilabel
 >Área de Exercício</guilabel
 ></term>
 <listitem
 ><para
 >Apresenta, para um determinado exercício, os botões que controlam sua  apresentação, bem como um conjunto das respostas possíveis do exercício. A execução de um exercício é iniciada ao clicar no botão <guibutton
 >Nova pergunta</guibutton
 >. Um intervalo/acorde/escala aleatório é reproduzido pelo &minuet; e depois espera-se que o aluno escolha uma resposta dentre as apresentadas na grade. O &minuet; sempre apresenta - como um pequeno círculo branco na Área de Teclado - a primeira nota do intervalo/escala selecionado ou a nota principal do acorde selecionado. Ao passar o ponteiro do mouse sobre uma possível resposta, o &minuet; apresenta a sua representação visual correspondente na Área de Teclado. As notas restantes da resposta em questão são apresentadas como pequenos círculos, cujas cores são as mesmas do botão da resposta. O aluno poderá ouvir o exercício novamente clicando no botão <guibutton
 >Reproduzir pergunta</guibutton
 >, clicar no botão da resposta escolhida ou então obter a resposta correta clicando no botão <guibutton
 >Desistir</guibutton
 > Uma nova execução do mesmo exercício pode ser iniciada clicando novamente no botão <guibutton
 >Parar pergunta</guibutton
 > e clicando novamente o botão <guibutton
 >Nova pergunta</guibutton
 >.</para
 ></listitem>
 </varlistentry>
 
 </variablelist>
 </sect1>
 </chapter>
 
 <chapter id="creating-exercises">
 <title
 >Criando novos exercícios do &minuet;</title>
 
 <para
 >Os exercícios do &minuet; são definidos em arquivos de especificação, escritos no 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 Maior",
                   "sequenceFromRoot": "2"
                 }
               ]
             }
           ]
         }
       ]
     }
   ]
 }
 </programlisting>
 </para>
 <para
 >Os arquivos de especificação de exercícios do &minuet; contêm um objeto &JSON; raiz, que contém a lista <parameter
 >exercises</parameter
 >. Essa lista descreve uma estrutura hierárquica de exercícios, agrupada por categorias. Cada categoria/exercício tem um nome. Os objetos &JSON; das categorias contêm uma propriedade chamada <parameter
 >children</parameter
 >, que descreve as subcategorias/exercícios que pertencem a essa categoria. Os objetos &JSON; dos exercícios contêm uma propriedade chamada <parameter
 > options</parameter
 >, que define as possíveis respostas para este exercício. Na execução de cada exercício, o &minuet; seleciona aleatoriamente uma resposta dentre as possíveis e aguarda o aluno clicar no botão de resposta que corresponde à resposta selecionada. </para>
 <para
 >Qualquer (sub)categoria pode definir um parâmetro <parameter
 >root</parameter
 >, que define o intervalo a partir do qual a nota inicial do intervalo/acorde/escala será escolhido aleatoriamente para todos os exercícios desta categoria. Esse intervalo corresponde aos números das notas no padrão &MIDI; e segue o formato <parameter
 >&lt;valor-mín&gt;..&lt;valor-máx&gt;</parameter
 >. O exemplo apresentado acima usa toda a faixa do teclado como notas fundamentais possíveis (21..104). O parâmetro <parameter
 >playMode</parameter
 > indica como as possíveis respostas deverão ser tocadas: como <parameter
 >scale</parameter
 > (escala - uma nota após a outra) ou como <parameter
 >chord</parameter
 > (acorde - todas as notas tocadas simultaneamente). </para>
 <para
 >Cada opção do exercício define um nome e a sequência de notas que deverá ser reproduzida a partir da nota fundamental selecionada aleatoriamente na execução de cada exercício. Essa sequência de notas é definida como distâncias relativas à nota fundamental, descrevendo o intervalo que cada nota forma com a nota fundamental. Por exemplo, para uma escala maior, a sequência de notas é <quote
 >2 4 5 7 9 11 12</quote
 >, que define respectivamente a estrutura característica da escala maior <quote
 >tom tom semitom tom tom tom semitom</quote
 >. O parâmetro <parameter
 >sequenceFromRoot</parameter
 > pode conter qualquer número de notas. Da mesma forma, o núcleo do &minuet; garante que apenas as respostas em que todas as notas que estiverem dentro da faixa do teclado sejam selecionadas aleatoriamente. </para>
 <para
 >Para oferecer uma melhor infraestrutura na organização de um grande conjunto de arquivos de especificação de exercícios, o núcleo do &minuet; suporta o uso de diversos arquivos de especificação, os quais são combinados automaticamente para compor a hierarquia final de exercícios do menu de Navegação. Os exercícios são corretamente combinados desde que os diferentes arquivos de especificação usem o mesmo nome de (sub)categoria ao definir os exercícios. Por enquanto, o &minuet; não oferece nenhuma interface gráfica para criar as especificações de exercícios, sendo necessário criar manualmente estes arquivos &JSON;. Os arquivos de especificação de exercícios do &minuet; podem ser instalados globalmente no sistema ou localmente, na pasta <filename class="directory"
 >minuet/exercises/</filename
 > localizada no <userinput
 ><command
 >qtpaths</command
 > <option
 >--paths GenericDataLocation</option
 ></userinput
 > </para>
 
 </chapter>
 
 <chapter id="credits">
 
 <title
 >Créditos e Licença</title>
 
 <para
 >&minuet; </para>
 <para
 >Direitos autorais do programa 2016 &Sandro.Andrade; &Sandro.Andrade.mail; </para>
 
 <para
 >Direitos autorais da documentação &copy; 2016 &Sandro.Andrade; &Sandro.Andrade.mail; </para>
 
 <para
 >Tradução de André Marcelo Alvarenga <email
 >alvarenga@kde.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;
 -->