<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [

  <!ENTITY artikulate "Artikulate">
  <!ENTITY kappname "&artikulate;">
  <!ENTITY package "artikulate">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Portuguese "INCLUDE">
]>
<book id="artikulate" lang="&language;">

<bookinfo>
<title
>O Manual do &artikulate;</title>
<authorgroup>
<author
><personname
> <firstname
>Andreas</firstname
> <surname
>Cord-Landwehr</surname
> </personname
> <email
>cordlandwehr@kde.org</email
> </author>

<author
><personname
> <firstname
>Ondrila</firstname
> <surname
>Gupta</surname
> </personname
> <email
>oindrila.gupta92@gmail.com</email
> </author>

<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>zepires@gmail.com</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>

<copyright
><year
>2014-2015</year
><holder
>Os Programadores do &artikulate;</holder
></copyright>

<date
>2015-09-27</date>
<releaseinfo
>&artikulate; 0.6.0 (Aplicações 15.12)</releaseinfo>

<legalnotice
>&FDLNotice;</legalnotice>

<abstract>
<para
>O &artikulate; é um treinador de pronúncia, o qual o ajuda a melhorar e a aperfeiçoar as aptidões de pronúncia. Os aprendizes treinam a sua pronúncia, gravando as suas próprias vozes e comparando-as com as gravações dos locutores nativos. O &artikulate; faz parte do Projecto de Educação do &kde;. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>língua</keyword>
<keyword
>exercício</keyword>
<keyword
>unidade</keyword>
<keyword
>frase</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introdução</title>
<para
>O &artikulate; é um treinador de pronúncia que ajuda a melhorar e a aperfeiçoar as aptidões de pronúncia de um aluno para uma dada língua estrangeira. Para tal, o &artikulate; oferece exercícios com gravações de locutores nativos para a língua-alvo. O aluno pode seleccionar um conjunto de frases, gravar a sua própria voz ao falar as frases e comparar os resultados com as gravações do locutor nativo, ouvindo ambas, até que o resultado seja bom o suficiente para passar à frase seguinte. </para>

<sect1 id="introduction-concept">
<title
>O Conceito de Aprendizagem</title>
<para
>O conceito de estudo do &artikulate; baseia-se na auto-avaliação honesta do aluno. Um aluno treina diversas frases numa sessão de exercício. Para cada uma dessas fases, ele/ela reproduz a gravação da frase pelo locutor nativo e ouve-a. Depois, gravando a sua própria voz ao tentar repetir esta frase, é possível obter uma segunda gravação. O aluno poderá então comparar ambas as gravações e então poderá optar por decidir se a frase foi devidamente pronunciada ou se é necessária tentar outra vez. Os exercícios fornecidos oferecem exercícios para cenários especiais (como o pedido de comida num restaurante) mas também se focam na aprendizagem da pronúncia correcta de sílabas e palavras complicadas numa dada língua. </para>
</sect1>

<sect1 id="introduction-first-steps">
<title
>Primeiros Passos no &artikulate;</title>
<para
>Este capítulo explica como dar os primeiros passos no &artikulate;. </para>

<sect2>
<title
>1. Transferir um Novo Exercício</title>
<para
>Poderá transferir os exercícios em <menuchoice
><guimenu
>Ficheiro</guimenu
> <guimenuitem
>Obter Exercícios</guimenuitem
></menuchoice
>. Se o menu não estiver activo, poderá abrir o menu <menuchoice
><guimenu
>Ficheiro</guimenu
></menuchoice
> se carregar no botão superior direito. Irá aparecer uma janela de transferência, apresentando as línguas disponibilizadas pela Comunidade do &kde;. Podê-las-á ordenar com as funções de ordenação à direita. Transfira o curso de Polaco, por exemplo, carregando em <guilabel
>Instalar</guilabel
>. </para>
<screenshot>
<screeninfo
>Transferir um exercício.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="first-steps-3-download-course.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
</sect2>

