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

<book lang="&language;">

<bookinfo>
<title
>O Manual de &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
>Marce</firstname
><surname
>Villarino</surname
><affiliation
><address
><email
>mvillarino@users.sourceforge.net</email
></address
></affiliation
><contrib
>Tradutor do proxecto Trasno</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
>&kbruch; é un programa para praticar o cálculo con fraccións. Contén diferentes tipos de exercicios que serán de utilidade. O programa verifica as respostas do usuario e reacciona en consecuencia. </para>
	
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>educación</keyword>
<keyword
>fracción</keyword>
<keyword
>matemáticas</keyword>
<keyword
>denominador</keyword>
<keyword
>kbruch</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introdución</title>

<para
>&kbruch; é un programa para praticar o cálculo con fraccións. Oferece 4 tipos diferentes de exercicio con este propósito. </para>

<itemizedlist>
	<listitem
><para
>Exercicio de Fraccións - neste tipo de exercicio deberá resolver unha fracción dada. Deberá escreber o numerador e o denominador. Este é o tipo principal de exercicio. </para
></listitem>
	<listitem
><para
>Comparación - nestes exercicios deberá comparar duas fraccións dadas. </para
></listitem>
	<listitem
><para
>Conversión - nestes exercicios deberá converter un número dado nunha fracción. </para
></listitem>
	<listitem
><para
>Factorización - neste exercicio deberá descompor un número dado nos seus factores primos. </para
></listitem>
</itemizedlist>

<para
>En todos os tipos de exercicios &kbruch; xerará unha tarefa e o usuario terá que resolvela. O programa examinará a entrada do usuario e dará unha resposta acerca dela. </para>

<para
>&kbruch; leva a conta do número de problemas que foron resoltos e dos que errou. Mostra estatísticas ao usuario, pero esta parte da xanela principal pode ser acochada. O usuario pode reiniciar as estatísticas a calquer altura. </para>

<para
>&kbruch; é moi compacto e focalízase na idea dun xerador de tarefas. O sistema de axuda en liña fornece axuda sensíbel ao contexto para as diferentes situacións. </para>
<para
>&kbruch; é libre e distribúese baixo a licenza &GNU; Public License. </para>
</chapter>


<chapter id="using-kbruch">
<title
>Uso de &kbruch;</title>

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

<para
>Esta é unha captura de pantalla da xanela principal de &kbruch;:</para>

<screenshot>
	<screeninfo
>A xanela principal de &kbruch;, xusto tras iniciarse</screeninfo>
	<mediaobject>
		<imageobject>
			<imagedata fileref="gui_main.png" format="PNG"/>
		</imageobject>
		<textobject>
			<phrase
>A xanela principal de &kbruch;</phrase>
		</textobject>
	</mediaobject>
</screenshot>

<para
>Toda a acción acontece nesta xanela. Deste xeito &kbruch; é fácil de usar mesmo por cativos! A xanela principal está dividida en 5 partes: <itemizedlist>
	<listitem
><para
>a barra de menú cos 3 menús <guimenu
>Tarefas</guimenu
>, <guimenu
>Configuracion</guimenu
> e <guimenu
>Axuda</guimenu
> </para
></listitem>
	<listitem
><para
>a barra de ferramentas, onde poderá axustar o nível de dificultade dos exercicios de tipo <guimenu
>Exercicio de Fraccións</guimenu
>. </para
></listitem>
	<listitem
><para
>o selector de exercicio, onde pode mudar o tipo dos exercicios </para
></listitem>
	<listitem
><para
>a parte do exercicio, onde deberá escreber o resultado do exercicio </para
></listitem>
	<listitem
