<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kalcul "<application
>Kalcul</application
>">
  <!ENTITY kappname "&kalcul;">
  <!ENTITY package "kdeedu">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Portuguese "INCLUDE">
]>

<book lang="&language;">

<bookinfo>
<title
>O Manual do &kalcul;</title>

<authorgroup>
<author
><personname
> <firstname
>Anne-Marie</firstname
> <surname
>Mahfouf</surname
> </personname
> <email
>annma@kde.org</email
> </author>
</authorgroup>

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

<copyright>
<year
>2005</year>
<holder
>Anne-Marie Mahfouf</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2005-06-30</date>
<releaseinfo
>0.1</releaseinfo>

<abstract>
<para
>O &kalcul; é uma aplicação matemática para crianças pequenas (a partir dos 6 anos) para as testar com as somas, subtracções, multiplicações e divisões. Também permite exercícios mistos. Poderão ser feitos dois tipos de exercícios com o &kalcul;: os testes sobre operações, nos quais poderá definir o tipo de operação e o intervalo, para que o programa faça várias perguntas aleatórias, e os níveis predefinidos (poderá fornecer os testes ou então definir os seus próprios níveis com a opção <guimenu
>Ferramentas</guimenu
> -&gt; <guimenuitem
>Editor de Níveis</guimenuitem
>). </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>kdeedu</keyword>
<keyword
>crianças</keyword>
<keyword
>matemática</keyword>
<keyword
>soma</keyword>
<keyword
>subtracção</keyword>
<keyword
>multiplicação</keyword>
<keyword
>divisão</keyword>
</keywordset>

</bookinfo>


<chapter id="introduction">
<title
>Introdução</title>


<para
>O &kalcul; é uma aplicação matemática para crianças pequenas (a partir dos 6 anos) para as testar com as somas, subtracções, multiplicações e divisões. Também permite exercícios mistos. Poderão ser feitos dois tipos de exercícios com este programa: os testes sobre operações, nos quais poderá definir o tipo de operação e o intervalo, para que o programa faça várias perguntas aleatórias, e os níveis predefinidos, onde você poderá fazer as suas próprias perguntas. </para>

<para
>O &kalcul; pretende ser simples de usar para as crianças, mas poderoso o suficiente para deixar diversas opções e configurações para os adultos (pais ou professores). O &kalcul; também grava o resultado de qualquer teste num ficheiro associado ao utilizador actual, sendo que está planeado tornar estes resultados disponíveis para o KSpread e o KChart (ou outra aplicação de escritório qualquer). </para>
</chapter>

<!--<chapter id="quick-start">
<title
>Quick Start to &kalcul;</title>

</chapter
>-->

<chapter id="using-kapp">
<title
>Usar o &kalcul;</title>

<para
>A janela principal do &kalcul; consiste na área de texto à esquerda e no relógio à direita. O relógio tanto pode contabilizar o tempo do seu teste como lhe diz para fazer um teste num determinado período de tempo. </para>

<para>
<screenshot>
<screeninfo
>Aqui está uma imagem da janela principal do &kalcul;</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="kalcul1.png" format="PNG"/>
	  </imageobject>
	  <textobject>
	    <phrase
>Janela principal do &kalcul;</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
</para>

<para
>Carregue no botão Iniciar para começar um teste. O relógio arranca e é apresentada uma pergunta. Este é o Modo de Exercício, onde as perguntas são escolhidas aleatoriamente e onde alguns parâmetros poderão ser escolhidos no menu <guimenu
>Ferramentas</guimenu
> -&gt; <guimenuitem
>Janela de Exercício</guimenuitem
>. Os valores por omissão são: a operação é a soma com dois termos e cada um destes é menor que 10. </para>

<screenshot>
<screeninfo
>Iniciar um teste</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="kalcul2.png" format="PNG"/>
      </imageobject>
      <textobject>
        <phrase
>Iniciar um teste</phrase>
      </textobject>
    </mediaobject>
</screenshot>

<para
>Se você carregar no botão <guibutton
>Parar</guibutton
>, então o teste será interrompido e tudo será reposto no estado inicial, para dar início a um novo teste.</para>

