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

<book lang="&language;">

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

<authorgroup>
<author><firstname>Sebastian</firstname> <surname>Stein</surname> <affiliation> <address><email>seb.kde@hpfsc.de</email></address>
</affiliation>
</author>

<othercredit role="translator"><firstname>José</firstname><surname>Pires</surname><affiliation><address><email>jncp@netcabo.pt</email></address></affiliation><contrib>Tradução</contrib></othercredit> 

</authorgroup>

<copyright>
<year>2001-2005</year>
<holder>Sebastian Stein</holder>
</copyright>

<legalnotice>&FDLNotice;</legalnotice>

<date>2004-07-09</date>
<releaseinfo>3.4</releaseinfo>

<abstract>
<para>O &kbruch; é um pequeno programa para gerar problemas com fracções. Estão disponíveis vários exercícios para este fim. O programa verifica os dados introduzidos e dá um resultado. </para>
	
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>educação</keyword>
<keyword>fracção</keyword>
<keyword>matemática</keyword>
<keyword>denominador</keyword>
<keyword>kbruch</keyword>
</keywordset>

</bookinfo>

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

<para>O &kbruch; é um pequeno programa para praticar o cálculo de fracções. Como tal, são oferecidos 4 exercícios diferentes. </para>

<itemizedlist>
	<listitem><para>Problema de Fracções - neste exercício, você terá de resolver um problema de fracções indicado. Você terá de indicar o numerador e o denominador. Este é o exercício principal. </para></listitem>
	<listitem><para>Comparação - neste exercício, você tem de comparar o valor de 2 fracções indicadas. </para></listitem>
	<listitem><para>Conversão - neste exercício, você tem de converter um dado número numa fracção. </para></listitem>
	<listitem><para>Factorização - neste exercício, você terá de factorizar um dado número nos seus factores primos. </para></listitem>
</itemizedlist>

<para>Em todos os vários exercícios, o &kbruch; irá gerar um problema e o utilizador terá de o resolver. O programa verifica os dados introduzidos e irá dar o resultado para eles. </para>

<para>O &kbruch; conta quantos problemas foram resolvidos de todo e quantos foram resolvidos correctamente. As estatísticas são mostradas ao utilizador, mas esta parte da janela principal pode ser escondida. O utilizador poderá limpar as estatísticas em qualquer altura. </para>

<para>O &kbruch; é muito compacto e foca-se na ideia de base de um gerador de problemas. Existe um sistema de ajuda 'online' que oferece uma ajuda dependente do contexto para as diferentes situações. </para>
<para>O &kbruch; é livre e está licenciado segundo a Licença Pública da &GNU;. </para>
</chapter>


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

<sect1 id="overview">
<title>Ecrã principal</title>

<para>Aqui está uma imagem do ecrã principal do &kbruch;:</para>

<screenshot>
	<screeninfo>O ecrã principal do &kbruch;, directamente a seguir ao início</screeninfo>
	<mediaobject>
		<imageobject>
			<imagedata fileref="gui_main.png" format="PNG"/>
		</imageobject>
		<textobject>
			<phrase>Ecrã principal do &kbruch;</phrase>
		</textobject>
	</mediaobject>
</screenshot>

<para>Toda a acção toma lugar neste ecrã. Isto garante que o &kbruch; é fácil de usar mesmo para os utilizadores novos! O ecrã principal está separado em 5 partes: <itemizedlist>
	<listitem><para>a barra de menu com os 3 menus <guimenu>Problema</guimenu>, <guimenu>Configuração</guimenu> e <guimenu>Ajuda</guimenu> </para></listitem>
	<listitem><para>a barra de ferramentas, onde você pode definir a dificuldade dos problemas indicados no exercício <guimenu>Problema de Fracções</guimenu> </para></listitem>
	<listitem><para>o selector de exercícios, onde poderá mudar entre os vários exercícios </para></listitem>
	<listitem><para>a parte da tarefa, onde você terá de introduzir o resultado da tarefa indicada </para></listitem>
	<listitem><para>a parte estatística, onde você poderá ver as tarefas que foram tentadas ou resolvidas correctamente </para></listitem>