><para
>a parte das estatísticas, onde poderá ver cantos problemas resolveu e cantos tentou </para
></listitem>
</itemizedlist>
</para>
<para
>En primeiro lugar deberá escoller un tipo de exercicio no selector de exercicios á esquerda da xanela. A parte do exercicio mudará de acordo ao tipo escollido. Activaranse as configuracións na barra de ferramentas de escoller <guimenu
>Exercicio de Fraccións</guimenu
>. </para>
<para
>Na barra de ferramentas tamén atopará un ícone para xerar un novo exercicio. Esta acción tamén está disponíbel no menú <menuchoice
><guimenu
>Exercicio</guimenu
> <guimenuitem
>Novo Exercicio</guimenuitem
></menuchoice
>. Esta acción sempre está disponíbel. Se non resolveu o exercicio actual, xerarase un novo e o actual será contado como non resolto correctamente. </para>
<para
>Poderá acochar a parte das estatísticas arrastando o separador vertical para a direita. </para>
<para
>Se pecha &kbruch; o exercicio actual será guardado e restaurado a próxima vez que o inicie. </para>
</sect1>

<sect1 id="statistics">
<title
>Parte das Estatísticas</title>
<para
>Nesta parte da xanela principal poderá ver: <itemizedlist>
	<listitem
><para
>cantos exercicios foron resoltos </para
></listitem>
	<listitem
><para
>cantos exercicios foron resoltos correctamente </para
></listitem>
	<listitem
><para
>cantos exercicios foron resoltos incorrectamente </para
></listitem>
</itemizedlist>
</para>
<para
>Pode reiniciar as estatísticas premendo no botón <guimenu
>Reiniciar</guimenu
> baixo os números. </para>
<para
>As estatísticas serán guardadas ao pechar &kbruch; e restauradas a próxima vez que o inicie. </para>
</sect1>

<sect1 id="settings">
<title
>Xanela de Configuración</title>
<para
>Nesta parte da xanela principal poderá axustar algúns parámetros xerais da maneira en que son mostradas as tarefas. Para abrir este diálogo use <menuchoice
><guimenu
>Configuración</guimenu
> <guimenuitem
>Configurar &kbruch;</guimenuitem
></menuchoice
>. </para>

<screenshot>
	<screeninfo
>O diálogo de configuración de &kbruch;</screeninfo>
	<mediaobject>
		<imageobject>
			<imagedata fileref="settings.png" format="PNG"/>
		</imageobject>
		<textobject>
			<phrase
>O diálogo de configuración de &kbruch;</phrase>
		</textobject>
	</mediaobject>
</screenshot>

<para
>Na parte superior do diálogo pode escoller un tipo de letra. Na parte inferior poderá escoller as cores das distintas partes das expresións matemáticas. Pode escoller se mostrar  unha notación mixta no resultado. Esta notación non é coñecida en todas partes e portanto pode ser deshabilitada. </para>
<para
>A configuración será guardada ao sair de &kbruch; e restaurada no próximo inicio. </para>
</sect1>

</chapter>

<chapter id="exercises">
<title
>Exercicios</title>

<sect1 id="exer_fraction">
<title
>Exercicios de Fraccións</title>

<para
>Nestes exercicios terá que resolver unha fracción dada. Terá que introducir o numerador e o denominador. A dificuldade do exercicio pode ser axustada cos parámetros descritos mais adiante. </para>

<sect2 id="task_paras">
<title
>Parámetros do Tipo de Problema</title>
<para
>Hai 3 parámetros que inciden na dificuldade dos exercicios xerados:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Termos</guilabel
></term>
<listitem
><para
>O número de termos (fraccións individuais) dados en cada exercicio. De 2 a 5, inclusive.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Máx. común denominador</guilabel
></term>
<listitem
><para
>O número máximo que &kbruch; usará como denominador común nos exercicios. De un mínimo de 10 a un máximo de 50.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Operacións</guilabel
></term>
<listitem
><para
>As operacións que serán usadas nos exercicios: <guilabel
>Soma/Resta</guilabel
>, <guilabel
>Multiplicación/División</guilabel
> ou <guilabel
>Todas as Operacións Misturadas</guilabel
>.</para
></listitem>
</varlistentry>
</variablelist>

