QUESTVOX - MANUAL DE CRIAÇÃO DE QUESTIONÁRIOS

O QUESTVOX é um programa destinado a aplicar questões
de múltipla escolha.   Neste aspecto, existem várias
aplicações, tais como provas, jogos didáticos,
estatísticas e muitas outras.

As perguntas são geradas num arquivo cuja extensão
deve ser ".qst", por exemplo teste.qst.

As respostas do usuário ficam registradas num arquivo
chamado "resposta.txt", que contém o nome de todas
as pessoas que fizeram aquele teste, a lista de
respostas e a nota obtida.

As questões são faladas sinteticamente, normalmente.
Eventualmente a fala sintética pode ser substituída
por mensagens gravadas, dando ao programa, portanto
a opção de tocar músicas, incluir interpretações
e efeitos sonoros etc.

É hábito criar um questionário por diretório, para
poder separar o arquivo de respostas.  Assim,
antes de executar o questvox, normalmente se deve
posicionar o diretório como sendo aquele que contém
as questões.


Construção de um questionário:

Um questionário é composto por 3 seções:

a) Titulo
    Uma ou mais linhas contendo uma frase.
    As frases podem ter até 39 letras, pois
    o programa trabalha com letras grandes,
    visando favorecer leitores de visão subnormal.

    Caso o título contenha mais de uma linha,
    a primeira deve ficar na coluna 1, e as
    linhas de continuação devem conter um espaço
    em branco na coluna 1.

    Ao final das linhas do título deixa-se
    uma linha em branco, para separá-lo das
    questões.

b) Questões
    As questões contém duas partes:

    1   O texto da questão, criado como se fosse o
    título acima.  Neste caso, porém, após a última
    linha de título, seguem-se diretamente, sem
    nenhuma linha em branco, as opções da questão.

    2   Cada opção contém uma letra (como A,B,C, etc)
    seguida da pontuação obtida pelo usuário se escolher
    este item, e depois o texto.  Se o texto não couber
    em 39 letras, continua-se na próxima linha, deixando
    um espaço em branco ao início.

Ao final de cada questão, deixa-se uma linha em branco.

c) Avaliações
     As avaliações contém três partes:

     1   Uma linha contendo apenas um asterisco

     2   O texto que será falado antes de ser mostrada
     a avaliação

     3   Um conjunto de avaliações separadas por uma linha
     em branco.  Cada avaliação contem a nota mínima seguida
     pelo diagnóstico.   O valor deve ser um numero inteiro
     e é interpretado como "até este valor", o diagnóstico
     é o texto que se segue.
     Da mesma forma, também pode-se colocar avaliações com mais
     de uma linha, deixando-se um caractere em branco antes
     das linhas de continuação.


Exemplo:  

Prova de Conhecimentos Gerais
 Criada por José Antonio Borges

Quantos anos tem Antonio Borges?
A 0 10
B 0 20
C 1 Nenhuma das opções acima

Quem descobriu o Brasil ?
A 1 Cabral
B 0 Colombo
C 0 Pinzon

Quem descobriu a América ?
A 0 Cabral
B 1 Colombo
C 0 Pinzon

Em que ano foi descoberta a América ?
A 1 1492
B 0 1500
C 0 1503

Em que ano foi descoberto o Brasil ?
A 0 1492
B 1 1500
C 0 1503

*

Seu diagnóstico foi o seguinte:

0
Êta zebra

1
Tá mal

3
Precisa estudar mais

4
Quase lá

5
Perfeito

- - - - -

Incluindo sons

    É possível substituir as mensagens sintéticas por textos
    gravados.  Neste caso, aparece o texto na tela, mas o
    som produzido é tomado de um arquivo gravado.  Cada arquivo
    deve conter todo um item, por exemplo, um arquivo de som
    referente uma questão deve conter o som a questão e
    também o som das opções.

    Para especificar um som basta escrever o nome do arquivo
    entre colchetes, antes do início da questão ou da avaliação.
    Os arquivos de som tem extensão .WAV mas essa extensão não
    deve ser escrita na especificação do som.

    O arquivo a seguir ilustra esta implementação:

[PROVA]
Prova de Conhecimentos Gerais
 Criada por Jose Antonio Borges

[CLASSICA]
Qual das seguintes músicas pode ser
 considerada como clássica ?
A 1 O Lago dos Cisnes
B 0 Conversa de Botequim
C 0 Atirei o Pau no Gato

[QUEMAMER]
Quem descobriu a América ?
A 0 Cabral
B 1 Colombo
C 0 Pinzon

[QUEMVOZ]
De quem é essa voz ?
A 1 Marcelo Pimentel
B 0 Antonio Borges
C 0 Renato Costa

[QUEANOBR]
Em que ano foi descoberto o Brasil ?
A 0 1492
B 1 1500
C 0 1503

[SEGREDO]
Qual é o ruído produzido por um grilo ?
A 0 cricri
B 0 sissi
C 1 zizi

*

[DIAGNOST]
Seu diagnóstico foi o seguinte:

0
[ZEBRA]
Muito ruim, você não conhece
 nada de nada.

1
[TAMAL]
Tá mal.  Seu conhecimento básico
 é quase zero.

3
[PRECESTU]
Precisa escutar mais rádio.

4
[QUASELA]
Quase lá.  Você é bom,
 mas nem tanto.

5
[PERFEITO]
Você é maravilhoso.

- - - - -

Diretórios de sons

    Todos os arquivos são buscados no diretório padrão de sons
    especificado no arquivo geral de configuração do DOSVOX,
    que por padrão é c:\winvox\som\questões.

    É possível mudar este diretório para um certo arquivo de
    questões introduzindo neste a seguinte linha ao início do
    texto:
    [DIRSOM=xxxxx]
    onde xxxxx será substituído pelo diretório correto, por exemplo,
    [DIRSOM=c:\meus documentos\sons das questões]