<para
>Se você carregar no botão <guibutton
>Pausa</guibutton
>, o teste é mudado para o modo de Pausa, onde a pergunta continua visível e o relógio é posto em pausa. Se carregar no botão <guibutton
>Continuar</guibutton
>, o teste irá continuar.</para>

<para
>Existem duas barras de progresso que lhe mostram quantas perguntas já respondeu até agora e quantas estavam correctas. </para>

<screenshot>
<screeninfo
>Resultado</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="kalcul3.png" format="PNG"/>
      </imageobject>
      <textobject>
        <phrase
>Resultado</phrase>
      </textobject>
    </mediaobject>
</screenshot>

<para
>Na barra de estado, é mostrado o nome do utilizador, o número de respostas certas e o número de perguntas.</para>

<para
>Quando um determinado teste terminar, aparece uma janela com os resultados dos testes. </para>

<screenshot>
<screeninfo
>A janela de Resultados</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="kalcul4.png" format="PNG"/>
      </imageobject>
      <textobject>
        <phrase
>A janela de Resultados</phrase>
      </textobject>
    </mediaobject>
</screenshot>

</chapter>

<chapter id="tools">
<title
>Ferramentas</title>
<para
>Este capítulo explica as duas ferramentas principais do &kalcul;: a Janela de Exercícios e o Editor de Níveis.</para>
<sect1 id="exercise-dialog">
<title
>A Janela de Exercícios</title>
<para
>A janela de Exercícios permite escolher qual o tipo de exercício que você deseja que o filho/aluno faça. </para>
<para
>Quando escolher a opção do menu <guimenu
>Ferramentas</guimenu
> -&gt; <guimenuitem
>Janela de Exercícios</guimenuitem
>, irá ver em primeiro lugar esta janela:</para>

<screenshot>
<screeninfo
>A Janela de Exercícios</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="kalcul5.png" format="PNG"/>
      </imageobject>
      <textobject>
        <phrase
>A Janela de Exercícios</phrase>
      </textobject>
    </mediaobject>
</screenshot>

<para
>O Exercício é um teste cronometrado com perguntas aleatórias de um determinado tipo.</para>
<para
>O Nível é um teste cronometrado com um nível à sua escolha.</para>
<para
>Quando escolher o Exercício, aparecerá a seguinte janela:</para>

<screenshot>
<screeninfo
>Escolher o tipo</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="kalcul6.png" format="PNG"/>
      </imageobject>
      <textobject>
        <phrase
>Escolher o tipo</phrase>
      </textobject>
    </mediaobject>
</screenshot>

<para
>Se carregar em algum dos tipos à disposição, irá escolher o tipo do seu próximo teste. Poderá definir o número máximo de cada termo da operação, bem como outros parâmetros, na janela em <guimenu
>Configuração</guimenu
> -&gt; <guimenuitem
>Configurar o &kalcul;...</guimenuitem
>.</para>


<para
>Se o utilizador seleccionar o Nível no primeiro ecrã da Janela de Exercícios, irá obter a seguinte janela que enumera todos os ficheiros <filename
>.kalcul</filename
> presentes no seu sistema.</para>

<screenshot>
<screeninfo
>Escolher o nível</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="kalcul7.png" format="PNG"/>
      </imageobject>
      <textobject>
        <phrase
>Escolher o nível</phrase>
      </textobject>
    </mediaobject>
</screenshot>

<para
>Escolha um nível. As características do nível são apresentadas à direita. Se carregar em Começar! irá carregar o nível seleccionado.</para>
</sect1>

<sect1 id="level-editor">
<title
>O Editor de Níveis</title>
<para
>O Editor de Níveis permite-lhe criar os seus próprios testes. Estes serão então gravados como ficheiros <filename
>.kalcul</filename
>. </para>

<screenshot>
<screeninfo
>Editor de Níveis</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="kalcul8.png" format="PNG"/>
      </imageobject>
      <textobject>
        <phrase
>Editor de Níveis</phrase>
      </textobject>
    </mediaobject>
