messages: Aide aux affichages dans les textes des questions
In SARP.moodle: XML Output Functions for Easy Creation of Moodle Questions

messages.moodle

R Documentation

Aide aux affichages dans les textes des questions

Description

Ces fonctions permettent de créer une chaîne de caractère au format HTML, pour des messages courant d'indication dans les questions.

Usage

temps_necessaire.moodle( temps, couleur = getOption( "Sm.temps_couleur" ),
                         nv.ligne = TRUE,
                         masque = getOption( "Sm.temps_masque" ) )

Arguments

`temps`	Le temps conseillé pour la question. Ce peut être un nombre, le temps est alors supposé exprimé en minutes, ou une chaîne de caractères à un format de temps classique (par exemple 45s, 2'30...).
`couleur`	La couleur à utiliser pour le message. N'importe quelle couleur reconnue en CSS peut être utilisée. Par défaut, utilise la valeur dans l'option `Sm.temps_couleur` (qui correspond à une consigne en bleue si elle n'est pas modifiée).
`nv.ligne`	Si `TRUE`, le message est précédé d'un retour à la ligne (balise HTML `<br />`).
`masque`	Le masque à utiliser pour la consigne indiquant le temps nécessaire; dans ce masque, le code `#T` sera remplacé par le temps construit. Par défaut, utilise la valeur dans l'option `Sm.temps_masque` (qui correspond à “Temps conseillé pour répondre : <b>#T</b>”).

Details

Ces fonctions sont utilisées par les fonctions générant les questions classiques pour ajouter des consignes en fin d'énoncé. Elles peuvent être utilisées directement pour davantage de souplesse.

Le message créé par temps_necessaire.moodle est par défaut “Temps conseillé pour cette question : x min y s”, où x et y sont construits à partir du temps indiqué en minutes (par exemple, si temps=1.5, x=1 et y=30). Pour les questions classiques, il correspond à l'option temps. Ce message peut être modifié grâce à l'option Sm.temps_masque, qui doit contenir une chaîne de caractère. Dans cette chaîne, #T sera remplacé par “x min y s”.

Value

Ces fonctions renvoient une unique chaîne de caractères, en HTML, prête à être intégrée dans un énoncé.

Author(s)

Emmanuel Curis emmanuel.curis@parisdescartes.fr

Examples

  # Indication d'un temps conseillé de 2 min 30
  temps_necessaire.moodle( 2.5 )

  # Indication d'un temps conseillé de 10 secondes
  temps_necessaire.moodle( "10s" )

SARP.moodle documentation built on June 25, 2025, 5:09 p.m.