<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN"
 "dtd/kdex.dtd" [
<!ENTITY kbruch "<application
>KBruch</application
>">
<!ENTITY package "kdeedu">
<!ENTITY % addindex "IGNORE">
<!ENTITY % Brazilian-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
>Marcus</firstname
><surname
>Gama</surname
><affiliation
><address
><email
>marcus_gama@uol.com.br</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 

</authorgroup>

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

<legalnotice
>&FDLNotice;</legalnotice>

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

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

<keywordset>
<keyword
>KDE</keyword>
<keyword
>educação</keyword>
<keyword
>fraçã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 frações. Como tal, são oferecidos 4 exercícios diferentes. </para>

<itemizedlist>
	<listitem
><para
>Tarefa de Frações - neste exercício, você terá que resolver uma tarefa de frações indicado. Você terá que indicar o numerador e o denominador. Este é o exercício principal. </para
></listitem>
	<listitem
><para
>Comparação - neste exercício, você tem que comparar o valor de 2 frações indicadas. </para
></listitem>
	<listitem
><para
>Conversão - neste exercício, você tem que converter um determinado número numa fração. </para
></listitem>
	<listitem
><para
>Fatoração - neste exercício, você terá que fatorar um determinado número nos seus fatores primos. </para
></listitem>
</itemizedlist>

<para
>Em todos os vários exercícios, o &kbruch; irá gerar uma tarefa e o usuário terá que resolvê-la. O programa verifica os dados introduzidos e irá dar o resultado para eles. </para>

<para
>O &kbruch; conta quantas tarefas foram resolvidas no total e quantas foram resolvidas corretamente. As estatísticas são mostradas ao usuário, mas esta parte da janela principal pode ser oculta. O usuário poderá limpar as estatísticas a qualquer momento. </para>

<para
>O &kbruch; é muito compacto e foca-se na idéia básica de um gerador de tarefas. 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
>Usando o &kbruch;</title>

<sect1 id="overview">
<title
>Tela principal</title>

<para
>Aqui está uma imagem da tela principal do &kbruch;:</para>

<screenshot>
	<screeninfo
>A tela principal do &kbruch;, imediatamente após a incialização</screeninfo>
	<mediaobject>
		<imageobject>
			<imagedata fileref="gui_main.png" format="PNG"/>
		</imageobject>
		<textobject>
			<phrase
>Tela principal do &kbruch;</phrase>
		</textobject>
	</mediaobject>
</screenshot>

<para
>Toda a ação acontece neste tela. Isto garante que o &kbruch; é fácil de usar mesmo para os usuários novos! A tela principal está separada em 5 partes: <itemizedlist>
	<listitem
><para
>a barra de menu com os 3 menus <guimenu
>Tarefa</guimenu
>, <guimenu
>Configurações</guimenu
> e <guimenu
>Ajuda</guimenu
> </para
></listitem>
	<listitem
><para
>a barra de ferramentas, onde você pode definir a dificuldade das tarefasfornecidas no exercício <guimenu
>Tarefa de Frações</guimenu
> </para
></listitem>
	<listitem
><para
>o seletor de exercícios, onde você poderá alternar entre os vários exercícios </para
></listitem>
	<listitem
><para
>a parte da tarefa, onde você terá que inserir o resultado da tarefa indicada </para
></listitem>
	<listitem
><para
>a parte estatística, onde você poderá ver as tarefas que foram tentadas ou resolvidas corretamente </para
></listitem>
</itemizedlist>
</para>
<para
>Primeiro, você terá que escolher um exercício no seletor respectivo do lado esquerdo da janela. A parte da tarefa irá mudar de acordo com a tarefa escolhida. A configuração da barra de ferramentas ficará ativa, se você escolher o exercício do <guimenu
>Tarefa de Frações</guimenu
>. </para>
<para
>Você também irá encontrar um ícone para gerar uma nova tarefa na barra de ferramentas. Esta ação está também disponível no menu <menuchoice
><guimenu
>Tarefa</guimenu
><guimenuitem
>Nova Tarefa</guimenuitem
></menuchoice
>. Esta ação está sempre ativa. Se você não tiver resolvido a tarefa atual, será gerado uma nova e a atual irá contar como resolvida incorretamente. </para>
<para
>Você poderá ocultar a parte de estatísticas arrastando o separador vertical para a direita. </para>
<para
>Se você terminar o &kbruch;, o exercício escolhido será salvo e restaurado na próxima inicialização. </para>
</sect1>

<sect1 id="statistics">
<title
>Parte Estatística</title>
<para
>Nesta parte da tela principal, você poderá ver: <itemizedlist>
	<listitem
><para
>quantas tarefas foram resolvidas </para
></listitem>
	<listitem
><para
>quantas tarefas foram resolvidas corretamente </para
></listitem>
	<listitem
><para
>quantas tarefas foram resolvidas incorretamente </para
></listitem>
</itemizedlist>
</para>
<para
>Você poderá reiniciar as estatísticas clicando no botão <guimenu
>Reiniciar</guimenu
> abaixo das figuras. </para>
<para
>As estatísticas serão salvas na saída do &kbruch; e restauradas na próxima inicialização. </para>
</sect1>

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

<screenshot>
	<screeninfo
>Diálogo de configurações do &kbruch;</screeninfo>
	<mediaobject>
		<imageobject>
			<imagedata fileref="settings.png" format="PNG"/>
		</imageobject>
		<textobject>
			<phrase
>Diálogo de configurações do &kbruch;</phrase>
		</textobject>
	</mediaobject>
</screenshot>

<para
>Na parte de cima do diálogo, você poderá escolher uma fonte 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 lugares e pode portanto ser desativada. </para>
<para
>As configurações serão salvas na saída do &kbruch; e restauradas na próxima inicialização. </para>
</sect1>

</chapter>

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

<sect1 id="exer_fraction">
<title
>Exercitar as Tarefas de Frações</title>

<para
>Neste exercício você terá que resolver uma tarefa fornecida. Para isso, você terá que inserir o numerador e o denominador. A dificuldade da tarefa gerada poderá ser ajustada com os parâmetros da tarefa descritos abaixo. </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 (fraçõ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/Subtração</guilabel
>, <guilabel
>Multiplicação/Divisão</guilabel
> ou <guilabel
>Todas as Operações Misturadas</guilabel
>.</para
></listitem>
</varlistentry>
</variablelist>

<para
>Depois de você ter alterado os parâmetros, você terá que clicar no botão <guimenu
>Nova Tarefa</guimenu
> na barra de tarefas para gerar uma tarefa que use os novos parâmetros. Você também poderá chamar esta açã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 seleção do máximo denominador comum será reiniciada num valor padrão, toda vez que você altera o número de termos. Por isso você deverá alterar primeiro o número de termos e depois selecionar o máximo denominador comum. </para>
</note>
<para
>Se você não resolveu a tarefa atual e chamar a ação <guimenu
>Nova Tarefa</guimenu
>, a tarefa irá contar como resolvida incorretamente. Para evitar isto, você terá que alterar os parâmetros depois de resolver a tarefa mas antes de gerar uma nova. </para>
<para
>Os parâmetros escolhidos serão guardados na saída do &kbruch; e restaurados 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 tarefa fornecida, você terá que inserir o resultado nos dois campos de dados. Na parte superior você insere o numerador e na inferior o denominador. </para>
<para
>Se o resultado for negativo, você poderá inserir 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 inserir o resultado, você deverá clicar no botão <guibutton
>Checar Tarefa</guibutton
> abaixo dos campos de texto. O &kbruch; irá validar o seu resultado e apresentar o resultado correto. Assim, o tela principal irá mudar um pouco, como você 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 corretamente. O valor correto é mostrado de 2 formas diferentes. A segunda forma à frente da palavra <guilabel
>CORRETO</guilabel
> só é usada em alguns países e deverá ser lida como 2 + 1/5 no caso indicado. </para>
<note>
<para
>Você terá que inserir sempre o resultado reduzido, porque a maioria dos professores só darão a pontuação completa aos resultados reduzidos. O &kbruch; mostrará uma mensagem curta como a da imagem abaixo, se você inserir o resultado correto 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, clique 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 clicar 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á que comparar 2 frações indicadas. Você terá que escolher a maior fração da duas, selecionando o sinal de comparação correto. </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 sinalo de comparação correto. Para mudar o sinal de comparação, terá que clicar no botão que mostra o sinal de comparação. Depois de tê-lo escolhido, clique na opção <guimenu
>Checar Tarefa</guimenu
>. O &kbruch; irá verificar os seus dados e apresentar o resultado correto. Depois deste passo, você poderá passar ao próximo exercício clicando no botão <guimenu
>Próximo Tarefa</guimenu
>. </para>
</sect1>

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

<para
>Neste exercício, você terá que converter um número fornecido numa fração. Você terá que 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, você poderá ver um ponto decimal recorrente. Isto significa que a fração mostrada tem uma parte repetitiva. A parte repetitiva é identificada com a pequena barra acima dos números. Estes números repetem-se infinitamente. </para>

<para
>Depois de ter inserido o numerador e o denominador clique no botão <guimenu
>Verificar Tarefa</guimenu
>. O &kbruch; irá verificar os seus dados e apresentar o resultado correto. Depois deste passo, você irá passar para a próxima tarefa clicando no botão <guimenu
>Próxima Tarefa</guimenu
>. </para>

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

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

<para
>Neste exercício, você terá que fatorar um número fornecido nos seus fatores primos. Você terá que inserir todos os fatores primos do número. </para>

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

<para
>Você poderá inserir um fator clicando nos <guimenu
>botões de fatores-primos</guimenu
>. Os fatores-primos inseridos serão mostrados no campo ao lado do número a ser fatorado. Você poderá remover o último fator primo inserido clicando no botão <guimenu
>Remover Último Fator</guimenu
>. </para>
<para
>Depois de ter inserido todos os fatores primos clique no botão <guimenu
>Verificar Tarefa</guimenu
>. O &kbruch; irá verificar os seus dados e apresentar o resultado correto. Depois deste passo, você irá passar para a próxima tarefa clicando no botão <guimenu
>Próxima Tarefa</guimenu
>. </para>

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

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

</chapter>

<chapter id="credits">

<title
>Créditos e Licença</title>
<para
>&kbruch;</para>
<para
>Direitos autorais do programa e documentação, 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 gerenciar o projeto &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 correçã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 Marcus Gama<email
>marcus_gama@uol.com.br</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 projeto KDE-Edu.</para>

<para
>Você poderá encontrar uma lista com as mudanças 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>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=2:sw=2:tw=78:noet
-->
