| libre.moodle {SARP.moodle} | R Documentation |
Créer une question libre (« cloze », texte à compléter)
Description
Cette fonction permet de créer une question dont le format est libre, qui se présente sous forme d'un texte à trous — format dit « cloze ».
Usage
question_libre.moodle( texte.intro, textes.avant, texte.final,
reponses, notes = NULL, types = NULL,
commentaires = NULL,
titre = "Question libre",
commentaire.global = NA,
penalite = NA, note.question = NA, idnum = NA,
temps,
fichier.xml = get( "fichier.xml",
envir = SARP.Moodle.env ) )
Arguments
texte.intro |
L'introduction de la question (une chaîne de caractères). Cet énoncé peut contenir n'importe quel caractère (codage en UTF-8) et n'importe quelles balises HTML. Il se trouvera au tout début de la question. |
textes.avant |
Un vecteur de chaîne de caractères. À chaque
élément de ce vecteur sera associé un champ de réponse, qui sera
précédé du texte contenu dans cette chaîne de caractères. Ces
textes peuvent contenir n'importe quel caractère (codage en UTF-8) et
n'importe quelles balises HTML. Le nombre d'éléments du vecteur
doit être égal au nombre d'éléments de |
texte.final |
Le texte qui doit se placer après le dernier champ de réponse de la question. Il peut contenir n'importe quel caractère (codage en UTF-8) et n'importe quelles balises HTML. |
reponses |
Une liste dont chaque élément décrit la ou les
réponses attendues pour chaque « trou » du texte. Le nombre d'éléments
de cette liste définit le nombre de champs réponses dans la question
et doit être égal à la longueur du vecteur |
notes |
Le vecteur des notes associées à chaque réponse. S'il
est fourni, il doit être de même longueur que |
types |
Le vecteur des types de champ réponse. S'il est fourni,
il doit être de même longueur que |
commentaires |
Une liste de commentaires associés aux réponses
de chaque champ réponse. Si elle est fournie, elle doit être de même
longueur que |
titre |
L'intitulé de la question, en HTML. |
commentaire.global, penalite, note.question, idnum |
Options
communes à toutes les questions Moodle, voyez
|
temps |
Le temps conseillé pour répondre à la question, en minutes. |
fichier.xml |
Le fichier correspondant au questionnaire qui contiendra cette question (par défaut, le dernier créé). |
Details
Cette fonction construit, à partir des éléments fournis, une question de type « cloze » : un texte à trous, les réponses étant à entrer dans les trous ou à choisir dans une liste. C'est donc une suite de « champs réponses », séparés par des textes.
Chaque champ réponse est défini par la ou les réponses possibles, son type, sa note et éventuellement les commentaires renvoyés à l'étudiant en fonction de ses réponses. Ces informations sont obtenues à partir des paramètres ci-dessus, le i-ème élément étant utilisé pour le i-ème champ réponse.
Le type NUMERICAL correspond à un champ attendant une réponse
numérique — c'est l'équivalent d'une question numérique. Une ou
plusieurs réponses sont possibles, qui seront de bonnes réponses, mais
pas forcément donnant toute tous les points. Les réponses sont à
fournir sous la forme d'une liste comportant un vecteur des valeurs,
nommé Valeur et un vecteur des tolérances associées, nommé
Tolerance.
Les types MULTICHOICE, MULTICHOICE_V,
MULTICHOICE_H, MULTICHOICE_S, MULTICHOICE_VS,
MULTICHOICE_HS, MULTIRESPONSE, MULTIRESPONSE_S,
MULTIRESPONSE_S, MULTIRESPONSE_HS, SHORTANSWER et
SHORTANSWER_C correspondent à un champ permettant de choisir
(cocher) une ou plusieurs réponses dans une liste prédéfinie — c'est
l'équivalent d'un QCM. Tous ces types fonctionnent de façon similaire,
seuls la façon d'afficher la question et le nombre de réponses
sélectionnables varient (voyez le tableau récapitulatif ci-dessous).
Dans tous les cas, reponses doit contenir pour ces champs une
liste de deux éléments, l'un contenant le vecteur des textes des
réponses (élément nommé Textes), le second indiquant pour chaque
texte s'il correspond à une réponse correcte (TRUE) ou non
(FALSE). S'il y a plusieurs réponses correctes, chacune donne
une fraction égale des points. Pour préciser la note de chaque réponse,
placez dans la liste un élément nommé Notes, contenant le
vecteur des notes de chaque réponse (ces notes doivent être exprimées
en pourcentage de la note, arrondi à l'entier le plus proche, parmi les
valeurs autorisées par Moodle) ; dans ce cas, l'élément Correct
est ignoré et peut être omis. Les commentaires de chaque réponse sont
à donner dans un vecteur de même longueur que reponses$Textes;
utilisez NA pour une réponse sans commentaire.
| Code | Disposition | Remarque |
MULTICHOICE | Menu déroulant | Une seule réponse possible |
MULTICHOICE_V | Série de boutons radio verticaux | Une seule réponse |
MULTICHOICE_H | Série de boutons radio horizontaux | Une seule réponse |
MULTIRESPONSE | Série de cases à cocher verticales | Plusieurs réponse possibles |
MULTICHOICE_H | Série de cases à cocher horizontales | Plusieurs réponses possibles |
SHORTANSWER | Champ de texte libre | sensible à la casse |
SHORTANSWER_C | Champ de texte libre | insensible à la casse |
Les variantes avec le suffixe S conduisent à un ordre des réponses tiré au sort par Moodle lors de l'affichage de la question.
Une fois le texte complet de la question créé, au format « cloze », à
partir de ces éléments, la question est créée grâce à la fonction
question.moodle.
Value
Aucune valeur n'est renvoyée par cette fonction.
Author(s)
Emmanuel Curis emmanuel.curis@parisdescartes.fr
See Also
numerique.moodle, qcm.moodle,
qroc.moodle, question_ouverte.moodle, vrai_faux.moodle
Examples
## Not run:
# Commencer un nouveau questionnaire
q <- debuter_xml.moodle( "exemple.libre" )
# Catégorie : exemples
categorie.moodle( "Exemples SARP/Question libre" )
# Une question Moodle libre avec champs numériques
question_libre.moodle( "Indiquez les chiffres du nombre 1974.",
list( "Unité : ", " — dizaine : ",
" — centaine : ", " — milliers : " ), ".",
reponses = list( 4, 7, 9, 1 ) )
# Avec un champ numérique et des champs à choix multiples
question_libre.moodle( "<cite>Le Corbeau et le Renard</cite>.",
list( "<i>Maître ",
" sur son arbre perché<br />Tenait en son bec un ",
".<br />Maître ",
paste0( "</i>par l'odeur alléché<br />...",
"<br />est un poème composé en " ) ),
" par le poète Jean de la Fontaine.",
types = c( "MULTICHOICE", "MULTICHOICE_H",
"SHORTANSWER", "NUMERICAL" ),
reponses = list( list( "Textes" = c( "Renard", "Goupil",
"Corbeau", "Corneille" ),
"Correct" = c( FALSE, FALSE, TRUE, FALSE ) ),
list( "Textes" = c( "Fromage", "Camembert",
"Bleu", "Livre" ),
"Correct" = c( TRUE, FALSE, FALSE, FALSE ) ),
list( "Textes" = c( "Renard", "Goupil",
"Corbeau", "Corneille" ),
"Correct" = c( TRUE, FALSE, FALSE, FALSE ) ),
1668 ) )
# On termine le questionnaire
finir_xml.moodle( )
# Importez le fichier exemple.libre.xml dans Moodle pour voir le résultat...
print(
"Importez le fichier exemple.libre.xml dans Moodle pour voir le r\u00e9sultat..." )
## End(Not run)