Pour les utilisateurs qui ne souhaitent pas se mettre à LaTeX, AMC embarque un filtre qui rédige pour vous le fichier LaTeX à partir d'une représentation en texte simple de votre questionnaire. Ce format est appelé AMC-TXT, et ce chapitre détaille la syntaxe à utiliser. Si vous souhaitez profiter de la puissance de LaTeX pour la rédaction de vos questionnaires, passez au chapitre suivant.
Commençons par un exemple simple de fichier source utilisable par AMC :
# AMC-TXT source PaperSize: A4 Lang: FR Title: Mon premier questionnaire Presentation: Veuillez répondre aux questions ci-dessous du mieux que vous pouvez. * Quelle est la capitale du Cameroun ? + Yaoundé - Douala - Kribi ** Parmi les nombres suivants, lesquels sont positifs ? + 2 - -2 + 10
Important | |
---|---|
Le fichier qui contient la description de votre sujet doit être codé en UTF-8. C'est le codage par défaut de plusieurs éditeurs de texte, dont fait partie gedit par exemple. N'utilisez pas d'éditeur de texte permettant d'appliquer des mises en forme à votre texte, comme OpenOffice/LibreOffice ou abiword : ils n'enregistrent pas seulement votre texte, mais beaucoup d'autres informations de mise en forme qu'AMC ne sait pas lire... |
Note | |
---|---|
La police de caractères qui sera utilisée par défaut pour votre questionnaire est la police libertine. C'est une police libre qui définit un très grand nombre de caractères de toutes langues. Cette police doit être installée sur votre système pour que votre sujet puisse être préparé (c'est le cas si vous installez AMC sur debian ou Ubuntu avec les paquets qu'il recommande). |
Vous remarquez dès maintenant la structure du fichier de description du questionnaire : il commence par quelques définitions ou options générales de mise en forme, puis viennent les questions.
Vous pouvez écrire des commentaires dans votre fichier AMC-TXT sur
des lignes commençant par le caractère
#
. Ces lignes seront tout simplement ignorées par
AMC.
Voici les options que vous pouvez utiliser au début de votre fichier (dans n'importe quel ordre) :
Indique le format de papier utilisé. Parmi les valeurs
possibles, on trouve A3
, A4
,
A5
, A6
, B3
,
B4
, B5
, B6
,
letter
, legal
, ANSIA
,
ANSIB
, ANSIC
, ANSID
,
ANSIE
.
donne la langue dans laquelle le questionnaire est écrit. Pour l'instant, les seules langues disponibles sont FR (français), ES (espagnol), DE (allemand), IT (Italien), NL (Néerlandais), NO (Norvégien), PT (portugais), JA (Japonais, voir la section intitulée « En japonais ») et AR (arabe, voir la section intitulée « En langue arabe »). Si vous n'utilisez pas cette option, ce sera l'anglais qui sera choisi.
Moteur de compilation : xelatex -shell-escape
, par exemple
Le titre de l'examen, qui sera écrit en haut de la copie.
Un texte introductif pour l'examen, présentant par exemple la durée, les consignes...
Si le mélange des questions et des réponses ne nous convient pas, on peut toujours en changer en modifiant la graine du générateur aléatoire utilisé pour le mélange, grâce à cette option. Si la valeur fournie (à choisir entre 1 et 4194303) est modifiée, alors le mélange sera différent. Bien entendu, une fois les copies d'examen imprimées, il ne faut surtout pas modifier cette valeur !
Note | |
---|---|
La valeur est enregistrée dans le fichier xy (sous la
forme |
Si cette option est mise à 1 (c'est la valeur par défaut), les questions ne seront pas dans le même ordre dans chaque copie. Si vous lui donnez la valeur 0, les questions ne seront pas mélangées.
Affectez à cette option une valeur entière
n
(par exemple 8) pour demander la
présence de cases à cocher pour que les étudiants codent leur
numéro d'étudiant sur n
chiffres.
Donnez à cette option la valeur horizontal
ou
vertical
pour imposer la direction suivant laquelle
les chiffres du code seront présentés. Si vous n'utilisez pas
cette option, AMC choisira en fonction de la taille du code
(direction horizontale pour un petit nombre de chiffres, et
verticale pour un grand nombre de chiffres).
Si vous donnez à cette option une valeur
n
entière supérieure à 1, le
questionnaire sera écrit sur n
colonnes.
Cette option prend la valeur 1 par défaut, ce qui signifie qu'une réponse "Aucune des réponses ci-dessus n'est correcte" sera ajoutée à la fin de toutes les questions multiples de votre questionnaire. Sans celle-ci, il serait impossible de faire la différence entre "l'étudiant ne répond pas à cette question" et "l'étudiant pense qu'aucune des réponses proposées n'est exacte". Si vous ne souhaitez pas que cette dernière réponse soit ajoutée, donnez la valeur 0 à cette option.
Cette option indique un texte qui remplacera Aucune des réponses ci-dessus n'est correcte (voir option précédente) pour votre questionnaire.
Si cette option prend la valeur 1 (sa valeur par défaut), toutes vos questions seront enfermées dans des boîtes (invisibles), de sorte qu'elles ne puissent pas être coupées sur deux pages, ou sur plusieurs colonnes. Avec la valeur 0, les questions pourront être coupées si besoin, ce qui peut gagner de la place au détriment de la lisibilité.
Cette option sert à remplacer le mot
Question dans votre questionnaire si vous
utilisez une autre langue que celle indiquée par l'option
Lang
.
Cette option sert à remplacer le texte Nom et prénom inscrit dans le cadre où l'étudiant doit inscrire son identité.
Cette option sert à remplacer le petit texte qui demande de
coder son numéro d'étudiant et d'inscrire son nom sur les copies
(quand l'option Code
a été utilisée).
Largeur de la zone prévue pour le titre, dans le cas où on
n'utilise pas Code:
. La valeur par défaut est
.47\linewidth
.
Largeur de la zone destinée à l'écriture du nom et prénom de
l'étudiant. On peut utiliser les unités usuelles en LaTeX. La
valeur par défaut est 5.8cm
si on utilise
Code:
, et .47\linewidth
sinon.
Nombre de lignes prévues pour l'écriture du nom et prénom de
l'étudiant. La valeur par défaut est 2
si on utilise
Code:
, et 1
sinon.
Interligne dans la zone destinée à l'écriture du nom et
prénom de l'étudiant. La valeur par défaut est
.5em
.
Donne un nombre de pages minimal pour le sujet. Si un sujet
comporte moins de pages que cette valeur, des pages blanches
seront ajoutées. Dans le cas de l'utilisation d'une feuille de
réponses séparée, cette option peut être écrite sous la forme
(par exemple s
+r
4+2
), où
s
sera le nombre de pages minimal pour
la partie sujet et
s
+r
le
nombre de pages minimal pour le sujet complet.
Avec la valeur 1 (ce n'est pas la valeur par défaut), chaque sujet sera constitué d'un nombre pair de pages, de telle sorte que tous les sujets pourront être imprimés manuellement à partir du fichier PDF sujet en mode recto/verso (sans l'utilisation de cette option, le début d'une copie pourraît être sur le verso de la fin de la copie précédente).
Avec la valeur 1 (ce n'est pas la valeur par défaut), aucune page blanche ne sera ajoutée entre le sujet et la feuille de réponses séparée, même si le sujet comporte un nombre impair de pages. Ceci peut être utile quand les sujets sont imprimés en recto simple, ou quand il n'est pas nécessaire de séparer physiquement le sujet de la feuille de réponses.
Permet de choisir une couleur pour les cases qui peuvent
être cochées par les étudiants, afin de perturber le moins
possible la saisie automatique à partir des scans
(red, pour rouge, est une valeur commune,
mais on peut aussi penser à un gris clair). La couleur fournie
doit être une couleur valide pour xcolor (voir
la documentation du paquet LaTeX xcolor pour
plus de détails), comme red,
magenta, pink,
lightgray, cyan, ou bien
sous la forme #RRGGBB
, comme #FFBEC8
pour un rouge clair.
Donne le barème par défaut pour les questions simples (Reportez-vous à la section intitulée « Barème » pour la description des barèmes possibles). Sans cette option, le barème par défaut donne un point à la bonne réponse, et zéro aux autres.
Donne le barème par défaut pour les questions multiples
(Reportez-vous à la section intitulée « Barème » pour la description des
barèmes possibles). Sans cette option le barème par défaut est
haut=2
, ce qui correspond à un barème donnant deux
points pour une réponse parfaitement exacte, et qui enlève un
point à chaque erreur (case cochée alors qu'elle ne devrait pas
l'être, ou case non-cochée alors qu'elle devrait l'être), sans
passer en-dessous de zéro.
Si cette option prend la valeur 1, tous les textes de votre
questionnaire sont considérés comme étant écrits en TeX (ou
LaTeX). Vous pourrez ainsi écrire des formules mathématiques comme
$\sqrt{a+b}$
. Avec la valeur 0 (valeur par défaut),
vos textes seront reproduits sans modification.
Donne des commandes LaTeX à ajouter dans le préambule (par exemple des \usepackage).
Donne des commandes LaTeX à ajouter au début de l'environnement document (par exemple des définitions de macros).
Donne des commandes LaTeX à ajouter au début de la description d'une copie.
Donne des commandes LaTeX à ajouter à la fin de la description d'une copie.
Donne le nom d'un fichier PDF à ajouter au début de chaque copie.
Donne le nom d'un fichier PDF à ajouter à la fin de chaque copie.
Donne une liste de convertisseurs à désactiver, séparés par
des virgules. Les convertisseurs disponibles sont
verbatim
(voir la section intitulée « Verbatim »),
images
(voir la section intitulée « Inclusion d'images »),
embf
(voir la section intitulée « Gras, italique, typewriter, souligné ») et
local_latex
(voir la section intitulée « Petits morceaux de LaTeX »).
Donne des options supplémentaires à transmettre au paquet LaTeX automultiplechoice (voir la section intitulée « Options du paquet »).
Dans le cas d'un sujet avec feuille de réponses séparée, vous pourrez considérer l'emploi des options suivantes :
Donner la valeur 1 à cette option pour obtenir une feuille de réponses séparée.
Donne le titre à inscrire en tête de la feuille de réponse.
Donne le texte de présentation de la feuille de réponse. On pourra, par exemple, y préciser que les réponses doivent uniquement être données sur cette feuille.
Nombre de colonnes pour la feuille de réponses.
Donner la valeur 1 à cette option pour utiliser l'option
automarks
(voir la section intitulée « Options du paquet »).
Dans certaines situations, il peut être souhaitable de préparer des copies nominatives pour tous les étudiants, à partir d’une liste d’étudiants.
Le nom du fichier avec la liste des étudiants et l'extension .csv
Identifiant unique dans cette liste : il s’agit du nom de la colonne qui, dans le fichier csv des étudiants, contient le numéro d’étudiant (voir la section intitulée « Liste des étudiants »).
\prenom{} \nom{} en-têtes des colonnes avec le prénom et le nom des étudiants.
La liste des étudiants doit être au format CSV. On suppose
dans la suite que le fichier liste.csv
, placé
dans le répertoire du projet, utilise l'encodage UTF8 et est sous la
forme suivante :
nom,prenom,id,mail Boulix,Jojo,001,jojo@boulix.fr Golin,André,002,andre@golin.fr Moniuszko,Stanisław,003,Moniuszko@Stanisław.fr
Avertissement | |
---|---|
Ne pas utiliser le symbole _ (underscore) dans le nom ou prénom des étudiants. Une erreur de compilation sera affichée. |
Code doit être égal à zéro ou omis.
#Exemple simple au format AMC-TXT avec les copies pré-remplies PaperSize: A4 Lang: FR PreAssociation: liste.csv PreAssociationKey: id PreAssociationName: \prenom{} \nom{} Title: Mon premier questionnaire Presentation: Veuillez répondre aux questions ci-dessous du mieux que vous pouvez. * Quelle est la capitale du Cameroun ? + Yaoundé - Douala - Kribi ** Parmi les nombres suivants, lesquels sont positifs ? + 2 - -2 + 10
Plus de détails pour la correction : voir le dernier item de la section intitulée « Copies pré-remplies ».
Les questions simples (qui acceptent une et une seule bonne
réponse) commencent par un *
en début de ligne, et les
questions multiples (celles qui peuvent comporter zéro, une ou
plusieurs bonnes réponses), commencent par un **
en début
de ligne. Vient ensuite le texte de la question, puis les réponses,
introduites par un +
quand la réponse est correcte ou un
-
quand elle ne l'est pas.
Des options particulières peuvent être indiquées pour chaque question, entre crochets, juste après l'étoile (ou les deux étoiles pour des questions multiples) qui commence la question (sans espace avant), comme dans l'exemple suivant :
*[ordered,horiz,id=addition] Combien font un plus un ? - 0 - 1 + 2
Les options disponibles sont les suivantes :
Avec cette option, les réponses se suivront horizontalement plutôt que verticalement une par ligne.
n
Avec cette option, les réponses seront réparties sur
n
colonnes.
Avec cette option, les réponses ne seront pas mélangées dans chaque copie : elles resteront toujours dans l'ordre indiqué.
xxxx
Avec cette option, le nom xxxx
sera donné à la question. Ce nom apparaît dans les fichiers de
notes exportés par AMC pour identifier la question plus
facilement. Il ne doit comporter que des caractères simples non
accentués.
Important | |
---|---|
Voir aussi Identifiant des questions. |
name
a le même rôle que l'option
id
. Cette option est présente pour assurer la
compatibilité avec d'anciennes versions, préférez l'utilisation
de id
.
Indique que le score affecté à cette question ne sera pas pris en compte pour le score final de l'étudiant.
Avec cette option, la question suivra toujours la question
précédente, même lorsque l'on demande de mélanger les questions
avec l'option générale ShuffleQuestions
.
Avec cette option, la question sera toujours insérée en début de groupe (voir la section intitulée « Groupes de questions »).
Avec cette option, la question sera toujours insérée en fin de groupe (voir la section intitulée « Groupes de questions »).
Si vous voulez utiliser un barème particulier pour une question
ou une réponse, vous pouvez l'indiquer entre accolades, après le signe
*
, **
, +
, ou -
, et
après les éventuelles options, comme dans l'exemple suivant.
Reportez-vous à la section intitulée « Barème » pour la syntaxe de
description des barèmes à utiliser.
*{b=2,m=-1} Quelle est la capitale de la France ? + Paris - Lille -{-2} Ouagadougou **[ordered,horiz,id=positifs]{haut=1} Parmi les nombres suivants, lesquels sont positifs ? - -2 + 2 + 10
Les questions peuvent être transformées en questions ouvertes en
indiquant des options (voir la section intitulée « Questions ouvertes ») entre
<
et >
, comme dans l'exemple
suivant :
*<lines=4> Décrivez la lune. -[O]{0} O -[P]{1} P +[V]{2} V
Lors de l'utilisation de questions ouvertes, les options générales suivantes peuvent être intéressantes :
Texte à ajouter après les questions pour demander aux étudiants d'écrire la réponse sur la feuille de réponses séparée (dans le cas où celle-ci est utilisée).
Texte (court) à ajouter à côté des cases à cocher des questions ouvertes, indiquant aux étudiants que ces cases sont réservées aux correcteurs.
Tout texte peut se continuer sur la ou les lignes suivantes (même si certaines sont vides), pourvu qu'elles ne puissent pas être interprétées comme un début de définition d'option générale, un début de question ou de réponse. Considérons par exemple l'écriture de question suivante :
* Combien font 2 + 2 ? - 0 + 4 - 10
Cette écriture suit bien la syntaxe AMC-TXT, mais ne correspond pas à ce que l'on voulait écrire : ici, la deuxième ligne sera considérée comme une réponse possible, et non comme la suite de la question !
Un problème similaire sera rencontré dans la portion de fichier
source suivante, où "Chopin:
" sera considéré comme une
définition d'option générale :
* Vous connaissez sans doute Frédéric Chopin: c'est un compositeur. De quel pays est-il originaire ? + la Pologne - le Vénézuela - la Suisse
La version correcte est la suivante :
* Vous connaissez sans doute Frédéric Chopin: c'est un compositeur. De quel pays est-il originaire ? + la Pologne - le Vénézuela - la Suisse
Notez enfin que pour passer à la ligne suivante, il faut laisser une ligne vide dans le fichier source de l'examen, comme ceci :
Description: Titre Description de l'examen sur la ligne suivante. ** Question difficile. Combien y a-t-il d'étoiles dans le ciel ? - une - deux - dix millions
Pour obtenir un bloc de texte verbatim (par
exemple pour un code informatique), entourez-le de
[verbatim]
et [/verbatim]
:
* Qu'est-ce que le code suivant écrit ? [verbatim] main( ) { printf("hello, world\n"); } [/verbatim] + [| hello, world |] - [| hello |] - [| world |]
Les parties du textes à écrire en gras
devront être entourées de [*
et *]
. Les
parties à mettre en italique devront être entourées
de [_
et _]
. Pour avoir une police façon
machine à écrire typewriter, le texte devra être
encadré par [|
et |]
. Pour
souligner, encadrer le texte par [/
et
/]
.
** Choisissez parmi les expressions suivantes celles où le mot en italique est [*un adjectif*]. + Une balle [_bleue_] - Un [_livre_] rose + Quelle [_belle_] histoire !
Vous pouvez inclure des images dans votre document en utilisant la syntaxe suivante :
![height=2cm]images/oiseau.png!
Dans cet exemple, l'image images/oiseau.png
située dans le répertoire du projet sera insérée avec une hauteur de
2cm. Les options que l'on peut utiliser entre les crochets sont celles
de la commande LaTeX \includegraphics (par exemple,
width=1cm
, ou
keepaspectratio
). Pour obtenir une image centrée
sur une ligne et ayant pour largeur les trois quarts de la ligne, on
utilisera de même :
!{center}[width=.75\linewidth]images/carte.pdf!
Vous pouvez inclure quelques segments de code LaTeX dans votre description en les incluant entre des double crochets, comme dans l'exemple suivant :
Les questions marquées d'un [[\multiSymbole{}]] peuvent avoir zéro, une ou plusieurs bonnes réponses.
Vous pouvez demander à ce que certaines questions restent groupées lors du mélange des questions, et ajouter un texte introductif avant ce groupe de questions (et un autre texte après), en utilisant la syntaxe suivante :
*( Les trois questions suivantes concernent Martin Luther King. * En quelle année est-il né ? - 1901 + 1929 - 1968 * En quelle année est-il mort ? - 1945 - 1515 + 1968 - 1999 * Dans quelle ville est-il né ? + Atlanta - Memphis - New York *) Fin des questions sur Martin Luther King.
Vous pouvez ajouter des options à l'ouverture du groupe, comme suit :
*([shuffle=false,columns=2] Les trois questions suivantes concernent Martin Luther King.
Les options suivantes sont acceptées :
xxx
En donnant la valeur true
ou
false
, on demande à mélanger ou non les
questions de ce groupe. La valeur par défaut est celle utilisée
globalement par l'option ShuffleQuestions
.
n
Donne le nombre de colonnes dans lesquelles seront mises en forme les questions.
nom
Donne un nom au groupe (celui-ci ne sera pas visible sur le sujet, mais uniquement dans le fichier LaTeX généré à partir du fichier source AMC-TXT).
n
Avec cette option, les n
premières questions du groupes seront utilisées. Si les questions
sont mélangées, cela permettra de sélectionner
n
questions au hasard.
Note | |
---|---|
Les questions utilisant l'option |
dim
Donne une hauteur (avec l'unité : par exemple
4cm
) nécessaire pour commencer l'énoncé
de ce groupe. Si la place encore disponible dans la page courante
est inférieure à cette valeur, alors l'énoncé du groupe commencera
sur la page suivante.
La rédaction d'un questionnaire en langue arabe comporte quelques spécificités. Vous utiliserez bien entendu l'option
Lang: AR
Mais vous devrez également prêter attention aux options suivantes :
C'est la police de caractères qui sera utilisée pour les textes en arabe. Par défaut, AMC utilisera Rasheeq, une police du projet ArabEyes (disponible dans la paquet ttf-arabeyes sur debian et ubuntu par exemple).
Note | |
---|---|
Pour pouvoir insérer des textes en d'autres caractères dans
votre questionnaire, vous devrez utiliser l'option
|
Vous pourrez construire des questionnaires incluant des caractères japonais grâce à l'option
Lang: JA
AMC fera les ajustements nécessaires pour permettre un bon rendu de ces caractères.
Avertissement | |
---|---|
Dans ce cas, AMC utilisera pTex comme moteur LaTeX. Une version récente de pTex est nécessaire. La distribution texlive 2009, disponible par exemple sur certaines anciennes versions de distributions linux, n'est pas suffisante. |
Vous pouvez inclure le contenu d'autres fichiers à tout moment comme suit :
IncludeFile: fichier-a-inclure.txt
Avertissement | |
---|---|
Faites très attention si le fichier à inclure est utilisé par
plusieurs projets ! Supposons par exemple que
|
# Exemple plus complet au format AMC-TXT avec du code LaTeX. PaperSize: A4 Lang: FR CompleteMulti: 0 ShuffleQuestions: 0 LaTeX: 1 LaTex-Preambule: \geometry{hmargin=2cm,headheight=2cm,headsep=.3cm,footskip=1cm,top=2.5cm, bottom=2cm} \usepackage{siunitx} \sisetup{locale = FR,detect-all,group-minimum-digits=3,per-mode=symbol} \usepackage[french]{babel} LaTeX-BeginDocument: \def\multiSymbole{$\star$} Title: Évaluation de SVT \no{}4 : Régimes et équilibres alimentaires Presentation: Colorier en noir la case correspondante à la proposition correcte pour chaque phrase. *([shuffle=true] PARTIE I : Quelques connaissances du cours **[horiz,last]Les aliments contiennent : + Des lipides - Des acides + Des sels minéraux **La dépense énergétique minimum de notre corps est : + Le métabolisme de base - Les besoins énergétiques - L'IMC **[columns=2]Les aliments nous apportent de : + La matière - Du diabète + De l'énergie **[columns=2]Les besoins énergétiques d'une personne varient suivant : + Le sexe + Les activités physiques - Les aliments consommés *[columns=2]Manger équilibré signifie : + Equilibrer nos apports et nos dépenses - Manger ce qui nous fait envie - Manger plus que ce qu'on dépense **[columns=2]Manger en excès par rapport à ses besoins peut aboutir à : - Des carences + Des maladies cardio-vasculaires - Un manque de nutriments **[columns=2]L'IMC signifie : - Indice de Maladies cardio-vasculaires + Indice de Masse Corporelle - Indice de Matière et de Composition *) *(PARTIE II : Le goûter de Vanessa **[columns=2]Dans le gouter de Vanessa, l'aliment le plus énergétique est : - les pruneaux + Les biscuits - les deux sont identiques. **[columns=2]Par rapport aux biscuits, les pruneaux contiennent : + moins de protides - plus de glucides + moins de lipides **[columns=2]Les dépenses énergétiques journalières d'une adolescente sont en moyenne de \qty{10000}{\kilo\joule} . Vanessa a consommé \qty{3200}{kJ} au petit-déjeuner, \qty{3500}{kJ} à midi et \qty{2400}{\kilo\joule} au diner. Elle a donc mangé équilibré : - Faux + Vrai *)
La réponse "Aucune des réponses ci-dessus n'est correcte" ne sera pas ajoutée pour les questions multiples. | |
Les questions ne seront pas mélangées. | |
Autoriser l'insertion de code LaTeX. | |
Différents paquets utiles. | |
Le symbole des questions multiples est changé. | |
Utilisation du paquet LaTeX babel pour la gestion de la langue. | |
Les questions de ce groupe seront mélangées. | |
Cette question sera toujours la dernière de ce groupe. | |
Une commande LaTeX utilisée grâce à LaTeX:1 et LaTeX-Preambule. |