</screenshot>

<para
>No campo de Descrição, descreva as características do nível, como por exemplo: 3a Classe - Simples, 6o Ano - Médio ou Turma 102 - Somas até 10.</para>
<para
>A área de Opções inclui duas listas. Escolha o nível de dificuldade como Fácil, Médio, Difícil ou Experiente e escolha o tipo de operação do nível: Soma, Subtracção, Multiplicação, Divisão ou Misto. O Misto corresponde a uma mistura das várias operações, como por exemplo: 2 + 4 - 5.</para>
<para
>A área de Perguntas é onde você poderá editar as suas perguntas. Estas serão depois feitas à criança. Indique a operação na Pergunta e o resultado da operação no Resultado. </para>
<para
>Carregue no botão <guibutton
>Adicionar uma Pergunta</guibutton
> para incluir uma nova linha. Faça duplo-click em cada campo (Pergunta e Resultado) para escrever a sua pergunta e resposta. Faça duplo-click para editar o campo da pergunta e introduzir a operação: por exemplo, 2+5 ou 5-3. Não interessa se você adiciona espaços. O Enter irá validar o campo. Faça então duplo-click no campo do resultado e escreva o resultado da Pergunta. O Enter irá validar os seus dados.</para>
<para
>Se carregar no botão <guibutton
>Remover a Pergunta</guibutton
>, irá apagar a linha seleccionada.</para>
<para
>No fundo da janela, existem quatro botões. O <guibutton
>Novo</guibutton
> cria um nível novo. Não grava o nível actual e irá limpar todos os campos. O <guibutton
>Abrir</guibutton
> permite-lhe abrir um ficheiro com um nível (com a extensão <filename
>.kalcul</filename
>) e editá-lo. O <guibutton
>Gravar</guibutton
> grava o teste actual. Ele irá abrir uma janela de selecção de ficheiros e propõe-lhe gravar o nível com a extensão <filename
>.kalcul</filename
>. O <guibutton
>Fechar</guibutton
> fecha a janela sem gravar os dados.</para>
</sect1>
</chapter>

<chapter id="configuration">
<title
>Configuração</title>
<para
>Este capítulo explica a janela <guimenu
>Configuração</guimenu
> -&gt; <guimenuitem
>Configurar o &kalcul;...</guimenuitem
>.</para>

<sect1 id="general">
<title
>A página Geral</title>

<screenshot>
<screeninfo
>A página Geral</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="kalcul9.png" format="PNG"/>
      </imageobject>
      <textobject>
        <phrase
>A página Geral</phrase>
      </textobject>
    </mediaobject>
</screenshot>

<para
>Indique o nome do utilizador no campo Nome do Utilizador. Este nome será usado para gravar os resultados de todos os testes para este utilizador.</para>
<para
>Também poderá definir aqui o número de perguntas por cada teste.</para>
</sect1>

<sect1 id="timer">
<title
>A página do Relógio</title>

<screenshot>
<screeninfo
>A página do Relógio</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="kalcul10.png" format="PNG"/>
      </imageobject>
      <textobject>
        <phrase
>A página do Relógio</phrase>
      </textobject>
    </mediaobject>
</screenshot>

<para
>Se assinalar a opção Usar um Relógio, o teste será cronometrado, i.e., irá parar quando o tempo definido chegar ao fim. O relógio irá decrementando até ao zero.</para>
<para
>Configure o tempo-limite do Relógio com o cursor abaixo.</para>
</sect1>

<sect1 id="advanced">
<title
>A página Avançado</title>

<screenshot>
<screeninfo
>A página Avançado</screeninfo>
    <mediaobject>
      <imageobject>
        <imagedata fileref="kalcul11.png" format="PNG"/>
      </imageobject>
      <textobject>
        <phrase
>A página Avançado</phrase>
      </textobject>
    </mediaobject>
</screenshot>