<para
>Tras modificar os parámetros ten que premer no botón <guimenu
>Nova tarefa</guimenu
> na barra de ferramentas para xerar unha tarefa que empregue os novos parámetros. Tamén pode chamar esta acción desde a barra de menú mediante <menuchoice
><guimenu
>Tarefa</guimenu
><guimenuitem
>Nova tarefa</guimenuitem
></menuchoice
>. </para>
<note>
<para
>O valor que teña escollido para o máximo común denominador será reposta cun valor por omisión cada vez que mude o número de termos. Polo tanto deberá mudar primeiro o número de termos e logo escoller o máximo común denominador. </para>
</note>
<para
>Se non resolveu o exercicio actual e chamase a acción <guimenu
>Nova Tarefa</guimenu
>, contarase como non resolta correctamente. Para evitar isto debe mudar os parámetros tras resolver o exercicio e antes de xerar un novo. </para>
<para
>Os parámetros escollidos serán guardados cando peche &kbruch; e repostos a próxima vez que o inicie. </para>
</sect2>

<sect2 id="exer_fraction_solve_task">
<title
>Resolver Exercicios</title>
<para
>Tras resolver un exercicio, deberá escreber o resultado nos dous campos de entrada. Na caixa de acima deberá escreber o numerador e na de baixo o denominador. </para>
<para
>Se o resultado é negativo, poderá escreber un signo negativo (-) diante do numerador ou do denominador. Se o resultado é 0, simplesmente escreba un 0 no denominador. Se o resultado ten un denominador de 1, pode deixar o campo de baixo valeiro. </para>
<para
>Tras escreber o resultado deberá premer no botón <guibutton
>Comprobar resposta</guibutton
> baixo os campos de entrada. &kbruch; verificará a súa resposta e mostrará o resultado correcto. A xanela cambiará un chisco, como pode ver na seguinte imaxe: </para>
<screenshot>
<screeninfo
>Resposta verificada</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="checked.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Resposta verificada</phrase>
  </textobject>
</mediaobject>
</screenshot>
<para
>Este exercicio non foi resolto correctamente. O valor correcto é mostrado de 2 xeitos distintos. A segunda forma diante da palabra <guilabel
>CORRECTO</guilabel
> só é usada nalgúns países e debe lerse como 2 + 1/5 nese caso. </para>
<note>
<para
>Sempre deberá escreber o resultado reducido, debido a que a maioría dos profesores só dan toda a pontuación ás formas reducidas. &kbruch; mostraralle unha mensaxe como a da seguinte imaxe, se escrebe o valor correcto sen reducir. </para>
</note>
<screenshot>
<screeninfo
>Resultado Non Reducido</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="reduced.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Resultado Non Reducido</phrase>
  </textobject>
</mediaobject>
</screenshot>

<para
>Para continuar co seguinte exercicio, prema no botón <guimenu
>Nova Tarefa</guimenu
>. Se desexa mudar os parámetros por favor faga-o antes de premer ese botón. </para>
</sect2>
</sect1>

<sect1 id="exer_compare">
<title
>Comparación de Exercicios</title>

<para
>Neste tipo de exercicio deberá comparar 2 fraccións dadas. Deberá escoller a maior entre ambas as dúas escollendo o símbolo correcto. </para>

<screenshot>
<screeninfo
>Exercicio de Comparación</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="compare.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Exercicio de Comparación</phrase>
  </textobject>
</mediaobject>
</screenshot>

<para
>En primeiro lugar escolla o símbolo correcto premendo no botón que o mostra. Tras escoller o símbolo prema no botón <guimenu
>Comprobar resposta</guimenu
>. &kbruch; verificará a súa respostar e mostrará o resultado correcto. Tras este paso poderá facer outro problema premendo no botón <guimenu
>Nova Tarefa</guimenu
>. </para>
</sect1>

<sect1 id="exer_convert">
<title
>Exercicios de Conversión</title>

<para
>Nestes exercicios deberá converter un número dado nunha fraccioón. Deberá escreber o numerador e o denominador. </para>

<screenshot>
<screeninfo
>Exercicio de Conversión</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="convert.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Exercicio de Conversión</phrase>
  </textobject>
</mediaobject>
</screenshot>

<para
>Á esquerda do signo de igualdade na captura de pantalla de cima pode ver un decimal periódico. Isto significa que a fracción ten unha parte que se repete. A parte que se repete é marcada cunha barra sobre os números. Estes números repétense até o infinito. </para>

