<?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 % 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
>kbruch@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-2003</year>
<holder
>Sebastian Stein</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2003-09-22</date>
<releaseinfo
>3.1.91</releaseinfo>

<abstract>
<para
>O &kbruch; é um pequeno programa para gerar tarefas com fracções. O utilizador tem de resolver a tarefa em questão, indicando o valor para o numerador e para o denominador. 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 gerar tarefas com fracções. O utilizador tem de resolver a tarefa em questão, indicando o valor para o numerador e para o denominador. O programa verifica os dados introduzidos e dá um resultado. </para>
<para
>A geração de tarefas pode ser ajustada se usar parâmetros diferentes. O utilizador pode decidir se deseja resolver as tarefas com adições/subtracções e/ou multiplicação. </para>
<para
>É possível indicar o número de proporções e o máximo para o denominador principal. </para>
<para
>O &kbruch; é muito compacto e foca-se na ideia de base de um gerador de tarfas. Existe um sistema de ajuda 'online' que oferece uma ajuda dependente do contexto para as diferentes situações. </para>
<para
>O &kbruch; oferece também uma interface de texto. Isto significa que você pode usar o &kbruch; sem iniciar o &X-Window;. Para o fazer, você usa a opção da linha de comandos <option
>-t</option
>. </para>
<para
>É 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 4 partes: <itemizedlist>
	<listitem
><para
>a barra de menu com os dois menus <guimenu
>Tarefa</guimenu
> e <guimenu
>Ajuda</guimenu
> </para
></listitem>
	<listitem
><para
>a barra de tarefas, onde você pode definir a dificuldade das tarefas geradas </para
></listitem>
	<listitem
><para
>a parte estatística, onde você poderá ver as tarefas que foram tentadas ou resolvidas correctamente </para
></listitem>
	<listitem
><para
>a parte da tarefa, onde você terá de introduzir o resultado da tarefa indicada </para
></listitem>
</itemizedlist>
</para>
</sect1>

<sect1 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 você 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>
</sect1>

<sect1 id="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 em branco. </para>
<para
>Depois de indicar o resultado, você deverá carregar no botão <guibutton
>Verificar a Tarefa</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
>Esta tarefa foi resolvida 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 4 + 1/4 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>
</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>

</chapter>

<chapter id="config">
<title
>A Interface de Texto e o Modo de Geração</title>
<para
>O &kbruch; também oferece uma interface de texto. Você poderá iniciar esta interface directamente a partir de uma linha de comandos: </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>-t</option
></userinput>
</para>
<para
>ou </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>--text</option
></userinput>
</para>
<screenshot>
<screeninfo
>Menu Principal</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="text_main.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Menu Principal</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para
>Se você for um professor, poderá estar interessado em gerar uma quantidade de tarefas complicadas. Para esse fim, o &kbruch; oferece um modo de geração. Você só o poderá invocar a partir da linha de comandos: </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>-g</option
></userinput>
</para>
<para
>ou </para>
<para>
	<userinput
><command
>kbruch</command
> <option
>--generate</option
></userinput>
</para>
<screenshot>
<screeninfo
>Modo de Geração</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="generator.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Modo de Geração</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para
>Tal como é mostrado na imagem, você poderá parar o modo de geração se carregar em <keycombo action="simul"
>&Ctrl;<keycap
>C</keycap
></keycombo
>. Não é possível influenciar o gerador de tarefas. Você não poderá alterar os parâmetros como o número de termos, o tamanho do máximo denominador comum ou as operações que deverão ser usadas. </para>
</chapter>

<chapter id="credits">

<title
>Créditos e Licença</title>
<para
>&kbruch;</para>
<para
>Programa e documentação Copyright, 2001-2003 Sebastian Stein <email
>kbruch@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
>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 </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 no ficheiro ChangeLog da distribuição do &kbruch; ou ver as 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
-->