</itemizedlist>
</para>
<para>Primeiro, você terá de escolher um exercício no selector respectivo do lado esquerdo da janela. A parte do problema irá mudar de acordo com o problema escolhido. A configuração da barra de ferramentas ficará activa, se você escolher o exercício do <guimenu>Problema de Fracções</guimenu>. </para>
<para>Você também irá encontrar um ícone para gerar um novo problema na barra de ferramentas. Esta acção está também disponível no menu <menuchoice><guimenu>Problema</guimenu><guimenuitem>Novo Problema</guimenuitem></menuchoice>. Esta acção está sempre activa. Se você não tiver resolvido o problema actual, será gerado um novo e o actual irá contar como resolvido incorrectamente. </para>
<para>Você poderá esconder a parte de estatísticas se arrastar o separador vertical para a direita. </para>
<para>Se você terminar o &kbruch;, o exercício escolhido será guardado à saída e reposto na próxima inicialização. </para>
</sect1>

<sect1 id="statistics">
<title>Parte Estatística</title>
<para>Nesta parte do ecrã principal, você poderá ver: <itemizedlist>
	<listitem><para>quantas tarefas foram resolvidas </para></listitem>
	<listitem><para>quantas tarefas foram resolvidas correctamente </para></listitem>
	<listitem><para>quantas tarefas foram resolvidas incorrectamente </para></listitem>
</itemizedlist>
</para>
<para>Você poderá reiniciar as estatísticas se carregar no botão <guimenu>Reiniciar</guimenu> por baixo das imagens. </para>
<para>As estatísticas serão gravadas à saída do &kbruch; e repostas no próximo arranque. </para>
</sect1>

<sect1 id="settings">
<title>Janela de Configuração</title>
<para>Nesta parte do ecrã principal você poderá ajustar algumas opções gerais para a área de problemas. Para abrir esta janela use a opção <menuchoice><guimenu>Configuração</guimenu><guimenuitem>Configurar o &kbruch;</guimenuitem></menuchoice>. </para>

<screenshot>
	<screeninfo>Janela de configuração do &kbruch;</screeninfo>
	<mediaobject>
		<imageobject>
			<imagedata fileref="settings.png" format="PNG"/>
		</imageobject>
		<textobject>
			<phrase>Janela de configuração do &kbruch;</phrase>
		</textobject>
	</mediaobject>
</screenshot>

<para>Na parte de cima da janela, você poderá escolher um tipo de letra para a visualização. Na parte inferior, você poderá escolher as cores para as diferentes partes de uma expressão matemática. Pode escolher mostrar a notação mista de números no resultado. Esta notação não é conhecida em todos os lados e pode portanto ser desactivada. </para>
<para>As configurações serão gravadas à saída do &kbruch; e repostas no próximo arranque. </para>
</sect1>

</chapter>

<chapter id="exercises">
<title>Exercícios</title>

<sect1 id="exer_fraction">
<title>Exercitar os Problemas de Fracções</title>

<para>Neste exercício você terá de resolver um problema indicado. Como tal, você terá de indicar o numerador e o denominador. A dificuldade do problema gerado poderá ser ajustada com os parâmetros do problema descritos em baixo. </para>

<sect2 id="task_paras">
<title>Parâmetros da Tarefa</title>
<para>Existem 3 parâmetros que influenciam a dificuldade das tarefas geradas:</para>

<variablelist>
<varlistentry>
<term><guilabel>Termos</guilabel></term>
<listitem><para>O número de termos (fracções separadas) indicados em cada tarefa. De 2 a 5, inclusive.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Máx. denominador comum</guilabel></term>
<listitem><para>O maior número que o &kbruch; irá usar como denominador comum nas tarefas que cria. Desde um mínimo de 10 até um máximo de 50.</para></listitem>
</varlistentry>

<varlistentry>
<term><guilabel>Operações</guilabel></term>
<listitem><para>As operações que deverão ser usadas na tarefa: <guilabel>Adição/Subtracção</guilabel>, <guilabel>Multiplicação/Divisão</guilabel> ou <guilabel>Todas as Operações em Conjunto</guilabel>.</para></listitem>
</varlistentry>
</variablelist>

