# O Manual do &kbruch;

## Introdução

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.

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.

É possível indicar o número de proporções e o máximo para o denominador principal.

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.

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 `-t`.

É livre e está licenciado segundo a Licença Pública da &GNU;.

## Usar o &kbruch;

### Ecrã principal

Aqui está uma imagem do ecrã principal do &kbruch;:

O ecrã principal do &kbruch;, directamente a seguir ao início Ecrã principal do &kbruch;

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:

- a barra de menu com os dois menus Tarefa e Ajuda

- a barra de tarefas, onde você pode definir a dificuldade das tarefas geradas

- a parte estatística, onde você poderá ver as tarefas que foram tentadas ou resolvidas correctamente

- a parte da tarefa, onde você terá de introduzir o resultado da tarefa indicada

### Parâmetros da Tarefa

Existem 3 parâmetros que influenciam a dificuldade das tarefas geradas:

Termos

- O número de termos (fracções separadas) indicados em cada tarefa. De 2 a 5, inclusive.

Máx. denominador comum

- 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.

Operações

- As operações que deverão ser usadas na tarefa: Adição/Subtracção, Multiplicação/Divisão ou Todas as Operações em Conjunto.

Depois de você ter alterado os parâmetros, você terá de carregar no botão Nova Tarefa 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 Tarefa Nova Tarefa.

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.

Se você não resolveu a tarefa actual e chamar a acção Nova Tarefa, 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.

Os parâmetros escolhidos serão guardados à saída do &kbruch; e repostos na próxima inicialização.

### Resolução de Tarefas

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.

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.

Depois de indicar o resultado, você deverá carregar no botão Verificar a Tarefa 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:

Tarefa Verificada Tarefa Verificada

Esta tarefa foi resolvida correctamente. O valor correcto é mostrado de 2 formas diferentes. A segunda forma à frente da palavra CORRECTO só é usada em alguns países deverá ser lida como 4 + 1/4 no caso indicado.

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.

Resultado não Reduzido Resultado não Reduzido

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

### Parte Estatística

Nesta parte do ecrã principal, você poderá ver:

- quantas tarefas foram resolvidas

- quantas tarefas foram resolvidas correctamente

- quantas tarefas foram resolvidas incorrectamente

Você poderá reiniciar as estatísticas se carregar no botão Reiniciar por baixo das imagens.

As estatísticas serão gravadas à saída do &kbruch; e repostas no próximo arranque.

## A Interface de Texto e o Modo de Geração

O &kbruch; também oferece uma interface de texto. Você poderá iniciar esta interface directamente a partir de uma linha de comandos:

``kbruch` `-t``

ou

``kbruch` `--text``

Menu Principal Menu Principal

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:

``kbruch` `-g``

ou

``kbruch` `--generate``

Modo de Geração Modo de Geração

Tal como é mostrado na imagem, você poderá parar o modo de geração se carregar em &Ctrl;C. 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.

## Créditos e Licença

&kbruch;

Programa e documentação Copyright, 2001-2003 Sebastian Stein kbruch@hpfsc.de

Os agradecimentos vão para:

- Anne-Marie Mahfouf por gerir o projecto &kde; Edu

- Eva Brucherseifer por criar o KMath (a interface gráfica do &kbruch; é baseada nesse trabalho)

- Dominique Devriese pela correcção de erros

- Stefan Schumacher por ter testado uma versão muito preliminar

- Sven Guckes por testar a interface de texto

- David Faure por ajudar com o CVS e com o Bugzilla do &kde;

- Robert Gogolok por ajudar com o CVS do &kde;

- John Kesson por validar o manual

Tradução de José Nuno Pires jncp@netcabo.pt

&underFDL; &underGPL;

## Instalação

### Como obter o &kbruch;

&install.intro.documentation;

### Requisitos

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

O &kbruch; em si poderá ser encontrado na página pessoal do &kbruch; e faz parte do projecto KDE-Edu.

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 CVS.

### Compilação e Instalação

&install.compile.documentation;
&documentation.index;