1 | <?xml version="1.0" encoding="UTF-8"?>
|
2 | <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
3 | "/usr/share/xml/docbook/schema/dtd/4.5/docbookx.dtd">
|
4 | <article lang="fr">
|
5 | <title>Auto Multiple Choice</title>
|
6 |
|
7 | <articleinfo>
|
8 | <title>Auto Multiple Choice</title>
|
9 |
|
10 | <subtitle>Conception et correction automatisée de QCM.</subtitle>
|
11 |
|
12 | <abstract>
|
13 | <para>AMC est un ensemble d'utilitaires permettant l'utilisation de QCM
|
14 | rédigés en texte simple ou en LaTeX et leur correction automatique à
|
15 | partir des scans des copies des étudiants, grâce à une reconnaissance
|
16 | optique de marques (OMR). Le présent document décrit son utilisation
|
17 | (pour la version @/PACKAGE_V_DEB/@~svn @/PACKAGE_V_SVN/@).</para>
|
18 |
|
19 | <para>Le projet AMC est hébergé par <ulink
|
20 | url="http://gna.org/">Gna !</ulink> : vous retrouverez son site internet
|
21 | à l'adresse <ulink
|
22 | url="http://home.gna.org/auto-qcm/">http://home.gna.org/auto-qcm/</ulink>,
|
23 | et la page d'hébergement du projet à l'adresse <ulink
|
24 | url="https://gna.org/projects/auto-qcm/">https://gna.org/projects/auto-qcm/</ulink>.</para>
|
25 | </abstract>
|
26 |
|
27 | <author>
|
28 | <firstname>Alexis</firstname>
|
29 |
|
30 | <affiliation>
|
31 | <address><email>paamc@passoire.fr</email></address>
|
32 | </affiliation>
|
33 |
|
34 | <surname>Bienvenüe</surname>
|
35 | </author>
|
36 |
|
37 | <othercredit>
|
38 | <surname>Abel</surname>
|
39 |
|
40 | <firstname>Benjamin</firstname>
|
41 |
|
42 | <contrib>Paragraphes concernant l'usage de tikz et de
|
43 | lualatex.</contrib>
|
44 | </othercredit>
|
45 |
|
46 | <copyright>
|
47 | <year>2008-2012</year>
|
48 |
|
49 | <holder>Alexis Bienvenüe</holder>
|
50 | </copyright>
|
51 |
|
52 | <legalnotice>
|
53 | <para>Ce document peut être utilisé selon les termes de la Licence
|
54 | publique générale de GNU version 2 ou suivante.</para>
|
55 | </legalnotice>
|
56 | </articleinfo>
|
57 |
|
58 | <sect1>
|
59 | <title>Licence</title>
|
60 |
|
61 | <para>Le programme Auto Multiple Choice est un logiciel libre ; vous
|
62 | pouvez le redistribuer ou le modifier suivant les termes de la “GNU
|
63 | General Public License” telle que publiée par la Free Software
|
64 | Foundation : soit la version 2 de cette licence, soit (à votre gré) toute
|
65 | version ultérieure.</para>
|
66 |
|
67 | <para>Ce programme est distribué dans l’espoir qu’il vous sera utile, mais
|
68 | SANS AUCUNE GARANTIE : sans même la garantie implicite de
|
69 | COMMERCIALISABILITÉ ni d’ADÉQUATION À UN OBJECTIF PARTICULIER. Consultez
|
70 | la Licence Générale Publique GNU pour plus de détails. Vous devriez avoir
|
71 | reçu une copie de la Licence Générale Publique GNU avec ce programme ; si
|
72 | ce n’est pas le cas, consultez : <ulink
|
73 | url="http://www.gnu.org/licenses/">http://www.gnu.org/licenses/</ulink>.</para>
|
74 | </sect1>
|
75 |
|
76 | <sect1 id="prerequis">
|
77 | <title>Prérequis</title>
|
78 |
|
79 | <sect2>
|
80 | <title>Système d'exploitation</title>
|
81 |
|
82 | <para>Les utilitaires AMC sont pour l'instant écrits pour Linux. Ils
|
83 | devraient pouvoir être adaptés à MAC OS X ou Windows sans trop de
|
84 | difficulté, mais je n'ai pas prévu de le faire dans un avenir proche.
|
85 | N'hésitez pas à me contactez si vous souhaitez le faire : j'essayerai de
|
86 | vous aider et j'intègrerai les changements nécessaires dans AMC.</para>
|
87 | </sect2>
|
88 |
|
89 | <sect2>
|
90 | <title>Logiciels</title>
|
91 |
|
92 | <note>
|
93 | <para>Si vous installez AMC à l'aide d'un paquet debian (sur une
|
94 | distribution debian, ubuntu ou dérivés) ou RPM (distribution Mandriva,
|
95 | openSUSE, Fedora), tout ce dont AMC a besoin sera automatiquement
|
96 | installé.</para>
|
97 | </note>
|
98 |
|
99 | <para>Les paquets/logiciels principaux requis pour l'utilisation d'AMC
|
100 | sont les suivants :</para>
|
101 |
|
102 | <itemizedlist>
|
103 | <listitem>
|
104 | <para>LaTeX</para>
|
105 | </listitem>
|
106 |
|
107 | <listitem>
|
108 | <para>ImageMagick</para>
|
109 | </listitem>
|
110 |
|
111 | <listitem>
|
112 | <para>Perl, ainsi que Gtk2-Perl et Glade::XML pour l'interface
|
113 | graphique</para>
|
114 | </listitem>
|
115 | </itemizedlist>
|
116 |
|
117 | <sect3>
|
118 | <title>Versions conseillées pour les logiciels utilisés par
|
119 | AMC</title>
|
120 |
|
121 | <para>Quelques anciens bugs des logiciels utilisés par AMC sont
|
122 | particulièrement préjudiciables à son bon fonctionnement :</para>
|
123 |
|
124 | <itemizedlist>
|
125 | <listitem>
|
126 | <para>Avec d'anciennes versions de <package>Net::CUPS</package>
|
127 | (paquet debian <package>libnet-cups-perl</package>), la demande
|
128 | d'impression du sujet provoque la fermeture prématurée de toute
|
129 | l'interface graphique d'AMC. Ce bug a été corrigé à partir de la
|
130 | version 0.61 de <package>Net::CUPS</package>.</para>
|
131 | </listitem>
|
132 |
|
133 | <listitem>
|
134 | <para>Avec d'anciennes versions de ImageMagick, le regroupement
|
135 | des pages corrigées en un fichier PDF par étudiant ne fonctionne
|
136 | pas dans le cas où ces copies comprennent plusieurs pages. Ce bug
|
137 | a été corrigé à partie de la version 6.5.5 de ImageMagick.</para>
|
138 | </listitem>
|
139 | </itemizedlist>
|
140 | </sect3>
|
141 | </sect2>
|
142 |
|
143 | <sect2>
|
144 | <title>LaTeX</title>
|
145 |
|
146 | <para>À parti de la version 1.1.0 d'AMC, il n'est plus nécessaire de
|
147 | rédiger ses sujets de QCM en LaTeX (voir <xref linkend="AMC-TXT"/>).
|
148 | Cependant, ceci est toujours possible et permet une extraordinaire
|
149 | liberté dans la conception des sujets. Par ailleurs, les modèles fournis
|
150 | permettent à ceux qui ne sont pas réfractaires aux formats de documents
|
151 | du type LaTeX/XML/HTML d'écrire assez rapidement leurs premiers
|
152 | formulaires en LaTeX.</para>
|
153 | </sect2>
|
154 | </sect1>
|
155 |
|
156 | <sect1 id="notesutilisation">
|
157 | <title>Notes d'utilisation</title>
|
158 |
|
159 | <sect2>
|
160 | <title>Limitations numériques</title>
|
161 |
|
162 | <para>Dans la version actuelle (à partir de la version 0.156), le nombre
|
163 | de copies est limité à 4095 et le nombre de pages par copies est limité
|
164 | à 63.</para>
|
165 |
|
166 | <para>Le nombre de réponses proposées pour une même question est limité
|
167 | à 199.</para>
|
168 |
|
169 | <para>Par ailleurs, les limitations de LaTeX pourront bloquer la
|
170 | compilation avant ces limites (erreur du type « <errortext>No room for a
|
171 | new \toks</errortext> »). Dans ce cas, essayez en utilisant le package
|
172 | <package>etex</package>, grâce à la commande
|
173 | <code>\usepackage{etex}</code>.</para>
|
174 | </sect2>
|
175 |
|
176 | <sect2>
|
177 | <title>Versions</title>
|
178 |
|
179 | <para>Même si cela ne devrait pas avoir trop de conséquences, il vaut
|
180 | mieux essayer de ne pas changer de version du programme en cours
|
181 | d'utilisation pour un projet donné (entre le moment où les copies sont
|
182 | imprimé et le moment où les notes sont calculées et les copies
|
183 | annotées). Il existe quelques modifications qui risquent de perturber le
|
184 | fonctionnement d'AMC si vous les appliquez au cours de la gestion d'un
|
185 | projet :</para>
|
186 |
|
187 | <itemizedlist>
|
188 | <listitem>
|
189 | <para>Si vous avez compilé et imprimé un sujet avec une version
|
190 | d'AMC égale ou inférieure à 0.155, et que vous continuez la gestion
|
191 | du projet avec la version 0.156 ou postérieure, ajoutez l'option
|
192 | <option>versionA</option> dans l'appel au paquet
|
193 | <package>automultiplechoice</package> dans le fichier LaTeX. Exemple
|
194 | :</para>
|
195 |
|
196 | <programlisting>\usepackage[bloc,completemulti,versionA]{automultiplechoice}</programlisting>
|
197 | </listitem>
|
198 |
|
199 | <listitem>
|
200 | <para>À partir de la version 0.262, le dessin des cases à cocher est
|
201 | différent, légèrement plus gros, ce qui risque de modifier la
|
202 | disposition de vos sujets.</para>
|
203 | </listitem>
|
204 |
|
205 | <listitem>
|
206 | <para>À partir de la version 0.267, si vous souhaitez produire vos
|
207 | sujets en format A4, vous devez l'indiquer explicitement dans le
|
208 | sujet LaTeX :</para>
|
209 |
|
210 | <programlisting>\documentclass[a4paper]{article} </programlisting>
|
211 | </listitem>
|
212 |
|
213 | <listitem>
|
214 | <para>À partir de la version 0.345, les commandes
|
215 | <command>\AMCformulaireQuestion</command> et
|
216 | <command>\AMCformulaireReponse</command> ont été renommées
|
217 | respectivement <command>\AMCformQuestion</command> et
|
218 | <command>\AMCformAnswer</command>.</para>
|
219 | </listitem>
|
220 |
|
221 | <listitem>
|
222 | <para>À partir de la version 0.394, vous devez indiquer
|
223 | explicitement si vous utilisez le paquet LaTeX
|
224 | <package>graphicx</package> (dans les versions précédentes, il était
|
225 | chargé par AMC).</para>
|
226 | </listitem>
|
227 |
|
228 | <listitem>
|
229 | <para>La commande <command>\AMCcode</command> a été réécrite au
|
230 | passage à la version 0.518. La nouvelle version est plus propre et
|
231 | mieux configurable, mais vous aurez sans doute à adapter légèrement
|
232 | votre code LaTeX pour que le résultat reste semblable.</para>
|
233 | </listitem>
|
234 |
|
235 | <listitem>
|
236 | <para>À partir de la version 1.1.0, le stockage de toutes les
|
237 | informations manipulées par AMC se fait dans des bases de données
|
238 | SQLite, au lieu des multiples fichiers XML utilisés par les versions
|
239 | précédentes. Lors de l'ouverture d'un projet créé par une version
|
240 | antérieure, AMC transforme toutes ces données dans le nouveau
|
241 | format, mais conserve les anciens fichiers XML.</para>
|
242 | </listitem>
|
243 | </itemizedlist>
|
244 | </sect2>
|
245 |
|
246 | <sect2>
|
247 | <title>Installation</title>
|
248 |
|
249 | <para>Sur un système debian ou Ubuntu ou dérivés, Mandriva, openSUSE ou
|
250 | Fedora, l'installation est facilitée par l'utilisation des paquets deb
|
251 | et RPM contenant AMC. La procédure d'installation est décrite sur le
|
252 | <ulink url="http://home.gna.org/auto-qcm/download">site
|
253 | d'AMC</ulink>.</para>
|
254 |
|
255 | <para>Vous pouvez aussi télécharger l'archive des sources dans l'<ulink
|
256 | url="http://download.gna.org/auto-qcm/">espace de téléchargement</ulink>
|
257 | du projet, puis utiliser les commandes suivantes dans un
|
258 | terminal :</para>
|
259 |
|
260 | <screen>tar xvzf auto-multiple-choice_xxxx_precomp.tar.gz
|
261 | cd auto-multiple-choice-xxx
|
262 | make
|
263 | sudo make install</screen>
|
264 | </sect2>
|
265 |
|
266 | <sect2>
|
267 | <title>Accès</title>
|
268 |
|
269 | <para>Une fois installé, l'interface graphique peut être appelée en
|
270 | choisissant <menuchoice>
|
271 | <guimenu>Applications</guimenu>
|
272 |
|
273 | <guisubmenu>Éducation</guisubmenu>
|
274 |
|
275 | <guimenuitem>Auto Multiple Choice</guimenuitem>
|
276 | </menuchoice> dans le menu général de Gnome (ou son équivalent dans
|
277 | KDE ou autre), mais on peut aussi utiliser la commande
|
278 | <userinput>auto-multiple-choice</userinput>.</para>
|
279 | </sect2>
|
280 | </sect1>
|
281 |
|
282 | <sect1 id="AMC-TXT">
|
283 | <title>Source au format AMC-TXT</title>
|
284 |
|
285 | <para>Pour les utilisateurs qui ne souhaitent pas se mettre à LaTeX, AMC
|
286 | embarque un filtre qui rédige pour vous le fichier LaTeX à partir d'une
|
287 | représentation en texte simple de votre questionnaire. Ce format est
|
288 | appelé AMC-TXT, et ce chapitre détaille la syntaxe à utiliser. Si vous
|
289 | souhaitez profiter de la puissance de LaTeX pour la rédaction de vos
|
290 | questionnaires, passez au chapitre suivant.</para>
|
291 |
|
292 | <para>Commençons par un exemple simple de fichier source utilisable par
|
293 | AMC :</para>
|
294 |
|
295 | |
296 | DESC: Un exemple très simple utilisant le format AMC-TXT qui permet de concevoir des questionnaires sans aucune connaissance de LaTeX.-->
|
297 |
|
298 | <programlisting id="modeles-simple-txt.txt"># AMC-TXT source
|
299 | PaperSize: A4
|
300 | Lang: FR
|
301 | Title: Mon premier questionnaire
|
302 |
|
303 | Presentation: Veuillez répondre aux questions
|
304 | ci-dessous du mieux que vous pouvez.
|
305 |
|
306 | * Quelle est la capitale du Cameroun ?
|
307 | + Yaoundé
|
308 | - Douala
|
309 | - Kribi
|
310 |
|
311 | ** Parmi les nombres suivants,
|
312 | lesquels sont positifs ?
|
313 | + 2
|
314 | - -2
|
315 | + 10</programlisting>
|
316 |
|
317 | <important>
|
318 | <para>Le fichier qui contient la description de votre sujet doit être
|
319 | codé en UTF-8. C'est le codage par défaut de plusieurs éditeurs de
|
320 | texte, dont fait partie <command>gedit</command> par exemple. N'utilisez
|
321 | pas d'éditeur de texte permettant d'appliquer des mise en forme à votre
|
322 | texte, comme OpenOffice/LibreOffice ou abiword : ils n'enregistrent pas
|
323 | seulement votre texte, mais beaucoup d'autres informations de mise en
|
324 | forme qu'AMC ne sait pas lire...</para>
|
325 | </important>
|
326 |
|
327 | <note>
|
328 | <para>La police de caractères qui sera utilisée par défaut pour votre
|
329 | questionnaire est la police <ulink
|
330 | url="http://www.linuxlibertine.org/">libertine</ulink>. C'est une police
|
331 | libre qui définit un très grand nombre de caractères de toutes langues.
|
332 | Cette police doit être installée sur votre système pour que votre sujet
|
333 | puisse être préparé (c'est le cas si vous installez AMC sur debian ou
|
334 | Ubuntu avec les paquets qu'il recommande).</para>
|
335 | </note>
|
336 |
|
337 | <para>Vous remarquez dès maintenant la structure du fichier de description
|
338 | du questionnaire : il commence par quelques définitions ou options
|
339 | générales de mise en forme, puis viennent les questions.</para>
|
340 |
|
341 | <sect2>
|
342 | <title>Commentaires</title>
|
343 |
|
344 | <para>Vous pouvez écrire des commentaires dans votre fichier AMC-TXT sur
|
345 | des lignes <emphasis>commençant</emphasis> par le caractère
|
346 | <code>#</code>. Ces lignes seront tout simplement ignorées par
|
347 | AMC.</para>
|
348 | </sect2>
|
349 |
|
350 | <sect2>
|
351 | <title>Options générales</title>
|
352 |
|
353 | <para>Voici les options que vous pouvez utiliser au début de votre
|
354 | fichier (dans n'importe quel ordre) :</para>
|
355 |
|
356 | <variablelist>
|
357 | <varlistentry>
|
358 | <term>PaperSize:</term>
|
359 |
|
360 | <listitem>
|
361 | <para>Indique le format de papier utilisé. Parmi les valeurs
|
362 | possibles, on trouve <code>A3</code>, <code>A4</code>,
|
363 | <code>A5</code>, <code>A6</code>, <code>B3</code>,
|
364 | <code>B4</code>, <code>B5</code>, <code>B6</code>,
|
365 | <code>letter</code>, <code>legal</code>, <code>ANSIA</code>,
|
366 | <code>ANSIB</code>, <code>ANSIC</code>, <code>ANSID</code>,
|
367 | <code>ANSIE</code>.</para>
|
368 | </listitem>
|
369 | </varlistentry>
|
370 |
|
371 | <varlistentry>
|
372 | <term>Lang:</term>
|
373 |
|
374 | <listitem>
|
375 | <para>donne la langue dans laquelle le questionnaire est écrit.
|
376 | Pour l'instant, les seules langues disponibles sont FR (français),
|
377 | ES (espagnol), DE (allemand), IT (Italien), NL (Néerlandais), NO
|
378 | (Norvégien), JA (Japonais, voir <xref linkend="txt-japanese"/>) et
|
379 | AR (arabe, voir <xref linkend="txt-arabic"/>). Si vous n'utilisez
|
380 | pas cette option, ce sera l'anglais qui sera choisi.</para>
|
381 | </listitem>
|
382 | </varlistentry>
|
383 |
|
384 | <varlistentry>
|
385 | <term>Title:</term>
|
386 |
|
387 | <listitem>
|
388 | <para>Le titre de l'examen, qui sera écrit en haut de la
|
389 | copie.</para>
|
390 | </listitem>
|
391 | </varlistentry>
|
392 |
|
393 | <varlistentry>
|
394 | <term>Presentation:</term>
|
395 |
|
396 | <listitem>
|
397 | <para>Un texte introductif pour l'examen, présentant par exemple
|
398 | la durée, les consignes...</para>
|
399 | </listitem>
|
400 | </varlistentry>
|
401 |
|
402 | <varlistentry>
|
403 | <term>ShuffleQuestions:</term>
|
404 |
|
405 | <listitem>
|
406 | <para>Si cette option est mise à 1 (c'est la valeur par défaut),
|
407 | les questions ne seront pas dans le même ordre dans chaque copie.
|
408 | Si vous lui donnez la valeur 0, les questions ne seront pas
|
409 | mélangées.</para>
|
410 | </listitem>
|
411 | </varlistentry>
|
412 |
|
413 | <varlistentry>
|
414 | <term>Code:</term>
|
415 |
|
416 | <listitem>
|
417 | <para>Affectez à cette option une valeur entière
|
418 | <replaceable>n</replaceable> (par exemple 8) pour demander la
|
419 | présence de cases à cocher pour que les étudiants codent leur
|
420 | numéro d'étudiant sur <replaceable>n</replaceable>
|
421 | chiffres.</para>
|
422 | </listitem>
|
423 | </varlistentry>
|
424 |
|
425 | <varlistentry>
|
426 | <term>Columns:</term>
|
427 |
|
428 | <listitem>
|
429 | <para>Si vous donnez à cette option une valeur
|
430 | <replaceable>n</replaceable> entière supérieure à 1, le
|
431 | questionnaire sera écrit sur <replaceable>n</replaceable>
|
432 | colonnes.</para>
|
433 | </listitem>
|
434 | </varlistentry>
|
435 |
|
436 | <varlistentry>
|
437 | <term>CompleteMulti:</term>
|
438 |
|
439 | <listitem>
|
440 | <para>Cette option prend la valeur 1 par défaut, ce qui signifie
|
441 | qu'une réponse "Aucune des réponses ci-dessus n'est correcte" sera
|
442 | ajoutée à la fin de toutes les questions multiples de votre
|
443 | questionnaire. Sans celle-ci, il serait impossible de faire la
|
444 | différence entre "l'étudiant ne répond pas à cette question" et
|
445 | "l'étudiant pense qu'aucune des réponses proposées n'est exacte".
|
446 | Si vous ne souhaitez pas que cette dernière réponse soit ajoutée,
|
447 | donnez la valeur 0 à cette option.</para>
|
448 | </listitem>
|
449 | </varlistentry>
|
450 |
|
451 | <varlistentry>
|
452 | <term>L-None:</term>
|
453 |
|
454 | <listitem>
|
455 | <para>Cette option indique un texte qui remplacera
|
456 | <emphasis>Aucune des réponses ci-dessus n'est correcte</emphasis>
|
457 | (voir option précédente) pour votre questionnaire.</para>
|
458 | </listitem>
|
459 | </varlistentry>
|
460 |
|
461 | <varlistentry>
|
462 | <term>QuestionBlocks:</term>
|
463 |
|
464 | <listitem>
|
465 | <para>Si cette option prend la valeur 1 (sa valeur par défaut),
|
466 | toutes vos questions seront enfermées dans des boîtes
|
467 | (invisibles), de sorte qu'elles ne puissent pas être coupées sur
|
468 | deux pages, ou sur plusieurs colonnes. Avec la valeur 0, les
|
469 | questions pourront être coupées ci besoin, ce qui peut gagner de
|
470 | la place mais perd en lisibilité.</para>
|
471 | </listitem>
|
472 | </varlistentry>
|
473 |
|
474 | <varlistentry>
|
475 | <term>L-Question:</term>
|
476 |
|
477 | <listitem>
|
478 | <para>Cette option sert à remplacer le mot
|
479 | <emphasis>Question</emphasis> dans votre questionnaire si vous
|
480 | utilisez une autre langue que celle indiquée par l'option
|
481 | <option>Lang</option>.</para>
|
482 | </listitem>
|
483 | </varlistentry>
|
484 |
|
485 | <varlistentry>
|
486 | <term>L-Name:</term>
|
487 |
|
488 | <listitem>
|
489 | <para>Cette option sert à remplacer le texte <emphasis>Nom et
|
490 | prénom</emphasis> inscrit dans le cadre où l'étudiant doit
|
491 | inscrire son identité.</para>
|
492 | </listitem>
|
493 | </varlistentry>
|
494 |
|
495 | <varlistentry>
|
496 | <term>L-Student:</term>
|
497 |
|
498 | <listitem>
|
499 | <para>Cette option sert à remplacer le petit texte qui demande de
|
500 | coder son numéro d'étudiant et d'inscrire son nom sur les copies
|
501 | (quand l'option <option>Code</option> a été utilisée).</para>
|
502 | </listitem>
|
503 | </varlistentry>
|
504 |
|
505 | <varlistentry>
|
506 | <term>ManualDuplex:</term>
|
507 |
|
508 | <listitem>
|
509 | <para>Avec la valeur 1 (ce n'est pas la valeur par défaut), chaque
|
510 | sujet sera constitué d'un nombre pair de pages, de telle sorte que
|
511 | tous les sujets pourront être imprimés manuellement à partir du
|
512 | fichier PDF sujet en mode recto/verso (sans l'utilisation de cette
|
513 | option, le début d'une copie pourraît être sur le verso de la fin
|
514 | de la copie précédente).</para>
|
515 | </listitem>
|
516 | </varlistentry>
|
517 |
|
518 | <varlistentry>
|
519 | <term>SingleSided:</term>
|
520 |
|
521 | <listitem>
|
522 | <para>Avec la valeur 1 (ce n'est pas la valeur par défaut), aucune
|
523 | page blanche ne sera ajoutée entre le sujet et la feuille de
|
524 | réponses séparée, même si le sujet comporte un nombre impair de
|
525 | pages. Ceci peut être utile quand les sujets sont imprimés en
|
526 | recto simple, ou quand il n'est pas nécessaire de séparer
|
527 | physiquement le sujet de la feuille de réponses.</para>
|
528 | </listitem>
|
529 | </varlistentry>
|
530 |
|
531 | <varlistentry>
|
532 | <term>BoxColor:</term>
|
533 |
|
534 | <listitem>
|
535 | <para>Permet de choisir une couleur pour les cases qui peuvent
|
536 | être cochées par les étudiants, afin de perturber le moins
|
537 | possible la saisie automatique à partir des scans
|
538 | (<emphasis>red</emphasis>, pour rouge, est une valeur commune,
|
539 | mais on peut aussi penser à un gris clair). La couleur fournie
|
540 | doit être une couleur valide pour <command>xcolor</command> (voir
|
541 | la documentation du paquet LaTeX <command>xcolor</command> pour
|
542 | plus de détails), comme <emphasis>red</emphasis>,
|
543 | <emphasis>magenta</emphasis>, <emphasis>pink</emphasis>,
|
544 | <emphasis>lightgray</emphasis>, <emphasis>cyan</emphasis>, ou bien
|
545 | sous la forme <code>#RRGGBB</code>, comme <code>#FFBEC8</code>
|
546 | pour un rouge clair.</para>
|
547 | </listitem>
|
548 | </varlistentry>
|
549 |
|
550 | <varlistentry>
|
551 | <term>DefaultScoringS:</term>
|
552 |
|
553 | <listitem>
|
554 | <para>Donne la barème par défaut pour les questions simples
|
555 | (Reportez-vous à <xref linkend="bareme"/> pour la description des
|
556 | barèmes possibles). La valeur par défaut à cette option est le
|
557 | barème qui donne un point à la bonne réponse, et zéro aux
|
558 | autres.</para>
|
559 | </listitem>
|
560 | </varlistentry>
|
561 |
|
562 | <varlistentry>
|
563 | <term>DefaultScoringM:</term>
|
564 |
|
565 | <listitem>
|
566 | <para>Donne le barème par défaut pour les questions multiple
|
567 | (Reportez-vous à <xref linkend="bareme"/> pour la description des
|
568 | barèmes possibles). La valeur par défaut de cette option est
|
569 | <code>haut=2</code>, ce qui correspond à un barème donnant deux
|
570 | points pour une réponse parfaitement exacte, et qui enlève un
|
571 | point à chaque erreur (case cochée alors qu'elle ne devrait pas
|
572 | l'être, ou case non-cochée alors qu'elle devrait l'être), sans
|
573 | passer en-dessous de zéro.</para>
|
574 | </listitem>
|
575 | </varlistentry>
|
576 |
|
577 | <varlistentry>
|
578 | <term>LaTeX:</term>
|
579 |
|
580 | <listitem>
|
581 | <para>Si cette option prend la valeur 1, tous les textes de votre
|
582 | questionnaire sont considérés comme étant écrits en TeX (ou
|
583 | LaTeX). Vous pourrez ainsi écrire des formules mathématiques comme
|
584 | <code>$\sqrt{a+b}$</code>. Avec la valeur 0 (valeur par défaut),
|
585 | vos textes seront reproduits sans modification.</para>
|
586 | </listitem>
|
587 | </varlistentry>
|
588 |
|
589 | <varlistentry>
|
590 | <term>LaTeX-Preambule:</term>
|
591 |
|
592 | <listitem>
|
593 | <para>Donne des commandes LaTeX à ajouter dans le préambule (par
|
594 | exemple des <command>\usepackage</command>).</para>
|
595 | </listitem>
|
596 | </varlistentry>
|
597 |
|
598 | <varlistentry>
|
599 | <term>LaTeX-BeginDocument:</term>
|
600 |
|
601 | <listitem>
|
602 | <para>Donne des commandes LaTeX à ajouter au début de
|
603 | l'environnement <command>document</command> (par exemple des
|
604 | définitions de macros).</para>
|
605 | </listitem>
|
606 | </varlistentry>
|
607 |
|
608 | <varlistentry>
|
609 | <term>Disable:</term>
|
610 |
|
611 | <listitem>
|
612 | <para>Donne une liste de convertisseurs à désactiver, séparés par
|
613 | des virgules. Les convertisseurs disponibles sont
|
614 | <code>images</code> (voir <xref linkend="parse_images"/>),
|
615 | <code>embf</code> (voir <xref linkend="parse_embf"/>) et
|
616 | <code>local_latex</code> (voir <xref
|
617 | linkend="parse_local_latex"/>).</para>
|
618 | </listitem>
|
619 | </varlistentry>
|
620 | </variablelist>
|
621 |
|
622 | <sect3>
|
623 | <title>Sujet avec feuille de réponses séparée</title>
|
624 |
|
625 | <para>Dans le cas d'un sujet avec feuille de réponses séparée, vous
|
626 | pourrez considérer l'emploi des options suivantes :</para>
|
627 |
|
628 | <variablelist>
|
629 | <varlistentry>
|
630 | <term>SeparateAnswerSheet:</term>
|
631 |
|
632 | <listitem>
|
633 | <para>Donner la valeur 1 à cette option pour obtenir une feuille
|
634 | de réponses séparée.</para>
|
635 | </listitem>
|
636 | </varlistentry>
|
637 |
|
638 | <varlistentry>
|
639 | <term>AnswerSheetTitle:</term>
|
640 |
|
641 | <listitem>
|
642 | <para>Donne le titre à inscrire en tête de la feuille de
|
643 | réponse.</para>
|
644 | </listitem>
|
645 | </varlistentry>
|
646 |
|
647 | <varlistentry>
|
648 | <term>AnswerSheetPresentation:</term>
|
649 |
|
650 | <listitem>
|
651 | <para>Donne le texte de présentation de la feuille de réponse.
|
652 | On pourra par exemple y préciser que les réponses doivent
|
653 | uniquement être données sur cette feuille.</para>
|
654 | </listitem>
|
655 | </varlistentry>
|
656 |
|
657 | <varlistentry>
|
658 | <term>AnswerSheetColumns:</term>
|
659 |
|
660 | <listitem>
|
661 | <para>Nombre de colonnes pour la feuille de réponses.</para>
|
662 | </listitem>
|
663 | </varlistentry>
|
664 | </variablelist>
|
665 | </sect3>
|
666 | </sect2>
|
667 |
|
668 | <sect2>
|
669 | <title>Questions</title>
|
670 |
|
671 | <para>Les questions simples (qui acceptent une et une seule bonne
|
672 | réponse) commencent par un <code>*</code> en début de ligne, et les
|
673 | questions multiples (celles qui peuvent comporter zéro, une ou
|
674 | plusieures bonnes réponses), commencent par un <code>**</code> en début
|
675 | de ligne. Vient ensuite le texte de la question, puis les réponses,
|
676 | introduites par un <code>+</code> quand la réponse est correcte ou un
|
677 | <code>-</code> quand elle ne l'est pas.</para>
|
678 |
|
679 | <sect3>
|
680 | <title>Options pour les questions</title>
|
681 |
|
682 | <para>Des options particulières peuvent être indiquées pour chaque
|
683 | question, entre crochets, juste après l'étoile (ou les deux étoiles
|
684 | pour des questions multiples) qui commence la question (sans espace
|
685 | avant), comme dans l'exemple suivant :</para>
|
686 |
|
687 | <programlisting>*[ordered,horiz,name=addition] Combien font
|
688 | un plus un ?
|
689 | - 0
|
690 | - 1
|
691 | + 2</programlisting>
|
692 |
|
693 | <para>Les options disponibles sont les suivantes :</para>
|
694 |
|
695 | <variablelist>
|
696 | <varlistentry>
|
697 | <term>horiz</term>
|
698 |
|
699 | <listitem>
|
700 | <para>Avec cette option, les réponses se suivront
|
701 | horizontalement plutôt que verticalement une par ligne.</para>
|
702 | </listitem>
|
703 | </varlistentry>
|
704 |
|
705 | <varlistentry>
|
706 | <term>columns=<replaceable>n</replaceable></term>
|
707 |
|
708 | <listitem>
|
709 | <para>Avec cette option, les réponses seront réparties sur
|
710 | <replaceable>n</replaceable> colonnes.</para>
|
711 | </listitem>
|
712 | </varlistentry>
|
713 |
|
714 | <varlistentry>
|
715 | <term>ordered</term>
|
716 |
|
717 | <listitem>
|
718 | <para>Avec cette option, les réponses ne seront pas mélangées
|
719 | dans chaque copies : elles resteront toujours dans l'ordre
|
720 | indiqué.</para>
|
721 | </listitem>
|
722 | </varlistentry>
|
723 |
|
724 | <varlistentry>
|
725 | <term>id=<replaceable>xxxx</replaceable></term>
|
726 |
|
727 | <listitem>
|
728 | <para>Avec cette option, le nom <replaceable>xxxx</replaceable>
|
729 | sera donné à la question. Ce nom apparaît dans les fichiers de
|
730 | notes exportés par AMC pour identifier la question plus
|
731 | facilement. Il ne doit comporter que des caractères simples non
|
732 | accentués.</para>
|
733 |
|
734 | <para><option>name</option> a le même rôle que l'option
|
735 | <option>id</option>. Cette option est présente pour assurer la
|
736 | compatibilité avec d'anciennes versions, préférez l'utilisation
|
737 | de <option>id</option>.</para>
|
738 | </listitem>
|
739 | </varlistentry>
|
740 |
|
741 | <varlistentry>
|
742 | <term>indicative</term>
|
743 |
|
744 | <listitem>
|
745 | <para>Indique que le score affecté à cette question ne sera pas
|
746 | pris en compte pour le score final de l'étudiant.</para>
|
747 | </listitem>
|
748 | </varlistentry>
|
749 | </variablelist>
|
750 | </sect3>
|
751 |
|
752 | <sect3>
|
753 | <title>Barèmes particuliers</title>
|
754 |
|
755 | <para>Si vous voulez utiliser un barème particulier pour une question
|
756 | ou une réponse, vous pouvez l'indiquer entre accolades, après le signe
|
757 | <code>*</code>, <code>**</code>, <code>+</code>, ou <code>-</code>, et
|
758 | après les éventuelles options, comme dans l'exemple suivant.
|
759 | Reportez-vous à <xref linkend="bareme"/> pour la syntaxe de
|
760 | description des barèmes à utiliser.</para>
|
761 |
|
762 | <programlisting>*{b=2,m=-1} Quelle est la capitale de la France ?
|
763 | + Paris
|
764 | - Lille
|
765 | -{-2} Ouagadougou
|
766 |
|
767 | **[ordered,horiz,name=positifs]{haut=1} Parmi les nombres suivants,
|
768 | lesquels sont positifs ?
|
769 | - -2
|
770 | + 2
|
771 | + 10</programlisting>
|
772 | </sect3>
|
773 |
|
774 | <sect3>
|
775 | <title>Questions ouvertes</title>
|
776 |
|
777 | <para>Les questions peuvent être transformées en questions ouvertes en
|
778 | indiquant des options (voir <xref linkend="questionsouvertes"/>) entre
|
779 | <code><</code> et <code>></code>, comme dans l'exemple
|
780 | suivant :</para>
|
781 |
|
782 | <programlisting>*<lines=4> Décrivez la lune.
|
783 | -[O]{0} O
|
784 | -[P]{1} P
|
785 | +[V]{2} V</programlisting>
|
786 |
|
787 | <para>Lors de l'utilisation de questions ouvertes, les options
|
788 | générales suivantes peuvent être intéressantes :</para>
|
789 |
|
790 | <variablelist>
|
791 | <varlistentry>
|
792 | <term>L-OpenText:</term>
|
793 |
|
794 | <listitem>
|
795 | <para>Texte à ajouter après les questions pour demander aux
|
796 | étudiants d'écrire la résponse sur la feuille de réponses
|
797 | séparée (dans le cas où celle-ci est utilisée).</para>
|
798 | </listitem>
|
799 | </varlistentry>
|
800 |
|
801 | <varlistentry>
|
802 | <term>L-OpenReserved:</term>
|
803 |
|
804 | <listitem>
|
805 | <para>Texte (court) à ajouter à côté des cases à cocher des
|
806 | questions ouvertes, indiquant aux étudiants que ces cases sont
|
807 | réservées aux correcteurs.</para>
|
808 | </listitem>
|
809 | </varlistentry>
|
810 | </variablelist>
|
811 | </sect3>
|
812 | </sect2>
|
813 |
|
814 | <sect2>
|
815 | <title>Lignes multiples</title>
|
816 |
|
817 | <para>Tout texte peut se continuer sur la ou les lignes suivantes (même
|
818 | si certaines sont vides), pourvu qu'elles ne puissent pas être
|
819 | interprétées comme un début de définition d'option générale, un début de
|
820 | question ou de réponse. Considérons par exemple l'écriture de question
|
821 | suivante :</para>
|
822 |
|
823 | <programlisting>* Combien font 2
|
824 | + 2 ?
|
825 | - 0
|
826 | + 4
|
827 | - 10</programlisting>
|
828 |
|
829 | <para>Cette écriture suit bien la syntaxe AMC-TXT, mais ne correspond
|
830 | pas à ce que l'on voulait écrire : ici, la deuxième ligne sera
|
831 | considérée comme une réponse possible, et non comme la suite de la
|
832 | question !</para>
|
833 |
|
834 | <para>Un problème similaire sera rencontré dans la portion de fichier
|
835 | source suivante, où "<code>Chopin:</code>" sera considéré comme une
|
836 | définition d'option générale :</para>
|
837 |
|
838 | <programlisting>* Vous connaissez sans doute Frédéric
|
839 | Chopin: c'est un compositeur. De quel pays est-il
|
840 | originaire ?
|
841 | + la Pologne
|
842 | - le Vénézuela
|
843 | - la Suisse</programlisting>
|
844 |
|
845 | <para>La version correcte est la suivante :</para>
|
846 |
|
847 | <programlisting>* Vous connaissez sans doute Frédéric Chopin:
|
848 | c'est un compositeur. De quel pays est-il
|
849 | originaire ?
|
850 | + la Pologne
|
851 | - le Vénézuela
|
852 | - la Suisse</programlisting>
|
853 |
|
854 | <para>Notez enfin que pour passer à la ligne suivante, il faut laisser
|
855 | une ligne vide dans le fichier source de l'examen, comme ceci :</para>
|
856 |
|
857 | <programlisting>Description: Titre
|
858 |
|
859 | Description de l'examen sur la ligne suivante.
|
860 |
|
861 | ** Question difficile.
|
862 |
|
863 | Combien y a-t-il d'étoiles dans le ciel ?
|
864 |
|
865 | - une
|
866 | - deux
|
867 | - dix millions</programlisting>
|
868 | </sect2>
|
869 |
|
870 | <sect2 id="parse_embf">
|
871 | <title>Gras, italique</title>
|
872 |
|
873 | <para>Les parties du textes à écrire en gras devront être entourées de
|
874 | <code>[*</code> et <code>*]</code>. Les parties à mettre en italique
|
875 | devront être entourées de <code>[_</code> et <code>_]</code>.</para>
|
876 |
|
877 | <programlisting>** Choisissez parmi les expressions suivantes celles
|
878 | où le mot en italique est [*un adjectif*].
|
879 | + Une balle [_bleue_]
|
880 | - Un [_livre_] rose
|
881 | + Quelle [_belle_] histoire !</programlisting>
|
882 | </sect2>
|
883 |
|
884 | <sect2 id="parse_images">
|
885 | <title>Inclusion d'images</title>
|
886 |
|
887 | <para>Vous pouvez inclure des images dans votre document suivant la
|
888 | syntaxe suivante :</para>
|
889 |
|
890 | <programlisting>![height=2cm]images/oiseau.png!</programlisting>
|
891 |
|
892 | <para>Dans cet exemple, l'image <filename>images/zozo.png</filename>
|
893 | située dans le répertoire du projet sera insérée avec une hauteur de
|
894 | 2cm. Les options que l'on peut utiliser entre les crochets sont celles
|
895 | de la commande LaTeX <command>\includegraphics</command> (par exemple,
|
896 | <parameter>width=1cm</parameter>, ou
|
897 | <parameter>keepaspectratio</parameter>). Pour obtenir une image centrée
|
898 | sur une ligne et ayant pour largeur les trois quards de la ligne, on
|
899 | utilisera de même :</para>
|
900 |
|
901 | <programlisting>!{center}[width=.75\linewidth]images/carte.pdf!</programlisting>
|
902 | </sect2>
|
903 |
|
904 | <sect2 id="parse_local_latex">
|
905 | <title>Petits morceaux de LaTeX</title>
|
906 |
|
907 | <para>Vous pouvez inclure quelques segments de code LaTeX dans votre
|
908 | description en les incluant entre des double crochets, comme dans
|
909 | l'exemple suivant :</para>
|
910 |
|
911 | <programlisting>Les questions marquées d'un [[\multiSymbole{}]] peuvent avoir zéro, une ou plusieurs bonnes réponses.</programlisting>
|
912 | </sect2>
|
913 |
|
914 | <sect2 id="txt-arabic">
|
915 | <title>En langue arabe</title>
|
916 |
|
917 | <para>La rédaction d'un questionnaire en langue arabe comporte quelques
|
918 | spécificités. Vous utiliserez bien entendu l'option</para>
|
919 |
|
920 | <programlisting>Lang: AR</programlisting>
|
921 |
|
922 | <para>Mais vous devrez également prêter attention aux options
|
923 | suivantes :</para>
|
924 |
|
925 | <variablelist>
|
926 | <varlistentry>
|
927 | <term>ArabicFont:</term>
|
928 |
|
929 | <listitem>
|
930 | <para>C'est la police de caractères qui sera utilisée pour les
|
931 | textes en arabe. Par défaut, AMC utilisera
|
932 | <emphasis>Rasheeq</emphasis>, une police du projet <ulink
|
933 | url="http://arabeyes.org/">ArabEyes</ulink> (disponible dans la
|
934 | paquet ttf-arabeyes sur debian et ubuntu par exemple).</para>
|
935 | </listitem>
|
936 | </varlistentry>
|
937 | </variablelist>
|
938 |
|
939 | <warning>
|
940 | <para>Pour un meilleur fonctionnement et une meilleure portabilité,
|
941 | vous devrez également spécifier explicitement la valeur des options
|
942 | <option>L-Name</option> et <option>L-Student</option>.</para>
|
943 | </warning>
|
944 |
|
945 | <note>
|
946 | <para>Pour pouvoir insérer des textes en d'autres caractères dans
|
947 | votre questionnaire, vous devrez utiliser l'option
|
948 | <option>LaTeX</option> pour passer en mode LaTeX, et englober toutes
|
949 | les portions de texte en caractères non-arabes par la commande LaTeX
|
950 | <command>\textLR</command> comme dans <code>\textLR{la commande
|
951 | xelatex}</code>.</para>
|
952 | </note>
|
953 | </sect2>
|
954 |
|
955 | <sect2 id="txt-japanese">
|
956 | <title>En japonais</title>
|
957 |
|
958 | <para>Vous pourrez construire des questionnaires incluant des caractères
|
959 | japonais grâce à l'option</para>
|
960 |
|
961 | <programlisting>Lang: JA</programlisting>
|
962 |
|
963 | <para>AMC fera les ajustements nécessaires pour permettre un bon rendu
|
964 | de ces caractères.</para>
|
965 |
|
966 | <warning>
|
967 | <para>Dans ce cas, AMC utilisera <command>pTex</command> comme moteur
|
968 | LaTeX. Une version <emphasis>récente</emphasis> de
|
969 | <command>pTex</command> est nécessaire. La distribution texlive 2009,
|
970 | disponible par exemple sur certaines anciennes versions de
|
971 | distributions linux, n'est <emphasis>pas</emphasis> suffisante.</para>
|
972 | </warning>
|
973 | </sect2>
|
974 | </sect1>
|
975 |
|
976 | <sect1 id="latex">
|
977 | <title>Source au format LaTeX</title>
|
978 |
|
979 | <para>Ce paragraphe détaille la rédaction en LaTeX d'une questionnaire à
|
980 | choix multiples utilisable par AMC. Si vous avez choisi un autre format de
|
981 | fichier source, vous pouvez passer directement au chapitre suivant.</para>
|
982 |
|
983 | <para>Un questionnaire à choix multiples peut être décrit sous la forme
|
984 | d'une fichier LaTeX utilisant le package
|
985 | <package>automultiplechoice</package>. Vous pouvez à tout moment tester le
|
986 | fichier LaTeX que vous êtes en train de concevoir en le compilant avec la
|
987 | commande <command>latex</command> puis en visualisant le fichier dvi qui
|
988 | en résulte.</para>
|
989 |
|
990 | <para>Nous commençons par quelques exemples qui permettent d'appréhender
|
991 | rapidement la construction de fichiers LaTeX de QCM ; les fichiers tex de
|
992 | ces exemples sont fournis avec AMC sous la forme de modèles utilisables en
|
993 | créant un nouveau projet de QCM à partir d'un de ces modèles.</para>
|
994 |
|
995 | <sect2>
|
996 | <title>Un exemple simple</title>
|
997 |
|
998 | <para> |
999 | DESC: Un exemple simple (issu de la documentation) avec une question simple et une question multiple.--><programlisting
|
1000 | id="modeles-simple.tex" linenumbering="numbered">\documentclass[a4paper]{article}
|
1001 |
|
1002 | \usepackage[utf8x]{inputenc} <co id="simple.latin1"
|
1003 | linkends="simple.latin1.exp"/>
|
1004 | \usepackage[T1]{fontenc}
|
1005 |
|
1006 | \usepackage[francais,bloc,completemulti]{automultiplechoice} <co
|
1007 | id="simple.amc" linkends="simple.amc.exp"/>
|
1008 | \begin{document}
|
1009 |
|
1010 | \exemplaire{10}{ <co id="simple.exemplaire"
|
1011 | linkends="simple.exemplaire.exp"/>
|
1012 |
|
1013 | %%% debut de l'en-tête des copies : <co id="simple.entete"
|
1014 | linkends="simple.entete.exp"/>
|
1015 |
|
1016 | \noindent{\bf QCM \hfill TEST}
|
1017 |
|
1018 | \vspace*{.5cm}
|
1019 | \begin{minipage}{.4\linewidth}
|
1020 | \centering\large\bf Test\\ Examen du 01/01/2008\end{minipage}
|
1021 | \champnom{\fbox{ <co id="simple.champnom" linkends="simple.champnom.exp"/>
|
1022 | \begin{minipage}{.5\linewidth}
|
1023 | Nom et prénom :
|
1024 |
|
1025 | \vspace*{.5cm}\dotfill
|
1026 | \vspace*{1mm}
|
1027 | \end{minipage}
|
1028 | }}
|
1029 |
|
1030 | \begin{center}\em
|
1031 | Durée : 10 minutes.
|
1032 |
|
1033 | Aucun document n'est autorisé.
|
1034 | L'usage de la calculatrice est interdit.
|
1035 |
|
1036 | Les questions faisant apparaître le symbole \multiSymbole{} peuvent
|
1037 | présenter zéro, une ou plusieurs bonnes réponses. Les autres ont
|
1038 | une unique bonne réponse.
|
1039 |
|
1040 | Des points négatifs pourront être affectés à de \emph{très
|
1041 | mauvaises} réponses.
|
1042 | \end{center}
|
1043 | \vspace{1ex}
|
1044 |
|
1045 | %%% fin de l'en-tête
|
1046 |
|
1047 | \begin{question}{prez} <co id="simple.qr" linkends="simple.qr.exp"/>
|
1048 | Parmi les personnalités suivantes, laquelle a été présidente de la république française~?
|
1049 | \begin{reponses}
|
1050 | \bonne{René Coty}
|
1051 | \mauvaise{Alain Prost}
|
1052 | \mauvaise{Marcel Proust}
|
1053 | \mauvaise{Claude Monet}
|
1054 | \end{reponses}
|
1055 | \end{question}
|
1056 |
|
1057 | \begin{questionmult}{pref} <co id="simple.qrmult"
|
1058 | linkends="simple.qrmult.exp"/>
|
1059 | Parmi les villes suivantes, lesquelles sont des préfectures~?
|
1060 | \begin{reponses}
|
1061 | \bonne{Poitiers}
|
1062 | \mauvaise{Sainte-Menehould}
|
1063 | \bonne{Avignon}
|
1064 | \end{reponses}
|
1065 | \end{questionmult}
|
1066 |
|
1067 | \clearpage <co id="simple.clear" linkends="simple.clear.exp"/>
|
1068 |
|
1069 | } <co id="simple.fin" linkends="simple.fin.exp"/>
|
1070 |
|
1071 | \end{document}
|
1072 | </programlisting></para>
|
1073 |
|
1074 | <para>Quelques précisions sur cet exemple :</para>
|
1075 |
|
1076 | <para><calloutlist>
|
1077 | <callout arearefs="simple.latin1" id="simple.latin1.exp">
|
1078 | <para>Les deux paquets <package>inputenc</package> et
|
1079 | <package>fontenc</package> permettent d'écrire le texte du
|
1080 | questionnaire en utilisant l'encodage ISO-8859-1 (latin1). Vous
|
1081 | pouvez bien entendu les modifier suivant l'encodage que vous
|
1082 | utilisez.</para>
|
1083 | </callout>
|
1084 |
|
1085 | <callout arearefs="simple.amc" id="simple.amc.exp">
|
1086 | <para>Les options utilisées ici pour le paquet LaTeX
|
1087 | <package>automultiplechoice</package> permettent d'éviter le
|
1088 | changement de page à l'intérieur des questions
|
1089 | (<option>bloc</option>) et de compléter automatiquement chaque
|
1090 | question multiple par une réponse type permettant à l'étudiant
|
1091 | d'indiquer qu'il considère qu'aucune des réponses proposées n'est
|
1092 | exacte (<option>completemulti</option>).</para>
|
1093 | </callout>
|
1094 |
|
1095 | <callout arearefs="simple.exemplaire" id="simple.exemplaire.exp">
|
1096 | <para>La commande <command>exemplaire</command> permet de
|
1097 | fabriquer autant d'exemplaires (différents) du questionnaire QCM
|
1098 | que l'on souhaite (ici, 10). Voir <xref linkend="sec.unecopie"/>
|
1099 | pour une syntaxe alternative utilisant un environnement.</para>
|
1100 | </callout>
|
1101 |
|
1102 | <callout arearefs="simple.entete" id="simple.entete.exp">
|
1103 | <para>Les lignes qui commencent ici permettent la mise en forme de
|
1104 | l'en-tête de chaque copie.</para>
|
1105 | </callout>
|
1106 |
|
1107 | <callout arearefs="simple.champnom" id="simple.champnom.exp">
|
1108 | <para>La commande <command>champnom</command> permet d'indiquer la
|
1109 | partie du questionnaire dans laquelle chaque étudiant inscrira son
|
1110 | nom.</para>
|
1111 | </callout>
|
1112 |
|
1113 | <callout arearefs="simple.qr" id="simple.qr.exp">
|
1114 | <para>Les environnements <command>question</command> et
|
1115 | <command>reponses</command> permettent de fabriquer une question à
|
1116 | choix multiples pour laquelle une unique réponse est correcte. Il
|
1117 | faut indiquer un identifiant unique de la question (ici :
|
1118 | <emphasis>prez</emphasis>).</para>
|
1119 | </callout>
|
1120 |
|
1121 | <callout arearefs="simple.qrmult" id="simple.qrmult.exp">
|
1122 | <para>Les environnements <command>questionmult</command> et
|
1123 | <command>reponses</command> permettent de fabriquer une question
|
1124 | pouvant avoir zéro, une ou plusieurs bonnes réponses. L'étudiant
|
1125 | est donc invité à cocher toutes les cases correspondant aux
|
1126 | réponses qu'il pense correctes, ou la dernière case (ajoutée
|
1127 | automatiquement grâce à l'option <option>completemulti</option>
|
1128 | passée au paquet en ligne 6).</para>
|
1129 | </callout>
|
1130 |
|
1131 | <para>Il est important de ne pas imbriquer deux questions sinon l'exportation sera incomplète.</para>
|
1132 |
|
1133 |
|
1134 | <callout arearefs="simple.clear" id="simple.clear.exp">
|
1135 | <para>La commande <command>clearpage</command> permet de passer à
|
1136 | la page suivante pour le début de la copie suivante.</para>
|
1137 | </callout>
|
1138 |
|
1139 | <callout arearefs="simple.fin" id="simple.fin.exp">
|
1140 | <para>Cette fermeture d'accolade marque la fin de la commande
|
1141 | <command>exemplaire</command> (débutée à la ligne 9).</para>
|
1142 | </callout>
|
1143 | </calloutlist></para>
|
1144 | </sect2>
|
1145 |
|
1146 | <sect2>
|
1147 | <title>Un exemple avec groupes de questions mélangées</title>
|
1148 |
|
1149 | <para>Dans cet exemple, on veut que l'ordre dans lequel les questions
|
1150 | sont posées soit différent d'une copie à l'autre, tout en laissant
|
1151 | ensemble les questions traitant du même sujet. On va donc créer deux
|
1152 | groupes de questions, et les mélanger lors de la fabrication de chaque
|
1153 | copie. |
1154 | DESC: Un exemple (issu de la documentation) où les questions sont mélangées à l'intérieur de deux groupes différents.--><programlisting
|
1155 | id="modeles-groupes.tex" linenumbering="numbered">\documentclass[a4paper]{article}
|
1156 |
|
1157 | \usepackage[utf8x]{inputenc}
|
1158 | \usepackage[T1]{fontenc}
|
1159 |
|
1160 | \usepackage[francais,bloc,completemulti]{automultiplechoice}
|
1161 | \begin{document}
|
1162 |
|
1163 | %%% préparation des groupes
|
1164 |
|
1165 | \element{geographie}{
|
1166 | \begin{question}{Paris}
|
1167 | Dans quel continent se situe Paris~?
|
1168 | \begin{reponses}
|
1169 | \bonne{L'Europe}
|
1170 | \mauvaise{L'Afrique}
|
1171 | \mauvaise{L'Asie}
|
1172 | \mauvaise{La planète Mars}
|
1173 | \end{reponses}
|
1174 | \end{question}
|
1175 | }
|
1176 |
|
1177 | \element{geographie}{
|
1178 | \begin{question}{Cameroun}
|
1179 | Quelle est la capitale du Cameroun~?
|
1180 | \begin{reponses}
|
1181 | \bonne{Yaoundé}
|
1182 | \mauvaise{Douala}
|
1183 | \mauvaise{Abou-Dabi}
|
1184 | \end{reponses}
|
1185 | \end{question}
|
1186 | }
|
1187 |
|
1188 | \element{histoire}{
|
1189 | \begin{question}{Marignan}
|
1190 | En quelle année a eu lieu la bataille de Marignan~?
|
1191 | \begin{reponseshoriz}
|
1192 | \bonne{1515}
|
1193 | \mauvaise{1915}
|
1194 | \mauvaise{1519}
|
1195 | \end{reponseshoriz}
|
1196 | \end{question}
|
1197 | }
|
1198 |
|
1199 | \element{histoire}{
|
1200 | \begin{questionmult}{Nantes}
|
1201 | Que peut-on dire de l'Édit de Nantes~?
|
1202 | \begin{reponses}
|
1203 | \bonne{Il a été signé en 1598}
|
1204 | \bonne{Il a été définitivement révoqué par Louis XIV}
|
1205 | \mauvaise{Il a été signé par Henri II}
|
1206 | \end{reponses}
|
1207 | \end{questionmult}
|
1208 | }
|
1209 |
|
1210 | %%% fabrication des copies
|
1211 |
|
1212 | \exemplaire{10}{
|
1213 |
|
1214 | %%% debut de l'en-tête des copies :
|
1215 |
|
1216 | \noindent{\bf QCM \hfill TEST}
|
1217 |
|
1218 | \vspace*{.5cm}
|
1219 | \begin{minipage}{.4\linewidth}
|
1220 | \centering\large\bf Histoire et géographie\\ Examen du 01/01/2008
|
1221 | \end{minipage}
|
1222 | \champnom{\fbox{\begin{minipage}{.5\linewidth}
|
1223 | Nom et prénom :
|
1224 |
|
1225 | \vspace*{.5cm}\dotfill
|
1226 | \vspace*{1mm}
|
1227 | \end{minipage}}}
|
1228 |
|
1229 | %%% fin de l'en-tête
|
1230 |
|
1231 | \begin{center}
|
1232 | \hrule\vspace{2mm}
|
1233 | \bf\Large Géographie
|
1234 | \vspace{1mm}\hrule
|
1235 | \end{center}
|
1236 |
|
1237 | \melangegroupe{geographie}
|
1238 | \restituegroupe{geographie}
|
1239 |
|
1240 | \begin{center}
|
1241 | \hrule\vspace{2mm}
|
1242 | \bf\Large Histoire
|
1243 | \vspace{2mm}\hrule
|
1244 | \end{center}
|
1245 |
|
1246 | \melangegroupe{histoire}
|
1247 | \restituegroupe{histoire}
|
1248 |
|
1249 | \clearpage
|
1250 |
|
1251 | }
|
1252 |
|
1253 | \end{document}
|
1254 | </programlisting></para>
|
1255 | </sect2>
|
1256 |
|
1257 | <sect2 id="secensemble">
|
1258 | <title>Un exemple avec une feuille de réponses séparée</title>
|
1259 |
|
1260 | <para>Dans cet exemple, on souhaite que les cases à cocher soient toutes
|
1261 | rassemblées sur une feuille à part. De cette manière, la triche entre
|
1262 | étudiants est plus difficile, et surtout, il suffira de scanner une
|
1263 | seule page par étudiant, ce qui allège la tâche de l'enseignant dans le
|
1264 | cas où son matériel ne lui permet de scanner les copies que de manière
|
1265 | manuelle. Dans cet exemple, le nombre de questions est réduit : elles
|
1266 | tiennent toutes sur une page et il serait donc inutile d'utiliser une
|
1267 | telle mise en page dans ce cas précis. À vous de modifier cette base
|
1268 | pour utiliser cette mise en page avec de nombreuses questions !</para>
|
1269 |
|
1270 | <para> |
1271 | DESC: Un exemple (issu de la documentation) où toutes les cases à cocher sont regroupées sur une page à part pour chaque étudiant.--><programlisting
|
1272 | id="modeles-ensemble.tex" linenumbering="numbered">\documentclass[a4paper]{article}
|
1273 |
|
1274 | \usepackage[utf8x]{inputenc}
|
1275 | \usepackage[T1]{fontenc}
|
1276 |
|
1277 | \usepackage[francais,bloc,completemulti,ensemble]{automultiplechoice} <co
|
1278 | id="ensemble.opt" linkends="ensemble.opt.exp"/>
|
1279 | \begin{document}
|
1280 |
|
1281 | \AMCrandomseed{1237893}
|
1282 |
|
1283 | \def\AMCformQuestion#1{\vspace{\AMCformVSpace}\par {\sc Question #1 :} } <co
|
1284 | id="ensemble.fq" linkends="ensemble.fq.exp"/>
|
1285 |
|
1286 | \element{general}{
|
1287 | \begin{question}{prez}
|
1288 | Parmi les personnalités suivantes, laquelle a été présidente de la république française~?
|
1289 | \begin{reponses}
|
1290 | \bonne{René Coty}
|
1291 | \mauvaise{Alain Prost}
|
1292 | \mauvaise{Marcel Proust}
|
1293 | \mauvaise{Claude Monet}
|
1294 | \end{reponses}
|
1295 | \end{question}
|
1296 | }
|
1297 |
|
1298 | \element{general}{
|
1299 | \begin{questionmult}{pref}
|
1300 | Parmi les villes suivantes, lesquelles sont des préfectures~?
|
1301 | \begin{reponses}
|
1302 | \bonne{Poitiers}
|
1303 | \mauvaise{Sainte-Menehould}
|
1304 | \bonne{Avignon}
|
1305 | \end{reponses}
|
1306 | \end{questionmult}
|
1307 | }
|
1308 |
|
1309 | \element{general}{
|
1310 | \begin{question}{nb-ue}
|
1311 | Combien d'états sont membres de l'Union Européenne en janvier 2009 ?
|
1312 | \begin{reponseshoriz}[o]
|
1313 | \mauvaise{15}
|
1314 | \mauvaise{21}
|
1315 | \mauvaise{25}
|
1316 | \bonne{27}
|
1317 | \mauvaise{31}
|
1318 | \end{reponseshoriz}
|
1319 | \end{question}
|
1320 | }
|
1321 |
|
1322 | \exemplaire{5}{
|
1323 |
|
1324 | %%% debut de l'en-tête des copies :
|
1325 |
|
1326 | \noindent{\bf QCM \hfill TEST}
|
1327 |
|
1328 | \vspace*{.5cm}
|
1329 | \begin{minipage}{.4\linewidth}
|
1330 | \centering\large\bf Test\\ Examen du 01/01/2008
|
1331 | \end{minipage}
|
1332 |
|
1333 | \begin{center}\em
|
1334 | Durée : 10 minutes.
|
1335 |
|
1336 | Aucun document n'est autorisé.
|
1337 | L'usage de la calculatrice est interdit.
|
1338 |
|
1339 | Les questions faisant apparaître le symbole \multiSymbole{} peuvent
|
1340 | présenter zéro, une ou plusieurs bonnes réponses. Les autres ont
|
1341 | une unique bonne réponse.
|
1342 |
|
1343 | Des points négatifs pourront être affectés à de \emph{très
|
1344 | mauvaises} réponses.
|
1345 | \end{center}
|
1346 | \vspace{1ex}
|
1347 |
|
1348 | %%% fin de l'en-tête
|
1349 |
|
1350 | \melangegroupe{general}
|
1351 | \restituegroupe{general}
|
1352 |
|
1353 | \AMCcleardoublepage <co id="ensemble.cp" linkends="ensemble.cp.exp"/>
|
1354 |
|
1355 | \AMCdebutFormulaire <co id="debut.form" linkends="debut.form.exp"/>
|
1356 |
|
1357 | %%% début de l'en-tête de la feuille de réponses
|
1358 |
|
1359 | {\large\bf Feuille de réponses :}
|
1360 | \hfill \champnom{\fbox{ <co id="ensemble.nom" linkends="ensemble.nom.exp"/>
|
1361 | \begin{minipage}{.5\linewidth}
|
1362 | Nom et prénom :
|
1363 |
|
1364 | \vspace*{.5cm}\dotfill
|
1365 | \vspace*{1mm}
|
1366 | \end{minipage}
|
1367 | }}
|
1368 |
|
1369 | \begin{center}
|
1370 | \bf\em Les réponses aux questions sont à donner exclusivement sur cette feuille :
|
1371 | les réponses données sur les feuilles précédentes ne seront pas prises en compte.
|
1372 | \end{center}
|
1373 |
|
1374 | %%% fin de l'en-tête de la feuille de réponses
|
1375 |
|
1376 | \formulaire <co id="ensemble.formulaire" linkends="ensemble.formulaire.exp"/>
|
1377 |
|
1378 | \clearpage
|
1379 |
|
1380 | }
|
1381 |
|
1382 | \end{document}</programlisting>Les remarques suivantes devraient éclaircir cet
|
1383 | exemple :<calloutlist>
|
1384 | <callout arearefs="ensemble.opt" id="ensemble.opt.exp">
|
1385 | <para>C'est l'option <option>ensemble</option> qui permet de faire
|
1386 | ce que l'on veut faire ici.</para>
|
1387 | </callout>
|
1388 |
|
1389 | <callout arearefs="ensemble.fq" id="ensemble.fq.exp">
|
1390 | <para>On peut redéfinir de cette manière la façon dont les
|
1391 | questions seront identifiées sur la page des réponses (cette ligne
|
1392 | est facultative).</para>
|
1393 | </callout>
|
1394 |
|
1395 | <callout arearefs="ensemble.cp" id="ensemble.cp.exp">
|
1396 | <para>Ce saut de page précède la page spéciale où seront
|
1397 | regroupées toutes les cases à cocher. Si on imprime en
|
1398 | recto-verso, il vaut mieux utiliser
|
1399 | <command>\AMCcleardoublepage</command> pour que la page de
|
1400 | formulaire soit sur une feuille séparée des autres. Si on imprime
|
1401 | en recto simple, on peut utiliser simplement
|
1402 | <command>\clearpage</command>.</para>
|
1403 | </callout>
|
1404 |
|
1405 | <callout arearefs="debut.form" id="debut.form.exp">
|
1406 | <para>Cette commande marque le début de la partie formulaire de la
|
1407 | copie. Son utilisation est indispensable pour un bon traitement
|
1408 | des questions qui n'apparaissent que dans cette partie, comme par
|
1409 | exemple celles générées par <command>AMCcode</command>.</para>
|
1410 | </callout>
|
1411 |
|
1412 | <callout arearefs="ensemble.nom" id="ensemble.nom.exp">
|
1413 | <para>La case où écrire son nom doit normalement être située sur
|
1414 | la page des réponses !</para>
|
1415 | </callout>
|
1416 |
|
1417 | <callout arearefs="ensemble.formulaire" id="ensemble.formulaire.exp">
|
1418 | <para>C'est la commande LaTeX <command>formulaire</command> qui
|
1419 | écrit toutes les cases à cocher.</para>
|
1420 | </callout>
|
1421 | </calloutlist></para>
|
1422 |
|
1423 | <warning>
|
1424 | <para>Quand on utilise une page de réponses séparée, des lettres (ou
|
1425 | des chiffres, avec l'utilisation de l'option
|
1426 | <option>chiffres</option>, voir <xref linkend="sec.package.options"/>)
|
1427 | sont inscrites dans les cases à cocher. Pour obtenir une bonne
|
1428 | détection des cases cochées, il est donc indispensable de demander aux
|
1429 | étudiants de remplir totalement les cases voulues (cocher uniquement
|
1430 | les cases à l'aide d'une croix ne serait pas suffisant). Il faut par
|
1431 | ailleurs fixer le paramètre « seuil de noirceur » (qui définit la
|
1432 | proportion de noir dans une case à partir de laquelle cette case est
|
1433 | considérée comme étant cochée) à une valeur de l'ordre de 0,5.</para>
|
1434 | </warning>
|
1435 | </sect2>
|
1436 |
|
1437 | <sect2>
|
1438 | <title>Description des commandes LaTeX</title>
|
1439 |
|
1440 | <sect3 id="sec.package.options">
|
1441 | <title id="sec.package.options.titre">Options du paquet</title>
|
1442 |
|
1443 | <para>L'utilisation du paquet <package>automultiplechoice</package> se
|
1444 | fait grâce à la ligne <programlisting>\usepackage[...]{automultiplechoice}</programlisting>où
|
1445 | les pointillés sont remplacés par une liste d'options séparées par des
|
1446 | virgules. Les options disponibles sont les suivantes :</para>
|
1447 |
|
1448 | <itemizedlist>
|
1449 | <listitem>
|
1450 | <para><option>francais</option> : indique que le sujet d'examen
|
1451 | est en français. Les quelques mentions éventuellement ajoutées par
|
1452 | <package>automultiplechoice</package> seront alors écrites en
|
1453 | français (on peut en particulier penser à la phrase
|
1454 | « <emphasis>aucune de ces réponses n'est correcte</emphasis> »,
|
1455 | voir option <option>completemulti</option> plus loin).</para>
|
1456 | </listitem>
|
1457 |
|
1458 | <listitem>
|
1459 | <para><option>lang=<replaceable>XX</replaceable></option> :
|
1460 | indique que le sujet est dans la langue
|
1461 | <replaceable>XX</replaceable>. Pour le moment, seules les langues
|
1462 | FR (français), DE (allemand), ES (espagnol), IT (Italien), JA
|
1463 | (Japonais) et NL (Néerlandais) sont disponibles.</para>
|
1464 | </listitem>
|
1465 |
|
1466 | <listitem>
|
1467 | <para><option>bloc</option> : place chaque question dans un bloc,
|
1468 | de telle sorte qu'elle ne puisse pas être coupée par un saut de
|
1469 | page.</para>
|
1470 | </listitem>
|
1471 |
|
1472 | <listitem>
|
1473 | <para><option>completemulti</option> : ajoute de manière
|
1474 | automatique une réponse type « aucune de ces réponses n'est
|
1475 | correcte » à la fin de chaque question multiple. Ceci permet de
|
1476 | différencier, pour ces questions, une absence de réponse et la
|
1477 | réponse qui consiste à ne choisir aucune des réponses proposées.
|
1478 | Que cette option soit utilisée ou non, on peut demander l'ajout de
|
1479 | cette dernière réponse ou l'annuler pour une question particulière
|
1480 | en utilisant une des commandes
|
1481 | <command>\AMCcompleteMulti</command> et
|
1482 | <command>\AMCnoCompleteMulti</command> à l'intérieur de
|
1483 | l'environnement <command>questionmult</command>
|
1484 | correspondant.</para>
|
1485 | </listitem>
|
1486 |
|
1487 | <listitem>
|
1488 | <para><option>ordre</option> : annule le mélange automatique de
|
1489 | l'ordre des réponses dans toutes les questions.</para>
|
1490 | </listitem>
|
1491 |
|
1492 | <listitem>
|
1493 | <para><option>correc</option> : produit la correction du QCM, et
|
1494 | non le sujet.</para>
|
1495 | </listitem>
|
1496 |
|
1497 | <listitem>
|
1498 | <para><option>ensemble</option> : demande à ce que les cases à
|
1499 | cocher soient toutes rassemblées en fin de copie (cette option est
|
1500 | en général utilisée quand on ne veut scanner qu'une seule page par
|
1501 | étudiant - voir l'exemple de la <xref
|
1502 | linkend="secensemble"/>).</para>
|
1503 | </listitem>
|
1504 |
|
1505 | <listitem>
|
1506 | <para><option>chiffres</option> : si on utilise l'option
|
1507 | <option>ensemble</option>, l'option <option>chiffres</option>
|
1508 | demande d'identifier les questions avec des chiffres plutôt
|
1509 | qu'avec des lettres (ce qui est le comportement par défaut). Avec
|
1510 | cette option, il faut bien entendu veiller à ce que le nombre de
|
1511 | réponses ne dépasse pas 9 pour chaque question.</para>
|
1512 | </listitem>
|
1513 |
|
1514 | <listitem>
|
1515 | <para><option>outsidebox</option> : si on utilise l'option
|
1516 | <option>ensemble</option>, cette option demande à ce que les
|
1517 | lettres ou chiffres soient inscrits, sur la feuille de réponses, à
|
1518 | l'extérieur des cases à cocher plutôt qu'à l'intérieur.</para>
|
1519 | </listitem>
|
1520 |
|
1521 | <listitem>
|
1522 | <para><option>insidebox</option> : si on n'utilise pas l'option
|
1523 | <option>ensemble</option>, cette option permet d'inscrire des
|
1524 | lettres (ou chiffres) à l'intérieur des cases à cocher (ce n'est
|
1525 | pas le cas par défaut).</para>
|
1526 | </listitem>
|
1527 |
|
1528 | <listitem>
|
1529 | <para><option>catalog</option> : option utilisée pour présenter
|
1530 | les questions sous forme d'un catalogue dans lequel on piochera
|
1531 | pour constituer un examen. Les questions ne sont pas identifiées
|
1532 | par des numéros mais par leur nom. En général, on n'utilise pas la
|
1533 | commande <command>\exemplaire</command> pour cette
|
1534 | présentation.</para>
|
1535 | </listitem>
|
1536 |
|
1537 | <listitem>
|
1538 | <para><option>postcorrect</option> : option utilisée si on
|
1539 | souhaite indiquer les bonnes réponses après l'examen, grâce à une
|
1540 | copie remplie par l'enseignant - voir <xref
|
1541 | linkend="postcorrect"/>.</para>
|
1542 | </listitem>
|
1543 |
|
1544 | <listitem>
|
1545 | <para><option>automarks</option> : en mode
|
1546 | <option>ensemble</option>, utilisez cette option si vous voulez
|
1547 | que les marques de calage ne soient pas imprimées sur les pages de
|
1548 | sujet, mais uniquement sur les pages de réponse. Vous pouvez alors
|
1549 | personnaliser la façon d'imprimer les numéros de page sur le sujet
|
1550 | en redéfinissant la commande
|
1551 | <command>\AMCsubjectPageTag</command> :</para>
|
1552 |
|
1553 | <programlisting>\renewcommand\AMCsubjectPageTag{%
|
1554 | \fbox{\texttt{\the\AMCid@etud:\thepage}}%
|
1555 | }</programlisting>
|
1556 |
|
1557 | <warning>
|
1558 | <para>L'option <option>automarks</option> ne doit pas être
|
1559 | utilisée dans le cas ou une quelconque information doit être
|
1560 | collectée depuis les pages de sujet, car AMC ne pourra pas
|
1561 | traiter ces pages.</para>
|
1562 | </warning>
|
1563 | </listitem>
|
1564 | </itemizedlist>
|
1565 | </sect3>
|
1566 |
|
1567 | <sect3 id="sec.unecopie">
|
1568 | <title>Description d'une copie</title>
|
1569 |
|
1570 | <para>Le code LaTeX décrivant le contenu de chaque copie doit être
|
1571 | inclus dans un appel à la commande <command>\exemplaire</command>,
|
1572 | avec pour premier argument le nombre de copies et pour deuxième
|
1573 | argument le code utilisé pour générer une copie.</para>
|
1574 |
|
1575 | <programlisting>\exemplaire{50}{ ... }</programlisting>
|
1576 |
|
1577 | <para>Si vous avez chargé le paquet LaTeX <package>environ</package>
|
1578 | <emphasis>avant</emphasis> <package>automultiplechoice</package>, vous
|
1579 | disposez d'une syntaxe alternative utilisant l'environnement
|
1580 | <command>copieexamen</command>, qui a en option le nombre de copies
|
1581 | désiré (5 par défaut).</para>
|
1582 |
|
1583 | <programlisting>\begin{copieexamen}[50]
|
1584 | ...
|
1585 | \end{copieexamen}</programlisting>
|
1586 |
|
1587 | <note>
|
1588 | <para>Le paquet <package>environ</package> n'est pas disponible dans
|
1589 | la distribution TeX Live 2007, encore utilisée dans des
|
1590 | distributions Ubuntu jusqu'à la version 9.10 (Karmic Koala).</para>
|
1591 | </note>
|
1592 | </sect3>
|
1593 |
|
1594 | <sect3 id="latex.qr">
|
1595 | <title id="latex.qr.title">Questions et réponses</title>
|
1596 |
|
1597 | <para>Pour les questions simples (une seule réponse correcte), on
|
1598 | utilisera le modèle suivant : <programlisting
|
1599 | linenumbering="unnumbered">\begin{question}{identifiant}
|
1600 | Texte de la question...
|
1601 | \begin{reponses}
|
1602 | \bonne{La bonne réponse}
|
1603 | \mauvaise{Une mauvaise réponse}
|
1604 | \mauvaise{Une autre mauvaise réponse}
|
1605 | \end{reponses}
|
1606 | \end{question}</programlisting></para>
|
1607 |
|
1608 | <important>
|
1609 | <para>Il faut utiliser un <parameter>identifiant</parameter>
|
1610 | différent pour chaque question. Un identifiant peut être constitué
|
1611 | de chiffres, lettres et caractères simples (ne pas utiliser les
|
1612 | accolades, crochets, par exemple !). Il ne faut pas utiliser
|
1613 | d'identifiants se terminant par un point suivi d'un ou plusieurs
|
1614 | chiffres (comme <parameter>marine-marchande.2</parameter> ou
|
1615 | <parameter>123.27</parameter>), car cette forme d'identifiants est
|
1616 | réservée à la saisie de longs codes (par exemple grâce à
|
1617 | <command>\AMCcode</command> - voir <xref
|
1618 | linkend="latex.codes"/>).</para>
|
1619 | </important>
|
1620 |
|
1621 | <note>
|
1622 | <para>Le nombre de réponses pour une question est actuellement
|
1623 | limité à 20.</para>
|
1624 | </note>
|
1625 |
|
1626 | <para>Pour demander à garder l'ordre des réponses pour cette
|
1627 | question-ci, on peut utiliser l'option <option>o</option> de
|
1628 | l'environnement <option>reponses</option>, en remplaçant la ligne 3
|
1629 | par <programlisting>\begin{reponses}[o]</programlisting></para>
|
1630 |
|
1631 | <para>Pour mettre les réponses sur deux colonnes, on peut utiliser le
|
1632 | package <package>multicol</package> en mettant dans le préambule
|
1633 | (juste après l'appel au paquet <package>automultiplechoice</package>
|
1634 | par exemple) la ligne <programlisting>\usepackage{multicol}</programlisting>et
|
1635 | en incluant l'environnement reponses à l'intérieur d'un environnement
|
1636 | multicols de la manière suivante : <programlisting> \begin{multicols}{2}
|
1637 | \begin{reponses}
|
1638 | \bonne{La bonne réponse}
|
1639 | \mauvaise{Une mauvaise réponse}
|
1640 | \mauvaise{Une autre mauvaise réponse}
|
1641 | \end{reponses}
|
1642 | \end{multicols}</programlisting></para>
|
1643 |
|
1644 | <para>Pour les réponses plus courtes encore, on peut demander à ce que
|
1645 | les réponses soient imprimées les unes à la suite des autres, en
|
1646 | utilisant l'environnement <option>reponseshoriz</option> au lieu de
|
1647 | <option>reponses</option>.</para>
|
1648 |
|
1649 | <para>Les questions multiples (celles pour lesquelles aucune, une ou
|
1650 | plusieurs réponses peuvent être correctes) utiliseront l'environnement
|
1651 | <option>questionmult</option> au lieu de
|
1652 | <option>question</option>.</para>
|
1653 |
|
1654 | <para>Dans le cas où la question posée est juste informative et ne
|
1655 | doit pas contribuer à la note de l'étudiant, on utilisera la commande
|
1656 | <code>\QuestionIndicative</code>, comme dans l'exemple
|
1657 | suivant :</para>
|
1658 |
|
1659 | <para><programlisting>\begin{question}{facilite}\QuestionIndicative
|
1660 | \bareme{auto=0,v=-1,e=-2}
|
1661 | Vous êtes-vous sentis à l'aise ou en difficulté dans cet enseignement ?
|
1662 | Répondez sur une échelle de 0 (grandes difficultés) à 5 (très à l'aise).
|
1663 | \begin{reponseshoriz}[o]
|
1664 | \bonne{0}
|
1665 | \bonne{1}
|
1666 | \bonne{2}
|
1667 | \bonne{3}
|
1668 | \bonne{4}
|
1669 | \bonne{5}
|
1670 | \end{reponseshoriz}
|
1671 | \end{question}</programlisting></para>
|
1672 | </sect3>
|
1673 |
|
1674 | <sect3>
|
1675 | <title>Réponses sur plusieurs colonnes</title>
|
1676 |
|
1677 | <para>Afin de présenter les réponses sur plusieurs colonnes (et gagner
|
1678 | de la place), on pourra englober l'environnement
|
1679 | <option>reponses</option> dans un environnement
|
1680 | <option>multicols</option>, en utilisant le paquet LaTeX
|
1681 | <package>multicol</package>.</para>
|
1682 |
|
1683 | <para>Si de plus les réponses tiennent sur plusieurs lignes, cela
|
1684 | pourrait entraîner le passage d'une réponse d'une colonne à l'autre,
|
1685 | ce qui est un peu déroutant pour le lecteur. La commande
|
1686 | <command>\AMCBoxedAnswers</command> a été définie afin d'éviter ce
|
1687 | phénomène, en enveloppant chaque réponse dans une boite. On pourra
|
1688 | l'utiliser comme dans l'exemple suivant :</para>
|
1689 |
|
1690 | <para><programlisting>\begin{question}{deux colonnes}
|
1691 | Qu'est-ce qu'un oiseau ?
|
1692 | \begin{multicols}{2}\AMCBoxedAnswers
|
1693 | \begin{reponses}
|
1694 | \bonne{C'est un animal à ailes et qui pond des \oe{}ufs.
|
1695 | Il y en a de toutes les couleurs}
|
1696 | \mauvaise{C'est un grand meuble en bois qui sert la plupart
|
1697 | du temps à ranger du linge de maison}
|
1698 | \mauvaise{C'est une machine à vapeur qui permet de fermer
|
1699 | les boîtes de conserve à grande vitesse}
|
1700 | \end{reponses}
|
1701 | \end{multicols}
|
1702 | \end{question}</programlisting></para>
|
1703 |
|
1704 | <para>On notera qu'il est aussi possible de paramétrer l'espace
|
1705 | vertical séparant deux blocs de réponse grâce à la dimension
|
1706 | <parameter>AMCinterBrep</parameter> :</para>
|
1707 |
|
1708 | <para><programlisting>\AMCinterBrep=.5ex</programlisting></para>
|
1709 | </sect3>
|
1710 |
|
1711 | <sect3>
|
1712 | <title>Espacement entre les réponses</title>
|
1713 |
|
1714 | <para>Il est possible d'augmenter l'espace vertical séparant plusieurs
|
1715 | réponses en modifiant la dimension
|
1716 | <parameter>AMCinterIrep</parameter> :</para>
|
1717 |
|
1718 | <programlisting>\AMCinterIrep=.75ex</programlisting>
|
1719 | </sect3>
|
1720 |
|
1721 | <sect3>
|
1722 | <title>Groupes de questions</title>
|
1723 |
|
1724 | <para>L'inclusion de questions dans des groupes permet de mélanger les
|
1725 | questions à l'intérieur de ces groupes, de manière différente pour
|
1726 | chaque copie. Chaque groupe de questions devra avoir un nom formé
|
1727 | uniquement de lettres non-accentuées.</para>
|
1728 |
|
1729 | <para>On peut mettre une à une des questions dans un groupe, comme
|
1730 | dans l'exemple suivant : <programlisting>\element{ungroupe}{
|
1731 | \begin{question}{facile}
|
1732 | Alors, combien font un plus un~?
|
1733 | \begin{reponseshoriz}
|
1734 | \bonne{deux}
|
1735 | \mauvaise{zéro}
|
1736 | \mauvaise{trois}
|
1737 | \end{reponseshoriz}
|
1738 | \end{question}
|
1739 | }</programlisting></para>
|
1740 |
|
1741 | <important>
|
1742 | <para>La constitution du groupe, par les commandes
|
1743 | <command>element</command>, doit être faite une seule fois : ces
|
1744 | commandes doivent donc être utilisées <emphasis>avant</emphasis> la
|
1745 | commande <command>exemplaire</command>, qui va répéter certaines
|
1746 | actions pour chaque copie.</para>
|
1747 | </important>
|
1748 |
|
1749 | <para>Une fois un groupe constitué, on peut mélanger les questions qui
|
1750 | le composent par la commande <command>melangegroupe</command> : par
|
1751 | exemple, <programlisting>\melangegroupe{ungroupe}</programlisting></para>
|
1752 |
|
1753 | <para>Enfin, on restitue les questions du groupe par la commande
|
1754 | <command>restituegroupe</command>, comme dans <programlisting>\restituegroupe{ungroupe}</programlisting></para>
|
1755 |
|
1756 | <note>
|
1757 | <para>Ces deux dernières commandes (<command>melangegroupe</command>
|
1758 | et <command>restituegroupe</command>) seront quand à elles
|
1759 | normalement utilisées à l'intérieur du texte en argument de la
|
1760 | commande <command>exemplaire</command>, pour que le mélange soit
|
1761 | effectué avant chaque copie.</para>
|
1762 | </note>
|
1763 |
|
1764 | <para>On peut manipuler les groupes de questions de manière plus
|
1765 | précise grâce aux commandes suivantes :</para>
|
1766 |
|
1767 | <itemizedlist>
|
1768 | <listitem>
|
1769 | <para><code>\restituegroupe[n]{ungroupe}</code> (utilisation du
|
1770 | paramètre optionnel <replaceable>n</replaceable>) restitue
|
1771 | uniquement les <replaceable>n</replaceable> premiers éléments du
|
1772 | groupe.</para>
|
1773 | </listitem>
|
1774 |
|
1775 | <listitem>
|
1776 | <para><code>\cleargroup{groupe}</code> efface tout le contenu du
|
1777 | groupe.</para>
|
1778 | </listitem>
|
1779 |
|
1780 | <listitem>
|
1781 | <para><code>\copygroup{depuis}{vers}</code> copie le contenu du
|
1782 | groupe <replaceable>depuis</replaceable> à la fin du groupe
|
1783 | <replaceable>vers</replaceable>. Cette commande admet un argument
|
1784 | optionnel qui permet de ne copier qu'un certain nombre d'éléments,
|
1785 | comme dans <code>\copygroup[n]{depuis}{vers}</code>.</para>
|
1786 | </listitem>
|
1787 | </itemizedlist>
|
1788 |
|
1789 | <para>À l'aide de ces commandes, on peut par exemple composer un sujet
|
1790 | en prenant 4 questions au hasard dans le groupe GA, 5 questions au
|
1791 | hasard dans le groupe GB, toutes les questions du groupe GO, puis en
|
1792 | mélangeant le tout, grâce aux commandes suivantes (à mettre à
|
1793 | l'intérieur du texte en argument de la commande
|
1794 | <command>exemplaire</command>) :</para>
|
1795 |
|
1796 | <programlisting>\cleargroup{tout}
|
1797 | \melangegroupe{GA}\copygroup[4]{GA}{tout}
|
1798 | \melangegroupe{GB}\copygroup[5]{GB}{tout}
|
1799 | \copygroup{GO}{tout}
|
1800 | \melangegroupe{tout}
|
1801 | \restituegroupe{tout}</programlisting>
|
1802 | </sect3>
|
1803 |
|
1804 | <sect3>
|
1805 | <title>Papier, marges</title>
|
1806 |
|
1807 | <para>Le paquet LaTeX <command>automultiplechoice</command> utilise
|
1808 | <command>geometry</command> pour gérer les marges et la mise en page.
|
1809 | Vous pouvez modifier ses réglages grâce à l'utilisation de la commande
|
1810 | <command>\geometry</command> juste avant le
|
1811 | <code>\begin{document}</code> - voir la documentation du paquet
|
1812 | <command>geometry</command> pour plus de détails. Les valeurs
|
1813 | initialisées par AMC sont les suivantes :</para>
|
1814 |
|
1815 | <programlisting>\geometry{hmargin=3cm,headheight=2cm,headsep=.3cm,footskip=1cm,top=3.5cm,bottom=2.5cm}</programlisting>
|
1816 |
|
1817 | <para>Si vous réduisez les marges pour gagner de la place, gardez à
|
1818 | l'esprit que :</para>
|
1819 |
|
1820 | <itemizedlist>
|
1821 | <listitem>
|
1822 | <para>Les quatre marques de coin doivent être imprimées
|
1823 | entièrement (elles pourraient disparaître à cause des marges
|
1824 | d'impression).</para>
|
1825 | </listitem>
|
1826 |
|
1827 | <listitem>
|
1828 | <para>Les quatre marques de coin doivent apparaître complètement
|
1829 | sur les scans des copies remplies par les étudiants (si elles sont
|
1830 | trop près des bords, elles pourraient disparaître lors du scan à
|
1831 | la suite d'un décalage ou d'une rotation des feuilles de
|
1832 | papier).</para>
|
1833 | </listitem>
|
1834 | </itemizedlist>
|
1835 |
|
1836 | <para>Vous pouvez également préciser la taille de papier à utiliser en
|
1837 | ajoutant l'option correspondante à la liste donnée en argument à
|
1838 | <command>\geometry</command>. Parmi les valeurs possibles, on trouvera
|
1839 | <code>a4paper</code>, <code>a5paper</code>, <code>a6paper</code>,
|
1840 | <code>b4paper</code>, <code>b5paper</code>, <code>ansibpaper</code>,
|
1841 | <code>ansicpaper</code>, <code>ansidpaper</code>,
|
1842 | <code>letterpaper</code>, <code>executivepaper</code>,
|
1843 | <code>legalpaper</code>.</para>
|
1844 |
|
1845 | <para>Pour des petites tailles de papier, il peut aussi être
|
1846 | intéressant de modifier la position de l'identifiant de copie (de la
|
1847 | forme <code>+1/1/53+</code>) à côté de son équivalent en cases
|
1848 | blanches et noires, en haut de chaque page. Ceci est rendu possible
|
1849 | par la commande <command>\AMCidsPosition</command>, sous la
|
1850 | forme</para>
|
1851 |
|
1852 | <programlisting>\AMCidsPosition{pos=<replaceable>p</replaceable>,width=<replaceable>w</replaceable>,height=<replaceable>h</replaceable>}</programlisting>
|
1853 |
|
1854 | <para>où <replaceable>p</replaceable> peut valoir <code>none</code>
|
1855 | (ne pas écrire cet identifiant), <code>top</code> (l'écrire au-dessus)
|
1856 | et <code>side</code> (à côté), et <replaceable>w</replaceable> et
|
1857 | <replaceable>h</replaceable> sont les dimensions de la boîte
|
1858 | (invisible) qui entoure l'identifiant. Les valeurs par défaut sont les
|
1859 | suivantes :</para>
|
1860 |
|
1861 | <programlisting>\AMCidsPosition{pos=side,width=4cm,height=3ex}</programlisting>
|
1862 |
|
1863 | <para>Concluons par un exemple raisonnable au format A5 :</para>
|
1864 |
|
1865 | <programlisting>\geometry{a5paper,hmargin=1.6cm,top=2.5cm}
|
1866 | \AMCidsPosition{pos=top}</programlisting>
|
1867 | </sect3>
|
1868 |
|
1869 | <sect3>
|
1870 | <title>Style des cases à cocher</title>
|
1871 |
|
1872 | <para>La commande <command>\AMCboxDimensions</command> permet de
|
1873 | modifier une ou plusieurs dimensions relatives aux cases à
|
1874 | cocher :</para>
|
1875 |
|
1876 | <itemizedlist>
|
1877 | <listitem>
|
1878 | <para><option>shape</option> représente la forme des cases à
|
1879 | cocher. La valeur <replaceable>square</replaceable> produit des
|
1880 | carrés (ou des rectangles si on donne des dimensions différentes
|
1881 | pour la hauteur et la largeur). La valeur
|
1882 | <replaceable>oval</replaceable> produit des cercles ou des ovales.
|
1883 | Si vous voulez utiliser <replaceable>oval</replaceable>, vous
|
1884 | devez charger le paquet LaTeX tikz.</para>
|
1885 | </listitem>
|
1886 |
|
1887 | <listitem>
|
1888 | <para><option>width</option> représente la largeur des
|
1889 | cases ;</para>
|
1890 | </listitem>
|
1891 |
|
1892 | <listitem>
|
1893 | <para><option>height</option> représente la hauteur des
|
1894 | cases ;</para>
|
1895 | </listitem>
|
1896 |
|
1897 | <listitem>
|
1898 | <para><option>size</option> représente la taille (à la fois
|
1899 | <option>width</option> et <option>height</option>) de ces
|
1900 | cases ;</para>
|
1901 | </listitem>
|
1902 |
|
1903 | <listitem>
|
1904 | <para><option>rule</option> représente l'épaisseur du contour des
|
1905 | cases ;</para>
|
1906 | </listitem>
|
1907 |
|
1908 | <listitem>
|
1909 | <para><option>down</option> représente la taille du déplacement
|
1910 | vers le bas des cases.</para>
|
1911 | </listitem>
|
1912 | </itemizedlist>
|
1913 |
|
1914 | <para>Pour obtenir des cases plus petites, on pourra par exemple
|
1915 | utiliser la commande</para>
|
1916 |
|
1917 | <programlisting>\AMCboxDimensions{size=1.7ex,down=.2ex}</programlisting>
|
1918 |
|
1919 | <para>Lors de l'utilisation de l'option <option>ensemble</option>, il
|
1920 | est possible de modifier la manière de nommer les cases à cocher
|
1921 | (c'est-à-dire ce qui sera inscrit dans chaque case). Le comportement
|
1922 | par défaut est d'écrire des lettres majuscules, ou des chiffres si
|
1923 | l'option <option>chiffres</option> est utilisée. Pour changer cela, il
|
1924 | faut redéfinir la commande <command>\AMCchoiceLabel</command>, qui
|
1925 | prend comme unique argument le nom du compteur utilisé pour la
|
1926 | numérotation des cases. Ainsi, pour obtenir des lettres minuscules, on
|
1927 | utilisera</para>
|
1928 |
|
1929 | <programlisting>\def\AMCchoiceLabel#1{\alph{#1}}</programlisting>
|
1930 |
|
1931 | <para>De même, lors de l'utilisation du paquet LaTeX
|
1932 | <command>arabxetex</command>, la commande suivante pourra se révéler
|
1933 | utile :</para>
|
1934 |
|
1935 | <programlisting>\def\AMCchoiceLabel#1{\textLR{\Alph{#1}}}</programlisting>
|
1936 |
|
1937 | <para>Pour changer le style des lettres inscrites dans les cases, on
|
1938 | pourra également redéfinir la commande
|
1939 | <command>\AMCchoiceLabelFormat</command>. Par exemple, pour obtenir
|
1940 | des lettres grasses, on utilisera</para>
|
1941 |
|
1942 | <programlisting>\def\AMCchoiceLabelFormat#1{\textbf{#1}}</programlisting>
|
1943 |
|
1944 | <para>Notons enfin que la couleur des cases à cocher par les étudiants
|
1945 | peut être modifiée grâce à la commande</para>
|
1946 |
|
1947 | <programlisting>\AMCboxColor{red}</programlisting>
|
1948 |
|
1949 | <para>en remplaçant <code>red</code> par la couleur désirée (qui doit
|
1950 | être reconnue par le paquet LaTeX <command>xcolor</command>). Pour
|
1951 | obtenir un vert clair par exemple, on pourra par exemple
|
1952 | utiliser</para>
|
1953 |
|
1954 | <programlisting>\definecolor{amcboxcolor}{rgb}{0.67,0.88,0.5}
|
1955 | \AMCboxColor{amcboxcolor}</programlisting>
|
1956 | </sect3>
|
1957 |
|
1958 | <sect3>
|
1959 | <title>Style du questionnaire</title>
|
1960 |
|
1961 | <para>La façon dont chaque question est présentée peut être modifiée
|
1962 | en redéfinissant la commande LaTeX
|
1963 | <command>AMCbeginQuestion</command>, dont la définition par défaut est
|
1964 | la suivante :</para>
|
1965 |
|
1966 | <para><programlisting>\def\AMCbeginQuestion#1#2{\par\noindent{\bf Question #1} #2\hspace*{1em}}</programlisting></para>
|
1967 |
|
1968 | <para>Le premier paramètre transmis à cette commande est le numéro de
|
1969 | question à afficher. Le second paramètre contient
|
1970 | <code>\multiSymbole</code> dans le cas dune question à plusieurs
|
1971 | réponses possibles, et est vide dans les autres cas. La commande
|
1972 | <code>\multiSymbole</code> peut aussi être modifiée : elle a pour
|
1973 | charge de différentier les questions à réponses multiples des autres.
|
1974 | Par défaut, elle affiche un trèfle :</para>
|
1975 |
|
1976 | <para><programlisting>\def\multiSymbole{$\clubsuit$}</programlisting></para>
|
1977 |
|
1978 | <para>Enfin, on peut modifier le numéro de la prochaine question à
|
1979 | laide de la commande <code>\AMCnumero</code>. Au début de chaque
|
1980 | copie, un appel à</para>
|
1981 |
|
1982 | <para><programlisting>\AMCnumero{1}</programlisting></para>
|
1983 |
|
1984 | <para>est effectué, mais cette commande peut être utilisée à tout
|
1985 | moment.</para>
|
1986 |
|
1987 | <para>La présentation des réponses peut être modifiée de la même
|
1988 | façon, si on utilise l'environnement <option>reponsesperso</option> au
|
1989 | lieu de <option>reponses</option> ou <option>reponseshoriz</option>,
|
1990 | en redéfinissant les trois macros LaTeX suivantes :</para>
|
1991 |
|
1992 | <programlisting>\def\AMCbeginAnswer{}
|
1993 | \def\AMCendAnswer{}
|
1994 | \def\AMCAnswer#1#2{#1 #2}
|
1995 | </programlisting>
|
1996 |
|
1997 | <para>Certains espacements peuvent également être modifiés :</para>
|
1998 |
|
1999 | <programlisting>\AMCinterIrep=0pt
|
2000 | \AMCinterBrep=.5ex
|
2001 | \AMCinterIquest=0pt
|
2002 | \AMCinterBquest=3ex</programlisting>
|
2003 |
|
2004 | <para>Ces dimensions correspondent aux espaces verticaux ajoutés entre
|
2005 | les questions (<code>quest</code>) ou les réponses (<code>rep</code>),
|
2006 | en mode boîte (<code>B</code>, obtenu avec
|
2007 | <command>\AMCBoxedAnswers</command> ou l'option de package
|
2008 | <option>bloc</option>) ou standard (<code>I</code>).</para>
|
2009 | </sect3>
|
2010 |
|
2011 | <sect3>
|
2012 | <title>Mise en page</title>
|
2013 |
|
2014 | <para>Les marges ont été choisies de telle manière que le document
|
2015 | s'imprime correctement sur la majorité des imprimantes. Si votre
|
2016 | imprimante permet de les réduire, vous pouvez le faire en utilisant la
|
2017 | commande <command>geometry</command> du paquet LaTeX
|
2018 | <package>geometry</package>. Par exemple, pour resserrer le haut des
|
2019 | copies, on pourra utiliser <code>\geometry{top=3cm}</code> au lieu de
|
2020 | la valeur 3.5cm utilisée par défaut, juste avant le
|
2021 | <code>\begin{document}</code>.</para>
|
2022 | </sect3>
|
2023 |
|
2024 | <sect3>
|
2025 | <title>Style du formulaire séparé</title>
|
2026 |
|
2027 | <para>Il est aussi possible de modifier la mise en page du formulaire
|
2028 | de réponses séparé produit avec l'option <option>ensemble</option>
|
2029 | (voir section <xref linkend="secensemble"/>).</para>
|
2030 |
|
2031 | <orderedlist>
|
2032 | <listitem>
|
2033 | <para>Si on veut simplement modifier l'espacement horizontal entre
|
2034 | deux cases de réponses ou l'espacement vertical entre deux
|
2035 | questions, il suffit de redéfinir les dimensions
|
2036 | suivantes :</para>
|
2037 |
|
2038 | <programlisting>\AMCformHSpace=.3em
|
2039 | \AMCformVSpace=1.2ex
|
2040 | </programlisting>
|
2041 | </listitem>
|
2042 |
|
2043 | <listitem>
|
2044 | <para>Pour un changement plus profond de la mise en page, on peut
|
2045 | aussi redéfinir les commandes utilisées en début de chaque
|
2046 | question et pour chaque réponse (ici c'est la définition par
|
2047 | défaut) :</para>
|
2048 |
|
2049 | <programlisting>\def\AMCformQuestion#1{\vspace{\AMCformVSpace}\par{\bf Question #1 :}}
|
2050 | \def\AMCformAnswer#1{\hspace{\AMCformHSpace} #1}
|
2051 | </programlisting>
|
2052 | </listitem>
|
2053 | </orderedlist>
|
2054 |
|
2055 | <para>Ces définitions sont à insérer juste après la balise
|
2056 | <code>\begin{document}</code> dans le document LaTeX.</para>
|
2057 | </sect3>
|
2058 |
|
2059 | <sect3 id="latex.codes">
|
2060 | <title>Saisie de codes</title>
|
2061 |
|
2062 | <para>L'entrée de codes peut être aisément effectuée à l'aide de la
|
2063 | commande LaTeX <command>AMCcode</command>, par exemple pour que chaque
|
2064 | étudiant codifie son numéro d'étudiant lui-même sur sa copie. Les deux
|
2065 | arguments de cette commande sont un identifiant de question, auquel
|
2066 | sera ajouté le numéro du chiffre dans le code, ainsi que le nombre de
|
2067 | chiffres du codage désiré. On pourra par exemple utiliser l'entête de
|
2068 | copie suivant :</para>
|
2069 |
|
2070 | <para><programlisting>{\setlength{\parindent}{0pt}\hspace*{\fill}\AMCcode{etu}{8}\hspace*{\fill}
|
2071 | \begin{minipage}[b]{6.5cm}
|
2072 | $\longleftarrow{}$\hspace{0pt plus 1cm} codez votre numéro d'étu\-diant ci-contre,
|
2073 | et inscrivez votre nom et prénom ci-dessous.
|
2074 |
|
2075 | \vspace{3ex}
|
2076 |
|
2077 | \hfill\champnom{\fbox{
|
2078 | \begin{minipage}{.9\linewidth}
|
2079 | Nom et prénom :
|
2080 |
|
2081 | \vspace*{.5cm}\dotfill
|
2082 |
|
2083 | \vspace*{.5cm}\dotfill
|
2084 | \vspace*{1mm}
|
2085 | \end{minipage}
|
2086 | }}\hfill\vspace{5ex}\end{minipage}\hspace*{\fill}
|
2087 |
|
2088 | }
|
2089 | </programlisting></para>
|
2090 |
|
2091 | <para>Dans le cas de l'utilisation de l'option
|
2092 | <option>ensemble</option>, la commande <command>AMCcode</command>
|
2093 | devra se trouver dans la partie formulaire, c'est-à-dire après la
|
2094 | commande <command>AMCdebutFormulaire</command>.</para>
|
2095 |
|
2096 | <para>Notez enfin que la présentation de ces formulaires de saisie de
|
2097 | codes peut être légèrement modifiée en changeant la valeur des
|
2098 | dimensions <command>\AMCcodeHspace</command>,
|
2099 | <command>\AMCcodeVspace</command> et
|
2100 | <command>\AMCcodeBoxSep</command>, qui représentent les espaces
|
2101 | horizontaux et verticaux entre les cases, ainsi que les espaces entre
|
2102 | les cases et leurs étiquette (dans le cas où celles-ci sont inscrites
|
2103 | à côté). Les valeurs par défaut sont définies de la manière
|
2104 | suivante :</para>
|
2105 |
|
2106 | <programlisting>\AMCcodeHspace=.5em
|
2107 | \AMCcodeVspace=.5em
|
2108 | \AMCcodeBoxSep=.1em</programlisting>
|
2109 |
|
2110 | <para>Notons enfin qu'il existe aussi la version horizontale
|
2111 | <command>AMCcodeH</command> de cette commande, particulièrement utile
|
2112 | pour un faible nombre de chiffres dans le code à saisir.</para>
|
2113 | </sect3>
|
2114 |
|
2115 | <sect3 id="questionsouvertes">
|
2116 | <title>Questions ouvertes</title>
|
2117 |
|
2118 | <para>On peut ajouter des questions ouvertes (qui ne sont pas à choix
|
2119 | multiple) à l'intérieur du sujet.</para>
|
2120 |
|
2121 | <para>Une manière de procéder consiste à présenter des cases à cocher
|
2122 | par le correcteur. Après l'examen, le correcteur lit la réponse
|
2123 | fournie par l'étudiant et affecte les points qui correspondent en
|
2124 | cochant certaines cases qui lui sont réservées. Il peut ensuite
|
2125 | scanner les copies et utiliser AMC pour les corriger, tout en
|
2126 | intégrant les résultats des questions ouvertes dans la notation (dans
|
2127 | l'exemple suivant, chaque case cochée rapporte un demi-point à
|
2128 | l'étudiant) : <programlisting>\begin{question}{ouverte}
|
2129 | Donnez la d\'efinition de l'inflation.
|
2130 | \AMCOpen{lines=5}{\wrongchoice[F]{f}\scoring{0}\wrongchoice[P]{p}\scoring{1}\correctchoice[J]{j}\scoring{2}}
|
2131 | \end{question}
|
2132 | </programlisting></para>
|
2133 |
|
2134 | <para>Dans cet exemple, l'enseignant disposera de trois cases. En
|
2135 | cochant la première (nommée F pour faux), l'étudiant n'aura aucun
|
2136 | point. En cochant la deuxième (appelée P pour partielle), l'étudiant
|
2137 | aura 1 point. En cochant la dernière (nommée J pour juste), l'étudiant
|
2138 | optiendra 2 points.</para>
|
2139 |
|
2140 | <para>Le premier argument de la commande <command>\AMCOpen</command>
|
2141 | est une liste d'options séparées par des virgules. Les options
|
2142 | disponibles sont les suivantes :</para>
|
2143 |
|
2144 | <variablelist>
|
2145 | <varlistentry>
|
2146 | <term>lineup=<replaceable>bool</replaceable></term>
|
2147 |
|
2148 | <listitem>
|
2149 | <para>avec la valeur <code>true</code>, la zone de réponse et
|
2150 | les cases de notation sont présentées sur la même ligne. Avec la
|
2151 | valeur <code>false</code> (c'est la valeur par défaut), la zone
|
2152 | de réponse est présentée dans un cadre placé en-dessous des
|
2153 | cases à cocher).</para>
|
2154 | </listitem>
|
2155 | </varlistentry>
|
2156 |
|
2157 | <varlistentry>
|
2158 | <term>lines=<replaceable>num</replaceable></term>
|
2159 |
|
2160 | <listitem>
|
2161 | <para>fixe le nombre de lignes allouées à la réponse (la valeur
|
2162 | par défaut est <code>1)</code>.</para>
|
2163 | </listitem>
|
2164 | </varlistentry>
|
2165 |
|
2166 | <varlistentry>
|
2167 | <term>lineheight=<replaceable>dim</replaceable></term>
|
2168 |
|
2169 | <listitem>
|
2170 | <para>fixe la hauteur de chaque ligne (la valeur par défaut est
|
2171 | <code>1cm</code>).</para>
|
2172 | </listitem>
|
2173 | </varlistentry>
|
2174 |
|
2175 | <varlistentry>
|
2176 | <term>dots=<replaceable>bool</replaceable></term>
|
2177 |
|
2178 | <listitem>
|
2179 | <para>avec la valeur <code>true</code> (par défaut), chaque
|
2180 | ligne sera matérialisée par des pointillés. Donner la valeur
|
2181 | <code>false</code> pour les supprimer.</para>
|
2182 | </listitem>
|
2183 | </varlistentry>
|
2184 |
|
2185 | <varlistentry>
|
2186 | <term>contentcommand=<replaceable>cmdname</replaceable></term>
|
2187 |
|
2188 | <listitem>
|
2189 | <para>cette option peut être utilisée pour personnaliser le
|
2190 | contenu de la zone de réponse. Il faut définir une commande
|
2191 | <command>\<replaceable>cmdname</replaceable></command> qui devra
|
2192 | produire le contenu désiré.</para>
|
2193 | </listitem>
|
2194 | </varlistentry>
|
2195 |
|
2196 | <varlistentry>
|
2197 | <term>hspace=<replaceable>dim</replaceable></term>
|
2198 |
|
2199 | <listitem>
|
2200 | <para>fixe l'espace à ajouter entre les cases de la zone de
|
2201 | notation.</para>
|
2202 | </listitem>
|
2203 | </varlistentry>
|
2204 |
|
2205 | <varlistentry>
|
2206 | <term>backgroundcol=<replaceable>color</replaceable></term>
|
2207 |
|
2208 | <listitem>
|
2209 | <para>fixe la couleur de fond de la zone de notation.</para>
|
2210 | </listitem>
|
2211 | </varlistentry>
|
2212 |
|
2213 | <varlistentry>
|
2214 | <term>foregroundcol=<replaceable>color</replaceable></term>
|
2215 |
|
2216 | <listitem>
|
2217 | <para>fixe la couleur utilisée dans la zone de notation.</para>
|
2218 | </listitem>
|
2219 | </varlistentry>
|
2220 |
|
2221 | <varlistentry>
|
2222 | <term>scan=<replaceable>bool</replaceable></term>
|
2223 |
|
2224 | <listitem>
|
2225 | <para>avec la valeur <code>false</code>, la saisie automatique
|
2226 | (à partir des scans) n'est pas effectuée pour cette question
|
2227 | (cela peut être utile si vous souhaitez utiliser uniquement la
|
2228 | saisie manuelle pour noter la question, et que vous ne voulez
|
2229 | pas que les étudiants puissent perturber le processus en cochant
|
2230 | ces cases). La valeur par défaut est <code>true</code>.</para>
|
2231 | </listitem>
|
2232 | </varlistentry>
|
2233 |
|
2234 | <varlistentry>
|
2235 | <term>annotate=<replaceable>bool</replaceable></term>
|
2236 |
|
2237 | <listitem>
|
2238 | <para>avec la valeur <code>false</code> (par défaut), les cases
|
2239 | correspondantes à cette question ne seront pas annotées lors de
|
2240 | la fabrication des copies annotées (seule le score à la question
|
2241 | sera écrit).</para>
|
2242 | </listitem>
|
2243 | </varlistentry>
|
2244 |
|
2245 | <varlistentry>
|
2246 | <term>question=<replaceable>texte</replaceable></term>
|
2247 |
|
2248 | <listitem>
|
2249 | <para>donne un texte court pour que le correcteur identifie
|
2250 | facilement la question posée. Ce texte sera écrit juste avant
|
2251 | les cases de notation, uniquement dans le cas de l'utilisation
|
2252 | d'une feuille de réponses séparée.</para>
|
2253 | </listitem>
|
2254 | </varlistentry>
|
2255 |
|
2256 | <varlistentry>
|
2257 | <term>answer=<replaceable>texte</replaceable></term>
|
2258 |
|
2259 | <listitem>
|
2260 | <para>donne un texte court qui sera inscrit dans la zone de
|
2261 | réponse sur la correction.</para>
|
2262 | </listitem>
|
2263 | </varlistentry>
|
2264 |
|
2265 | <varlistentry>
|
2266 | <term>width=<replaceable>dim</replaceable></term>
|
2267 |
|
2268 | <listitem>
|
2269 | <para>donne la dimension horizontale du cadre entoutant la zone
|
2270 | de réponse dans le cas <code>lineup=false</code>. La valeur par
|
2271 | défaut est <code>.95\linewidth</code>.</para>
|
2272 | </listitem>
|
2273 | </varlistentry>
|
2274 |
|
2275 | <varlistentry>
|
2276 | <term>framerule=<replaceable>dim</replaceable></term>
|
2277 |
|
2278 | <listitem>
|
2279 | <para>donne l'épaisseur du trait pour le cadre entoutant la zone
|
2280 | de réponse.</para>
|
2281 | </listitem>
|
2282 | </varlistentry>
|
2283 |
|
2284 | <varlistentry>
|
2285 | <term>framerulecol=<replaceable>color</replaceable></term>
|
2286 |
|
2287 | <listitem>
|
2288 | <para>donne la couleur du cadre entoutant la zone de
|
2289 | réponse.</para>
|
2290 | </listitem>
|
2291 | </varlistentry>
|
2292 |
|
2293 | <varlistentry>
|
2294 | <term>boxmargin=<replaceable>dim</replaceable></term>
|
2295 |
|
2296 | <listitem>
|
2297 | <para>donne la taille de la marge entourant les cases de la zone
|
2298 | de notation.</para>
|
2299 | </listitem>
|
2300 | </varlistentry>
|
2301 |
|
2302 | <varlistentry>
|
2303 | <term>boxframerule=<replaceable>dim</replaceable></term>
|
2304 |
|
2305 | <listitem>
|
2306 | <para>donne l'épaisseur du trait pour le cadre entourant la zone
|
2307 | de notation.</para>
|
2308 | </listitem>
|
2309 | </varlistentry>
|
2310 |
|
2311 | <varlistentry>
|
2312 | <term>boxframerulecol=<replaceable>color</replaceable></term>
|
2313 |
|
2314 | <listitem>
|
2315 | <para>donne la couleur du trait pour le cadre entourant la zone
|
2316 | de notation.</para>
|
2317 | </listitem>
|
2318 | </varlistentry>
|
2319 | </variablelist>
|
2320 |
|
2321 | <para>Vous pouvez modifier la valeur par défaut (pour tout votre
|
2322 | questionnaire) de toutes ces options grâce à la commande
|
2323 | <command>\AMCopenOpts</command>, comme</para>
|
2324 |
|
2325 | <programlisting>\AMCopenOpts{boxframerule=2pt,boxframerulecol=red}</programlisting>
|
2326 |
|
2327 | <para>De plus, on peut ajouter un petit texte dans la zone de notation
|
2328 | pour signifier aux étudiants de ne pas cocher ces cases-là en
|
2329 | redéfinissant la commande <command>\AMCotextReserved</command> comme
|
2330 | suit :</para>
|
2331 |
|
2332 | <programlisting>\def\AMCotextReserved{\emph{Reservé}}</programlisting>
|
2333 |
|
2334 | <para>Dans le cas de l'utilisation d'une feuille de réponse séparée,
|
2335 | on peut également ajouter un petit texte à chaque question ouverte
|
2336 | comme suit :</para>
|
2337 |
|
2338 | <programlisting>\def\AMCotextGoto{\par{\bf\emph{Répondez sur la feuille de réponses.}}}</programlisting>
|
2339 | </sect3>
|
2340 |
|
2341 | <sect3>
|
2342 | <title>Choix du mélange</title>
|
2343 |
|
2344 | <para>Si le mélange des question et des réponses ne nous convient pas,
|
2345 | on peut toujours en changer en modifiant la graine du générateur
|
2346 | aléatoire utilisé pour le mélange, grâce à la commande suivante (à
|
2347 | utiliser juste au début du document, et en tous cas en-dehors de la
|
2348 | commande <command>exemplaire</command>) :</para>
|
2349 |
|
2350 | <para><programlisting>\AMCrandomseed{1527384}</programlisting></para>
|
2351 |
|
2352 | <para>Si la valeur fournie (à choisir entre 1 et 4194303) est
|
2353 | modifiée, alors le mélange sera différent. Bien entendu, une fois les
|
2354 | copies d'examen imprimées, il ne faut surtout pas modifier cette
|
2355 | valeur !</para>
|
2356 | </sect3>
|
2357 |
|
2358 | <sect3>
|
2359 | <title>Sections et feuille de réponses séparée</title>
|
2360 |
|
2361 | <para>Pour que les sections définies dans votre sujet soient reprises
|
2362 | dans la feuille de réponses séparées, utiliser
|
2363 | <command>\AMCsection</command> et <command>\AMCsubsection</command> à
|
2364 | la place de <command>\section</command> et
|
2365 | <command>\subsection</command>.</para>
|
2366 | </sect3>
|
2367 |
|
2368 | <sect3>
|
2369 | <title>Références à l'intérieur des copies</title>
|
2370 |
|
2371 | <para>Dans la description du sujet, les commandes LaTeX
|
2372 | <command>\label</command>, <command>\ref</command> et
|
2373 | <command>\pageref</command> posent problème car elles seront appelées
|
2374 | avec les mêmes arguments pour chaque copie produite, ce qui perturbera
|
2375 | la numérotation des références. Pour résoudre ce problème, les
|
2376 | commandes <command>\AMClabel</command>, <command>\AMCref</command> et
|
2377 | <command>\AMCpageref</command> peuvent leur être substituées : elles
|
2378 | ajoutent le numéro de la copie avant leur argument avant de le
|
2379 | transmettre à <command>\label</command>, <command>\ref</command> et
|
2380 | <command>\pageref</command>.
|
2381 | Pour faire référence à une question, utilisez la commande <command>\AMCqlabel</command></para>
|
2382 |
|
2383 | <para>Il faudra en outre penser à remettre les compteurs utilisés à
|
2384 | zéro au début de chaque copie. Par exemple, si on veut inclure des
|
2385 | références à des images regroupées dans une page à part dans certaines
|
2386 | questions, on pourra écrire quelque chose comme</para>
|
2387 |
|
2388 | <programlisting>\element{animaux}{
|
2389 | \begin{figure}[p]
|
2390 | \centering
|
2391 | \includegraphics[width=.6\linewidth]{tigre}
|
2392 | \caption{Un animal}
|
2393 | \AMClabel{tigre}
|
2394 | \end{figure}
|
2395 |
|
2396 | \begin{question}{tigre}
|
2397 | Quel est l'animal sur la photographie de la figure~\AMCref{tigre} en page \AMCpageref{tigre}~?
|
2398 | \begin{reponses}
|
2399 | \bonne{Un tigre}
|
2400 | \mauvaise{Une girafe}
|
2401 | \mauvaise{Un éléphant}
|
2402 | \mauvaise{Un chat}
|
2403 | \end{reponses}
|
2404 | \end{question}
|
2405 | }</programlisting>
|
2406 |
|
2407 | <para>en prenant soin d'ajouter au début de l'appel à
|
2408 | <command>\exemplaire</command> (lors de la description de l'en-tête
|
2409 | des copies) la ligne</para>
|
2410 |
|
2411 | <programlisting>\setcounter{figure}{0}</programlisting>
|
2412 |
|
2413 | <para>afin que les figures soient numérotées à partir de 1 pour chaque
|
2414 | copie. Sans cette dernière commande, la numérotation des figures
|
2415 | continuerait d'une copie à l'autre, ce qui n'est pas
|
2416 | souhaitable.</para>
|
2417 | </sect3>
|
2418 |
|
2419 | <sect3>
|
2420 | <title>Personnalisation des textes insérés par AMC</title>
|
2421 |
|
2422 | <para>Il est possible de personnaliser certain textes insérés par le
|
2423 | paquet automultiplechoice, grâce à la commande
|
2424 | <command>\AMCtext</command> :</para>
|
2425 |
|
2426 | <itemizedlist>
|
2427 | <listitem>
|
2428 | <para><code>\AMCtext{none}{<replaceable>phrase</replaceable>}</code>
|
2429 | remplace le texte par défaut « aucune de ces réponses n'est
|
2430 | correcte » (en français) par la <replaceable>phrase</replaceable>
|
2431 | fournie lors de l'utilisation de l'option
|
2432 | <option>completemulti</option>.</para>
|
2433 | </listitem>
|
2434 |
|
2435 | <listitem>
|
2436 | <para><code>\AMCtext{corrected}{<replaceable>titre</replaceable>}</code>
|
2437 | remplace « Correction » (en français) par le
|
2438 | <replaceable>titre</replaceable> fourni sur la correction de
|
2439 | l'examen.</para>
|
2440 | </listitem>
|
2441 |
|
2442 | <listitem>
|
2443 | <para><code>\AMCtext{catalog}{<replaceable>titre</replaceable>}</code>
|
2444 | remplace « Catalogue » (en français) par le
|
2445 | <replaceable>titre</replaceable> fourni sur le catalogue de
|
2446 | questions fourni avec l'option <option>catalog</option>.</para>
|
2447 | </listitem>
|
2448 |
|
2449 | <listitem>
|
2450 | <para>Vous pouvez aussi considérer l'utilisation de commandes
|
2451 | comme celles-ci (données ici avec comme deuxième argument la
|
2452 | valeur par défaut en français) :</para>
|
2453 |
|
2454 | <programlisting>\AMCtext{draft}{PROJET}
|
2455 | \AMCtext{message}{Pour votre examen, imprimez de pr\'ef\'erence
|
2456 | les documents compil\'es \`a l'aide de auto-multiple-choice.}</programlisting>
|
2457 | </listitem>
|
2458 | </itemizedlist>
|
2459 | </sect3>
|
2460 | </sect2>
|
2461 |
|
2462 | <sect2>
|
2463 | <title>Options pour AMC</title>
|
2464 |
|
2465 | <para>Certaines options indiquées dans l'en-tête du fichier source au
|
2466 | format LaTeX (c'est-à-dire les premières lignes qui commenecnt par
|
2467 | un'%') peuvent être transmises à AMC :</para>
|
2468 |
|
2469 | <variablelist>
|
2470 | <varlistentry>
|
2471 | <term><code>%%AMC:preprocess_command=<replaceable>commandname</replaceable></code></term>
|
2472 |
|
2473 | <listitem>
|
2474 | <para>demande à AMC d'exécuter la commande
|
2475 | <replaceable>commandname</replaceable> avant de compiler le
|
2476 | fichier LaTeX. Cette commande sera appelée à l'intérieur du
|
2477 | répertoire projet, avec comme argument le nom de la copie du
|
2478 | fichier source à traiter. Comme il s'agit d'une copie du fichier
|
2479 | source, la commande <replaceable>commandname</replaceable> peut en
|
2480 | modifier le contenu.</para>
|
2481 | </listitem>
|
2482 | </varlistentry>
|
2483 |
|
2484 | <varlistentry>
|
2485 | <term><code>%%AMC:latex_engine=<replaceable>engine</replaceable></code></term>
|
2486 |
|
2487 | <listitem>
|
2488 | <para>demande à AMC d'utiliser le moteur LaTeX
|
2489 | <replaceable>engine</replaceable>, sans tenir compte de la valeur
|
2490 | fournie par l'utilisateur dans les préférences du projet.</para>
|
2491 | </listitem>
|
2492 | </varlistentry>
|
2493 | </variablelist>
|
2494 | </sect2>
|
2495 |
|
2496 | <sect2>
|
2497 | <title>Des questions mathématiques à énoncés aléatoires</title>
|
2498 |
|
2499 | <sect3>
|
2500 | <title>Utilisation du package fp</title>
|
2501 |
|
2502 | <para>Grâce au paquet LaTeX <package>fp</package>, dont la
|
2503 | documentation se trouve sur <ulink
|
2504 | url="http://mirrors.ctan.org/macros/latex/contrib/fp/README">http://mirrors.ctan.org/macros/latex/contrib/fp/README</ulink>
|
2505 | et que l'on peut charger grâce à la commande<programlisting>\usepackage{fp}</programlisting>ajoutée
|
2506 | avant celle correspondant à <package>automultiplechoice</package>, on
|
2507 | peut créer des exercices dont les données sont aléatoires. Commençons
|
2508 | par un petit exemple :</para>
|
2509 |
|
2510 | <para><programlisting>\begin{question}{addition}
|
2511 | \FPeval\VQa{trunc(1+random*8,0)} <co id="alea.random"
|
2512 | linkends="alea.random.exp"/>
|
2513 | \FPeval\VQb{trunc(4+random*5,0)}
|
2514 | \FPeval\VQsomme{clip(VQa+VQb)} <co id="alea.result"
|
2515 | linkends="alea.result.exp"/>
|
2516 | \FPeval\VQnonA{clip(VQa+VQb-1)} <co id="alea.fausse"
|
2517 | linkends="alea.fausse.exp"/>
|
2518 | \FPeval\VQnonB{clip(VQa*VQb)}
|
2519 | \FPeval\VQnonC{clip(VQa-VQb)}
|
2520 |
|
2521 | Quelle est la somme de \VQa{} et \VQb{} ?
|
2522 | \begin{reponseshoriz}
|
2523 | \bonne{\VQsomme}
|
2524 | \mauvaise{\VQnonA}
|
2525 | \mauvaise{\VQnonB}
|
2526 | \mauvaise{\VQnonC}
|
2527 | \end{reponseshoriz}
|
2528 | \end{question}</programlisting></para>
|
2529 |
|
2530 | <para>La commande <command>\FPeval</command> sert à faire des
|
2531 | calculs :</para>
|
2532 |
|
2533 | <para><calloutlist>
|
2534 | <callout arearefs="alea.random" id="alea.random.exp">
|
2535 | <para>Comme <command>random</command> renvoie un nombre réel de
|
2536 | l'intervalle [0,1], cette commande met dans la variable VQa un
|
2537 | entier aléatoire entre 1 et 8. La ligne suivante place dans VQb
|
2538 | un entier aléatoire entre 4 et 8.</para>
|
2539 | </callout>
|
2540 |
|
2541 | <callout arearefs="alea.result" id="alea.result.exp">
|
2542 | <para>On place la bonne réponse dans la variable VQsomme.</para>
|
2543 | </callout>
|
2544 |
|
2545 | <callout arearefs="alea.fausse" id="alea.fausse.exp">
|
2546 | <para>On place dans les variables VQnonA, VQnonB et VQnonC des
|
2547 | mauvaises réponses...</para>
|
2548 | </callout>
|
2549 | </calloutlist>Les noms de variables commençant par VQ ont été
|
2550 | choisis afin de ne pas interférer avec d'autres commandes
|
2551 | LaTeX.</para>
|
2552 |
|
2553 | <sect4 id="latex.intervals">
|
2554 | <title>Choix parmi une suite d'intervalles</title>
|
2555 |
|
2556 | <para>La paquet automultiplechoice définit en outre une commande
|
2557 | <command>\choixIntervalle</command> qui simplifie ce genre de
|
2558 | constructions, comme illustré dans l'exemple
|
2559 | suivant :<programlisting>\begin{question}{inf-expo-indep}
|
2560 | \FPeval\VQa{trunc(2 + random * 4,0)}
|
2561 | \FPeval\VQb{trunc(6 + random * 5,0)}
|
2562 | \FPeval\VQr{VQa/(VQa+VQb)}
|
2563 |
|
2564 | Soient $X$ et $Y$ deux variables aléatoires indépendantes, de lois exponentielles
|
2565 | de paramètres respectifs \VQa{} et \VQb{}.
|
2566 | À quel intervalle appartient la probabilité $\mathbb{P}[X<Y]$ ?
|
2567 |
|
2568 | \begin{multicols}{5}
|
2569 | \begin{reponses}[o]
|
2570 | \choixIntervalles{\VQr}{0}{1}{0.1} <co id="choix.intervalles"
|
2571 | linkends="choix.intervalles.exp"/>
|
2572 | \end{reponses}
|
2573 | \end{multicols}
|
2574 | \end{question}</programlisting></para>
|
2575 |
|
2576 | <calloutlist>
|
2577 | <callout arearefs="choix.intervalles" id="choix.intervalles.exp">
|
2578 | <para>Cette ligne insère dix réponses correspondant aux
|
2579 | intervalles [0,0.1[ [0.1,0.2[ ... [0.9,1[, tout en indiquant que
|
2580 | le bon intervalle est celui qui contient VQr. Les arguments de
|
2581 | la commande <command>\choixIntervalle</command> sont les
|
2582 | suivants :</para>
|
2583 |
|
2584 | <orderedlist>
|
2585 | <listitem>
|
2586 | <para>La bonne réponse,</para>
|
2587 | </listitem>
|
2588 |
|
2589 | <listitem>
|
2590 | <para>La borne gauche du premier intervalle,</para>
|
2591 | </listitem>
|
2592 |
|
2593 | <listitem>
|
2594 | <para>La borne droite du dernier intervalle,</para>
|
2595 | </listitem>
|
2596 |
|
2597 | <listitem>
|
2598 | <para>La longueur de chaque intervalle.</para>
|
2599 | </listitem>
|
2600 | </orderedlist>
|
2601 | </callout>
|
2602 | </calloutlist>
|
2603 |
|
2604 | <para>La mise en forme des intervalles peut être modifiée en
|
2605 | redéfinissant la commande LaTeX
|
2606 | <command>\AMCintervalFormat</command>, définie originellement
|
2607 | par</para>
|
2608 |
|
2609 | <programlisting>\def\AMCIntervalFormat#1#2{[#1,\,#2[}</programlisting>
|
2610 |
|
2611 | <para>pour suivre une convention différente (on rencontra par
|
2612 | exemple souvent l'utilisation de [a,b) à la place de [a,b[).</para>
|
2613 | </sect4>
|
2614 |
|
2615 | <sect4 id="latex.numeric">
|
2616 | <title>Codage du résultat</title>
|
2617 |
|
2618 | <para>Vous pouvez également demander aux étudiants de coder leur
|
2619 | réponse numérique, grâce à la commande
|
2620 | <command>\AMCnumericChoices</command>, comme dans l'exemple
|
2621 | suivant :</para>
|
2622 |
|
2623 | <programlisting>\begin{questionmultx}{sqrt}
|
2624 | \FPeval\VQa{trunc(5+random*15,0)}
|
2625 | \FPeval\VQs{VQa^0.5}
|
2626 | Calculez $\sqrt{\VQa}$ et arrondissez le résultat avec deux chiffres
|
2627 | après la virgule.
|
2628 |
|
2629 | \AMCnumericChoices{\VQs}{digits=3,decimals=2,sign=true,
|
2630 | borderwidth=0pt,backgroundcol=lightgray,approx=5}
|
2631 | \end{questionmultx}
|
2632 | </programlisting>
|
2633 |
|
2634 | <para>Notez l'utilisation de l'environnement
|
2635 | <code>questionmultx</code> : nous avons besoin ici d'une question
|
2636 | multiple car plusieurs cases doivent être cochées, mais pourtant une
|
2637 | seule réponse est correcte, et nous ne souhaitons donc pas afficher
|
2638 | le symbole des questions multiples normales.</para>
|
2639 |
|
2640 | <para>Les options disponibles dans le deuxième argument de cette
|
2641 | commande sont les suivants :</para>
|
2642 |
|
2643 | <variablelist>
|
2644 | <varlistentry>
|
2645 | <term>digits=<replaceable>num</replaceable></term>
|
2646 |
|
2647 | <listitem>
|
2648 | <para>donne le nombre de chiffres à coder (la valeur par
|
2649 | défaut est 3).</para>
|
2650 | </listitem>
|
2651 | </varlistentry>
|
2652 |
|
2653 | <varlistentry>
|
2654 | <term>decimals=<replaceable>num</replaceable></term>
|
2655 |
|
2656 | <listitem>
|
2657 | <para>donne le nombre de chiffres après la virgule (la valeur
|
2658 | par défaut est 0). Quand <replaceable>num</replaceable> n'est
|
2659 | pas nul, le paquet LaTeX <command>fp</command> doit être
|
2660 | chargé.</para>
|
2661 | </listitem>
|
2662 | </varlistentry>
|
2663 |
|
2664 | <varlistentry>
|
2665 | <term>base=<replaceable>num</replaceable></term>
|
2666 |
|
2667 | <listitem>
|
2668 | <para>donne la base dans laquelle sera écrit le nombre à coder
|
2669 | (la valeur par défaut est 10).</para>
|
2670 | </listitem>
|
2671 | </varlistentry>
|
2672 |
|
2673 | <varlistentry>
|
2674 | <term>significant=<replaceable>bool</replaceable></term>
|
2675 |
|
2676 | <listitem>
|
2677 | <para>avec la valeur <code>true</code>, les chiffres à
|
2678 | renseigner sont les premiers chiffres significatifs du premier
|
2679 | argument de <command>\AMCnumericChoices</command>. Par
|
2680 | exemple, la bonne réponse à
|
2681 | <code>\AMCnumericChoices{56945.23}{digits=2,significant=true}</code>
|
2682 | est 57.</para>
|
2683 | </listitem>
|
2684 | </varlistentry>
|
2685 |
|
2686 | <varlistentry>
|
2687 | <term>nozero=<replaceable>bool</replaceable></term>
|
2688 |
|
2689 | <listitem>
|
2690 | <para>avec la valeur true, enlève le choix 0 pour tous les
|
2691 | chiffres du nombre à saisir. Cette option peut être utile lors
|
2692 | de la saisie de petits (<10) nombres non nuls.</para>
|
2693 | </listitem>
|
2694 | </varlistentry>
|
2695 |
|
2696 | <varlistentry>
|
2697 | <term>sign=<replaceable>bool</replaceable></term>
|
2698 |
|
2699 | <listitem>
|
2700 | <para>demande (ou non) la saisie d'un signe (la valeur par
|
2701 | défaut les <code>true</code>).</para>
|
2702 | </listitem>
|
2703 | </varlistentry>
|
2704 |
|
2705 | <varlistentry>
|
2706 | <term>strict=<replaceable>bool</replaceable></term>
|
2707 |
|
2708 | <listitem>
|
2709 | <para>avec la valeur <code>true</code>, une case doit être
|
2710 | obligatoirement cochée pour le signe et pour chaque chiffre.
|
2711 | Avec la valeur <code>false</code> (valeur par défaut), si pour
|
2712 | certains chiffres aucune case n'est cochée, ces chiffres
|
2713 | seront fixés à la valeur 0.</para>
|
2714 | </listitem>
|
2715 | </varlistentry>
|
2716 |
|
2717 | <varlistentry>
|
2718 | <term>vertical=<replaceable>bool</replaceable></term>
|
2719 |
|
2720 | <listitem>
|
2721 | <para>avec la valeur <code>true</code>, chaque chiffre sera
|
2722 | représenté par une colonne. Avec la valeur <code>false</code>
|
2723 | (valeur par défaut), chaque chiffre sera représenté par une
|
2724 | ligne.</para>
|
2725 | </listitem>
|
2726 | </varlistentry>
|
2727 |
|
2728 | <varlistentry>
|
2729 | <term>reverse=<replaceable>bool</replaceable></term>
|
2730 |
|
2731 | <listitem>
|
2732 | <para>avec la valeur <code>true</code> (valeur par défaut), en
|
2733 | mode <code>vertical</code>, les grandes valeurs des chiffres
|
2734 | seront placées en haut plutôt qu'en bas.</para>
|
2735 | </listitem>
|
2736 | </varlistentry>
|
2737 |
|
2738 | <varlistentry>
|
2739 | <term>vhead=<replaceable>bool</replaceable></term>
|
2740 |
|
2741 | <listitem>
|
2742 | <para>avec la valeur <code>true</code>, en mode
|
2743 | <code>vertical</code>, un en-tête sera placé au-dessus de
|
2744 | chaque colonne correspondant à un chiffre. Le texte de cet
|
2745 | en-tête est donné par la commande
|
2746 | <command>\AMCntextVHead</command>, qui est originellement
|
2747 | définie par</para>
|
2748 |
|
2749 | <programlisting>\def\AMCntextVHead#1{\emph{b#1}}</programlisting>
|
2750 |
|
2751 | <para>Cette définition permet de numéroter les chiffres
|
2752 | binaires.</para>
|
2753 |
|
2754 | <para>La valeur par défaut est <code>false</code>.</para>
|
2755 | </listitem>
|
2756 | </varlistentry>
|
2757 |
|
2758 | <varlistentry>
|
2759 | <term>hspace=<replaceable>space</replaceable></term>
|
2760 |
|
2761 | <listitem>
|
2762 | <para>donne l'espace horizontal entre les cases
|
2763 | (<code>.5em</code> par défaut).</para>
|
2764 | </listitem>
|
2765 | </varlistentry>
|
2766 |
|
2767 | <varlistentry>
|
2768 | <term>vspace=<replaceable>space</replaceable></term>
|
2769 |
|
2770 | <listitem>
|
2771 | <para>donne l'espace vertical entre les cases
|
2772 | (<code>1ex</code> par défaut).</para>
|
2773 | </listitem>
|
2774 | </varlistentry>
|
2775 |
|
2776 | <varlistentry>
|
2777 | <term>borderwidth=<replaceable>space</replaceable></term>
|
2778 |
|
2779 | <listitem>
|
2780 | <para>donne l'épaisseur du cadre qui entoure toutes les cases
|
2781 | (<code>1mm</code> par défaut).</para>
|
2782 | </listitem>
|
2783 | </varlistentry>
|
2784 |
|
2785 | <varlistentry>
|
2786 | <term>bordercol=<replaceable>color</replaceable></term>
|
2787 |
|
2788 | <listitem>
|
2789 | <para>donne la couleur du cadre (<code>lightgray</code> par
|
2790 | défaut).</para>
|
2791 | </listitem>
|
2792 | </varlistentry>
|
2793 |
|
2794 | <varlistentry>
|
2795 | <term>backgroundcol=<replaceable>color</replaceable></term>
|
2796 |
|
2797 | <listitem>
|
2798 | <para>donne la couleur du fond (<code>white</code> par
|
2799 | défaut).</para>
|
2800 | </listitem>
|
2801 | </varlistentry>
|
2802 |
|
2803 | <varlistentry>
|
2804 | <term>Tsign=<replaceable>text</replaceable></term>
|
2805 |
|
2806 | <listitem>
|
2807 | <para>donne le texte à inscrire au-dessus des deux cases
|
2808 | correspondant au signe (vous pouvez obtenir le même résultat
|
2809 | grâce à
|
2810 | <code>\def\AMCntextSign{<replaceable>text</replaceable>}</code>,
|
2811 | le texte par défaut étant vide).</para>
|
2812 | </listitem>
|
2813 | </varlistentry>
|
2814 |
|
2815 | <varlistentry>
|
2816 | <term>Tpoint=<replaceable>text</replaceable></term>
|
2817 |
|
2818 | <listitem>
|
2819 | <para>donne le texte correspondant à la virgule (décimale). Il
|
2820 | peut également être modifié par
|
2821 | <code>\def\AMCdecimalPoint{<replaceable>text</replaceable>}</code>,
|
2822 | et la valeur par défaut est <code>\raisebox{1ex}{\bf
|
2823 | .}</code>.</para>
|
2824 | </listitem>
|
2825 | </varlistentry>
|
2826 |
|
2827 | <varlistentry>
|
2828 | <term>scoring=<replaceable>bool</replaceable></term>
|
2829 |
|
2830 | <listitem>
|
2831 | <para>avec la valeur <code>true</code> (valeur par défaut), un
|
2832 | barème sera transmis à AMC.</para>
|
2833 | </listitem>
|
2834 | </varlistentry>
|
2835 |
|
2836 | <varlistentry>
|
2837 | <term>scoreexact=<replaceable>num</replaceable></term>
|
2838 |
|
2839 | <listitem>
|
2840 | <para>donne le score à affecter à une réponse exacte (2 par
|
2841 | défaut).</para>
|
2842 | </listitem>
|
2843 | </varlistentry>
|
2844 |
|
2845 | <varlistentry>
|
2846 | <term>exact=<replaceable>num</replaceable></term>
|
2847 |
|
2848 | <listitem>
|
2849 | <para>donne la distance maximale à la valeur correcte
|
2850 | en-dessous de laquelle une réponse sera considérée comme
|
2851 | <emphasis>exacte</emphasis> (et sera rétribuée de
|
2852 | <code>scoreexact</code> points). La valeur par défaut est
|
2853 | 0.</para>
|
2854 | </listitem>
|
2855 | </varlistentry>
|
2856 |
|
2857 | <varlistentry>
|
2858 | <term>scoreapprox=<replaceable>num</replaceable></term>
|
2859 |
|
2860 | <listitem>
|
2861 | <para>donne le score à affecter à une réponse
|
2862 | <emphasis>approximative</emphasis> (1 par défaut).</para>
|
2863 | </listitem>
|
2864 | </varlistentry>
|
2865 |
|
2866 | <varlistentry>
|
2867 | <term>approx=<replaceable>num</replaceable></term>
|
2868 |
|
2869 | <listitem>
|
2870 | <para>donne la distance maximale à la valeur correcte
|
2871 | en-dessous de laquelle une réponse sera considérée comme
|
2872 | <emphasis>approximative</emphasis> (et sera rétribuée de
|
2873 | <code>scoreapprox</code> points). La valeur par défaut est
|
2874 | 0.</para>
|
2875 | </listitem>
|
2876 | </varlistentry>
|
2877 | </variablelist>
|
2878 |
|
2879 | <para>Vous pouvez modifier la valeur par défaut (pour tout votre
|
2880 | questionnaire) de toutes ces options grâce à la commande
|
2881 | <command>\AMCnumericOpts</command>, comme</para>
|
2882 |
|
2883 | <programlisting>\AMCnumericOpts{scoreexact=3,borderwidth=2pt}</programlisting>
|
2884 |
|
2885 | <para>Vous pouvez de plus ajouter un texte à la suite des questions,
|
2886 | quand la réponse à celle-ci est reléguée à une feuille séparée (par
|
2887 | l'utilisation de l'option <code>ensemble</code>), en redéfinissant
|
2888 | la commande <command>\AMCntextGoto</command>, comme ceci par
|
2889 | exemple :</para>
|
2890 |
|
2891 | <programlisting>\def\AMCntextGoto{\par{\bf\emph{Codez la réponse
|
2892 | sur la feuille de réponses séparée.}}}</programlisting>
|
2893 | </sect4>
|
2894 | </sect3>
|
2895 |
|
2896 | <sect3>
|
2897 | <title>Utilisation du package pgf/tikz</title>
|
2898 |
|
2899 | <para>Le paquet LaTeX <package>pgf/tikz</package>, dont la
|
2900 | documentation se trouve sur <ulink
|
2901 | url="http://www.ctan.org/tex-archive/graphics/pgf/base">http://www.ctan.org/tex-archive/graphics/pgf/base</ulink>
|
2902 | possède notamment une bibliothèque mathématique que l'on peut charger
|
2903 | grâce à la commande : <programlisting>\usepackage{tikz}</programlisting></para>
|
2904 |
|
2905 | <para>La première précaution à prendre, pour avoir des sujets
|
2906 | identiques malgré les recompilations latex est de choisir la base de
|
2907 | génération des nombres pseudo-aléatoires.</para>
|
2908 |
|
2909 | <para><programlisting>\pgfmathsetseed{2056}
|
2910 | </programlisting></para>
|
2911 |
|
2912 | <sect4>
|
2913 | <title>Réaliser un calcul simple</title>
|
2914 |
|
2915 | <para>Voici un exemple d'utilisation avec un calcul simple :</para>
|
2916 |
|
2917 | <para><programlisting>\begin{question}{inverse}
|
2918 | \pgfmathrandominteger{\x}{1}{50}
|
2919 |
|
2920 | Quel est l'inverse de $x=\x$ ?
|
2921 |
|
2922 | \begin{reponses}
|
2923 | \bonne{\pgfmathparse{1/\x}\pgfmathresult }
|
2924 | \mauvaise{\pgfmathparse{1/(\x +1))}\pgfmathresult}
|
2925 | \mauvaise{\pgfmathparse{cos(\x)} \pgfmathresult}
|
2926 | \mauvaise{\pgfmathparse{\x^(-0.5)}\pgfmathresult}
|
2927 | \end{reponses}
|
2928 | \end{question}
|
2929 | </programlisting></para>
|
2930 |
|
2931 | <para>Les commandes <command>\pgfmathparse</command> et
|
2932 | <command>\pgfmathresult</command> permettent respectivement
|
2933 | d'effectuer le calcul et d'afficher son résultat.</para>
|
2934 |
|
2935 | <para>Il est possible de choisir la mise en forme des résultats en
|
2936 | utilisant la commande <command>\pgfmathprintnumber</command>, par
|
2937 | exemple, ici on choisit une notation avec trois décimales, en
|
2938 | utilisant une virgule comme séparateur décimal.</para>
|
2939 |
|
2940 | <para><programlisting>\begin{question}{inverse3}
|
2941 | \pgfmathrandominteger{\x}{1}{50}
|
2942 | \pgfkeys{/pgf/number format/.cd,fixed,fixed zerofill,precision=3,use comma}
|
2943 | Quel est l'inverse de $x=\pgfmathprintnumber{\x}$ ?
|
2944 |
|
2945 | \begin{reponses}
|
2946 | \bonne{\pgfmathparse{1/\x}\pgfmathprintnumber{\pgfmathresult}}
|
2947 | \mauvaise{\pgfmathparse{1/(\x +1))} \pgfmathprintnumber{\pgfmathresult}}
|
2948 | \mauvaise{\pgfmathparse{cos(\x)} \pgfmathprintnumber{\pgfmathresult}}
|
2949 | \mauvaise{\pgfmathparse{\x^(-0.5)} \pgfmathprintnumber{\pgfmathresult}}
|
2950 | \end{reponses}
|
2951 | \end{question}
|
2952 | </programlisting><note>
|
2953 | <para>Les commandes <command>\AMCIntervals</command> et
|
2954 | <command>\AMCnumericChoices</command> peuvent aussi être
|
2955 | utilisées dans ce contexte (voir <xref
|
2956 | linkend="latex.intervals"/> et <xref
|
2957 | linkend="latex.numeric"/>)</para>
|
2958 | </note></para>
|
2959 | </sect4>
|
2960 |
|
2961 | <sect4>
|
2962 | <title>Questions de lecture graphique</title>
|
2963 |
|
2964 | <para>Il est aussi possible de générer des graphiques aléatoires(ou
|
2965 | non),et de poser des questions de lecture graphique.</para>
|
2966 |
|
2967 | <para><programlisting>\begin{questionmult}{graphique}
|
2968 | On considère trois fonctions f(x) dont les tracés sont représentés ci-dessous
|
2969 | dans un repère orthonormé~:
|
2970 | \pgfmathrandominteger{\a}{2}{4}
|
2971 | \begin{center}
|
2972 | \begin{tikzpicture}[domain=0:4]
|
2973 | \draw[very thin,color=gray] (-0.1,-4.1) grid (3.9,3.9);
|
2974 | \draw[->] (-0.2,0) -- (4.2,0) node[right] {$x$};
|
2975 | \draw[->] (0,-4.2) -- (0,4.2) node[above] {$f(x)$};
|
2976 | \draw[color=red] plot (\x,{(1+\a/4)*\x-\a}) node[right] {$f_{1} (x)$};
|
2977 | \draw[color=blue] plot (\x,{\a*sin(\x r)}) node[right] {$f_{2}(x)$};
|
2978 | \draw[color=orange] plot (\x,{\a*cos(\x r)}) node[right] {$f_{3}(x)$};
|
2979 | \end{tikzpicture}
|
2980 | \end{center}
|
2981 | Alors :
|
2982 | \begin{reponses}
|
2983 | \pgfmathrandominteger{\x0}{2}{4}
|
2984 | \bonne{$f_{2}(\x0)$=\pgfmathparse{\a*sin(\x0 r)} \pgfmathprintnumber{\pgfmathresult}.}
|
2985 | \bonne{$f_{3}(\x0)$=\pgfmathparse{\a*cos(\x0 r)} \pgfmathprintnumber{\pgfmathresult}.}
|
2986 | \mauvaise{La fonction $f_{1}(x)$ est une fonction linéaire.}
|
2987 | \end{reponses}
|
2988 | \end{questionmult}
|
2989 | </programlisting></para>
|
2990 |
|
2991 | <para>La mise en forme des graphiques peut être facilitée par
|
2992 | l'utilisation du package <package>pgfplots</package>.</para>
|
2993 |
|
2994 | <para>La précision des nombres sous pgfmath étant limitée, certains
|
2995 | tracés de graphiques ne sont pas possibles avec cette méthode, la
|
2996 | compilation latex adressant alors une erreur du type : "Arithmetic
|
2997 | overflow". Les packages <package>tikz</package> et
|
2998 | <package>pgfplots</package> permettent de pallier à ce manque de
|
2999 | précison en faisant appel au programme <command>gnuplot</command>
|
3000 | (voir documentation du package) pour obtenir les points de tracé.
|
3001 | Dans ce cas, il faut installer au préalable
|
3002 | <command>gnuplot</command> sur votre distribution, puis lancer la
|
3003 | compilation latex avec l'option <option>--shell-escape</option>.
|
3004 | Pour cela, aller dans les préférences de AMC et choisir pour moteur
|
3005 | LaTeX du projet en cours : "<option>pdflatex
|
3006 | --shell-escape</option>" (sans les guillemets).</para>
|
3007 | </sect4>
|
3008 | </sect3>
|
3009 |
|
3010 | <sect3>
|
3011 | <title>Utilisation de LuaLaTeX</title>
|
3012 |
|
3013 | <para>Il est possible d'utiliser le langage de programmation LUA au
|
3014 | sein de documents latex en compilant le sujet grâce à la commande
|
3015 | <command>lualatex</command>. Si vous choisissez cette compilation,
|
3016 | votre sujet doit être encodé en UTF-8, et il ne faut pas charger le
|
3017 | package <package>inputenc</package>. Pour de plus amples informations,
|
3018 | lire l'article de Manuel Pégourié-Gonnard présentant le projet à
|
3019 | l'adresse suivante : <ulink
|
3020 | url="http://dante.ctan.org/tex-archive/info/luatex/lualatex-doc/lualatex-doc.pdf">http://dante.ctan.org/tex-archive/info/luatex/lualatex-doc/lualatex-doc.pdf</ulink></para>
|
3021 |
|
3022 | <para>Pour faire appel au langage LUA, il faut utiliser la commande
|
3023 | <command>\directlua</command>. La fonction la plus utile est de
|
3024 | pouvoir écrire un résultat calculé par LUA dans le document tex grâce
|
3025 | à la commande : <command>tex.print</command></para>
|
3026 |
|
3027 | <para>Encore une fois, si vous utilisez des nombres aléatoires,
|
3028 | commencer par choisir la base de génération des nombres
|
3029 | pseudo-aléatoires.</para>
|
3030 |
|
3031 | <programlisting>\directlua{math.randomseed (2048)}</programlisting>
|
3032 |
|
3033 | <para>Voici un exemple très simple, de fichier:</para>
|
3034 |
|
3035 | <programlisting>\documentclass[a4paper]{article}
|
3036 | %\usepackage[utf8x]{inputenc}
|
3037 | \usepackage[T1]{fontenc}
|
3038 | \usepackage[francais,bloc,completemulti]{automultiplechoice}
|
3039 | \begin{document}
|
3040 |
|
3041 | \exemplaire{10}{
|
3042 |
|
3043 | %%% debut de l'en-tête des copies :
|
3044 |
|
3045 | \noindent{\bf QCM \hfill TEST}
|
3046 |
|
3047 | \vspace*{.5cm}
|
3048 | \begin{minipage}{.4\linewidth}
|
3049 | \centering\large\bf Sujet simpliste
|
3050 | \end{minipage}
|
3051 | \champnom{\fbox{\begin{minipage}{.5\linewidth}
|
3052 | Nom et prénom :
|
3053 |
|
3054 | \vspace*{.5cm}\dotfill
|
3055 | \vspace*{1mm}
|
3056 | \end{minipage}}}
|
3057 |
|
3058 | %%% fin de l'en-tête
|
3059 |
|
3060 | \directlua{math.randomseed (2048)}
|
3061 | \directlua{a=math.random()}
|
3062 |
|
3063 | \begin{question}{calcul}
|
3064 | Quelle est la racine carrée de \directlua{tex.print(a)}?
|
3065 |
|
3066 | \begin{reponses}
|
3067 | \bonne{\directlua{tex.print(math.sqrt(a))}}
|
3068 | \mauvaise{\directlua{tex.print(math.sqrt(2*a))}}
|
3069 | \mauvaise{\directlua{tex.print(math.sqrt(a*1.001))}}
|
3070 | \end{reponses}
|
3071 | \end{question}
|
3072 |
|
3073 | \clearpage
|
3074 | }
|
3075 |
|
3076 | \end{document} </programlisting>
|
3077 |
|
3078 | <para>Il est aussi possible de mettre en forme les résultats donnés
|
3079 | par lua soit en écrivant des fonctions lua, soit en utilisant le
|
3080 | package <package>siunitx</package></para>
|
3081 |
|
3082 | <note>
|
3083 | <para>Les commandes <command>\AMCIntervals</command> et
|
3084 | <command>\AMCnumericChoices</command> peuvent aussi être utilisées
|
3085 | dans ce contexte (voir <xref linkend="latex.intervals"/> et <xref
|
3086 | linkend="latex.numeric"/>)</para>
|
3087 | </note>
|
3088 | </sect3>
|
3089 | </sect2>
|
3090 | </sect1>
|
3091 |
|
3092 | <sect1 id="interface-graphique">
|
3093 | <title>Mise en œuvre - interface graphique</title>
|
3094 |
|
3095 | <para>Nous décrivons ici un exemple de cheminement avec l'interface
|
3096 | graphique depuis la conception du QCM jusqu'à l'édition des notes des
|
3097 | élèves.</para>
|
3098 |
|
3099 | <sect2>
|
3100 | <title>Création du nouveau projet et du sujet</title>
|
3101 |
|
3102 | <para>Commençons par ouvrir l'interface graphique. On peut normalement
|
3103 | le faire en sélectionnant <menuchoice>
|
3104 | <guimenu>Applications</guimenu>
|
3105 |
|
3106 | <guisubmenu>Éducation</guisubmenu>
|
3107 |
|
3108 | <guimenuitem>Auto Multiple Choice</guimenuitem>
|
3109 | </menuchoice> du menu général de Gnome (ou son équivalent dans KDE ou
|
3110 | autre), mais on peut aussi utiliser la commande
|
3111 | <userinput>auto-multiple-choice</userinput>.</para>
|
3112 |
|
3113 | <para>Créons maintenant un nouveau projet, grâce à <menuchoice>
|
3114 | <guimenu>Projet</guimenu>
|
3115 |
|
3116 | <guimenuitem>Nouveau</guimenuitem>
|
3117 | </menuchoice>. Une fenêtre s'ouvre qui permet de visualiser les noms
|
3118 | des projets déjà existant (si il en existe), et de choisir un nom
|
3119 | (composé de caractères simples ; « test » conviendra par exemple à notre
|
3120 | petit essai), que nous inscrivons dans le champ <guilabel>Nouveau
|
3121 | projet</guilabel>. Nous validons enfin en appuyant sur le bouton
|
3122 | <guibutton>Créer un projet</guibutton>.</para>
|
3123 |
|
3124 | <para>Nous devons maintenant désigner un fichier AMC-TXT ou LaTeX comme
|
3125 | source du QCM. Plusieurs possibilités nous sont proposées :</para>
|
3126 |
|
3127 | <itemizedlist>
|
3128 | <listitem>
|
3129 | <para><guilabel>modèle</guilabel> : ce choix permet de chercher
|
3130 | parmi les modèles fournis avec AMC un sujet que nous pourrons
|
3131 | modifier ensuite à loisir.</para>
|
3132 | </listitem>
|
3133 |
|
3134 | <listitem>
|
3135 | <para><guilabel>fichier</guilabel> : ce choix permet de choisir un
|
3136 | fichier source déjà composé pour l'examen. Il est en effet possible
|
3137 | de composer son sujet en dehors d'AMC grâce à un éditeur classique,
|
3138 | puis d'utiliser AMC quand celui-ci est au point.</para>
|
3139 | </listitem>
|
3140 |
|
3141 | <listitem>
|
3142 | <para><guilabel>vide</guilabel> : ce choix crée un fichier vide
|
3143 | qu'il faudra éditer depuis zéro pour créer son sujet.</para>
|
3144 | </listitem>
|
3145 |
|
3146 | <listitem>
|
3147 | <para><guilabel>archive</guilabel> : ce choix permet d'utiliser une
|
3148 | archive tgz ou zip dans laquelle on a placé le sujet et d'éventuels
|
3149 | autres fichiers (images, fichier décrivant les options pour AMC par
|
3150 | exemple). Il sera utilisé quand le sujet est fabriqué par un
|
3151 | programme extérieur (comme par exemple l'interfaçage avec la
|
3152 | plateforme nationale C2i niveau 1 pour les universités françaises)
|
3153 | ou pour reprendre un sujet AMC sauvegardé sous forme
|
3154 | d'archive.</para>
|
3155 | </listitem>
|
3156 | </itemizedlist>
|
3157 |
|
3158 | <para>Pour notre exemple, nous choisissons <guilabel>modèle</guilabel>.
|
3159 | Dans la fenêtre suivante, sélectionnons par exemple le modèle
|
3160 | <guilabel>Exemple simple</guilabel> dans le groupe <guilabel>[FR]
|
3161 | Documentation</guilabel>. Une fois le projet créé, nous pouvons modifier
|
3162 | ce sujet à loisir grâce au bouton <guibutton>Éditer le fichier
|
3163 | source</guibutton> qui lance l'éditeur par défaut.</para>
|
3164 | </sect2>
|
3165 |
|
3166 | <sect2>
|
3167 | <title>Préparation du sujet</title>
|
3168 |
|
3169 | <para>La préparation du projet se fait en deux étapes. Il faut tout
|
3170 | d'abord fabriquer les documents de référence à partir du fichier source.
|
3171 | Ceci se fait en cliquant sur le bouton <guibutton>Mise à
|
3172 | jour</guibutton> de la section <guilabel>Documents de
|
3173 | travail</guilabel>. Les documents produits sont les suivants :</para>
|
3174 |
|
3175 | <itemizedlist>
|
3176 | <listitem>
|
3177 | <para>Le <emphasis>sujet</emphasis>. C'est le fichier qu'il faudra
|
3178 | imprimer pour que ses pages soient distribuées aux étudiants (voir
|
3179 | plus bas).</para>
|
3180 | </listitem>
|
3181 |
|
3182 | <listitem>
|
3183 | <para>Le <emphasis>corrigé</emphasis>. On peut y vérifier que les
|
3184 | réponses cochées sont les bonnes. Il est aussi destiné à être
|
3185 | distribué aux étudiants.</para>
|
3186 | </listitem>
|
3187 | </itemizedlist>
|
3188 |
|
3189 | <para>Une fois produits, ces documents pourront être visualisés (et
|
3190 | éventuellement imprimés) grâce aux boutons correspondants.</para>
|
3191 |
|
3192 | <para>Nous pouvons maintenant passer à cette dernière étape de
|
3193 | préparation : l'analyse du document de calage. Elle se lance à partir du
|
3194 | bouton <guibutton>Calculer les mises en page</guibutton>. Cette analyse
|
3195 | détecte, dans chaque page du sujet, la position exacte des différents
|
3196 | éléments qui devront être analysés sur les copies des étudiants.</para>
|
3197 |
|
3198 | <para>Pour vérifier que les mises en page ont été correctement
|
3199 | détectées, on peut utiliser le bouton <guibutton>Vérifier les mises en
|
3200 | page</guibutton>. Un petit coup d'œil permettra de vérifier que les
|
3201 | cases à cocher en rouge sont bien positionnées sur les cases du
|
3202 | sujet.</para>
|
3203 | </sect2>
|
3204 |
|
3205 | <sect2 id="impression">
|
3206 | <title id="impression.titre">Impression du sujet</title>
|
3207 |
|
3208 | <para>Vous pouvez fonctionner de deux manières différentes :</para>
|
3209 |
|
3210 | <itemizedlist>
|
3211 | <listitem>
|
3212 | <para>Pour la méthode la plus robuste, il est nécessaire de produire
|
3213 | un nombre suffisant de copies ayant chacune un numéro de copie
|
3214 | différent, et de les imprimer toutes. Chaque page de chaque copie
|
3215 | est différenciée par les codes inscrits en haut de la page. Vous
|
3216 | pouvez ainsi scanner plusieurs fois la même page sans risque.</para>
|
3217 | </listitem>
|
3218 |
|
3219 | <listitem>
|
3220 | <para>La deuxième méthode consiste à produire un petit nombre de
|
3221 | copies (éventuellement une seule), à les imprimer, puis à les
|
3222 | photocopier en grand nombre pour en avoir une par étudiant. Avec
|
3223 | cette méthode, le mélange des questions et réponses perd de son
|
3224 | efficacité, et si vous fournissez plusieurs fois la même page
|
3225 | scannée à AMC, il ne pourra pas s'en rendre compte et la comptera
|
3226 | deux fois.</para>
|
3227 | </listitem>
|
3228 | </itemizedlist>
|
3229 |
|
3230 | <warning>
|
3231 | <para>Pour cette deuxième méthode utilisant des photocopies, il est
|
3232 | nécessaire que les étudiants n'aient à remplir qu'une seule page (ce
|
3233 | résultat peut être obtenu en utilisant une feuille de réponses
|
3234 | séparée). Dans le cas contraire, vous ne pourriez pas traiter les
|
3235 | scans par AMC ensuite ! En effet, il serait impossible pour AMC de
|
3236 | faire le lien entre plusieurs pages correspondant à un même
|
3237 | étudiant.</para>
|
3238 | </warning>
|
3239 |
|
3240 | <para>Une fois la préparation effectuée, nous pouvons imprimer le sujet,
|
3241 | et le distribuer aux étudiants... Nous avons pour cela plusieurs
|
3242 | possibilités :</para>
|
3243 |
|
3244 | <itemizedlist>
|
3245 | <listitem>
|
3246 | <para>Il est possible d'imprimer (ou de faire imprimer par un
|
3247 | service reprographie) directement le fichier
|
3248 | <filename>DOC-sujet.pdf</filename> du répertoire projet, auquel on
|
3249 | peut accéder par le bouton <guilabel>sujet</guilabel> de la liste
|
3250 | des <guilabel>documents de travail</guilabel>.</para>
|
3251 |
|
3252 | <para>Cette méthode peut avoir un léger inconvénient : si votre
|
3253 | sujet comporte certaines copies ayant un nombre impair de pages, une
|
3254 | impression recto-verso mettra plusieurs sujets sur une même feuille,
|
3255 | ce qui les rendra inutilisables. Pour éviter ce problème, vous
|
3256 | pouvez remplacer (si ce n'est pas déjà fait), dans le fichier LaTeX
|
3257 | du sujet, la commande <command>\clearpage</command> par
|
3258 | <command>\AMCcleardoublepage</command>, qui ajoutera les pages
|
3259 | blanches nécessaires pour que tous les sujets aient un nombre pair
|
3260 | de pages (voir exemple section <xref
|
3261 | linkend="secensemble"/>).</para>
|
3262 | </listitem>
|
3263 |
|
3264 | <listitem>
|
3265 | <para>Si l'imprimante à utiliser est configurée sur l'ordinateur
|
3266 | utilisé par AMC, on utilisera de préférence le bouton
|
3267 | <guibutton>Imprimer des copies</guibutton> (après avoir calculé les
|
3268 | mises en page), qui permet de sélectionner les copies à imprimer (si
|
3269 | on ne souhaite pas toutes les imprimer, ou pour une réimpression
|
3270 | dans le cas où une copie aurait été mal imprimée), de choisir les
|
3271 | options d'impression (recto-verso, agrafage), et de gérer
|
3272 | correctement les copies avec un nombre impair de pages même dans le
|
3273 | cas d'une impression recto-verso sans utilisation de
|
3274 | <command>\AMCcleardoublepage</command> (en effet, AMC envoie une
|
3275 | tâche d'impression par copie).</para>
|
3276 | </listitem>
|
3277 | </itemizedlist>
|
3278 | </sect2>
|
3279 |
|
3280 | <sect2>
|
3281 | <title>Examen</title>
|
3282 |
|
3283 | <para>Il ne reste plus qu'à faire passer l'examen aux
|
3284 | étudiants...</para>
|
3285 |
|
3286 | <important>
|
3287 | <para>Une fois que le sujet est imprimé et distribué, il ne faut plus
|
3288 | modifier les <emphasis>documents de travail</emphasis> car il faut
|
3289 | garder la certitude qu'ils sont conformes aux copies
|
3290 | distribuées.</para>
|
3291 | </important>
|
3292 | </sect2>
|
3293 |
|
3294 | <sect2>
|
3295 | <title>Lecture des copies</title>
|
3296 |
|
3297 | <para>Nous allons maintenant passer à la saisie des copies des
|
3298 | étudiants, qui peut se faire de manière automatique et/ou
|
3299 | manuelle.</para>
|
3300 |
|
3301 | <para>Pour cela, nous passons sur l'onglet <guilabel>Saisie</guilabel>
|
3302 | de l'interface graphique.</para>
|
3303 |
|
3304 | <sect3>
|
3305 | <title>Saisie automatique</title>
|
3306 |
|
3307 | <para>Pour une reconnaissance automatisée des cases cochées dans les
|
3308 | copies des étudiants, il faut tout d'abord les numériser. J'utilise
|
3309 | pour ma part une photocopieuse/scanner qui le fait de manière
|
3310 | automatique (toutes les pages à la suite sans intervention de ma
|
3311 | part), avec les réglages suivants : 300dpi, mode OCR (prévu pour la
|
3312 | reconnaissance de caractères, noir et blanc sans nuances de gris),
|
3313 | scan délivré en un fichier TIFF par page.</para>
|
3314 |
|
3315 | <note>
|
3316 | <para>Pour l'analyse des copies, nous devons disposer d'un ou
|
3317 | plusieurs fichiers images (TIFF, JPG, PNG, etc.) des scans. Les
|
3318 | formats vectoriels (PDF, PS ou EPS) sont également utilisables ; ils
|
3319 | seront convertis au format PNG par AMC avant leur analyse.</para>
|
3320 | </note>
|
3321 |
|
3322 | <note>
|
3323 | <para>Lors de la première saisie automatique, vous aurez à indiquer
|
3324 | à AMC quelle méthode vous avez choisie : sujets différents pour tous
|
3325 | les étudiants, ou photocopie de certains sujets (voir <xref
|
3326 | endterm="impression.titre" linkend="impression"/>).</para>
|
3327 | </note>
|
3328 |
|
3329 | <para>On sélectionne alors l'ensemble des fichiers obtenus à partir du
|
3330 | dialogue ouvert par le bouton <guibutton>Automatique</guibutton> de la
|
3331 | section <guilabel>Saisie des copies après examen</guilabel>, puis on
|
3332 | valide par le bouton <guibutton>Valider</guibutton> de ce même
|
3333 | dialogue. AMC va procéder à une reconnaissance optique de marques
|
3334 | (OMR) sur les scans afin de détecter les quatre marques circulaires
|
3335 | des coins, en déduire la position des cases à cocher et mesurer la
|
3336 | proportion de noir à l'intérieur de chacune d'entre elles.</para>
|
3337 |
|
3338 | <para>Le résultat de l'analyse de chaque page est indiqué dans les
|
3339 | listes de la section <guilabel>Diagnostic</guilabel> :</para>
|
3340 |
|
3341 | <itemizedlist>
|
3342 | <listitem>
|
3343 | <para>La valeur <emphasis>EQM</emphasis> (écart quadratique moyen)
|
3344 | est un indicateur du bon calage sur les marques de calage (les
|
3345 | quatre ronds noirs entourant chaque copie). Si il est trop
|
3346 | important, il faudra vérifier le calage (un clic droit sur la
|
3347 | ligne correspondant à la page puis le choix
|
3348 | <guimenuitem>page</guimenuitem> permet de visualiser la page
|
3349 | scannée et le cadre et les cases tels qu'ils sont
|
3350 | détectés).</para>
|
3351 | </listitem>
|
3352 |
|
3353 | <listitem>
|
3354 | <para>La valeur <emphasis>sensibilité</emphasis> est un indicateur
|
3355 | de la proximité du remplissage des cases avec la valeur seuil. Si
|
3356 | elle est trop importante (à partir de 8 et jusqu'à sa valeur
|
3357 | maximale 10), il faudra vérifier que les cases reconnues comme
|
3358 | étant cochées sont bien les bonnes (un clic droit sur la ligne
|
3359 | correspondant à la page puis le choix
|
3360 | <guimenuitem>zoom</guimenuitem> permet de visualiser l'ensemble
|
3361 | des cases de la copie, de voir si la détection s'est bien
|
3362 | déroulée, et éventuellement de la corriger par
|
3363 | glisser-déposer).</para>
|
3364 | </listitem>
|
3365 | </itemizedlist>
|
3366 | </sect3>
|
3367 |
|
3368 | <sect3>
|
3369 | <title>Saisie manuelle</title>
|
3370 |
|
3371 | <para>Si nous ne pouvons pas utiliser facilement de scanner, ou si,
|
3372 | pour quelques copies, la saisie automatique n'a pas bien fonctionné,
|
3373 | nous pouvons effectuer la saisie de manière manuelle. Pour cela,
|
3374 | ouvrons la fenêtre adéquate grâce au bouton
|
3375 | <guibutton>Manuelle</guibutton> de la section <guilabel>Saisie des
|
3376 | copies après examen</guilabel>. Dans cette fenêtre, nous pourrons
|
3377 | entrer nous-même les cases qui ont été cochées (en cliquant dessus)
|
3378 | sur les pages désirées.</para>
|
3379 |
|
3380 | <note>
|
3381 | <para>Toute saisie manuelle effectuée sur une page prendra la place
|
3382 | des résultats éventuels d'une saisie automatique pour cette même
|
3383 | page.</para>
|
3384 | </note>
|
3385 | </sect3>
|
3386 | </sect2>
|
3387 |
|
3388 | <sect2>
|
3389 | <title>Correction</title>
|
3390 |
|
3391 | <para>Dans l'onglet <guilabel>Notation</guilabel> de l'interface
|
3392 | graphique, la partie <guilabel>Correction</guilabel> nous permet de
|
3393 | déduire les notes des étudiants à partir des saisies effectuées, mais
|
3394 | aussi de lire les codes renseignés par les étudiants (voir <xref
|
3395 | linkend="latex.codes"/>).</para>
|
3396 |
|
3397 | <sect3>
|
3398 | <title>Processus</title>
|
3399 |
|
3400 | <para>Le calcul des notes se lance à l'aide du bouton
|
3401 | <guibutton>Corriger</guibutton>, mais nous avons auparavant le choix
|
3402 | suivant à effectuer :</para>
|
3403 |
|
3404 | <itemizedlist>
|
3405 | <listitem>
|
3406 | <para>Si nous cochons la case <guilabel>Mettre à jour le
|
3407 | barème</guilabel>, le barème sera tout d'abord extrait du fichier
|
3408 | source LaTeX. Ceci permet de tester plusieurs barèmes à la fin du
|
3409 | processus de correction. La mise à jour concerne également la
|
3410 | liste des bonnes et mauvaises réponses, ce qui permet de corriger
|
3411 | facilement après l'examen une erreur d'étourderie effectuée lors
|
3412 | de la conception du sujet. La façon de spécifier le barème dans le
|
3413 | fichier LaTeX sera expliquée à la section <xref
|
3414 | endterm="bareme.title" linkend="bareme"/> (un barème par défaut
|
3415 | est utilisé quand aucune indication n'est donnée).</para>
|
3416 | </listitem>
|
3417 | </itemizedlist>
|
3418 |
|
3419 | <para>En cliquant sur le bouton <guibutton>Corriger</guibutton>, la
|
3420 | correction est alors effectuée (cela peut prendre un peu de temps si
|
3421 | on a aussi demandé la lecture du barème).</para>
|
3422 | </sect3>
|
3423 |
|
3424 | <sect3 id="bareme">
|
3425 | <title id="bareme.title">Barème</title>
|
3426 |
|
3427 | <para>Le barème utilisé pour la notation des copies est indiqué dans
|
3428 | le fichier source LaTeX du questionnaire, à l'aide de la commande
|
3429 | <command>bareme</command>. Elle peut être utilisée dans un
|
3430 | environnement <command>question</command> ou
|
3431 | <command>questionmult</command>, pour fixer des paramètres de barème
|
3432 | concernant toutes les réponses, mais aussi dans l'environnement
|
3433 | <command>reponses</command>, pour donner des indications de barème ne
|
3434 | concernant qu'une réponse. L'argument de la commande LaTeX bareme est
|
3435 | constitué d'indications du type
|
3436 | <code><replaceable>parametre</replaceable>=<replaceable>valeur</replaceable></code>,
|
3437 | séparés par des virgules. Les paramètres utilisables sont les suivants
|
3438 | (le tableau indique aussi dans quels cadres ces paramètres peuvent
|
3439 | être utilisés) :</para>
|
3440 |
|
3441 | <informaltable>
|
3442 | <tgroup cols="6">
|
3443 | <colspec align="center" colname="param" colwidth="3pc"/>
|
3444 |
|
3445 | <colspec align="center" colname="q" colwidth="1pc"/>
|
3446 |
|
3447 | <colspec align="center" colname="r" colwidth="1pc"/>
|
3448 |
|
3449 | <colspec align="center" colname="qm" colwidth="1pc"/>
|
3450 |
|
3451 | <colspec align="center" colname="rm" colwidth="1pc"/>
|
3452 |
|
3453 | <colspec align="left" colname="valeur"/>
|
3454 |
|
3455 | <spanspec nameend="r" namest="q" spanname="simple"/>
|
3456 |
|
3457 | <spanspec nameend="rm" namest="qm" spanname="multiple"/>
|
3458 |
|
3459 | <tbody>
|
3460 | <row>
|
3461 | <entry morerows="1">paramètre</entry>
|
3462 |
|
3463 | <entry spanname="simple">simple</entry>
|
3464 |
|
3465 | <entry spanname="multiple">multiple</entry>
|
3466 |
|
3467 | <entry morerows="1">valeur</entry>
|
3468 | </row>
|
3469 |
|
3470 | <row>
|
3471 | <entry>Q</entry>
|
3472 |
|
3473 | <entry>R</entry>
|
3474 |
|
3475 | <entry>Q</entry>
|
3476 |
|
3477 | <entry>R</entry>
|
3478 | </row>
|
3479 |
|
3480 | <row>
|
3481 | <entry>e</entry>
|
3482 |
|
3483 | <entry>●</entry>
|
3484 |
|
3485 | <entry/>
|
3486 |
|
3487 | <entry>●</entry>
|
3488 |
|
3489 | <entry/>
|
3490 |
|
3491 | <entry>La note affectée en cas d'incohérence des réponses :
|
3492 | plusieurs cases cochées pour une question simple, ou, pour une
|
3493 | question multiple, case « aucune de ces réponses n'est
|
3494 | correcte » cochée en même temps qu'une autre case.</entry>
|
3495 | </row>
|
3496 |
|
3497 | <row>
|
3498 | <entry>v</entry>
|
3499 |
|
3500 | <entry>●</entry>
|
3501 |
|
3502 | <entry/>
|
3503 |
|
3504 | <entry>●</entry>
|
3505 |
|
3506 | <entry/>
|
3507 |
|
3508 | <entry>La note affectée en cas de non-réponse (aucune case
|
3509 | n'est cochée).</entry>
|
3510 | </row>
|
3511 |
|
3512 | <row>
|
3513 | <entry>d</entry>
|
3514 |
|
3515 | <entry/>
|
3516 |
|
3517 | <entry/>
|
3518 |
|
3519 | <entry>●</entry>
|
3520 |
|
3521 | <entry/>
|
3522 |
|
3523 | <entry>Un décalage, c'est-à-dire une valeur ajoutée à toutes
|
3524 | les notes qui ne relèvent pas des cas correspondant aux
|
3525 | paramètres e et v.</entry>
|
3526 | </row>
|
3527 |
|
3528 | <row>
|
3529 | <entry>p</entry>
|
3530 |
|
3531 | <entry/>
|
3532 |
|
3533 | <entry/>
|
3534 |
|
3535 | <entry>●</entry>
|
3536 |
|
3537 | <entry/>
|
3538 |
|
3539 | <entry>La note plancher. Si le calcul de la note obtenue à la
|
3540 | question donne une valeur inférieure à la valeur plancher,
|
3541 | cette note est ramenée à la valeur plancher.</entry>
|
3542 | </row>
|
3543 |
|
3544 | <row>
|
3545 | <entry>b</entry>
|
3546 |
|
3547 | <entry>●</entry>
|
3548 |
|
3549 | <entry/>
|
3550 |
|
3551 | <entry>●</entry>
|
3552 |
|
3553 | <entry>●</entry>
|
3554 |
|
3555 | <entry>Points à donner pour une bonne réponse à une
|
3556 | question.</entry>
|
3557 | </row>
|
3558 |
|
3559 | <row>
|
3560 | <entry>m</entry>
|
3561 |
|
3562 | <entry>●</entry>
|
3563 |
|
3564 | <entry/>
|
3565 |
|
3566 | <entry>●</entry>
|
3567 |
|
3568 | <entry>●</entry>
|
3569 |
|
3570 | <entry>Points à donner pour une mauvaise réponse à une
|
3571 | question.</entry>
|
3572 | </row>
|
3573 |
|
3574 | <row>
|
3575 | <entry/>
|
3576 |
|
3577 | <entry/>
|
3578 |
|
3579 | <entry>●</entry>
|
3580 |
|
3581 | <entry/>
|
3582 |
|
3583 | <entry/>
|
3584 |
|
3585 | <entry>Sans nom de paramètre (syntaxe
|
3586 | <code>\bareme{2}</code>), on indique le nombre de points à
|
3587 | donner si l'étudiant a coché <emphasis>cette</emphasis>
|
3588 | réponse.</entry>
|
3589 | </row>
|
3590 |
|
3591 | <row>
|
3592 | <entry>auto</entry>
|
3593 |
|
3594 | <entry>●</entry>
|
3595 |
|
3596 | <entry/>
|
3597 |
|
3598 | <entry/>
|
3599 |
|
3600 | <entry/>
|
3601 |
|
3602 | <entry>Avec ce paramètre, la valeur de la réponse numéro
|
3603 | <replaceable>i</replaceable> sera
|
3604 | <replaceable>auto</replaceable>+<replaceable>i</replaceable>-1.
|
3605 | Cette option est principalement utilisée avec
|
3606 | <code>\QuestionIndicative</code> (voir section <xref
|
3607 | endterm="latex.qr.title" linkend="latex.qr"/>).</entry>
|
3608 | </row>
|
3609 |
|
3610 | <row>
|
3611 | <entry>mz</entry>
|
3612 |
|
3613 | <entry>●</entry>
|
3614 |
|
3615 | <entry/>
|
3616 |
|
3617 | <entry>●</entry>
|
3618 |
|
3619 | <entry/>
|
3620 |
|
3621 | <entry>Ce paramètre impose un barème du type "maximum ou
|
3622 | zéro" : si les réponses à la question sont toutes les bonnes,
|
3623 | alors la note attribuée sera <replaceable>mz</replaceable>.
|
3624 | Sinon, elle sera nulle.</entry>
|
3625 | </row>
|
3626 |
|
3627 | <row>
|
3628 | <entry>haut</entry>
|
3629 |
|
3630 | <entry/>
|
3631 |
|
3632 | <entry/>
|
3633 |
|
3634 | <entry>●</entry>
|
3635 |
|
3636 | <entry/>
|
3637 |
|
3638 | <entry>En donnant à ce paramètre une valeur
|
3639 | <replaceable>n</replaceable>, la note attribuée à une réponse
|
3640 | parfaite sera <replaceable>n</replaceable>, et un point sera
|
3641 | enlevé par erreur.</entry>
|
3642 | </row>
|
3643 |
|
3644 | <row>
|
3645 | <entry>MAX</entry>
|
3646 |
|
3647 | <entry>●</entry>
|
3648 |
|
3649 | <entry/>
|
3650 |
|
3651 | <entry>●</entry>
|
3652 |
|
3653 | <entry/>
|
3654 |
|
3655 | <entry>Donne la valeur maximale attribuée à la question (pour
|
3656 | une « question notée sur 5 », on peut mettre MAX=5). À
|
3657 | renseigner uniquement si elle ne correspond pas à la note
|
3658 | obtenue en mettant toutes les bonnes réponses.</entry>
|
3659 | </row>
|
3660 |
|
3661 | <row>
|
3662 | <entry>formula</entry>
|
3663 |
|
3664 | <entry>●</entry>
|
3665 |
|
3666 | <entry/>
|
3667 |
|
3668 | <entry>●</entry>
|
3669 |
|
3670 | <entry/>
|
3671 |
|
3672 | <entry>Donne directement le score de la question, souvent par
|
3673 | le biais d'une formule faisant intervenir des variables (voir
|
3674 | <xref linkend="scoring.global"/>), sans tenir compte des
|
3675 | valeurs de <code>b</code> et <code>m</code>.</entry>
|
3676 | </row>
|
3677 |
|
3678 | <row>
|
3679 | <entry>set.<replaceable>XXX</replaceable></entry>
|
3680 |
|
3681 | <entry>●</entry>
|
3682 |
|
3683 | <entry>●</entry>
|
3684 |
|
3685 | <entry>●</entry>
|
3686 |
|
3687 | <entry>●</entry>
|
3688 |
|
3689 | <entry>Donne une valeur particulière à la variable nommée
|
3690 | <replaceable>XXX</replaceable>, qui pourra être utilisée par
|
3691 | la suite par <code>formula</code>. Dans le contexte d'une
|
3692 | réponse, la valeur est attribuée uniquement dans le cas où la
|
3693 | case est cochée.</entry>
|
3694 | </row>
|
3695 |
|
3696 | <row>
|
3697 | <entry>default.<replaceable>XXX</replaceable></entry>
|
3698 |
|
3699 | <entry>●</entry>
|
3700 |
|
3701 | <entry/>
|
3702 |
|
3703 | <entry>●</entry>
|
3704 |
|
3705 | <entry/>
|
3706 |
|
3707 | <entry>Donne une valeur à la variable
|
3708 | <replaceable>XXX</replaceable> si aucune case cochée n'en a
|
3709 | déjà donnée une par le biais de
|
3710 | <code>set.<replaceable>XXX</replaceable></code>.</entry>
|
3711 | </row>
|
3712 |
|
3713 | <row>
|
3714 | <entry>requires.<replaceable>XXX</replaceable></entry>
|
3715 |
|
3716 | <entry>●</entry>
|
3717 |
|
3718 | <entry/>
|
3719 |
|
3720 | <entry>●</entry>
|
3721 |
|
3722 | <entry/>
|
3723 |
|
3724 | <entry>Signale une saisie <emphasis>incohérente</emphasis>
|
3725 | (donc l'application du score donné par la valeur de
|
3726 | <code>e</code>) dans la cas où aucune valeur n'a été donnée à
|
3727 | la variable <replaceable>XXX</replaceable>.</entry>
|
3728 | </row>
|
3729 | </tbody>
|
3730 | </tgroup>
|
3731 | </informaltable>
|
3732 |
|
3733 | <para>Le barème par défaut pour une question simple est
|
3734 | <code>e=0,v=0,b=1,m=0</code>, ce qui donne un point pour une bonne
|
3735 | réponse et aucun point dans tous les autres cas. Le barème par défaut
|
3736 | pour une question multiple est
|
3737 | <code>e=0,v=0,b=1,m=0,p=-100,d=0</code>, ce qui donne un point pour
|
3738 | chaque case qui est cochée ou non à bon escient (case d'une bonne
|
3739 | réponse cochée, ou case d'une mauvaise réponse non cochée).</para>
|
3740 |
|
3741 | <para>La commande LaTeX <command>\bareme</command> peut aussi être
|
3742 | utilisée hors des définitions des questions, avec les paramètres
|
3743 | suivants :</para>
|
3744 |
|
3745 | <itemizedlist>
|
3746 | <listitem>
|
3747 | <para><code>SUF=</code><replaceable>x</replaceable> permet de
|
3748 | donner un total de points suffisant pour obtenir la note
|
3749 | maximale : si on fixe la note maximale à 20 par exemple, une copie
|
3750 | ayant un total de points de 12 avec l'utilisation de SUF=15 se
|
3751 | verra attribuer la note de 12/15*20=16, quel que soit le total
|
3752 | d'une copie ayant toutes les bonnes réponses.</para>
|
3753 | </listitem>
|
3754 |
|
3755 | <listitem>
|
3756 | <para><code>allowempty=<replaceable>x</replaceable></code> permet
|
3757 | à l'étudiant de laisser <replaceable>x</replaceable> questions
|
3758 | sans réponse. Parmi les questions laissées sans réponse par
|
3759 | l'étudiant, <replaceable>x</replaceable> (ou moins si il n'y en a
|
3760 | pas autant) seront annulées (c'est-à-dire qu'elles ne seront pas
|
3761 | prises en compte pour le calcul du score total).</para>
|
3762 | </listitem>
|
3763 | </itemizedlist>
|
3764 |
|
3765 | <para>L'utilisation combinée de tous ces paramètres permet de définir
|
3766 | toutes sortes de barèmes, comme dans l'exemple suivant :</para>
|
3767 |
|
3768 | <para> |
3769 | DESC: Exemple (issu de la documentation) de spécification du barème.--><programlisting
|
3770 | id="modeles-bareme.tex" linenumbering="numbered">\documentclass{article}
|
3771 |
|
3772 | \usepackage[utf8x]{inputenc}
|
3773 | \usepackage[T1]{fontenc}
|
3774 |
|
3775 | \usepackage[francais,bloc,completemulti]{automultiplechoice}
|
3776 |
|
3777 | \begin{document}
|
3778 |
|
3779 | % preparation du groupe de questions appelé qqs (on mettra au maximum
|
3780 | % 20 elements dans ce groupe) :
|
3781 |
|
3782 | \element{qqs}{
|
3783 | \begin{question}{le bon choix}
|
3784 | Combien de points voulez-vous à cette question~?
|
3785 | \begin{reponses}
|
3786 | \bonne{Le maximun : 10}\bareme{10}
|
3787 | \mauvaise{Seulement 5}\bareme{5}
|
3788 | \mauvaise{Deux me suffiront}\bareme{2}
|
3789 | \mauvaise{Aucun, merci}\bareme{0}
|
3790 | \end{reponses}
|
3791 | \end{question}
|
3792 | }
|
3793 |
|
3794 | \element{qqs}{
|
3795 | \begin{questionmult}{engrange}
|
3796 | Engrangez des points gratuitement en cochant les cases ci-dessous~:
|
3797 | \begin{reponses}
|
3798 | \bonne{2 points}\bareme{b=2}
|
3799 | \mauvaise{Un point négatif}\bareme{b=0,m=-1}
|
3800 | \bonne{3 points}\bareme{b=3}
|
3801 | \bonne{1 point}
|
3802 | \bonne{Un demi point}\bareme{b=0.5}
|
3803 | \end{reponses}
|
3804 | \end{questionmult}
|
3805 | }
|
3806 |
|
3807 | \element{qqs}{
|
3808 | \begin{questionmult}{tout ou rien}\bareme{mz=3}
|
3809 | Il faut cocher exactement comme il faut pour avoir trois points, sinon vous n'en
|
3810 | aurez aucun.
|
3811 | \begin{reponses}
|
3812 | \mauvaise{Fausse}
|
3813 | \mauvaise{Fausse}
|
3814 | \bonne{Juste}
|
3815 | \bonne{Juste}
|
3816 | \end{reponses}
|
3817 | \end{questionmult}
|
3818 | }
|
3819 |
|
3820 | \element{qqs}{
|
3821 | \begin{questionmult}{2 au plus}\bareme{haut=2}
|
3822 | Deux points pour tout juste, et un point pour chaque erreur...
|
3823 | \begin{reponses}
|
3824 | \bonne{Bonne réponse}
|
3825 | \bonne{Ceci est juste}
|
3826 | \bonne{Exact}
|
3827 | \mauvaise{Faux~!}
|
3828 | \mauvaise{Ne pas cocher~!}
|
3829 | \end{reponses}
|
3830 | \end{questionmult}
|
3831 | }
|
3832 |
|
3833 | \element{qqs}{
|
3834 | \begin{question}{attention}\bareme{b=2}
|
3835 | Alors là, la réponse très fausse mérite sanction (-2 points), mais
|
3836 | viser juste rapporte 2 points.
|
3837 | \begin{reponses}
|
3838 | \bonne{C'est bon !}
|
3839 | \mauvaise{Pas bon}
|
3840 | \mauvaise{Pas bon}
|
3841 | \mauvaise{Pas bon}
|
3842 | \mauvaise{Très faux !}\bareme{-2}
|
3843 | \end{reponses}
|
3844 | \end{question}
|
3845 | }
|
3846 |
|
3847 | \element{qqs}{
|
3848 | \begin{questionmult}{au choix}
|
3849 | Choisissez vos points :
|
3850 | \begin{reponses}
|
3851 | \bonne{J'en veux 2}\bareme{b=2}
|
3852 | \mauvaise{J'en donne trois}\bareme{b=0,m=3}
|
3853 | \bonne{J'en veux un (et sinon j'en perds un)}\bareme{m=-1}
|
3854 | \end{reponses}
|
3855 | \end{questionmult}
|
3856 | }
|
3857 |
|
3858 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
3859 |
|
3860 | \exemplaire{20}{
|
3861 |
|
3862 | \noindent{\bf QCM \hfill TEST DE BARÈME}
|
3863 |
|
3864 | \vspace*{.5cm}
|
3865 | \begin{minipage}{.4\linewidth}
|
3866 | \centering\large\bf Test\\ Examen du 01/01/2008\end{minipage}
|
3867 | \champnom{\fbox{\begin{minipage}{.5\linewidth}
|
3868 | Nom et prénom :
|
3869 |
|
3870 | \vspace*{.5cm}\dotfill
|
3871 | \vspace*{1mm}
|
3872 | \end{minipage}}}
|
3873 |
|
3874 | \begin{center}\em
|
3875 | Durée : 10 minutes.
|
3876 | \end{center}
|
3877 | \vspace{1ex}
|
3878 |
|
3879 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
3880 |
|
3881 | \melangegroupe{qqs}
|
3882 |
|
3883 | \restituegroupe{qqs}
|
3884 |
|
3885 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
3886 |
|
3887 | \clearpage
|
3888 |
|
3889 | }
|
3890 |
|
3891 | \end{document}</programlisting></para>
|
3892 | </sect3>
|
3893 |
|
3894 | <sect3 id="scoring.global">
|
3895 | <title>Barèmes généraux</title>
|
3896 |
|
3897 | <para>Pour utiliser un barème de manière générale pour tout un
|
3898 | ensemble de questions, on pourra le définir dans une commande LaTeX,
|
3899 | comme dans l'exemple suivant :</para>
|
3900 |
|
3901 | <programlisting>\def\barQmult{haut=3,p=-1}
|
3902 |
|
3903 | \begin{questionmult}\bareme{\barQmult}
|
3904 | [...]
|
3905 | \end{questionmult}</programlisting>
|
3906 |
|
3907 | <para>Une autre possibilité est offerte par les commandes LaTeX
|
3908 | <command>\baremeDefautS</command> et
|
3909 | <command>\baremeDefautM</command>, à utiliser en début de document (en
|
3910 | dehors de la commande <command>\exemplaire</command>), qui permettent
|
3911 | de donner des valeurs par défaut pour les barèmes des questions
|
3912 | simples et des questions multiples :</para>
|
3913 |
|
3914 | <programlisting>\baremeDefautM{haut=3,p=-1}</programlisting>
|
3915 |
|
3916 | <para>Dans certains cas de figure, il peut être intéressant de définir
|
3917 | un barème de manière générale <emphasis>en fonction du nombre de
|
3918 | réponses proposées</emphasis>. Il suffit pour cela de mettre les
|
3919 | valeurs intervenant dans le barème sous la forme de formules utilisant
|
3920 | la variable <varname>N</varname>. Par exemple, pour obtenir un barème
|
3921 | qui fixe à 4 la note maximale et tel que l'espérance de la note d'un
|
3922 | étudiant cochant au hasard chaque case soit de 1, on peut utiliser le
|
3923 | barème <code>d=4,b=0,m=-(4-1)*2/N</code> (qui donne une note de -2 si
|
3924 | toutes les réponses sont fausses, c'est-à-dire si on a coché les cases
|
3925 | qu'il ne fallait pas cocher et si on n'a pas coché les cases qu'il
|
3926 | fallait cocher). Les opérations acceptées dans ces formules sont les
|
3927 | quatre opérations simples (+ - * /), l'opérateur de test <code>( ? :
|
3928 | )</code>, les parenthèses et plus généralement toutes celles reconnues
|
3929 | par perl.</para>
|
3930 |
|
3931 | <para>D'autres variables sont aussi utilisables :</para>
|
3932 |
|
3933 | <itemizedlist>
|
3934 | <listitem>
|
3935 | <para><varname>N</varname> est le nombre de réponses proposées,
|
3936 | sans compter la réponse automatiquement ajoutée par l'option
|
3937 | <option>completemulti</option>.</para>
|
3938 | </listitem>
|
3939 |
|
3940 | <listitem>
|
3941 | <para><varname>NB</varname> est le nombre de bonnes réponses à la
|
3942 | question (sans tenir compte des cases cochées ou non).</para>
|
3943 | </listitem>
|
3944 |
|
3945 | <listitem>
|
3946 | <para><varname>NBC</varname> est le nombre de bonnes réponses qui
|
3947 | ont été cochées.</para>
|
3948 | </listitem>
|
3949 |
|
3950 | <listitem>
|
3951 | <para><varname>NM</varname> est le nombre de mauvaises réponses à
|
3952 | la question (sans tenir compte des cases cochées ou non).</para>
|
3953 | </listitem>
|
3954 |
|
3955 | <listitem>
|
3956 | <para><varname>NMC</varname> est le nombre de mauvaises réponses
|
3957 | qui ont été cochées.</para>
|
3958 | </listitem>
|
3959 |
|
3960 | <listitem>
|
3961 | <para><varname>IS</varname> vaut 1 si la question est simple et 0
|
3962 | sinon.</para>
|
3963 | </listitem>
|
3964 |
|
3965 | <listitem>
|
3966 | <para><varname>IMULT</varname> vaut 1 si la question est multiple
|
3967 | et 0 sinon.</para>
|
3968 | </listitem>
|
3969 | </itemizedlist>
|
3970 | </sect3>
|
3971 |
|
3972 | <sect3 id="note-finale">
|
3973 | <title>Du barème aux notes des étudiants</title>
|
3974 |
|
3975 | <para>Les notes des étudiants sont calculées de la manière suivante :
|
3976 | pour chaque étudiant,</para>
|
3977 |
|
3978 | <orderedlist>
|
3979 | <listitem>
|
3980 | <para>Le barème de chaque question est appliqué pour obtenir les
|
3981 | <emphasis>scores</emphasis> obtenus aux questions.</para>
|
3982 | </listitem>
|
3983 |
|
3984 | <listitem>
|
3985 | <para>La somme des <emphasis>scores</emphasis> de toutes les
|
3986 | questions (sauf les questions indicatives) est calculée : on
|
3987 | obtient le <emphasis>score total</emphasis> de l'étudiant.</para>
|
3988 | </listitem>
|
3989 |
|
3990 | <listitem>
|
3991 | <para>Si une <emphasis>note maximale</emphasis> non-nulle est
|
3992 | donnée en paramètre (dans l'onglet Projet de la fenêtre ), le
|
3993 | <emphasis>score total</emphasis> est divisé par le <emphasis>score
|
3994 | maximal</emphasis> (c'est-à-dire le <emphasis>score
|
3995 | total</emphasis> calculé pour une copie parfaite), puis multiplié
|
3996 | par la <emphasis>note maximale</emphasis>, pour obtenir la
|
3997 | <emphasis>note</emphasis> de l'étudiant. De cette façon, un
|
3998 | étudiant ayant répondu de manière parfaite se verra attribuer la
|
3999 | <emphasis>note maximale</emphasis>. Avec une <emphasis>note
|
4000 | maximale</emphasis> fixée à 100, la <emphasis>note</emphasis> de
|
4001 | l'étudiant pourra être vue comme un pourcentage de bonnes
|
4002 | réponses. En France, on utilise souvent une <emphasis>note
|
4003 | maximale</emphasis> égale à 20.</para>
|
4004 | </listitem>
|
4005 | </orderedlist>
|
4006 | </sect3>
|
4007 | </sect2>
|
4008 |
|
4009 | <sect2>
|
4010 | <title>Identification des étudiants</title>
|
4011 |
|
4012 | <para>Cette étape n'est pas obligatoire. Il s'agit d'associer chaque
|
4013 | copie à un étudiant. La lecture du nom d'étudiant n'est pas faite de
|
4014 | manière automatique, mais deux possibilités raisonnables sont
|
4015 | prévues :</para>
|
4016 |
|
4017 | <orderedlist>
|
4018 | <listitem>
|
4019 | <para>Il est possible de demander aux étudiants de s'identifier sur
|
4020 | leur copie grâce à leur numéro d'étudiant, qui sera renseigné en
|
4021 | cochant une case par chiffre. Une commande LaTeX est prévue pour
|
4022 | mettre cette méthode en œuvre sur la copie (voir la partie <xref
|
4023 | linkend="latex.codes"/>). Après l'examen, les copies seront
|
4024 | identifiées automatiquement à partir d'une liste mettant en
|
4025 | correspondance les numéros d'étudiants et les noms.</para>
|
4026 | </listitem>
|
4027 |
|
4028 | <listitem>
|
4029 | <para>Sans saisie des numéros d'étudiants, ou dans le cas où
|
4030 | l'identification automatique n'a pas parfaitement fonctionné (par
|
4031 | exemple en cas d'erreur de saisie des étudiants), l'interface
|
4032 | graphique permet une association manuelle assistée.</para>
|
4033 | </listitem>
|
4034 | </orderedlist>
|
4035 |
|
4036 | <para>Sélectionnons tout d'abord l'onglet <guilabel>Notation</guilabel>
|
4037 | de l'interface graphique.</para>
|
4038 |
|
4039 | <sect3 id="liste.etudiants">
|
4040 | <title id="liste.etudiants.title">Liste des étudiants</title>
|
4041 |
|
4042 | <para>Il faut tout d'abord disposer d'une liste d'étudiants. Cette
|
4043 | liste pourra bien sûr être utilisée pour plusieurs QCM. Elle devra
|
4044 | être préparée au format CSV, avec éventuellement des lignes de
|
4045 | commentaires au début préfixées par le caractère
|
4046 | `<code>#</code>' :<programlisting># liste des étudiants de première année
|
4047 | nom:prenom:no:email
|
4048 | Bienvenüe:Alexis:001:paamc@passoire.fr
|
4049 | Boulix:Jojo:002:jojo.boulix@rien.xx
|
4050 | Noël:Père:003:pere.noel@pole-nord.xx</programlisting></para>
|
4051 |
|
4052 | <para>Les lignes du fichier qui commencent par le caractère
|
4053 | `<code>#'</code> sont des commentaires. La première des autres lignes
|
4054 | contient, séparés par le caractère <code>`:'</code>, les titres des
|
4055 | colonnes. Ensuite, en une ligne par étudiant, on place les
|
4056 | informations voulues. Il est préférable d'inclure au moins une colonne
|
4057 | nommée <code>nom</code>.</para>
|
4058 |
|
4059 | <note>
|
4060 | <para>On peut remplacer le séparateur <code>`:'</code> par une
|
4061 | virgule, un point-virgule ou une tabulation. Il faut cependant
|
4062 | utiliser le même séparateur partout dans le fichier contenant la
|
4063 | liste des étudiants. Le séparateur utilisé sera détecté en prenant
|
4064 | le caractère (parmi les quatre possibles) qui apparaît le plus de
|
4065 | fois dans la première ligne qui n'est pas un commentaire.</para>
|
4066 |
|
4067 | <para>Tout fichier au format CSV devrait convenir.</para>
|
4068 | </note>
|
4069 |
|
4070 | <para>La liste des étudiants préparée (que se soit une liste simple ou
|
4071 | comprenant plus d'informations), nous la désignons maintenant en la
|
4072 | sélectionnant à partir du bouton <guibutton>Choisir</guibutton> de la
|
4073 | partie <guilabel>Identification des étudiants</guilabel>. Il faut
|
4074 | également désigner l'identifiant unique qui permettra d'identifier les
|
4075 | étudiants (en général, on choisit la colonne qui contient des numéros
|
4076 | d'étudiants). Enfin, en vue d'une association automatique, il faut
|
4077 | encore choisir le nom du code adopté dans la commande LaTeX
|
4078 | <command>AMCcode</command>.</para>
|
4079 | </sect3>
|
4080 |
|
4081 | <sect3>
|
4082 | <title>Association</title>
|
4083 |
|
4084 | <sect4>
|
4085 | <title>Association automatique</title>
|
4086 |
|
4087 | <para>En appuyant sur le bouton <guibutton>Automatique</guibutton>
|
4088 | de la partie <guilabel>Identification des étudiants</guilabel>, la
|
4089 | recherche parmi la liste des codes renseignés par les étudiants
|
4090 | s'opère. On peut ensuite observer ou peaufiner le résultat grâce à
|
4091 | une association manuelle.</para>
|
4092 |
|
4093 | <warning>
|
4094 | <para>Pour effectuer une association automatique, il est
|
4095 | nécessaire d'avoir utilisé au moins une fois la commande
|
4096 | <command>AMCcode</command> (voir <xref linkend="latex.codes"/>)
|
4097 | dans le fichier source LaTeX, et d'avoir une liste d'étudiants
|
4098 | avec une colonne qui contient une référence (en général un numéro
|
4099 | d'étudiant) qui sera identique à la saisie effectuée au niveau des
|
4100 | cases produites par <command>AMCcode</command>.</para>
|
4101 | </warning>
|
4102 | </sect4>
|
4103 |
|
4104 | <sect4>
|
4105 | <title>Association manuelle</title>
|
4106 |
|
4107 | <para>Pour ouvrir la fenêtre de reconnaissance des noms d'étudiants,
|
4108 | cliquons sur le bouton <guibutton>Manuelle</guibutton> de la partie
|
4109 | <guilabel>Identification des étudiants</guilabel>. Cette fenêtre se
|
4110 | compose d'une partie haute présentant successivement les noms
|
4111 | inscrits par les étudiants, d'une partie basse comprenant un bouton
|
4112 | par étudiant de la liste que nous avons fabriquée, ainsi que d'une
|
4113 | partie droite qui permet une navigation aisée parmi les copies à
|
4114 | identifier. Nous cliquons sur le bouton correspondant au nom inscrit
|
4115 | en partie haute pour chaque page qui nous est présentée (par défaut,
|
4116 | seules les copies non ou mal identifiées sont présentées. Ceci peut
|
4117 | être changé en cochant la case <guilabel>associés</guilabel>). Quand
|
4118 | toutes les pages sont lues, un fond bleu apparaît à la place des
|
4119 | noms, et il ne nous reste plus qu'à cliquer sur le bouton
|
4120 | <guibutton>Enregistrer</guibutton> de la fenêtre.</para>
|
4121 | </sect4>
|
4122 | </sect3>
|
4123 | </sect2>
|
4124 |
|
4125 | <sect2>
|
4126 | <title>Export de la liste des notes</title>
|
4127 |
|
4128 | <para>À ce stade, nous pouvons récupérer la liste des notes sous
|
4129 | plusieurs formats (pour l'instant CSV et OpenOffice), grâce au bouton
|
4130 | <guibutton>Exporter</guibutton>. Cet export s'accompagnera de
|
4131 | l'ouverture du fichier produit par le logiciel approprié (si il est
|
4132 | installé).</para>
|
4133 |
|
4134 | <sect3>
|
4135 | <title>Export ODS (OpenOffice, LibreOffice)</title>
|
4136 |
|
4137 | <para>Dans le fichier exporté, le codage couleur suivant est
|
4138 | adopté :</para>
|
4139 |
|
4140 | <variablelist>
|
4141 | <varlistentry>
|
4142 | <term>gris</term>
|
4143 |
|
4144 | <listitem>
|
4145 | <para>correspond aux cases qui ne comportent aucune information.
|
4146 | Il s'agit par exemple des scores d'un étudiant absent, ou des
|
4147 | scores aux questions qui n'ont pas été présentées à l'étudiant
|
4148 | correspondant.</para>
|
4149 | </listitem>
|
4150 | </varlistentry>
|
4151 |
|
4152 | <varlistentry>
|
4153 | <term>jaune</term>
|
4154 |
|
4155 | <listitem>
|
4156 | <para>utilisé pour repérer les questions où l'étudiant n'a pas
|
4157 | fourni de réponse.</para>
|
4158 | </listitem>
|
4159 | </varlistentry>
|
4160 |
|
4161 | <varlistentry>
|
4162 | <term>rouge</term>
|
4163 |
|
4164 | <listitem>
|
4165 | <para>utilisé pour les questions où l'étudiant a répondu de
|
4166 | manière <emphasis>invalide</emphasis> : il a coché plus d'une
|
4167 | case pour une question simple, ou il a coché une ou plusieurs
|
4168 | cases en plus de la case <emphasis>Aucune de ces réponses n'est
|
4169 | correcte</emphasis>.</para>
|
4170 | </listitem>
|
4171 | </varlistentry>
|
4172 |
|
4173 | <varlistentry>
|
4174 | <term>violet</term>
|
4175 |
|
4176 | <listitem>
|
4177 | <para>utilisé pour les cases correspondant à des questions
|
4178 | indicatives (ne comptent pas pour la note finale de
|
4179 | l'étudiant).</para>
|
4180 | </listitem>
|
4181 | </varlistentry>
|
4182 | </variablelist>
|
4183 | </sect3>
|
4184 | </sect2>
|
4185 |
|
4186 | <sect2>
|
4187 | <title>Annotation</title>
|
4188 |
|
4189 | <para>En appuyant sur le bouton <guibutton>Annoter les
|
4190 | copies</guibutton>, l'annotation des pages des étudiants commencera :
|
4191 | sur chaque scan, les annotations suivantes sont effectuées (nous
|
4192 | détaillons ici les annotations par défaut, qui peuvent être
|
4193 | configurées) :</para>
|
4194 |
|
4195 | <itemizedlist>
|
4196 | <listitem>
|
4197 | <para>les cases cochées à tort par l'étudiant sont entourées en
|
4198 | rouge ;</para>
|
4199 | </listitem>
|
4200 |
|
4201 | <listitem>
|
4202 | <para>les cases non-cochées qui auraient dû l'être sont cochées en
|
4203 | rouge ;</para>
|
4204 | </listitem>
|
4205 |
|
4206 | <listitem>
|
4207 | <para>les cases cochées et qui devaient l'être sont cochées en
|
4208 | bleu ;</para>
|
4209 | </listitem>
|
4210 |
|
4211 | <listitem>
|
4212 | <para>pour chaque question, sont indiquées la note obtenue ainsi que
|
4213 | la note maximale pouvant être obtenue ;</para>
|
4214 | </listitem>
|
4215 |
|
4216 | <listitem>
|
4217 | <para>la note globale de la copie est indiquée en première page de
|
4218 | la copie.</para>
|
4219 | </listitem>
|
4220 | </itemizedlist>
|
4221 |
|
4222 | <para>Le texte inscrit en haut de la première page de chaque copie peut
|
4223 | être configuré (<menuchoice>
|
4224 | <guimenu>Édition</guimenu>
|
4225 |
|
4226 | <guimenuitem>Préférences</guimenuitem>
|
4227 |
|
4228 | <guimenuitem>Annotation</guimenuitem>
|
4229 |
|
4230 | <guimenuitem>En-tête</guimenuitem>
|
4231 | </menuchoice> ou <menuchoice>
|
4232 | <guimenu>Édition</guimenu>
|
4233 |
|
4234 | <guimenuitem>Préférences</guimenuitem>
|
4235 |
|
4236 | <guimenuitem>Projet</guimenuitem>
|
4237 |
|
4238 | <guimenuitem>Annotation des copies</guimenuitem>
|
4239 |
|
4240 | <guimenuitem>Texte d'en-tête</guimenuitem>
|
4241 | </menuchoice>). Les substitutions suivantes s'applioquent sur ce texte
|
4242 | (voir <xref linkend="note-finale"/> pour une explication de la
|
4243 | signification de ces valeurs) :</para>
|
4244 |
|
4245 | <variablelist>
|
4246 | <varlistentry>
|
4247 | <term><literal>%S</literal></term>
|
4248 |
|
4249 | <listitem>
|
4250 | <para>est remplacé par le score total de l'étudiant.</para>
|
4251 | </listitem>
|
4252 | </varlistentry>
|
4253 |
|
4254 | <varlistentry>
|
4255 | <term><literal>%M</literal></term>
|
4256 |
|
4257 | <listitem>
|
4258 | <para>est remplacé par le score maximal (score obtenu par
|
4259 | l'étudiant si il ne fait aucune erreur).</para>
|
4260 | </listitem>
|
4261 | </varlistentry>
|
4262 |
|
4263 | <varlistentry>
|
4264 | <term><literal>%s</literal></term>
|
4265 |
|
4266 | <listitem>
|
4267 | <para>est remplacé par la note de l'étudiant.</para>
|
4268 | </listitem>
|
4269 | </varlistentry>
|
4270 |
|
4271 | <varlistentry>
|
4272 | <term><literal>%m</literal></term>
|
4273 |
|
4274 | <listitem>
|
4275 | <para>est remplacé par la note maximale.</para>
|
4276 | </listitem>
|
4277 | </varlistentry>
|
4278 |
|
4279 | <varlistentry>
|
4280 | <term><literal>%(ID)</literal></term>
|
4281 |
|
4282 | <listitem>
|
4283 | <para>est remplacé par le nom de l'étudiant.</para>
|
4284 | </listitem>
|
4285 | </varlistentry>
|
4286 |
|
4287 | <varlistentry>
|
4288 | <term><literal>%(<replaceable>COL</replaceable>)</literal></term>
|
4289 |
|
4290 | <listitem>
|
4291 | <para>est remplacé par la valeur de la colonne
|
4292 | <replaceable>COL</replaceable> dans la liste des étudiants pour
|
4293 | l'étudiant considéré.</para>
|
4294 | </listitem>
|
4295 | </varlistentry>
|
4296 | </variablelist>
|
4297 |
|
4298 | <para>Cette opération est effectuée page par page, et le résultat est
|
4299 | constitué de copies corrigées au format PDF. Le nom du fichier PDF qui
|
4300 | contiendra la copie corrigée d'un étudiant donné est formé à partir du
|
4301 | modèle indiqué dans le champ <guilabel>Modèle de nom de
|
4302 | fichier</guilabel>. Dans ce modèle, les textes du type
|
4303 | « (<replaceable>col</replaceable>) » seront remplacés par le contenu de
|
4304 | la colonne nommée <code><replaceable>col</replaceable></code> dans le
|
4305 | fichier listant les étudiants (voir section <xref
|
4306 | endterm="liste.etudiants.title" linkend="liste.etudiants"/>). Si on
|
4307 | laisse ce champ vide, une valeur par défaut formée du nom et du numéro
|
4308 | d'étudiant de l'étudiant sera utilisée.</para>
|
4309 | </sect2>
|
4310 | </sect1>
|
4311 |
|
4312 | <sect1>
|
4313 | <title>Utilisations particulières</title>
|
4314 |
|
4315 | <sect2>
|
4316 | <title>Photocopie du sujet</title>
|
4317 |
|
4318 | <para>Comme expliqué dans <xref endterm="impression.titre"
|
4319 | linkend="impression"/>, il n'est pas toujours possible de photocopier
|
4320 | une feuille de réponses pour en donner à plusieurs étudiants. Cependant,
|
4321 | dans le cas de l'utilisation de la feuille de réponses séparée, et quand
|
4322 | les questions et réponses ne doivent pas être mélangées, il est possible
|
4323 | de photocopier le sujet et imprimer les feuilles de réponses séparément.
|
4324 | La conduite à suivre pour obtenir un tel résultat est indiquée
|
4325 | ici.</para>
|
4326 |
|
4327 | <itemizedlist>
|
4328 | <listitem>
|
4329 | <para>Utiliser l'option <option>ensemble</option> (voir <xref
|
4330 | endterm="sec.package.options.titre"
|
4331 | linkend="sec.package.options"/>).</para>
|
4332 | </listitem>
|
4333 |
|
4334 | <listitem>
|
4335 | <para>Écrire le sujet avant l'utilisation de la commande
|
4336 | <command>exemplaire</command>, ou de l'environnement
|
4337 | <command>copieexamen</command>.</para>
|
4338 | </listitem>
|
4339 |
|
4340 | <listitem>
|
4341 | <para>Utiliser la commande <command>\AMCformS</command> pour
|
4342 | restituer les cases à cocher sur chaque feuille de réponses, à
|
4343 | l'intérieur de
|
4344 | <command>exemplaire</command>/<command>copieexamen</command>.</para>
|
4345 | </listitem>
|
4346 | </itemizedlist>
|
4347 |
|
4348 | <para>Voici un example minimal de fichier LaTeX :</para>
|
4349 |
|
4350 | <programlisting>\documentclass[a4paper]{article}
|
4351 | \usepackage[ensemble]{automultiplechoice}
|
4352 | \begin{document}
|
4353 |
|
4354 | \noindent{\bf Sujet}
|
4355 |
|
4356 | \begin{question}{sum}
|
4357 | Combien font un plus un ?
|
4358 | \begin{reponses}
|
4359 | \mauvaise{1}
|
4360 | \bonne{2}
|
4361 | \mauvaise{3}
|
4362 | \end{reponses}
|
4363 | \end{question}
|
4364 |
|
4365 | \begin{question}{k2}
|
4366 | Quelle est l'altitude du K2?
|
4367 | \begin{reponses}
|
4368 | \mauvaise{around 8000m}
|
4369 | \bonne{around 8600m}
|
4370 | \mauvaise{around 9000m}
|
4371 | \end{reponses}
|
4372 | \end{question}
|
4373 |
|
4374 | \AMCcleardoublepage
|
4375 |
|
4376 | \exemplaire{5}{
|
4377 |
|
4378 | \AMCdebutFormulaire
|
4379 |
|
4380 | {\large\bf Feuille de r\'eponses :}
|
4381 | \hfill \champnom{\fbox{
|
4382 | \begin{minipage}{.5\linewidth}
|
4383 | Nom:
|
4384 |
|
4385 | \vspace*{.5cm}\dotfill
|
4386 | \vspace*{1mm}
|
4387 | \end{minipage}
|
4388 | }}
|
4389 |
|
4390 | \AMCformS
|
4391 |
|
4392 | }
|
4393 |
|
4394 | \end{document}</programlisting>
|
4395 | </sect2>
|
4396 |
|
4397 | <sect2 id="postcorrect">
|
4398 | <title>Correction a posteriori</title>
|
4399 |
|
4400 | <para>Supposons que vous souhaitez utiliser une unique feuille de
|
4401 | réponses générique pour tous vos examens. Elle contiendra simplement des
|
4402 | cases à cocher (par exemple 5 cases par question, et 40 questions). Les
|
4403 | sujets des examens seront rédigés à part. Le problème ici est que les
|
4404 | bonnes réponses ne sont pas indiquées dans le fichier LaTeX, ce qui fait
|
4405 | que AMC ne peut pas les connaître. La solution consiste à demander à
|
4406 | l'enseignant de cocher sur une feuille de réponse les bonnes réponses,
|
4407 | qui sera transmise à AMC pour qu'il y lise les bonnes réponses.</para>
|
4408 |
|
4409 | <para>Pour mettre en œuvre ce schéma de fonctionnement, vous
|
4410 | devez :</para>
|
4411 |
|
4412 | <itemizedlist>
|
4413 | <listitem>
|
4414 | <para>utiliser les options <option>postcorrect</option>,
|
4415 | <option>insidebox</option> et <option>noshuffle</option> (voir <xref
|
4416 | endterm="sec.package.options.titre"
|
4417 | linkend="sec.package.options"/>) ;</para>
|
4418 | </listitem>
|
4419 |
|
4420 | <listitem>
|
4421 | <para>utiliser <command>\mauvaise</command> pour toutes les réponses
|
4422 | (jamais <command>\bonne</command>).</para>
|
4423 | </listitem>
|
4424 | </itemizedlist>
|
4425 |
|
4426 | <para>Voici un exemple minimal :</para>
|
4427 |
|
4428 | <programlisting>\documentclass[a4paper]{article}
|
4429 | \usepackage{multicol}
|
4430 | \usepackage[insidebox,noshuffle,postcorrect]{automultiplechoice}
|
4431 |
|
4432 | \begin{document}
|
4433 |
|
4434 | \exemplaire{5}{
|
4435 |
|
4436 | \noindent
|
4437 | \begin{tabular}{|l|l|l|}
|
4438 | \hline
|
4439 | num\'ero d'\'etudiant & classe & sujet\\
|
4440 | \hline
|
4441 | \vspace{-0.25cm}
|
4442 | & &\\
|
4443 | \AMCcode{NumEtud}{10}\hspace*{\fill}&
|
4444 | \AMCcode{Classe}{2}\hspace*{\fill}&
|
4445 | \AMCcode{Sujet}{3}\hspace*{\fill}
|
4446 | \\
|
4447 | \hline
|
4448 | \end{tabular}
|
4449 | \hfill\namefield{\fbox{
|
4450 | \begin{minipage}{.25\linewidth}
|
4451 | Nom :
|
4452 |
|
4453 | \vspace*{.5cm}\dotfill
|
4454 |
|
4455 | \vspace*{.5cm}\dotfill
|
4456 | \vspace*{1mm}
|
4457 | \end{minipage}
|
4458 | }}\hfill
|
4459 |
|
4460 |
|
4461 | \vspace{.5cm}
|
4462 | \noindent\hrulefill
|
4463 |
|
4464 | \begin{multicols}{2}\columnseprule=.4pt
|
4465 |
|
4466 | \begin{question}{01}
|
4467 | \begin{reponsesperso}
|
4468 | \mauvaise{}%
|
4469 | \mauvaise{}%
|
4470 | \mauvaise{}%
|
4471 | \mauvaise{}%
|
4472 | \mauvaise{}%
|
4473 | \end{reponsesperso}
|
4474 | \end{question}
|
4475 |
|
4476 | \begin{question}{02}
|
4477 | \begin{reponsesperso}
|
4478 | \mauvaise{}%
|
4479 | \mauvaise{}%
|
4480 | \mauvaise{}%
|
4481 | \mauvaise{}%
|
4482 | \mauvaise{}%
|
4483 | \end{reponsesperso}
|
4484 | \end{question}
|
4485 |
|
4486 | % continuez ici pour ajouter autant de questions que souhaité...
|
4487 |
|
4488 | \end{multicols}
|
4489 |
|
4490 | }
|
4491 |
|
4492 | \end{document}</programlisting>
|
4493 |
|
4494 | <para>Après traitement du fichier LaTeX par AMC, imprimez les feuilles
|
4495 | de réponses obtenues, faites passer l'examen et demandez à l'enseignant
|
4496 | de remplir une feuille. Scannez ensuite les feuilles de réponses, et
|
4497 | lancez la saisie automatique dans AMC (y compris de la feuille remplie
|
4498 | par l'enseignant). Quand vous cliquez sur
|
4499 | <guibutton>Corriger</guibutton> dans l'onglet
|
4500 | <guilabel>Notation</guilabel>, en laissant la case <guilabel>Mettre à
|
4501 | jour le barème</guilabel> cochée, AMC vous demandera le numéro de la
|
4502 | copie remplie par l'enseignant. La suite des opérations est la même que
|
4503 | dans le cas standard.</para>
|
4504 |
|
4505 | <note>
|
4506 | <para>Vous pouvez aussi écrire les lettres des cases à l'extérieur de
|
4507 | celles-ci : utilisez pour cela l'option <option>outsidebox</option> à
|
4508 | la place de <option>insidebox</option>, et écrivez vos questions de la
|
4509 | façon suivante:</para>
|
4510 |
|
4511 | <programlisting>\begin{question}{01}
|
4512 | \begin{reponsesperso}
|
4513 | \wrongchoice{A }%
|
4514 | \wrongchoice{B }%
|
4515 | \wrongchoice{C }%
|
4516 | \wrongchoice{D }%
|
4517 | \wrongchoice{E }%
|
4518 | \end{reponsesperso}
|
4519 | \end{question}
|
4520 | </programlisting>
|
4521 | </note>
|
4522 | </sect2>
|
4523 |
|
4524 | <sect2>
|
4525 | <title>Copies préremplies</title>
|
4526 |
|
4527 | <para>Dans certaines situations, il peut être souhaitable de préparer
|
4528 | des copies nominatives pour tous les étudiants, à partir d'une liste
|
4529 | d'étudiants. La démarche suivante, basée sur l'utilisation du paquet
|
4530 | LaTeX csvsimple, permet d'obtenir ce résultat.</para>
|
4531 |
|
4532 | <itemizedlist>
|
4533 | <listitem>
|
4534 | <para>La liste des étudiants doit être au format CSV. On suppose
|
4535 | dans la suite que le fichier <filename>liste.csv</filename>, placé
|
4536 | dans le répertoire du projet, utilise l'encodage UTF8 et est sous la
|
4537 | forme suivante :<programlisting>nom,prenom,id
|
4538 | Boulix,Jojo,001
|
4539 | Golin,André,002
|
4540 | Moniuszko,Stanisław,003</programlisting></para>
|
4541 | </listitem>
|
4542 |
|
4543 | <listitem>
|
4544 | <para>Le sujet LaTeX doit charger le paquet csvsimple, grâce à une
|
4545 | ligne<programlisting>\usepackage{csvsimple}</programlisting></para>
|
4546 | </listitem>
|
4547 |
|
4548 | <listitem>
|
4549 | <para>Dans le fichier source, le sujet doit être défini sous la
|
4550 | forme d'une commande LaTeX produisant un seul sujet, qui sera
|
4551 | appelée (autant de fois qu'il y a d'étudiants) par la commande
|
4552 | <command>\csvreader</command> de la façon suivante (on suppose que
|
4553 | les questions ont été préalablement insérées dans un groupe appelé
|
4554 | <code>general</code>) :</para>
|
4555 |
|
4556 | <programlisting>\newcommand{\sujet}{
|
4557 | \onecopy{1}{
|
4558 |
|
4559 | \noindent{\bf AutoMultipleChoice \hfill TEST}
|
4560 |
|
4561 | \vspace*{.5cm}
|
4562 |
|
4563 | \begin{center}\em
|
4564 | Test des copies pr\'e-remplies.
|
4565 | \end{center}
|
4566 |
|
4567 | \hfill \champnom{\fbox{
|
4568 | \begin{minipage}{.5\linewidth}
|
4569 | Nom:
|
4570 |
|
4571 | \Large\bf \prenom{} \nom{}
|
4572 |
|
4573 | \vspace*{1mm}
|
4574 | \end{minipage}
|
4575 | }}
|
4576 |
|
4577 | \noindent\hrulefill
|
4578 |
|
4579 | \vspace{1ex}
|
4580 |
|
4581 | \melangegroupe{general}
|
4582 | \restituegroupe{general}
|
4583 |
|
4584 | \AMCassociation{\id}
|
4585 | }
|
4586 | }
|
4587 |
|
4588 | \csvreader[head to column names]{liste.csv}{}{\sujet}
|
4589 | </programlisting>
|
4590 |
|
4591 | <para>Notez l'utilisation de l'option <code>head to column
|
4592 | names</code> de <command>\csvreader</command> qui définit des
|
4593 | commandes basées sur les en-tête du fichier CSV (ici
|
4594 | <command>\nom</command>, <command>\prenom</command> et
|
4595 | <command>\id</command>) utilisables dans la production du sujet
|
4596 | personnalisé, et l'appel de <command>\AMCassociation</command> qui
|
4597 | indique à AMC que la copie produite doit être associée à
|
4598 | l'identifiant d'étudiant <command>\id</command>.</para>
|
4599 | </listitem>
|
4600 |
|
4601 | <listitem>
|
4602 | <para>Après l'impression, le scan, la saisie automatique et la
|
4603 | notation des copies, au moment de l'association des copies avec les
|
4604 | étudiants, utiliser la valeur "<emphasis>pré-association</emphasis>"
|
4605 | pour le champ "Titre du code pour association automatique", et
|
4606 | "<emphasis>id</emphasis>" pour le champ "Identifiant unique".</para>
|
4607 | </listitem>
|
4608 | </itemizedlist>
|
4609 | </sect2>
|
4610 | </sect1>
|
4611 |
|
4612 | <sect1 id="commandes">
|
4613 | <title>Manuel des commandes</title>
|
4614 |
|
4615 | <para>Vous pouvez vous passer de la lecture de cette partie si vous
|
4616 | souhaitez utiliser uniquement l'interface graphique. Cependant, toutes les
|
4617 | actions effectuées par l'interface graphique peuvent aussi être exécutées
|
4618 | par les différentes commandes dont nous décrivons ici la syntaxe.</para>
|
4619 |
|
4620 | <refentry id="auto-multiple-choice">
|
4621 | <refmeta>
|
4622 | <refentrytitle>auto-multiple-choice</refentrytitle>
|
4623 |
|
4624 | <manvolnum>1</manvolnum>
|
4625 |
|
4626 | <refmiscinfo class="source">Auto Multiple Choice</refmiscinfo>
|
4627 |
|
4628 | <refmiscinfo class="version">@/PACKAGE_V_DEB/@</refmiscinfo>
|
4629 | </refmeta>
|
4630 |
|
4631 | <refnamediv>
|
4632 | <refname>auto-multiple-choice</refname>
|
4633 |
|
4634 | <refpurpose>Gestion automatisée de questionnaires QCM</refpurpose>
|
4635 | </refnamediv>
|
4636 |
|
4637 | <refsynopsisdiv>
|
4638 | <cmdsynopsis>
|
4639 | <command>auto-multiple-choice</command>
|
4640 |
|
4641 | <arg choice="plain"><replaceable>action</replaceable> <arg
|
4642 | rep="repeat">arguments</arg></arg>
|
4643 | </cmdsynopsis>
|
4644 |
|
4645 | <cmdsynopsis>
|
4646 | <command>auto-multiple-choice</command>
|
4647 |
|
4648 | <arg>projet</arg>
|
4649 | </cmdsynopsis>
|
4650 | </refsynopsisdiv>
|
4651 |
|
4652 | <refsect1>
|
4653 | <title>Description</title>
|
4654 |
|
4655 | <para>La commande <command>auto-multiple-choice</command> transmet à
|
4656 | la commande
|
4657 | <command>AMC-<replaceable>action</replaceable>.pl</command> les
|
4658 | arguments qu'on lui donne.</para>
|
4659 |
|
4660 | <para>La deuxième forme, qui ne mentionne aucune action, appelle
|
4661 | l'interface graphique <command>AMC-gui.pl</command> en lui
|
4662 | transmettant éventuellement le nom d'un projet à ouvrir.</para>
|
4663 | </refsect1>
|
4664 |
|
4665 | <refsect1>
|
4666 | <title>See also</title>
|
4667 |
|
4668 | <para>Différentes actions possibles : <citerefentry>
|
4669 | <refentrytitle>AMC-prepare</refentrytitle>
|
4670 |
|
4671 | <manvolnum>1</manvolnum>
|
4672 | </citerefentry>, <citerefentry>
|
4673 | <refentrytitle>AMC-imprime</refentrytitle>
|
4674 |
|
4675 | <manvolnum>1</manvolnum>
|
4676 | </citerefentry>, <citerefentry>
|
4677 | <refentrytitle>AMC-analyse</refentrytitle>
|
4678 |
|
4679 | <manvolnum>1</manvolnum>
|
4680 | </citerefentry>, <citerefentry>
|
4681 | <refentrytitle>AMC-note</refentrytitle>
|
4682 |
|
4683 | <manvolnum>1</manvolnum>
|
4684 | </citerefentry>, <citerefentry>
|
4685 | <refentrytitle>AMC-association-auto</refentrytitle>
|
4686 |
|
4687 | <manvolnum>1</manvolnum>
|
4688 | </citerefentry>, <citerefentry>
|
4689 | <refentrytitle>AMC-export</refentrytitle>
|
4690 |
|
4691 | <manvolnum>1</manvolnum>
|
4692 | </citerefentry>, <citerefentry>
|
4693 | <refentrytitle>AMC-annote</refentrytitle>
|
4694 |
|
4695 | <manvolnum>1</manvolnum>
|
4696 | </citerefentry>, <citerefentry>
|
4697 | <refentrytitle>AMC-regroupe</refentrytitle>
|
4698 |
|
4699 | <manvolnum>1</manvolnum>
|
4700 | </citerefentry>.</para>
|
4701 | </refsect1>
|
4702 | </refentry>
|
4703 | </sect1>
|
4704 | </article>
|