On appellera item un ensemble d'informations se rapportant à une interrogation. Un item contiendra plusieurs lignes dont le nombre variera en fonction du type d'interrogation. Dans la version 2.20 il existe 6 types de question :
Quel que soit le type d'interrogation, les deux premières lignes seront toujours les mêmes :
Les autres lignes dépendront du type de question. Il pourra y avoir selon les cas, une proposition par ligne ou des listes de propositions. On appellera liste de propositions une ligne sur laquelle les propositions seront écrites les unes à la suite des autres et séparées entre elles par des virgules. Chaque type d'item répertoriera les lignes qui le composent. Le séparateur des différentes propositions étant la virgule, il est fondamental que celles-ci ne contiennent pas ce caractère.
Les différents éléments d'une liste possèdent implicitement un numéro qui sera immuable : ce sera le numéro d'ordre dans la liste. Pour la liste "Balzac,Emile Zola,Jean-Jacques Rousseau,Lamartine,Montaigne,Victor Hugo", les différents éléments auront les numéros suivants :
Les items seront séparés les uns des autres par une ligne vierge, une ligne blanche sans aucun caractère, hormis le code (invisible) produit par l'appui de la touche Entrée. Toutefois, il n'y aura pas de ligne vierge après le dernier item. En effet, la ligne vierge servant à séparer les items entre eux, le dernier item n'a pas besoin d'être séparé du suivant, inexistant. La dernière ligne du fichier qcm ne sera donc pas vierge. S'il y en avait une par erreur, cela ne provoquerait pas l'arrêt du script mais la classe d'objet compterait une question de plus qui ne serait pas affichée puisque l'item suivant n'aurait pas été rédigé mais qui pourrait fausser les résultats obtenus à cause du nombre erroné de questions. Bien que le nombre d'items ne soit pas limité, la limite sera ce qu'impose le raisonnable.
Voici à quoi pourrait ressembler un item dans le fichier questionnaire : NB: les lignes grisées commençant par # ou ; sont des commentaires et seront ignorées
# Catégorie: Culture (1). QCMRM ; TCP/IP : Paul BARAN, Larry ROBERTS ; HTML : Tim BERNERS-LEE ; Netscape : Marc ANDRESSEN, Jim CLARK 1;1;2,5;3; Parmi ces noms quels sont ceux qui ont participé à la création de TCP/IP Marc ANDRESSEN Paul BARAN Tim BERNERS-LEE Jim CLARK Larry ROBERTS
et à l'affichage :
Exemple de ligne "propriétés" : 1;4;1,3,4,7;2;mm;http://www.etc...
Il signifie: Type 0 (QCMRU), pas de catégorie, la bonne réponse est la 2ème proposition, pas de point (on compte les bonnes réponses, donc pas de pondération), pas de multimédia.
Il signifie: Type 1 (QCMRM), pas de catégorie, la bonne réponse ne sera pas prise en compte (c'est un questionnaire d'apprentissage), pas de point (on ne compte pas, donc pas de pondération), pas de multimédia, la page à afficher lors du clic sur "Apprendre" sera la page http://fr.wikipedia.org/wiki/Honoré_de_Balzac
Le type 0 est une Question à Choix Multiple et Réponse Unique (QCMRU)
En-tête: categories=Histoire,Mathématiques,Français,Sciences # QCMRU, catégorie : Mathématiques ; Euclide : géométrie, par deux points passe une droite et une seule ; Pythagore : dans un triangle rectangle, le carré de l'hypoténuse ... ; Thalès : les triangles semblables (théorème d'intersection) 0;2;3;1; Qui a établi le théorème d'intersection ? Euclide Pythagore Thalès
Les quatres premières lignes de l'item sont ici des commentaires. Ceux-ci peuvent servir au concepteur du test pour y placer ses notes, commentaires, objectif de la question, etc...
Une question de type Vrai/Faux n'est en fait qu'un QCMRU à deux propositions : Vrai et Faux
En-tête: categories=Histoire,Géographie,Français,Anglais #QCMRU, catégorie : Géographie ; Faux ; Belgique : 30528 km2, 11.116.243 ha (2012), Bruxelles ; Suisse : 41285 km2, 8.036.917 ha (2013), Berne 0;2;2;1; En superficie, la Belgique est plus grande que la Suisse. Vrai Faux
Lignes :
Le type 1 est une Question à Choix Multiple et Réponse Multiple (QCMRM). Plusieurs réponses peuvent donc être cochées.
En-tête: categories=Culture,Réseau,Protocoles,Logiciels # QCMRM, catégorie : Culture réseau ; TCP/IP : Paul BARAN, Larry ROBERTS ; HTML : Tim BERNERS-LEE ; Netscape : Marc ANDRESSEN, Jim CLARK 1;1;2,5;2; Parmi ces noms quels sont ceux qui ont participé à la création de TCP/IP Marc ANDRESSEN Paul BARAN Tim BERNERS-LEE Jim CLARK Larry ROBERTS
Le type 2 est une question dans laquelle il faut trier des éléments (TRI)
En-tête: categories=Histoire,Mathématiques,Français,Sciences # TRI, catégorie : Histoire ; 30/05/1431 : Jeanne d'Arc brûlée vive à Rouen ; 22/09/1499 : Signature du traité de Bâle ; 14/09/1515 : Bataille de Marignan ; 13/04/1598 : Signature de l'Edit de Nantes 2;1;3,4,1,2;2; Classez ces évènements dans l'ordre chronologique (1 = le plus ancien) Bataille de Marignan,Edit de Nantes,Jeanne d'Arc brûlée à Rouen,Signature du traité de Bâle
Le type 3 est une question dans laquelle il faut associer des éléments (Appariement)
En-tête: categories=Mathématiques,Littérature,Sciences,Musique # ASSO, catégorie : Littérature 3;2;5,6,3,2;1; Associez les titres suivants avec leurs auteurs respectifs Les essais,Les misérables,Les rêveries du promeneur solitaire,Les Rougon-Macquart Balzac,Emile Zola,Jean-Jacques Rousseau,Lamartine,Montaigne,Victor Hugo
Pour éviter que le hasard "fasse bien les choses", et donc pour mieux vérifier les connaissances, il est utile de placer des distracteurs. On appelle distracteurs les éléments qui ne seront pas associés aux autres. Dans l'exemple cité ci-dessus, Balzac et Lamartine seraient les distracteurs.
Le type 4 est une question dans laquelle il faut, grâce à un choix proposé, compléter une proposition (Complétion).Par défaut, le caractère | marquera le point d'insertion de la liste d'éléments proposés. Si nécessaire, ce caractère d'insertion peut être changé dans l'en-tête grâce à la clef insertpoint
En-tête: categories=Culture,Logiciels,Protocoles,Ports # COMP, catégorie : Protocoles réseau 4;4;2;1; Sélectionnez dans la liste la bonne réponse Un serveur | attend les requêtes sur le port 3306 FTP,MySQL,POP,PostgreSQL,SMTP,Web
Le type 5 est une Question à Réponse Ouverte Courte (QROC). Elle est ouverte dans la mesure où il n'y a pas de proposition.La zone de saisie et sa longueur seront définis par deux caractères d'insertion (ou celui défini dans l'en-tête à la clef insertpoint) entre lesquels un chiffre ou un nombre représentera la longueur de celle-là.
En-tête: categories=Mathématiques,Littérature,Sciences,Musique # QROC, catégorie : Littérature 5;2;laboureur;1; Complétez ce vers de Jean de La Fontaine Un riche |8|, sentant sa mort prochaine, ...
Il est possible de proposer un texte ou un mot dans la zone de saisie. Dans ce cas, placer ce mot ou ce texte entre les deux caractères d'insertion et après une virgule placée derrière le chiffre indiquant la longueur de la zone. Attention ! Ce mot disparaîtra automatiquement lorsqu'on placera la curseur dans cette zone.
En-tête: categories=Grammaire,Sciences,Mathématiques,Musique # QROC, catégorie : Grammaire 5;1;geignaient;1; Mettre le verbe à l'imparfait de l'indicatif : Parmi les vieux ormes de l'allée, certains |8,geindre| comme de malades (R. Escholier)
Un item sera dit "multimédia" s'il doit afficher une image, un son ou une vidéo dans la question ou dans les propositions qui seront faites. Si c'est le cas, le cinquième champ des propriétés de l'item contiendra l'indication "mm" pour préciser à la classe PHP qu'il y aura des documents spéciaux à afficher.
Le son à jouer peut être un fichier mp3 ; la vidéo à afficher peut-être une vidéo se trouvant sur YouTube, sur Dailymotion ou même vos propres vidéos pour peu qu'elles soient au format flv (Flash Vidéo). Si ce n'est pas le cas, vous pouvez convertir votre vidéo au format flv en utilisant l'excellent freeware FormatFactory.
On remplacera les points de suspension ci-dessus par la référence du document multimédia. La référence pourra être faite soit en indiquant son identifiant YouTube ou Dailymotion soit en indiquant le nom du fichier.
Exemple de vidéo Youtube (La partie de cartes) : http://www.youtube.com/watch?v=w8rXPeB8-DY ; l'identifiant est : w8rXPeB8-DYVous aurez à indiquer : <#yt w8rXPeB8-DY #>
Exemple de vidéo Dailymotion (Le Schpountz) : http://www.dailymotion.com/video/x8434s_schpountz-2-pagnol-fernandel_shortfilms ; L'identifiant est : x8434s_schpountz-2-pagnol-fernandel_shortfilmsVous aurez à indiquer : <#dm x8434s_schpountz-2-pagnol-fernandel_shortfilms #>
Pour ce qui concerne les documents multimédia au format flv ou mp3, il suffira d'indiquer le nom du fichier (sans espace) s'il se trouve dans le même répertoire que le fichier qcm, ou son URL s'il se trouve sur une autre machine du réseau.
Enfin pour ce qui concerne l'insertion d'image, vous pouvez utiliser l'insertion simplifiée comme indiqué ci-dessus ou, pour ceux qui connaissent, la balise normale d'insertion d'image : <img src="nom-du-fichier-image.jpg">. Mais dans ce dernier cas (pour les images seulement), puisque vous prenez en charge vous-même l'écriture "normale" d'insertion des images, ce n'est pas la peine de demander à QCM Class de le faire à votre place. Vous n'avez donc pas à préciser le "mm" pour préciser à QCM Class qu'il y aura des documents multimédia, puisque vous l'avez fait à sa place.
Exemples : <#flv idontwantalover.flv #> <#mp3 http://www.qcmclass.fr/demos/chris-barber_hushabye.mp3 #>
Par ailleurs, si vous voulez afficher des fichiers flv, vous aurez besoin d'un player vidéo : dewtube.swf et si vous voulez jouer des fichiers audio mp3, vous aurez besoin d'un player audio : dewplayer.swf. Ils sont à placer, l'un, l'autre ou les deux selon vos besoins, sur le serveur dans le même répertoire que le fichier qcm.
Ces deux players sont disponibles en téléchargement dans le choix "Téléchargements" du menu ou sur le site original Alsacréations aux URLs suivantes : http://www.alsacreations.fr/dewtube.html et http://www.alsacreations.fr/dewplayer.html
Multimédia ou non, les items, quel qu'en soit le type, devront être rédigés selon des indications précédemment indiquées. Toutefois les documents multimédia (images, sons ou vidéos) ne pourront être placés que dans la question ou la consigne à respecter (2ème ligne) ainsi que dans les propositions fixes mais ne pourront pas être insérés dans les listes déroulantes
3;;4,3;1;mm Associez les musiques ci-dessous avec leurs auteurs respectifs <#mp3 k265.mp3 #>,<#mp3 tishomingo.mp3 #> Louis Armstrong,Jean-Sebastien Bach,Chris Barber,Wolfgang Amadeus Mozart,Johan Pachelbel
1;;3,5;1;mm Cochez les interprètes présents sur cet extrait d'Hôtel du Nord<br/><#yt JRn_EftE-r8 #> Charles Dullin Raimu Louis Jouvet Rina Ketty Léonie Bathiat
Un petit détail sur le player vidéo dewtube.swf : si, dans le même répertoire se trouvent un fichier vidéo flv et un fichier image de même nom (mais bien sûr avec des extensions différentes) et de mêmes dimensions, l'image sera affichée à l'emplacement de la vidéo et un clic sur cette image la fera disparaître en démarrant la vidéo. C'est le cas pour l'exemple suivant. Il y a la video idontwantalover.flv et l'image idontwantalover.jpg. Dimensions vidéo et image : 384 x 288. Comme dans l'exemple ci-dessous, l'image peut alors représenter la question elle-même.
0;;4;1;mm Répondez à la question ci-dessous en démarrant la vidéo puis en cochant la case appropriée<br/><#flv idontwantalover.flv #> ABBA ACDC Indochine Texas The Corrs
categories=Mathématiques,Sciences,Français,Histoire ... 0;1;2;1;mm <#img courbes.png #><br/>La fonction ayant un Δ > 0 est repésentée par la courbe Jaune Bleue Magenta
Pour une vidéo, on appelle ratio le rapport réduit entre la largeur et la hauteur. Que les dimensions de la vidéo soient 400x300, 800x600, 40x30 le rapport entre ces deux dimensions, une fois simplifié, réduit, sera le même : 4/3. On dira que le ratio est de 4:3. Les dimensions différentes ne sont que des homothéties (agrandissements ou réductions qui conservent le même ratio).
Les vidéos placées sur Youtube ou Dailymotion sont en général au ratio 4:3. C'est la raison pour laquelle QCM Class affiche par défaut les vidéos au ratio 4:3 avec des dimensions 384x288. Si les vidéos que vous avez à utiliser sont à ce ratio là et que ces dimensions vous conviennent vous n'avez rien d'autre à préciser et l'indicateur d'un item contenant des documents multimédia sera -;-;-;-;mm
Vous pouvez utiliser vos propres vidéos flv et celles-ci peuvent avoir un ratio différent : 5:4, 4:3, 3:2 ou encore 16:9. Si dans un même questionnaire, toutes les vidéos sont au même ratio, vous pouvez, selon celles que vous utilisez, modifier les clefs youtube, dewtube ou dailymotion de l'en-tête en indiquant les valeurs des dimensions de vos vidéos :
youtube=700,420 dailymotion=500,400 dewtube=320,180
En revanche, si dans le même questionnaire vous utilisez des vidéos qui ont des ratios différents, il vous suffira de le préciser dans l'item affichant la vidéo au ratio différent, derrière l'indicateur de document multimédia. Le format est le suivant :
Attention : Il vous revient d'indiquer les valeurs adéquates à vos vidéos. Si vous utilisez des dimensions qui ne sont pas en rapport avec le ratio de leurs vidéos, Youtube ou Dailymotion feront une homothétie et ajouteront des marges latérales plus ou moins larges pour conserver le ratio de la video qu'ils envoient.
En revanche, grâce au player vidéo dewtube vous pourrez afficher les vidéos avec les dimensions exactes que vous voulez. Toutefois, il n'y aura pas d'homothétie mais déformation. Choisissez-les donc avec soin.
Exemple d'item multimédia affichant une vidéo avec un ratio différent de 4:3
En-tête: categories=Mathématiques,Italien,Sciences,Musique # QROC, catégorie : Italien ; Tiré du film : Dio come ti amo ! ; Objectif : suivre et comprendre une conversation ou une chanson ; rondine: hirondelle ; rondini: hirondelles 5;2;rondini;1;mm:460x276 <#flv diocometiamo.flv #> Gigliola Cinquetti evoca le |10| in questa canzone
Toutefois, les modifications de tailles n'auront aucun effet sur le player audio dewplayer ni sur les images qui resteront à leurs dimensions d'origine.