<sect2>
<title
>4. Iniciar o Exercício</title>
<para
>Os exercícios consistem em várias unidades de treino. Seleccione uma das unidades de treino que estão disponíveis no painel da esquerda, carregando depois em <guilabel
>Iniciar o Treino</guilabel
>. </para>
<screenshot>
<screeninfo
>Seleccione a unidade e inicie o treino.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="first-steps-4-start-training.png" format="PNG"/>
</imageobject>
</mediaobject>
</screenshot>
</sect2>

<sect2>
<title
>Terminar o Exercício</title>
<para
>O exercício poderá ser terminado em qualquer altura, bastando para tal fechar o programa. </para>
</sect2>
</sect1>
</chapter>

<!--
<chapter id="screens">
<title
>Screens</title>
<sect1 id="screens-training">
<title
>The Training Screen</title>
<para>
The training view is the most important view in &artikulate;.
Whenever starting a training, this view is opened and will be presented until the training of the selected training unit is finished or the student stops the training.
In the center of this screen, there are controls for playing a native speaker recording, the text of the corresponding phrase, and controls to record and playback the student's own voice.
When a student judges to be done with training the pronunciation of the current phrase, by clicking <guilabel
>OK</guilabel
> the current phrase is marked as done and a next phrase is selected.
Otherwise, when clicking on <guilabel
>Retry Later</guilabel
>, a next phrase is selected but the current phrase will be displayed later again.
</para>

<para>
For training the pronunciation of a current phrase, the student shall first play the native speaker's recording by pressing at the <guilabel
>Playback</guilabel
> button at the left.
The next step is to press on the <guilabel
>Record</guilabel
> button and read the presented phrase aloud.
A further press on the <guilabel
>Record</guilabel
> button stops the recording and the recording can then be played with the corresponding <guilabel
>Playback</guilabel
> button.
By listening to both recordings, the student shall judge if the phrase was pronounced correctly or not.
If it was pronounced correctly, clicking on <guilabel
>OK</guilabel
> marks the phrase as learned and proceeds with the next phrase.
Otherwise, if not yet satisfied with the recording, the student either can retry recording by again clicking on <guilabel
>Record</guilabel
> or schedule the phrase for later training by clicking on <guilabel
>Retry Later</guilabel
>.
</para>

<para>
&artikulate;'s units are composed of a list of phrases of different lengths (words, expressions, sentences, and paragraphs).
A student can see the current learning progress at the bottom when looking at <link linkend="screens-training-progressbar"
>the progress bar</link
>.
The progress bar also allows switching between phrases.
</para>

<para>
At any time, the student can choose to stop training by clicking at the <guilabel
>Finish</guilabel
> button.
</para>

<screenshot>
<screeninfo
>The Training Screen.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="screen-training-overview.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>Screenshot of the Training Screen.</phrase>
</textobject>
</mediaobject>
</screenshot>

<sect2 id="screens-training-sound-controls">
<title
>Sound Controls</title>
<itemizedlist>
<listitem
><para>
<inlinemediaobject
><imageobject>
<imagedata fileref="hi32-action-artikulate-media-record.png" format="PNG"/></imageobject>
</inlinemediaobject>
<guilabel
>Record</guilabel
>: Record your pronunciation through your microphone. Click again to stop recording.
</para
></listitem>

<listitem
><para>
<inlinemediaobject
><imageobject>
<imagedata fileref="hi32-action-artikulate-media-playback-start.png" format="PNG"/></imageobject>
</inlinemediaobject>
<guilabel
>Playback</guilabel
>: Play a sound file. If active, click again to stop.
</para
></listitem>

</itemizedlist>
</sect2>

<sect2 id="screens-training-learning-controls">
<title
>Learning Controls</title>
<itemizedlist>
<listitem
><para>
<inlinemediaobject
><imageobject>
<imagedata fileref="training-ok.png" format="PNG"/></imageobject>
</inlinemediaobject>
<guilabel
>OK</guilabel
>: Mark current phrase as learned and continue with next phrase.
</para
></listitem>

