Importando arquivos no formato “GIFT”

GIFT é o formato de importação mais abrangente disponível para importar per-

guntas de um arquivo texto para o quiz do Moodle. Suporta perguntas múltipla
escolha, falso-verdadeiro, resposta breve, associação e numérica, tão bem
como a inserção de um _____ para o formato de preenchimento. Vários tipos
de perguntas podem ser misturadas em um arquivo texto, e o formato também
suporta linhas de comentários, nomes das perguntas, avaliação e notas com pe-
sos porcentuais.
A codificação do texto de seu arquivo texto deve ser a mesma como na instala-
ção do Moodle. Um arquivo texto com exemplos de perguntas pode ser encon-
trado em: gift/examples.txt.

Tipos de perguntas

Múltipla escolha:
Para perguntas múltipla escolha, as respostas erradas são prefixadas com um til
(~) e as respostas corretas com um sinal de igual (=).
Quem está enterrado na tumba de Grant?{~Grant ~Jefferson =ninguém}

O formato de preenchimento automaticamente insere uma linha com brancos

(______) no meio da sentença. Para se utilizar o formato de preenchimento, co-
loque as respostas onde você deseja que a linha apareça na sentença.
Grant está {~enterrado =sepultado ~morando} na tumba de Grant.

Se as respostas vierem antes da marca de pontuação final, uma linha com bran-
cos será inserida para o formato de preenchimento. Todos os tipos de perguntas
podem ser escritas no formato de preenchimento.
Deve haver uma linha separando as perguntas (duplo CR - carriage return).
Para ficar mais claro, as respostas podem ser escritas em linhas separadas ou
até mesmo recuadas. Por exemplo:
O feriado americano de ação de graças é celebrado na {
~segunda
~terceira
=quarta
} quinta-feira de novembro.

Os caracteres japoneses originalmente vêm de qual país? {

~Índia
=China
~Coréia
~Egito}
Resposta breve
Respostas para o tipo de pergunta com resposta breve são todas prefixadas com
um sinal de igual (=), indicando que todas são respostas corretas. As respostas
não devem conter um til.
Quem está enterrado na tumba de Grant?{=nenhuma pessoa =ninguém}
Dois mais dois é igual a (=quatro =4).

Caso somente uma resposta breve seja correta, ela pode ser escrita sem o sinal
de igual, contanto que não seja confundida como falso-verdadeiro.

Falso-verdadeiro
Neste tipo de pergunta a resposta indica se a sentença é falsa ou verdadeira. A
resposta deve ser escrita como (FALSE) ou (TRUE), ou abreviadamente como
(F) ou (T).
Grant está enterrado na tumba de Grant.{F)

O sol nasce no leste.{T}

Associação
Pares de associação iniciam-se com o sinal de igual (=) e são separados pelo
símbolo "->". Deve haver no mínimo três pares.
Pergunta de associação. {
=pergunta1 -> resposta1
=pergunta2 -> resposta2
=pergunta3 -> resposta3
}

Associe os seguintes países com suas respectivas capitais. {

=Canadá -> Ottawa
=Itália -> Roma
=Japão -> Tókio
=Índia -> Nova Deli
}

Pergunta de associação não suporta avaliação ou respostas com pesos porcentu-

ais.