<para>Depois de ter alterado os parâmetros, você terá de carregar no botão <guimenu>Nova Tarefa</guimenu> na barra de tarefas para gerar uma tarefa que usa os novos parâmetros. Você também poderá chamar esta acção a partir da barra do menu com a opção <menuchoice><guimenu>Tarefa</guimenu><guimenuitem>Nova Tarefa</guimenuitem></menuchoice>. </para>
<note>
<para>A sua selecção do máximo denominador comum será reposta num valor predefinido, de cada vez que você altera o número de termos. Por isso deverá alterar primeiro o número de termos e depois seleccionar o máximo denominador comum. </para>
</note>
<para>Se você não resolveu a tarefa actual e chamar a acção <guimenu>Nova Tarefa</guimenu>, a tarefa irá contar como resolvida incorrectamente. Para evitar isto, você terá de alterar os parâmetros depois de resolver a tarefa mas antes de gerar uma nova. </para>
<para>Os parâmetros escolhidos serão guardados à saída do &kbruch; e repostos na próxima inicialização. </para>
</sect2>

<sect2 id="exer_fraction_solve_task">
<title>Resolução de Tarefas</title>
<para>Depois de ter resolvido uma dada tarefa, você terá de indicar o resultado nos dois campos de dados. Na parte superior você indica o numerador e na inferior o denominador. </para>
<para>Se o resultado for negativo, você poderá indicar um sinal de menos à frente do numerador ou do denominador. Se o resultado for 0 (zero), você poderá deixar ambos os campos em branco. Se o resultado tiver um denominador igual a 1, você poderá deixar o campo de baixo em branco. </para>
<para>Depois de indicar o resultado, você deverá carregar no botão <guibutton>Verificar o Problema</guibutton> por baixo dos campos de texto. O &kbruch; irá validar o seu resultado e apresentar o resultado correcto. Como tal, o ecrã principal irá mudar um pouco, como poderá ver na imagem: </para>
<screenshot>
<screeninfo>Tarefa Verificada</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="checked.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase>Tarefa Verificada</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para>Este problema foi resolvido correctamente. O valor correcto é mostrado de 2 formas diferentes. A segunda forma à frente da palavra <guilabel>CORRECTO</guilabel> só é usada em alguns países deverá ser lida como 2 + 1/5 no caso indicado. </para>
<note>
<para>Você terá de indicar sempre o resultado reduzido, porque a maioria dos professores só dará a pontuação completa aos resultados reduzidos. O &kbruch; mostrar-lhe-á uma mensagem curta como a da imagem em baixo, se você indicar o resultado correcto mas não reduzido. </para>
</note>
<screenshot>
<screeninfo>Resultado não Reduzido</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="reduced.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase>Resultado não Reduzido</phrase>
  </textobject>
</mediaobject>
</screenshot>

<para>Para passar à próxima tarefa, carregue no botão <guimenu>Próxima Tarefa</guimenu>. Se quiser mudar os parâmetros para a próxima tarefa, por favor faça-o antes de carregar no botão <guimenu>Próxima Tarefa</guimenu>. </para>
</sect2>
</sect1>

<sect1 id="exer_compare">
<title>Exercitar a Comparação</title>

<para>Neste exercício, você terá de comparar 2 fracções indicadas. Você terá de escolher a maior fracção da duas, seleccionando o sinal de comparação correcto. </para>

<screenshot>
<screeninfo>Exercitar a Comparação</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="compare.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase>Exercitar a Comparação</phrase>
  </textobject>
</mediaobject>
</screenshot>

<para>Primeiro, escolha o sinal de comparação correcto. Para mudar o sinal de comparação, terá de carregar no botão que mostra o sinal de comparação. Depois de o ter escolhido, carregue na opção <guimenu>Verificar o Problema</guimenu>. O &kbruch; irá verificar os seus dados e apresentar o resultado correcto. Depois deste passo, poderá passar ao próximo exercício se carregar no botão <guimenu>Próximo Problema</guimenu>. </para>
</sect1>

<sect1 id="exer_convert">
<title>Exercitar a Conversão</title>

<para>Neste exercício, você terá de converter um dado número numa fracção. Você terá de indicar tanto o numerador como o denominador. </para>

<screenshot>
<screeninfo>Exercitar a Conversão</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="convert.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase>Exercitar a Conversão</phrase>
  </textobject>
</mediaobject>
</screenshot>

<para>Do lado esquerdo do sinal de igualdade na imagem, poderá ver um ponto decimal recorrente. Isto significa que a fracção mostrada tem uma parte repetitiva. A parte repetitiva é identificada com a pequena barra por cima dos números. Estes números repetem-se infinitamente. </para>

