<?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 "kdeedu">
 <!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>
<!--
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
-->