<listitem
><para>
<inlinemediaobject
><imageobject>
<imagedata fileref="training-retry.png" format="PNG"/></imageobject>
</inlinemediaobject>
<guilabel
>Retry Later</guilabel
>: Continue with training next phrase, but try this phrase later again.
</para
></listitem>

<listitem
><para>
<inlinemediaobject
><imageobject>
<imagedata fileref="training-finish.png" format="PNG"/></imageobject>
</inlinemediaobject>
<guilabel
>Stop</guilabel
>: Stops the training and proceeds to the statistics view. Current training results are saved to training statistics.
</para
></listitem>
</itemizedlist>
</sect2>

<sect2 id="screens-training-progressbar">
<title
>Progress Bar</title>
<para>
The progress bar displays the learning progress for the current unit.
It consists of blocks representing the phrases in the current unit, whereas the color of a block explains the length of the phrase.
You can hover over these blocks to see the phrases and click on them to switch the currently trained phrase.
Dark elements are already trained, light ones are untrained.
</para>
<screenshot>
<screeninfo
>Progress Bar</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="screen-training-progressbar.png" format="PNG"/>
</imageobject>
<textobject>
<phrase
>The progress bar for the current unit.</phrase>
</textobject>
</mediaobject>
</screenshot>
<para>
On top of the progress bar you can see which type of phrases you are currently learning.
The available types are:
<itemizedlist>
    <listitem
><para
>word: a single word, letter, or number</para
></listitem>
    <listitem
><para
>expression: an expression of several words that does not form a complete sentence</para
></listitem>
    <listitem
><para
>sentence: a complete sentence</para
></listitem>
    <listitem
><para
>paragraph: several sentences (usually 2-3) </para
></listitem>
</itemizedlist>
</para>
</sect2>
</sect1>
</chapter>
-->
<chapter>
<title
>Editor</title>
<para
>O editor integrado de exercícios é uma ferramenta avançada para os contribuintes de exercícios para uma dada língua, a qual permite a criação e o trabalho colaborativo sobre os exercícios de uma dada língua para o &artikulate;. Por um lado, permite a criação de exercícios da língua e a gravação dos ficheiros de som do locutor nativo. Por outro, permite o trabalho sobre os <emphasis
>esqueletos</emphasis
>, que são protótipo de exercícios de línguas e que permitem a criação rápida e simples de novos exercícios com base nesse protótipo. O editor só modifica os ficheiros fora do conjunto de exercícios de treino, i.e., o conjunto de exercícios transferidos para o &artikulate;. </para>

<sect1>
<title
>Introdução</title>

<sect2>
<title
>Noções do Editor</title>
<para
>Para o editor de exercícios usamos um conjunto específico de termos, os quais também são usados para as seguintes descrições. </para>
<variablelist>
<varlistentry>
    <term
>Língua:</term>
    <listitem>
    <para
>As línguas só estão disponíveis no &artikulate; se forem indicadas por definições de línguas. </para>
    </listitem>
</varlistentry>
<varlistentry>
    <term
>Exercício:</term>
    <listitem>
    <para
>Um exercício está associado a uma língua e contém uma lista de unidades. </para>
    </listitem>
</varlistentry>
<varlistentry>
    <term
>Unidade:</term>
    <listitem>
    <para
>Uma unidade consiste em frases que são "de certa forma" homogéneas. P.ex., estas podem ser frases faladas numa restaurante ou frases emitidas numa conversa de rua por um turista que tenta descobrir um caminho. </para>
    </listitem>
</varlistentry>
<varlistentry>
    <term
>Esqueletos de exercícios:</term>
    <listitem>
    <para
>Um esqueleto de exercício forma o protótipo de um exercício. Isto é, os esqueletos ajudam a facilitar a criação de exercícios em várias línguas, dado que definem um conjunto de unidades e frases (em Inglês) que poderão depois ser usadas como estrutura para criar um exercício numa nova língua. As actualizações dos esqueletos dos exercícios podem também ser importadas para os exercícios que são criados a partir de um esqueleto. </para>
    </listitem>