<para
>Tras escreber o numerador e o denominador prema no botón <guimenu
>Comprobar resposta</guimenu
>. &kbruch; verificará a súa resposta e mostrará o resultado correcto. Tras isto poderá facer outro exercicio premendo no botón <guimenu
>Nova Tarefa</guimenu
>. </para>

<note>
<para
>Non se esqueza de escreber o resultado reducido. Os que non estexan reducidos serán contados como incorrectos. </para>
</note>
</sect1>

<sect1 id="exer_factorize">
<title
>Exercicios de Factorización</title>

<para
>Nestes exercicios deberá factorizar un números dado nos seus factores primos. Deberá escreber todos os factores primos do número. </para>

<screenshot>
<screeninfo
>Exercicio de Factorización</screeninfo>
<mediaobject>
  <imageobject>
		<imagedata fileref="factorize.png" format="PNG"/>
  </imageobject>
  <textobject>
    <phrase
>Exercicio de Factorización</phrase>
  </textobject>
</mediaobject>
</screenshot>

<para
>Pode introducir un factor premendo no botón <guimenu
>Factor primo</guimenu
>. Os números que teña introducido como factores primos serán mostrados no campo xunto ao número a ser factorizado. Pode eliminar o último número da lista de factores primos premendo no botón <guimenu
>Eliminar o último factor</guimenu
>. </para>
<para
>Tras introducir todos os factores primos prema no botón <guimenu
>Comprobar resposta</guimenu
>. &kbruch; verificará a súa resposta e mostrará o resultado correcto. Tras isto poderá facer outro exercicio se preme no botón <guimenu
>Nova Tarefa</guimenu
>. </para>

<para
>Na captura de pantalla de acima pode ver un <quote
>*</quote
> entre os factores. Este é o signo de multiplicación. O produto de todos os factores primos debe ser o número que tenta factorizar. </para>

<note>
<para
>Deberá escreber todos os factores primos mesmo cando un se repete varias veces. Por exemplo: Como factores primos do número 18 deberá dar 2, 3 e 3. </para>
</note>
</sect1>

</chapter>

<chapter id="credits">

<title
>Recoñecimentos e Licenza</title>
<para
>&kbruch;</para>
<para
>Copyright do programa e da documentación, 2001-2004 Sebastian Stein <email
>seb.kde@hpfsc.de</email
> </para>

<para
>Agradecimentos especiais para:</para>

<itemizedlist>
	<listitem
><para
>&Anne-Marie.Mahfouf; por xestionar o proxecto educativo de &kde;</para
></listitem>
	<listitem
><para
>Klas Kalass por axudar no deseño da interface</para
></listitem>
	<listitem
><para
>Eva Brucherseifer por escreber <application
>KMath</application
> (A &GUI; de &kbruch; está baseada no seu traballo)</para
></listitem>
	<listitem
><para
>Dominique Devriese por corrixir erros</para
></listitem>
	<listitem
><para
><ulink url="http://www.net-tex.de/"
>Stefan Schumacher</ulink
> por probar unha versión moi inicial</para
></listitem>
	<listitem
><para
><ulink url="http://www.guckes.net/"
>Sven Guckes</ulink
> por probar a interface de texto (a cal foi eliminada)</para
></listitem>
	<listitem
><para
>&David.Faure; pola axuda co <acronym
>CVS</acronym
> e o Bugzilla de &kde;</para
></listitem>
	<listitem
><para
>&Robert.Gogolok; por axudar co<acronym
>CVS</acronym
> de &kde;</para
></listitem>
	<listitem
><para
>John Kesson por unha leitura crítica do manual</para
></listitem>
</itemizedlist>

<para
>mvillarino<email
>mvillarino@users.sourceforge.net</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Instalación</title>

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

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

<para
>Para poder usar &kbruch; precisa de &kde; 
> 3.1. </para>

<para
>&kbruch; en si pode ser atopado na <ulink url="http://edu.kde.org/kbruch/"
>páxina web de &kbruch;</ulink
> e é parte do proxecto educativo de &kde;</para>

<para
>Poderá atopar unha lista de mudanzas nas mensaxes de envío ao <acronym
>SVN</acronym
>.</para>

</sect1>

<sect1 id="compilation">
<title
>Compilación e Instalación</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
-->