<para
>Poderá definir o valor máximo que deseja para o resultado. Por exemplo, uma criança de 6 anos irá começar a aprender as somas até um resultado igual a 5, depois igual a 6, a 7 e assim por diante. Se configurar este valor como N, irá garantir que a operação aleatória não irá ter um resultado maior que N. Se configurar este valor como 0, não terá qualquer limite.</para>
<para
>Se configurar o máximo para o primeiro termo como N, irá garantir que o primeiro termo não será maior que N. Por exemplo, se for igual a 10, o primeiro termo será um número entre 0 e 10. O mesmo se aplica ao segundo termo.</para>

</sect1>
</chapter>

<chapter id="teachers-parents">
<title
>Guia de Professores/Pais para o &kalcul; </title>
<sect1 id="statistics">
<title
>Estatísticas</title>
<para
>Os resultados de uma criança (utilizador) são gravados no ficheiro <filename
>$KDEHOME/share/apps/kalcul/nome_utilizador.txt</filename
>. </para>
<para
>As funcionalidades futuras permitir-lhe-ão visualizar esses resultados com uma aplicação do KOffice, seja esta o KSpread ou o KChart.</para>
</sect1>
</chapter>

<chapter id="commands">
<title
>Referência de Comandos</title>

<sect1 id="kapp-mainwindow">
<title
>A janela principal do &kalcul;</title>

<sect2>
<title
>O Menu Ficheiro</title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Ficheiro</guimenu
> <guimenuitem
>Sair</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Sai</action
> do &kalcul;</para
></listitem>
</varlistentry>
</variablelist>
</para>

</sect2>

<sect2>
<title
>O Menu Ferramentas</title>
<para>
<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Ferramentas</guimenu
> <guimenuitem
>Janela de Exercícios</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Abre</action
> a Janela de Exercícios</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Ferramentas</guimenu
> <guimenuitem
>Editor de Níveis</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Abre</action
> a janela do Editor de Níveis</para
></listitem>
</varlistentry>

</variablelist>
</para>

</sect2>

<sect2>
<title
>O Menu <guimenu
>Ajuda</guimenu
></title>
&help.menu.documentation; </sect2>

</sect1>
</chapter>


<chapter id="faq">
<title
>Perguntas e Respostas</title>
&reporting.bugs; &updating.documentation; </chapter>

<chapter id="credits">

<!-- Include credits for the programmers, documentation writers, and
contributors here. The license for your software should then be included below
the credits with a reference to the appropriate license file included in the KDE
distribution. -->

<title
>Créditos e Licença</title>

<para
>&kalcul; </para>
<para
>Programa com 'copyright' 2005 de Anne-Marie Mahfouf <email
>annma@kde.org</email
> </para>
<para>
<itemizedlist>
<listitem
><para
>Desenvolvimento: Anne-Marie Mahfouf <email
>annma@kde.org</email
></para>
</listitem>
<listitem
><para
>Desenvolvimento: Michael Goettsche <email
>michael.goettsche@kdemail.net</email
></para>
</listitem>
<listitem
><para
>Ícones: Zoran Karavla <email
>webmaster@the-error.net</email
></para>
</listitem>
</itemizedlist>
</para>

<para
>Documentação com 'copyright' &copy; 2005 de Anne-Marie Mahfouf <email
>annma@kde.org</email
> </para>

<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-kapp">
<title
>Como obter o &kalcul;</title>
&install.intro.documentation; </sect1>

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

<para
>Para usar com sucesso o &kalcul;, irá necessitar pelo menos do &kde; 3.4. Também é necessário o KClock de /playground/edu/widgets. </para>

<para
>Todas as bibliotecas necessárias, assim como o próprio &kalcul;, poderão ser encontrados na <ulink url="http://edu.kde.org/kalcul.org"
>página pessoal do &kalcul;</ulink
>. </para>

<!-- For a list of updates, you may refer to the application web site
or the ChangeLog file, or ... -->
<para
>Poderá encontrar uma lista com as alterações em <ulink url="http://apps.kde.org/kalcul"
>http://apps.kde.org/kalcul</ulink
>. </para>
</sect1>

<sect1 id="compilation">
<title
>Compilação e Instalação</title>
&install.compile.documentation; </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 
-->