Numérica
A secção de resposta para questões numéricas deve iniciar com o sinal (#). As
respostas numéricas podem incluir uma margem de erro, que é escrita após a
resposta correta, separada por uma vírgula. Assim, por exemplo, se a resposta
correta estiver entre 1.5 e 2.5, então deve-se escrever {#2:0.5}. Isto indica que
2 com uma margem de 0.5 está correto (isto é, um valor entre 1.5 e 2.5). Caso
não seja especificada a margem de erro, ela será assumida como zero.
 Quando nasceu Ulysses S. Grant? {#1822}

Qual é o valor de pi (até 3 casas decimais)? {#3.1415:0.0005}.

Opcionalmente, as respostas numéricas podem ser escritas como uma faixa no

seguinte formato {#ValorMínimo..ValorMáximo}.
Qual é o valor de pi (até 3 casas decimais)? {#3.141..3.142}.

A interface do navegador do Moodle não suporta respostas numéricas múlti-

plas, mas o código do Moodle pode e assim faz o GIFT. Isto pode ser usado
para especificar faixas múltiplas numéricas, e pode ser particularmente utilizá-
vel quando combinado com notas em pesos porcentuais. Se as respostas múlti-
plas forem utilizadas, elas devem estar separadas por um sinal de igual, como
nas perguntas com respostas breves.
Quando nasceu Ulysses S. Grant? {#
=1822:0
=%50%1822:2}

Note que desde que o navegador GUI do Moodle não suporta respostas múlti-
plas para questões numéricas, não há maneira de vê-las ou editá-las pelo Mo-
odle. A única maneira de alterar a resposta numérica além do primeiro, será
apagar a questão e reimportá-la (ou usar algo como phpMyAdmin).

Opções
Além destes três tipos de perguntas, este filtro oferece as seguintes opções:
1. comentários em linhas
2. nomes das perguntas
3. avaliação
4. notas com pesos porcentuais.

Comentários em linhas
Os comentários que não foram importados para o Moodle podem ser incluídos
no arquivo texto. Isto pode ser utilizado para prover cabeçalhos ou mais infor-
mações sobre as perguntas. Todas as linhas que se iniciarem com duas barras
(sem contar com tab ou espaço) serão ignoradas pelo filtro.
// Sub-título: Questões numéricas abaixo
Quanto são 2 mais 2? {#4}

Nome da pergunta
Um nome de pergunta pode ser especificado colocando-se no início e no final
dele duplos dois pontos.
 ::Origem do Kanji::Os caracteres japoneses originalmente
vêm de qual país? {=China}

::Data de ação de graças::O feriado americano de ação de graças é

celebrado na {~segunda ~terceira =quarta} quinta-feira de novembro.

Se nenhum nome da pergunta for especificado, a pergunta inteira será usado

como nome por default.

Avaliação
A avaliação pode ser incluída em cada resposta colocando-se após a resposta e
depois do sinal (# também conhecido como jogo da velha).
Qual é a resposta para esta pergunta de múltipla escolha?{
~resposta errada#comentário para a resposta errada
~outra resposta errada#comentário para a resposta errada
=resposta certa#Muito bem!}

Quem está enterrado na tumba de Grant?{

=nenhuma pessoa#Resposta excelente!
=ninguém#Resposta excelente!}

Grant está enterrado na tumba de Grant.{FALSO#Ninguém está enterrado

na tumba de Grant.}

Para perguntas de múltipla escolha, a avaliação é mostrada somente para a res-

posta que o estudante selecionou. Para resposta breve, a avaliação é mostrada
somente quando a entrada do estudante corresponde à resposta correta. Para
perguntas falso-verdadeiro, a avaliação importada é salva para que seja mostra-
do se o estudante escolheu a resposta errada. Assim, no último exemplo acima,
o estudante verá a avaliação somente se selecionar VERDADEIRO como res-
posta.

Respostas com pesos porcentuais

As notas com pesos porcentuais estão disponíveis para ambas as perguntas de
múltipla escolha e resposta breve. As respostas com pesos porcentuais podem
ser incluídas após o til (para múltipla escolha) ou sinal de igual (para resposta
breve) com o por cento desejado dentro de sinais de por cento (p. ex., %50%).
Esta opção pode ser combinada com os comentários de avaliação.
Pergunta difícil.{~resposta errada ~%50%resposta meia correta
=resposta totalmente correta}

::Cidade de Jesus::Jesus Cristo era de {

~Jerusalém#Foi uma importante cidade, mas a resposta está errada.
~%25%Belém#Ele nasceu aqui, mas não cresceu aqui.
~%50%Galiléia#Você precisa ser mais específico.
=Nazaré#Sim! Está correta!}.

::Cidade de Jesus:: Jesus Cristo era de {

 =Nazaré#Sim! Está correta!
=%75%Nazaret#Correto, mas escrito erradamente.
=%25%Belém#Ele nasceu aqui, mas não cresceu aqui.}

Note que os dois últimos exemplos são essencialmente a mesma pergunta, an-
tes como múltipla escolha e depois como resposta breve.
Note que é possível especificar pesos porcentuais para respostas que NÃO es-
tão disponíveis através da interface do navegador. Tais pesos serão calculados
corretamente (de acordo com o valor nomeado quando foi importado), e apare-
cerão normalmente aos estudantes fazendo o teste. Mas tais pesos não serão
mostrados corretamente aos professores quando editados através da interface
de Moodle para editar as questões. O menu pull-down somente permite certos
valores fixos, e se o peso não equivale exatamente a um destes valores pré-
determinados, então não será mostrado corretamente. Se você editar uma per-
gunta através da interface do navegador, o peso mudará para aquele mostrado.

Especificando a formatação do texto para a pergunta

O texto da pergunta (somente) pode ter especificado um formato de texto opci-
onal. Atualmente os formato disponíveis são moodle (formato automático do
Moodle), html (formato HTML), plain e markdown. O formato é especifica-
do entre colchetes imediatamente antes do texto da pergunta. Mais informações
nos formatos de texto no Moodle.
[markdown]O *Feriado americano de ação de graças* é celebrado na {
~segunda
~terceira
=quarta
} quinta-feira de novembro.

Respostas múltiplas
A opção de respostas múltiplas é utilizada para perguntas de múltipla escolha
quando duas ou mais respostas podem ser selecionadas para obter-se a nota to-
tal. A opção de múltiplas respostas está habilitada nomeando-se pesos parciais
para as múltiplas respostas, não permitindo-se receber a nota total para uma
simples resposta..
Quais pessoas estão sepultadas na tumba de Grant? {
~Ninguém
~%50%Grant
~%50%esposa de Grant
~pai de Grant }

Note que não há o sinal de igual (=) em qualquer resposta e as respostas devem
totalizar não mais do que 100%, caso contrário o Moodle retornará erro. Para
evitar que os estudantes recebam automaticamente 100% simplesmente che-
cando todas as respostas, é melhor incluir pesos negativos às respostas erradas.
 Quais pessoas estão sepultadas na tumba de Grant? {
~%-50%Ninguém
~%50%Grant
~%50%esposa de Grant
~%-50%pai de Grant }

Caracteres espec ~ = # { }
Estes símbolos ~ = # { } controlam a operação deste filtro e não podem ser uti-
lizados como texto normais dentro das perguntas. Desde que símbolos têm um
especial significado em determinadas operações deste filtro, eles podem ser
chamados de “caracteres de controle”. Mas algumas vezes você pode desejar
utilizar um destes caracteres, por exemplo para mostrar uma fórmula matemáti-
ca em uma pergunta. A maneira para contornar este problema é "escapando"
dos caracteres de controle. Isto significa colocar uma barra invertida (\) antes
do carácter de controle, assim o filtro saberá que você deseja utilizá-lo como
um carácter literal ao invés de carácter de controle. Por exemplo:
Qual resposta iguala 5? {
~ \= 2 + 2
= \= 2 + 3
~ \= 2 + 4 }

::Caracteres de controle GIFT::

Qual dos seguintes caracteres NÃO é um caracter de controle para o
formato de importação GIFT? {
~ \~ # \~ é um caracter de controle.
~ \= # \= é um caracter de controle.
~ \# # \# é um caracter de controle.
~ \{ # \{ é um caracter de controle.
~ \} # \} é um caracter de controle.
= \ # Correto! \ (barra invertida) não é um caracter de
controle. MAS,
é utilizado para escapar dos caracteres de controle.
}

Quando a pergunta é processada, a barra invertida é removida e não é salva no

Moodle.

Outras opções
As perguntas de resposta breve podem ser feitas "sensíveis a maiúsculas e mi-
núsculas" alterando-se "0" para "1" na seguinte linha:
$question->usecase = 0; // Ignore "case sensitive"

Outras opções estão disponíveis através da edição do filtro de importação

gift/format.php.
Créditos
Este filtro foi escrito através da colaboração de inúmeros membros da comuni-
dade Moodle. Foi originalmente baseado no formato de preenchimento, cujo
código foi incluído por Martin Dougiamas e Thomas Robb. Paul Tsuchido
Shew escreveu este filtro em dezembro de 2003 incorporando as sugestões da
comunidade para formatos mais robustos de perguntas. O nome foi concebido
como um acrônimo “General Import Format Technology” ou algo parecido,
mas muito longo para um filtro simples como este, assim usou-se GIFT.
Filtro GIFT e documentação by Paul Tsuchido Shew http://ac.shew.jp.
Última atualização em 27 Fev 2004.