</varlistentry>
<varlistentry>
    <term
>Frases:</term>
    <listitem>
    <para
>As frases são indicadas através de um texto e uma gravação de um locutor nativo. São diferenciadas as frases pelos seus tamanhos. Existem os seguintes tamanhos de frases <itemizedlist>
        <listitem>
        <para
><inlinemediaobject
><imageobject>
        <imagedata fileref="hi32-action-artikulate-word.png" format="PNG"/></imageobject>
</inlinemediaobject
> palavra: uma única palavra, letra ou número</para>
        </listitem>
        <listitem>
        <para
><inlinemediaobject
><imageobject>
        <imagedata fileref="hi32-action-artikulate-expression.png" format="PNG"/></imageobject>
</inlinemediaobject
> expressão: uma expressão de várias palavras que não forme uma frase completa</para>
        </listitem>
        <listitem>
        <para
><inlinemediaobject
><imageobject>
        <imagedata fileref="hi32-action-artikulate-sentence.png" format="PNG"/></imageobject>
</inlinemediaobject
> frase: uma frase completa</para>
        </listitem>
        <listitem>
        <para
><inlinemediaobject
><imageobject>
        <imagedata fileref="hi32-action-artikulate-paragraph.png" format="PNG"/></imageobject>
</inlinemediaobject
> parágrafo: diversas frases (normalmente 2-3)</para>
        </listitem>
        </itemizedlist>
    </para>
    </listitem>
</varlistentry>
</variablelist>
<para
>Um exercício está associado a uma dada língua, consistindo em diferentes unidades e cada unidade é definida como uma sequência de frases de diferentes tamanhos. </para>
</sect2>

<sect2>
<title
>Definir a Pasta de Armazenamento/Repositório de Exercícios</title>
<para
>O editor funciona dentro de uma pasta separada (denominada a seguir como <emphasis
>repositório</emphasis
>, dado que se recomenda que deva estar sob um sistema de controlo de versões qualquer). Nessa pasta, o editor pesquisa pelos exercícios editáveis e os ficheiros de esqueleto, guardando também os ficheiros novos. </para>
<para
>O repositório de exercícios pode ser definido na janela de configuração. Poderá ser encontrado em <menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar o &artikulate;</guimenuitem
></menuchoice
> e as definições do exercício encontram-se na opção do menu <guilabel
>Recursos do Exercício</guilabel
>. </para>
<screenshot>
<screeninfo
>Definir o repositório de exercícios do editor.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editor-set-repository.png" format="PNG"/>
</imageobject>
<caption
><para
>Definir o repositório de exercícios do editor.</para
></caption>
</mediaobject>
</screenshot>
</sect2>
</sect1>

<!--<sect1
>TODO needs complete rewrite
<title
>Edit a Course</title>
<para>
The editor can be started from the main menu with <menuchoice
><guimenu
>Mode</guimenu
> <guimenuitem
>Course Editor mode</guimenuitem
></menuchoice
>.
There you have the options to work on existing skeleton files or to create new courses or edit existing ones.
After selecting a language, you can open an existing course to edit it, or otherwise use <guilabel
>New Course</guilabel
> to create a new course for this language.
In either case, you will be presented the list of units of the course, where you can create new units or open existing ones for edit.
</para>

<sect2>
<title
>Edit a Unit</title>
<para>
When opening a unit for editing, you will see the list of its phrases (see below).
One line of this list contains the following information:
<orderedlist>
    <listitem
><para
>edit button: open this phrase for edit</para
></listitem>
    <listitem
><para
>phrase type: icon that denotes the type of this phrase (e.g., word, expression)</para
></listitem>
    <listitem
><para
>edit state: a colored block that denotes the edit state of this phrase (red: unknown/no state set; orange: translated state; green: completed state)</para
></listitem>
    <listitem
