SARP.moodle (version 1.2.3)

categorie.moodle: Créer une catégorie de questions

Description

Cette fonction permet de créer une nouvelle catégorie de questions dans le questionnaire XML.

Usage

categorie.moodle( nom.categorie, autoriser.dollar = FALSE,
                  temps = NULL,
                  fichier.xml = get( "fichier.xml", envir = SARP.Moodle.env ) )

Value

Aucune valeur n'est renvoyée par cette fonction.

Arguments

nom.categorie

Le nom de la catégorie. Il est possible de donner une hiérarchie de catégories, en utilisant la barre oblique (/) comme séparateur des différents niveaux --- comme dans un chemin incluant des dossiers.

autoriser.dollar

Le dollar ($) est un caractère réservé, qui permet d'ancrer les catégories dans les divers cours. Pour éviter des difficultés, les dollars sont donc remplacés par des soulignés (_). Cette conversion peut être désactivée en indiquant TRUE pour cette option.

temps

Le temps conseillé pour répondre aux questions de la catégorie. Ce temps sera utilisé pour toutes les questions créées jusqu'au prochain appel de cette fonction, si aucun temps conseillé n'est indiqué lors de l'appel à la fonction créant la fonction.

fichier.xml

Le fichier correspondant au questionnaire qui contiendra cette question (par défaut, le dernier créé).

Author

Emmanuel Curis

Attention

Les catégories ne seront prises en compte que si l'option correspondante est cochée lors de l'import du fichier (case « Obtenir la catégorie à partir du fichier »)

Details

La catégorie proposée est toujours intégrée dans le cours actuel, en ajoutant $course$ en début de hiérarchie.

Pour éviter des sous-catégories sans nom, les séparateurs multiples sont simplifiés en un seul séparateur et ceux en fin de nom de catégorie sont supprimés. Si vous voulez vraiment des sous-catégories sans nom visible, utilisez des espaces entre les séparateurs ou après le dernier.

Examples

if (FALSE) {
# Commencer un nouveau questionnaire
q <- debuter_xml.moodle( "exemple.categorie" )

# Catégorie des questions numériques pour les exemples de cette documentation
categorie.moodle( "Exemples SARP/Numériques" )
numerique.moodle( "Combien vaut 1 + 1 ?", 2 )
numerique.moodle( "Combien vaut 1 × 1 ?", 1 )
numerique.moodle( "Combien vaut 1 + 1 en binaire ?", 10 )

# Catégorie des QROC pour les exemples de cette documentation
categorie.moodle( "Exemples SARP/QROC" )
qroc.moodle( "Comment s'appelle cette bibliothèque ?", "SARP.Moodle" )

# On termine le questionnaire
finir_xml.moodle( )

# Importez le fichier exemple.categorie.xml dans Moodle pour voir le résultat...
print(
"Importez le fichier exemple.categorie.xml dans Moodle pour voir le résultat..." )
}