Escrever um banco de questões

O editor

Em Bancos de questões → Novo banco cada questão é um formulário: o enunciado, as alternativas com a correta marcada e os detalhes. Ao lado, Como texto mostra a mesma questão como o formato de texto a escreve, e o formato se aprende olhando.

Cada alteração é salva sozinha e pode ser desfeita. Importar questões… acrescenta as questões de um arquivo .txt, de um banco com suas imagens (.zip) ou de uma planilha (.xlsx, .csv). Exportar grava uma cópia para compartilhar com colegas.

O formato de texto

Um arquivo de texto (.txt), escrito em qualquer editor. Uma questão começa com o seu número e um ponto; a alternativa correta começa com * e as outras com -.

1. Qual medida de tendência central é a menos afetada por valores extremos?- A média* A mediana- A moda- A amplitude

• Exatamente uma alternativa é marcada com *, e uma questão precisa de pelo menos duas.
• O enunciado pode ocupar várias linhas: elas são unidas até a primeira alternativa.
• As linhas em branco entre questões são opcionais. Os números não precisam estar em ordem: cada versão numera as suas questões de novo.
• Uma linha que começa com # é uma nota para você e nunca é impressa.
• O cartão-resposta tem cinco letras, de A a E. Uma questão pode ter mais alternativas: cada versão imprime então a correta e quatro distratores sorteados.

Enunciados com afirmações numeradas

As linhas numeradas logo depois do enunciado, contando a partir de 1, fazem parte da questão, não são questões novas:

5. Considere as seguintes afirmações sobre um valor p menor que 0,05:1. Prova que a hipótese nula é falsa.2. Indica um resultado estatisticamente significativo a 5%.3. Mede o tamanho do efeito.Quais estão corretas?* Apenas 2- Apenas 1 e 2- Apenas 2 e 3- 1, 2 e 3

Ordem fixa

As alternativas são embaralhadas em cada versão. Quando a ordem importa, como com «todas as anteriores», escreva [orden:fijo] na linha acima da questão e elas são impressas como estão escritas.

[orden:fijo]4. Qual destas é uma medida de dispersão?- O desvio padrão- A amplitude- A variância* Todas as anteriores

Detalhes da questão Pro

Uma linha entre colchetes logo acima de uma questão a descreve. Com ela as cotas equilibram as versões e a análise acompanha cada questão de uma prova para outra. Os campos são separados por | ou ;, e são escritos em espanhol em todos os idiomas, como o app os escreve.

[ra:1.1 | nivel:aplicar | concepto:delineamento-longitudinal | variante:2 | dificultad_estimada:0,5]3. A pressão arterial de 200 pessoas é medida todo ano durante uma década. Qual é o delineamento?* Longitudinal- Transversal- Caso-controle- Ecológico

Conceitos e variantes. Variantes são questões que compartilham um cenário e mudam a condição que decide a resposta. Elas se entregam umas às outras, por isso uma versão nunca leva duas variantes do mesmo conceito.

O app escreve sozinho mais três campos quando calibra o banco: dificultad_real, discriminacion e aplicaciones. Não é preciso escrevê-los.

Blocos

Várias questões sobre uma mesma coisa (um caso clínico, um texto, um gráfico, uma radiografia) são escritas como um bloco. O texto do bloco é impresso uma vez, acima das suas questões, e elas ficam juntas em todas as versões.

[orden:fijo]@bloco Um ensaio clínico designou aleatoriamente 120 pacientes com hipertensão para um fármaco novo ou para placebo.O desfecho principal foi a pressão sistólica em 12 semanas.@imagem ensaio.png 6. Que tipo de estudo é?* Experimental- Observacional- Ecológico 7. Para que serve a alocação aleatória?* Para que os grupos sejam comparáveis, inclusive no que não foi medido- Para que o estudo seja duplo-cego- Para aumentar o tamanho da amostra@fim

• @bloco o abre e @fim o fecha. O texto pode continuar em várias linhas, e uma linha em branco começa um parágrafo novo.
• @imagem acrescenta uma imagem por bloco. Se você importar um banco com imagens, traga um .zip com o .txt e as imagens; no editor, a imagem é acrescentada direto ao bloco.
• As questões de um bloco são embaralhadas entre si. Com [orden:fijo] na linha acima de @bloco, elas mantêm a ordem em que foram escritas.
• Os marcadores também são lidos em espanhol (@bloque, @imagen, @fin) e em inglês (@block, @image, @end), e o banco de um colega abre sem tradução.
• Um bloco não vai dentro de outro, e as questões dissertativas não vão dentro de um bloco.

Questões dissertativas Pro

Uma questão sem alternativas, com # e o número de linhas que o aluno tem para responder. Uma linha que começa com > é a resposta modelo: ajuda você a corrigir e nunca é impressa.

[puntaje:4]8. Explique a diferença entre significância estatística e relevância clínica.#6> Um resultado pode ser improvável por acaso e ainda assim pequeno demais para importar ao paciente.

Elas são impressas depois das de múltipla escolha, e as bolhas continuam numeradas a partir de 1. Você as corrige na etapa Dissertativa da avaliação, e elas somam à nota.

Excel e CSV

Uma linha por questão e uma coluna para cada parte. Os cabeçalhos podem estar em português, espanhol ou inglês e em qualquer ordem, e o app reconhece os nomes habituais («Questão», «Resposta», «Alternativa A»...).

Um arquivo CSV funciona igual, com vírgulas, ponto e vírgula ou tabulações. O que uma planilha ainda não consegue guardar são os blocos: para eles, use o formato de texto.

Exemplos para baixar

O mesmo banco de exemplo nos dois formatos: uma questão simples, detalhes, duas variantes de um conceito, ordem fixa, afirmações numeradas, um bloco e uma questão dissertativa. Importe-os em Bancos de questões → Importar… e abra-os no editor para ver cada questão como formulário.

banco-exemplo.txtbanco-exemplo.xlsx

A planilha não traz o bloco, porque as planilhas ainda não conseguem guardá-los.

Quando um banco é recusado

Um banco com erro não gera provas: assim o erro nunca chega ao papel. O editor marca a questão, e um arquivo importado diz em que linha está o problema. Os mais comuns:

• Nenhuma alternativa marcada com *, ou mais de uma.
• Uma questão com uma única alternativa.
• Um bloco aberto com @bloco e nunca fechado com @fim, ou um dentro de outro.
• Uma @imagem cuja imagem não veio com o banco.
• Um detalhe com um valor que ele não aceita, como nivel:compreender.