<para>Depois de ter introduzido o numerador e o denominador carregue no botão <guimenu>Verificar a Tarefa</guimenu>. O &kbruch; irá verificar os seus dados e apresentar o resultado correcto. Depois deste passo, você irá passar ao próximo problema ao carregar no botão <guimenu>Próximo Problema</guimenu>. </para>

<note>
<para>Não se esqueça de introduzir o resultado reduzidos. Os resultados não reduzidos irão contar como resolvidos incorrectamente. </para>
</note>
</sect1>

<sect1 id="exer_factorize">
<title>Exercitar a Factorização</title>

<para>Neste exercício, você terá de factorizar um dado número nos seus factores primos. Você terá de indicar todos os factores primos do número. </para>

<screenshot>
<screeninfo>Exercitar a Factorização</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="factorize.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase>Exercitar a Factorização</phrase>
  </textobject>
</mediaobject>
</screenshot>

<para>Você poderá indicar um factor se carregar nos <guimenu>botões de factores-primos</guimenu>. Os factores-primos indicados serão mostrados no campo ao lado do número a ser factorizado. Você poderá remover o último factor primo indicado se carregar no botão <guimenu>Remover o Último Factor</guimenu>. </para>
<para>Depois de ter introduzido todos os factores primos carregue no botão <guimenu>Verificar a Tarefa</guimenu>. O &kbruch; irá verificar os seus dados e apresentar o resultado correcto. Depois deste passo, você irá passar ao próximo problema ao carregar no botão <guimenu>Próximo Problema</guimenu>. </para>

<para>Na imagem do topo desta página, poderá ver um <quote>*</quote> entre os factores primos. Este é o sinal de multiplicação. O produto de todos os factores primos deverá ser o número que irá tentar factorizar. </para>

<note>
<para>Você terá de indicar todos os factores primos, mesmo quando um deles é repetido várias vezes. Por exemplo: como factores primos do número 18, terá de indicar 2, 3 e 3. </para>
</note>
</sect1>

</chapter>

<chapter id="credits">

<title>Créditos e Licença</title>
<para>&kbruch;</para>
<para>Programa e documentação Copyright, 2001-2004 Sebastian Stein <email>seb.kde@hpfsc.de</email> </para>

<para>Os agradecimentos vão para:</para>

<itemizedlist>
	<listitem><para>&Anne-Marie.Mahfouf; por gerir o projecto &kde;-Edu</para></listitem>
	<listitem><para>Klas Kalass por ter ajudado a desenhar a interface</para></listitem>
	<listitem><para>Eva Brucherseifer por criar o <application>KMath</application> (a interface gráfica do &kbruch; é baseada nesse trabalho)</para></listitem>
	<listitem><para>Dominique Devriese pela correcção de erros</para></listitem>
	<listitem><para><ulink url="http://www.net-tex.de/">Stefan Schumacher</ulink> por ter testado uma versão muito preliminar</para></listitem>
	<listitem><para><ulink url="http://www.guckes.net/">Sven Guckes</ulink> por testar a interface de texto (que foi removida)</para></listitem>
	<listitem><para>&David.Faure; por ajudar com o <acronym>CVS</acronym> e com o Bugzilla do &kde;</para></listitem>
	<listitem><para>&Robert.Gogolok; por ajudar com o <acronym>CVS</acronym> do &kde;</para></listitem>
	<listitem><para>John Kesson por validar o manual</para></listitem>
</itemizedlist>

<para>Tradução de José Nuno Pires <email>jncp@netcabo.pt</email></para> 
&underFDL; &underGPL; </chapter>

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

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

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

<para>Para conseguir usar com sucesso o &kbruch;, você precisa do &kde; > 3.1. </para>

<para>O &kbruch; em si poderá ser encontrado na <ulink url="http://edu.kde.org/kbruch">página pessoal do &kbruch;</ulink> e faz parte do projecto &kde;-Edu.</para>

<para>Você poderá encontrar uma lista com as alterações nas mensagens de alteração do <acronym>CVS</acronym>.</para>

</sect1>

<sect1 id="compilation">
<title>Compilação e Instalação</title>
&install.compile.documentation; </sect1>

</appendix>

&documentation.index;
</book>