inst/aux_files/other/tutorial_br.md

In ivanalaman/EDM: Exams Database Manager

TUTORIAL

Bem-vindos ao gerenciador de banco de questões!

A leitura deste tutorial é importante pois pretendemos esclarecer alguns pontos que achamos pertinentes para o bom uso do gerenciador.

Criando um banco de questões

Este menu é destinado aqueles que ainda não tem um banco de questões e gostariam de começar a contribuir com suas questões. Percebam que na primeira etapa você deve inserir seu nome completo e uma sigla que representará seu banco. Esta sigla deve conter somente três letras maiúsculas para que haja uma padronização do aplicativo. Caso suas siglas coincida com outras já criada, será disparado um alerta avisando-o para trocá-las.

Na segunda etapa, você deve escolher uma disciplina e um assunto desta disciplina. Evitem acentos ou qualquer tipo de caractere ao criar a disciplina/assunto. Siga o exemplo sugerido.

Em seguida clique no botão GERAR BANCO! para que sua base seja gerada e todos os demais arquivos para que o aplicativo reconheça sua base. Logo após feche o aplicativo e reinicie-o novamente para que sua base seja reconhecida.

Criando nova disciplina/assunto

Neste menu o usuário poderá criar novas disciplinas ou assuntos relacionados a uma disciplina que já foi criada. Para um bom funcionamento do aplicativo, toda vez que você criar uma nova disciplina, crie pelo menos um assunto relacionado a esta disciplina.

Uma nova disciplina ou assunto será criada toda vez que você clicar no botão GERAR DISCIPLINA ou GERAR ASSUNTO respectivamente. Novamente, para você visualizar as disciplinas criadas na coluna destinada a criação de assuntos, você deve reiniciar o aplicativo.

É importante que as disciplinas/assuntos criadas sejam com letras minúsculas. Caso o nome seja composto, separe-o com underline (_). Evitem acentos, caracteres especiais entre outros.

Progamando uma questão

Depois que você já criou se banco de questões, já pode começar a programar sua primeira questão.

Neste menu há duas opções. Interativo e Não interativo.

1. Interativo

2. É para aqueles que não tem conhecimento em LaTeX. O usuário deve seguir o exemplo sugerido em cada questão. Tentei ser o mais intuitivo possível. Após preencher os campos e apertar o botão salvar, um arquivo com o nome "myfile.Rnw" será salvo na pasta padrão do seu sistema (geralmente é a pasta download). Você deverá copiar o arquivo para dentro do seu banco de questões e editá-lo caso queira, para corrigir algum problema de acentuação por exemplo. Leia o texto no link https://github.com/ivanalaman/questionbankEDM/tree/master/lang/portuguese_br para maiores detalhes.

3. Não interativo

4. É para aqueles que tem algum conhecimento em LaTeX. Neste caso, para cada tipo de questão será apresentado o código fonte. O usuário deve seguir o exemplo sugerido. Um arquivo com o nome "myfile.Rnw" será salvo na pasta padrão do seu sistema (geralmente é a pasta download). Você deverá copiar o arquivo para dentro do seu banco de questões. Leia o texto no link https://github.com/ivanalaman/questionbankEDM/tree/master/lang/portuguese_br para maiores detalhes.

Percebam que as questões devem ter um padrão. Este padrão é o seguido pelo pacote exams. Portanto, embora o aplicativo tente minimizar o seu esforço para fazer uma questão, aconselhamos que acesse o site oficial do pacote exams http://www.r-exams.org/ para um conhecimento mais profundo.

Utilizar o banco de questões

Agora estamos prontos para utilizar o aplicativo.

Na primeira coluna da esquerda para direita, edite o cabeçalho de sua prova/exercício.

Na segunda coluna você escolherá quantas provas/exercícios deseja gerar. Por exemplo, se na minha sala de aula existem 10 alunos, então irei gerar 10 arquivos, um para cada aluno. Em seguida, você escolherá de qual(is) banco de questão(ões) será composto a(s) questão(ões) de sua prova/exercício. Após escolher o(s) banco(s) você poderá escolher qual(is) questão(ões) irá fazer parte de sua avaliação. Caso queira ver o arquivo antes, basta clicar com o botão direito em cima do arquivo, e clicar na opção copiar endereço do link, e colar no navegador.

Atualizando o banco de questões

O grande objetivo do aplicativo é que você tenha um banco de questões não só com suas questões, mas também de outros professores. Logo, caso queira atualizar seu banco com questões de outros professores clique no menu Atualizar banco de questões! e em seguida no botão Atualizar.

No momento não há uma distinção de país, matérias e disciplinas. Logo, a atualização do banco de questões implicará no Download de todos os arquivos que estarão no servidor.

Outras recomendações

Evite copiar a questão de um banco e colocar na sua base, pois deste modo, irá duplicar as questões e a idéia não é essa. Se tiver alguma coisa errada na questão de uma base que não é sua, envie um email para o mantenedor do banco de questões que estará no arquivo CADASTRO.md no repositório https://github.com/ivanalaman/questionbankEDM.

Faça como o autor do aplicativo, seja solidário, compartilhe. Ao colocar algumas questões na sua base, envie o seu arquivo compactado para o email [e-mail]. Após a revisão do arquivo, seu banco de questões será colocado no repositório https://github.com/ivanalaman/questionbankEDM para que outros usuários tenham acesso e também possam utilizar suas questões.

Caso haja algum bug no aplicativo e você não tenha intimidade com programação o suficiente para corrigí-lo, envie um email para [e-mail] e relate o bug para que possa ser corrigido.

ivanalaman/EDM documentation built on Sept. 23, 2021, 5:21 p.m.