><para
>the phrase</para
></listitem>
    <listitem
><para
>exclude button: if course derives from a course skeleton, this button allows excluding the phrase from the unit</para
></listitem>
</orderedlist>
</para>
<screenshot>
<screeninfo
>Editor View: list of phrases within a unit.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editor-screenshot-unit.png" format="PNG"/>
</imageobject>
<caption
><para
>Editor View: list of phrases within a unit.</para
></caption>
</mediaobject>
</screenshot>
</sect2>

<sect2>
<title
>Edit a Phrase</title>
<para>
When opening a phrase for editing, you will see the phrase editor as shown below.
This edit interface contains the following elements:
</para>
<itemizedlist>
    <listitem
><para
>the phrase text as it will be shown in the trainer</para
></listitem>
    <listitem
><para
>the original phrase, if using a course skeleton</para
></listitem>
    <listitem
><para
>the edit state of the phrase</para
></listitem>
    <listitem
><para
>the type/length of the phrase</para
></listitem>
    <listitem
><para
>recording buttons for the native speaker recordings</para
></listitem>
    <listitem
><para
>buttons to denote interesting phonemes of the phrase (currently not used in training mode)</para
></listitem>
</itemizedlist>
<para>
You can close the phrase editing interface with
<inlinemediaobject
><imageobject>
<imagedata fileref="editor-apply.png" format="PNG"/></imageobject>
</inlinemediaobject>
to accept the changes you did, or with
<inlinemediaobject
><imageobject>
<imagedata fileref="editor-cancel.png" format="PNG"/></imageobject>
</inlinemediaobject>
to discard your changes.
</para>
<screenshot>
<screeninfo
>Editor View: editing view for a phrase.</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="editor-screenshot-editing-phrase.png" format="PNG"/>
</imageobject>
<caption
><para
>Editor View: editing view for a phrase.</para
></caption>
</mediaobject>
</screenshot>
</sect2>

<sect2>
<title
>Update from Course Prototype</title>
<para>
If the currently edited course derives from a skeleton, then the course can be updated from the latest version of the skeleton by using the button <guilabel
>Update from Course Prototype</guilabel
> at the top left of the screen.
This button is deactivated if the course is not derived from a course skeleton.
</para>
</sect2>
</sect1
>-->
</chapter>


<chapter id="credits">
<title
>Créditos e Licença</title>

<para
>&artikulate; </para>
<para
>Copyright do Programa:</para>
<itemizedlist>
    <listitem
><para
>'Copyright' 2013-2015 de Andreas Cord-Landwehr</para
></listitem>
    <listitem
><para
>'Copyright' 2013 de Oindrila Gupta</para
></listitem>
    <listitem
><para
>'Copyright' 2013 de Magdalena Konkiewitz</para
></listitem>
    <listitem
><para
>'Copyright' 2013-2014 de Samikshan Bairagya</para
></listitem>
</itemizedlist>

<para
>'Copyright' da Documentação:</para>
<itemizedlist>
    <listitem
><para
>'Copyright' 2014-2015 de Andreas Cord-Landwehr</para
></listitem>
</itemizedlist>

<para
>Tradução de José Nuno Pires <email
>zepires@gmail.com</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Instalação</title>

<sect1 id="getting-artikulate">
<title
>Como obter o &artikulate;</title>
&install.intro.documentation; </sect1>

<sect1 id="compilation">
<title
>Compilação e instalação</title>
&install.compile.documentation; <sect2 id="compilation-details">
<title
>Instruções Específicas do &artikulate;</title>
<para
>Estão disponíveis mais algumas instruções de compilação do &artikulate; na <ulink url="http://techbase.kde.org/Projects/Edu/Artikulate"
><citetitle
>documentação técnica do &artikulate;</citetitle
></ulink
> na Base Técnica do &kde;. </para>
</sect2>

</sect1>
</appendix>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->
