<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"

"/usr/share/xml/docbook/schema/dtd/4.5/docbookx.dtd">

<article lang="fr">

  <title>Auto Multiple Choice</title>

  <articleinfo>

    <title>Auto Multiple Choice</title>

    <subtitle>Conception et correction automatisée de QCM.</subtitle>

    <abstract>

      <para>AMC est un ensemble d'utilitaires permettant l'utilisation de QCM

      rédigés en texte simple ou en LaTeX et leur correction automatique à

      partir des scans des copies des étudiants, grâce à une reconnaissance

      optique de marques (OMR). Le présent document décrit son utilisation

      (pour la version @/PACKAGE_V_DEB/@~@/PACKAGE_V_VC/@).</para>

      <para>Le projet AMC est hébergé par <ulink

      url="http://gna.org/">Gna !</ulink> : vous retrouverez son site internet

      à l'adresse <ulink

      url="http://home.gna.org/auto-qcm/">http://home.gna.org/auto-qcm/</ulink>,

      et la page d'hébergement du projet à l'adresse <ulink

      url="https://gna.org/projects/auto-qcm/">https://gna.org/projects/auto-qcm/</ulink>.</para>

    </abstract>

    <author>

      <firstname>Alexis</firstname>

      <affiliation>

        <address><email>paamc@passoire.fr</email></address>

      </affiliation>

      <surname>Bienvenüe</surname>

    </author>

    <othercredit>

      <surname>Abel</surname>

      <firstname>Benjamin</firstname>

      <contrib>Paragraphes concernant l'usage de tikz et de

      lualatex.</contrib>

    </othercredit>

    <copyright>

      <year>2008-2013</year>

      <holder>Alexis Bienvenüe</holder>

    </copyright>

    <legalnotice>

      <para>Ce document peut être utilisé selon les termes de la Licence

      publique générale de GNU version 2 ou suivante.</para>

    </legalnotice>

  </articleinfo>

  <sect1>

    <title>Licence</title>

    <para>Le programme Auto Multiple Choice est un logiciel libre ; vous

    pouvez le redistribuer ou le modifier suivant les termes de la “GNU

    General Public License” telle que publiée par la Free Software

    Foundation : soit la version 2 de cette licence, soit (à votre gré) toute

    version ultérieure.</para>

    <para>Ce programme est distribué dans l’espoir qu’il vous sera utile, mais

    SANS AUCUNE GARANTIE : sans même la garantie implicite de

    COMMERCIALISABILITÉ ni d’ADÉQUATION À UN OBJECTIF PARTICULIER. Consultez

    la Licence Générale Publique GNU pour plus de détails. Vous devriez avoir

    reçu une copie de la Licence Générale Publique GNU avec ce programme ; si

    ce n’est pas le cas, consultez : <ulink

    url="http://www.gnu.org/licenses/">http://www.gnu.org/licenses/</ulink>.</para>

  </sect1>

  <sect1 id="prerequis">

    <title>Prérequis</title>

    <sect2>

      <title>Système d'exploitation</title>

      <para>Les utilitaires AMC sont pour l'instant écrits pour Linux. Ils

      devraient pouvoir être adaptés à MAC OS X ou Windows sans trop de

      difficulté, mais je n'ai pas prévu de le faire dans un avenir proche.

      N'hésitez pas à me contactez si vous souhaitez le faire : j'essayerai de

      vous aider et j'intègrerai les changements nécessaires dans AMC.</para>

    </sect2>

    <sect2>

      <title>Logiciels</title>

      <note>

        <para>Si vous installez AMC à l'aide d'un paquet debian (sur une

        distribution debian, ubuntu ou dérivés) ou RPM (distribution Mandriva,

        openSUSE, Fedora), tout ce dont AMC a besoin sera automatiquement

        installé.</para>

      </note>

      <para>Les paquets/logiciels principaux requis pour l'utilisation d'AMC

      sont les suivants :</para>

      <itemizedlist>

        <listitem>

          <para>LaTeX</para>

        </listitem>

        <listitem>

          <para>ImageMagick</para>

        </listitem>

        <listitem>

          <para>Perl, ainsi que Gtk2-Perl et Glade::XML pour l'interface

          graphique</para>

        </listitem>

      </itemizedlist>

      <sect3>

        <title>Versions conseillées pour les logiciels utilisés par

        AMC</title>

        <para>Quelques anciens bugs des logiciels utilisés par AMC sont

        particulièrement préjudiciables à son bon fonctionnement :</para>

        <itemizedlist>

          <listitem>

            <para>Avec d'anciennes versions de <package>Net::CUPS</package>

            (paquet debian <package>libnet-cups-perl</package>), la demande

            d'impression du sujet provoque la fermeture prématurée de toute

            l'interface graphique d'AMC. Ce bug a été corrigé à partir de la

            version 0.61 de <package>Net::CUPS</package>.</para>

          </listitem>

          <listitem>

            <para>Avec d'anciennes versions de ImageMagick, le regroupement

            des pages corrigées en un fichier PDF par étudiant ne fonctionne

            pas dans le cas où ces copies comprennent plusieurs pages. Ce bug

            a été corrigé à partie de la version 6.5.5 de ImageMagick.</para>

          </listitem>

        </itemizedlist>

      </sect3>

    </sect2>

    <sect2>

      <title>LaTeX</title>

      <para>À parti de la version 1.1.0 d'AMC, il n'est plus nécessaire de

      rédiger ses sujets de QCM en LaTeX (voir <xref linkend="AMC-TXT"/>).

      Cependant, ceci est toujours possible et permet une extraordinaire

      liberté dans la conception des sujets. Par ailleurs, les modèles fournis

      permettent à ceux qui ne sont pas réfractaires aux formats de documents

      du type LaTeX/XML/HTML d'écrire assez rapidement leurs premiers

      formulaires en LaTeX.</para>

    </sect2>

  </sect1>

  <sect1 id="notesutilisation">

    <title>Notes d'utilisation</title>

    <sect2>

      <title>Limitations numériques</title>

      <para>Dans la version actuelle (à partir de la version 0.156), le nombre

      de copies est limité à 4095 et le nombre de pages par copies est limité

      à 63.</para>

      <para>Le nombre de réponses proposées pour une même question est limité

      à 199.</para>

      <para>Par ailleurs, les limitations de LaTeX pourront bloquer la

      compilation avant ces limites (erreur du type « <errortext>No room for a

      new \toks</errortext> »). Dans ce cas, essayez en utilisant le package

      <package>etex</package>, grâce à la commande

      <code>\usepackage{etex}</code>.</para>

    </sect2>

    <sect2>

      <title>Versions</title>

      <para>Même si cela ne devrait pas avoir trop de conséquences, il vaut

      mieux essayer de ne pas changer de version du programme en cours

      d'utilisation pour un projet donné (entre le moment où les copies sont

      imprimé et le moment où les notes sont calculées et les copies

      annotées). Il existe quelques modifications qui risquent de perturber le

      fonctionnement d'AMC si vous les appliquez au cours de la gestion d'un

      projet :</para>

      <itemizedlist>

        <listitem>

          <para>Si vous avez compilé et imprimé un sujet avec une version

          d'AMC égale ou inférieure à 0.155, et que vous continuez la gestion

          du projet avec la version 0.156 ou postérieure, ajoutez l'option

          <option>versionA</option> dans l'appel au paquet

          <package>automultiplechoice</package> dans le fichier LaTeX. Exemple

          :</para>

          <programlisting>\usepackage[bloc,completemulti,versionA]{automultiplechoice}</programlisting>

        </listitem>

        <listitem>

          <para>À partir de la version 0.262, le dessin des cases à cocher est

          différent, légèrement plus gros, ce qui risque de modifier la

          disposition de vos sujets.</para>

        </listitem>

        <listitem>

          <para>À partir de la version 0.267, si vous souhaitez produire vos

          sujets en format A4, vous devez l'indiquer explicitement dans le

          sujet LaTeX :</para>

          <programlisting>\documentclass[a4paper]{article} </programlisting>

        </listitem>

        <listitem>

          <para>À partir de la version 0.345, les commandes

          <command>\AMCformulaireQuestion</command> et

          <command>\AMCformulaireReponse</command> ont été renommées

          respectivement <command>\AMCformQuestion</command> et

          <command>\AMCformAnswer</command>.</para>

        </listitem>

        <listitem>

          <para>À partir de la version 0.394, vous devez indiquer

          explicitement si vous utilisez le paquet LaTeX

          <package>graphicx</package> (dans les versions précédentes, il était

          chargé par AMC).</para>

        </listitem>

        <listitem>

          <para>La commande <command>\AMCcode</command> a été réécrite au

          passage à la version 0.518. La nouvelle version est plus propre et

          mieux configurable, mais vous aurez sans doute à adapter légèrement

          votre code LaTeX pour que le résultat reste semblable.</para>

        </listitem>

        <listitem>

          <para>À partir de la version 1.1.0, le stockage de toutes les

          informations manipulées par AMC se fait dans des bases de données

          SQLite, au lieu des multiples fichiers XML utilisés par les versions

          précédentes. Lors de l'ouverture d'un projet créé par une version

          antérieure, AMC transforme toutes ces données dans le nouveau

          format, mais conserve les anciens fichiers XML.</para>

        </listitem>

      </itemizedlist>

    </sect2>

    <sect2>

      <title>Installation</title>

      <para>Sur un système debian ou Ubuntu ou dérivés, Mandriva, openSUSE ou

      Fedora, l'installation est facilitée par l'utilisation des paquets deb

      et RPM contenant AMC. La procédure d'installation est décrite sur le

      <ulink url="http://home.gna.org/auto-qcm/download">site

      d'AMC</ulink>.</para>

      <para>Vous pouvez aussi télécharger l'archive des sources dans l'<ulink

      url="http://download.gna.org/auto-qcm/">espace de téléchargement</ulink>

      du projet, puis utiliser les commandes suivantes dans un

      terminal :</para>

      <screen>tar xvzf auto-multiple-choice_xxxx_precomp.tar.gz

cd auto-multiple-choice-xxx

make

sudo make install</screen>

    </sect2>

    <sect2>

      <title>Accès</title>

      <para>Une fois installé, l'interface graphique peut être appelée en

      choisissant <menuchoice>

          <guimenu>Applications</guimenu>

          <guisubmenu>Éducation</guisubmenu>

          <guimenuitem>Auto Multiple Choice</guimenuitem>

        </menuchoice> dans le menu général de Gnome (ou son équivalent dans

      KDE ou autre), mais on peut aussi utiliser la commande

      <userinput>auto-multiple-choice</userinput>.</para>

    </sect2>

  </sect1>

  <sect1 id="AMC-TXT">

    <title>Source au format AMC-TXT</title>

    <para>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.</para>

    <para>Commençons par un exemple simple de fichier source utilisable par

    AMC :</para>

    <!--NAME: Exemple simple au format AMC-TXT

DESC: Un exemple très simple utilisant le format AMC-TXT qui permet de concevoir des questionnaires sans aucune connaissance de LaTeX.-->

    <programlisting id="modeles-simple-txt.txt"># 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</programlisting>

    <important>

      <para>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 <command>gedit</command> par exemple. N'utilisez

      pas d'éditeur de texte permettant d'appliquer des mise 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...</para>

    </important>

    <note>

      <para>La police de caractères qui sera utilisée par défaut pour votre

      questionnaire est la police <ulink

      url="http://www.linuxlibertine.org/">libertine</ulink>. 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).</para>

    </note>

    <para>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.</para>

    <sect2>

      <title>Commentaires</title>

      <para>Vous pouvez écrire des commentaires dans votre fichier AMC-TXT sur

      des lignes <emphasis>commençant</emphasis> par le caractère

      <code>#</code>. Ces lignes seront tout simplement ignorées par

      AMC.</para>

    </sect2>

    <sect2>

      <title>Options générales</title>

      <para>Voici les options que vous pouvez utiliser au début de votre

      fichier (dans n'importe quel ordre) :</para>

      <variablelist>

        <varlistentry>

          <term>PaperSize:</term>

          <listitem>

            <para>Indique le format de papier utilisé. Parmi les valeurs

            possibles, on trouve <code>A3</code>, <code>A4</code>,

            <code>A5</code>, <code>A6</code>, <code>B3</code>,

            <code>B4</code>, <code>B5</code>, <code>B6</code>,

            <code>letter</code>, <code>legal</code>, <code>ANSIA</code>,

            <code>ANSIB</code>, <code>ANSIC</code>, <code>ANSID</code>,

            <code>ANSIE</code>.</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>Lang:</term>

          <listitem>

            <para>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), JA (Japonais, voir <xref linkend="txt-japanese"/>) et

            AR (arabe, voir <xref linkend="txt-arabic"/>). Si vous n'utilisez

            pas cette option, ce sera l'anglais qui sera choisi.</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>Title:</term>

          <listitem>

            <para>Le titre de l'examen, qui sera écrit en haut de la

            copie.</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>Presentation:</term>

          <listitem>

            <para>Un texte introductif pour l'examen, présentant par exemple

            la durée, les consignes...</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>ShuffleQuestions:</term>

          <listitem>

            <para>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.</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>Code:</term>

          <listitem>

            <para>Affectez à cette option une valeur entière

            <replaceable>n</replaceable> (par exemple 8) pour demander la

            présence de cases à cocher pour que les étudiants codent leur

            numéro d'étudiant sur <replaceable>n</replaceable>

            chiffres.</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>CodeDigitsDirection:</term>

          <listitem>

            <para>Donnez à cette option la valeur <code>horizontal</code> ou

            <code>vertical</code> 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).</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>Columns:</term>

          <listitem>

            <para>Si vous donnez à cette option une valeur

            <replaceable>n</replaceable> entière supérieure à 1, le

            questionnaire sera écrit sur <replaceable>n</replaceable>

            colonnes.</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>CompleteMulti:</term>

          <listitem>

            <para>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.</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>L-None:</term>

          <listitem>

            <para>Cette option indique un texte qui remplacera

            <emphasis>Aucune des réponses ci-dessus n'est correcte</emphasis>

            (voir option précédente) pour votre questionnaire.</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>QuestionBlocks:</term>

          <listitem>

            <para>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 ci besoin, ce qui peut gagner de

            la place mais perd en lisibilité.</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>L-Question:</term>

          <listitem>

            <para>Cette option sert à remplacer le mot

            <emphasis>Question</emphasis> dans votre questionnaire si vous

            utilisez une autre langue que celle indiquée par l'option

            <option>Lang</option>.</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>L-Name:</term>

          <listitem>

            <para>Cette option sert à remplacer le texte <emphasis>Nom et

            prénom</emphasis> inscrit dans le cadre où l'étudiant doit

            inscrire son identité.</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>L-Student:</term>

          <listitem>

            <para>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 <option>Code</option> a été utilisée).</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>ManualDuplex:</term>

          <listitem>

            <para>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).</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>SingleSided:</term>

          <listitem>

            <para>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.</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>BoxColor:</term>

          <listitem>

            <para>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

            (<emphasis>red</emphasis>, pour rouge, est une valeur commune,

            mais on peut aussi penser à un gris clair). La couleur fournie

            doit être une couleur valide pour <command>xcolor</command> (voir

            la documentation du paquet LaTeX <command>xcolor</command> pour

            plus de détails), comme <emphasis>red</emphasis>,

            <emphasis>magenta</emphasis>, <emphasis>pink</emphasis>,

            <emphasis>lightgray</emphasis>, <emphasis>cyan</emphasis>, ou bien

            sous la forme <code>#RRGGBB</code>, comme <code>#FFBEC8</code>

            pour un rouge clair.</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>DefaultScoringS:</term>

          <listitem>

            <para>Donne la barème par défaut pour les questions simples

            (Reportez-vous à <xref linkend="bareme"/> pour la description des

            barèmes possibles). La valeur par défaut à cette option est le

            barème qui donne un point à la bonne réponse, et zéro aux

            autres.</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>DefaultScoringM:</term>

          <listitem>

            <para>Donne le barème par défaut pour les questions multiple

            (Reportez-vous à <xref linkend="bareme"/> pour la description des

            barèmes possibles). La valeur par défaut de cette option est

            <code>haut=2</code>, 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.</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>LaTeX:</term>

          <listitem>

            <para>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

            <code>$\sqrt{a+b}$</code>. Avec la valeur 0 (valeur par défaut),

            vos textes seront reproduits sans modification.</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>LaTeX-Preambule:</term>

          <listitem>

            <para>Donne des commandes LaTeX à ajouter dans le préambule (par

            exemple des <command>\usepackage</command>).</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>LaTeX-BeginDocument:</term>

          <listitem>

            <para>Donne des commandes LaTeX à ajouter au début de

            l'environnement <command>document</command> (par exemple des

            définitions de macros).</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>Disable:</term>

          <listitem>

            <para>Donne une liste de convertisseurs à désactiver, séparés par

            des virgules. Les convertisseurs disponibles sont

            <code>images</code> (voir <xref linkend="parse_images"/>),

            <code>embf</code> (voir <xref linkend="parse_embf"/>) et

            <code>local_latex</code> (voir <xref

            linkend="parse_local_latex"/>).</para>

          </listitem>

        </varlistentry>

      </variablelist>

      <sect3>

        <title>Sujet avec feuille de réponses séparée</title>

        <para>Dans le cas d'un sujet avec feuille de réponses séparée, vous

        pourrez considérer l'emploi des options suivantes :</para>

        <variablelist>

          <varlistentry>

            <term>SeparateAnswerSheet:</term>

            <listitem>

              <para>Donner la valeur 1 à cette option pour obtenir une feuille

              de réponses séparée.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>AnswerSheetTitle:</term>

            <listitem>

              <para>Donne le titre à inscrire en tête de la feuille de

              réponse.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>AnswerSheetPresentation:</term>

            <listitem>

              <para>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.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>AnswerSheetColumns:</term>

            <listitem>

              <para>Nombre de colonnes pour la feuille de réponses.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>AutoMarks:</term>

            <listitem>

              <para>Donner la valeur 1 à cette option pour utiliser l'option

              <option>automarks</option> (voir <xref

              linkend="sec.package.options"/>).</para>

            </listitem>

          </varlistentry>

        </variablelist>

      </sect3>

    </sect2>

    <sect2>

      <title>Questions</title>

      <para>Les questions simples (qui acceptent une et une seule bonne

      réponse) commencent par un <code>*</code> en début de ligne, et les

      questions multiples (celles qui peuvent comporter zéro, une ou

      plusieures bonnes réponses), commencent par un <code>**</code> en début

      de ligne. Vient ensuite le texte de la question, puis les réponses,

      introduites par un <code>+</code> quand la réponse est correcte ou un

      <code>-</code> quand elle ne l'est pas.</para>

      <sect3>

        <title>Options pour les questions</title>

        <para>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 :</para>

        <programlisting>*[ordered,horiz,name=addition] Combien font

un plus un ?

- 0

- 1

+ 2</programlisting>

        <para>Les options disponibles sont les suivantes :</para>

        <variablelist>

          <varlistentry>

            <term>horiz</term>

            <listitem>

              <para>Avec cette option, les réponses se suivront

              horizontalement plutôt que verticalement une par ligne.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>columns=<replaceable>n</replaceable></term>

            <listitem>

              <para>Avec cette option, les réponses seront réparties sur

              <replaceable>n</replaceable> colonnes.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>ordered</term>

            <listitem>

              <para>Avec cette option, les réponses ne seront pas mélangées

              dans chaque copies : elles resteront toujours dans l'ordre

              indiqué.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>id=<replaceable>xxxx</replaceable></term>

            <listitem>

              <para>Avec cette option, le nom <replaceable>xxxx</replaceable>

              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.</para>

              <para><option>name</option> a le même rôle que l'option

              <option>id</option>. Cette option est présente pour assurer la

              compatibilité avec d'anciennes versions, préférez l'utilisation

              de <option>id</option>.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>indicative</term>

            <listitem>

              <para>Indique que le score affecté à cette question ne sera pas

              pris en compte pour le score final de l'étudiant.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>next</term>

            <listitem>

              <para>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 <option>ShuffleQuestions</option>.</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>first</term>

            <listitem>

              <para>Avec cette option, la question sera toujours insérée en

              début de groupe (voir <xref linkend="sec.txt-groups"/>).</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>last</term>

            <listitem>

              <para>Avec cette option, la question sera toujours insérée en

              fin de groupe (voir <xref linkend="sec.txt-groups"/>).</para>

            </listitem>

          </varlistentry>

        </variablelist>

      </sect3>

      <sect3>

        <title>Barèmes particuliers</title>

        <para>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

        <code>*</code>, <code>**</code>, <code>+</code>, ou <code>-</code>, et

        après les éventuelles options, comme dans l'exemple suivant.

        Reportez-vous à <xref linkend="bareme"/> pour la syntaxe de

        description des barèmes à utiliser.</para>

        <programlisting>*{b=2,m=-1} Quelle est la capitale de la France ?

+ Paris

- Lille

-{-2} Ouagadougou

**[ordered,horiz,name=positifs]{haut=1} Parmi les nombres suivants,

lesquels sont positifs ?

- -2

+ 2

+ 10</programlisting>

      </sect3>

      <sect3>

        <title>Questions ouvertes</title>

        <para>Les questions peuvent être transformées en questions ouvertes en

        indiquant des options (voir <xref linkend="questionsouvertes"/>) entre

        <code>&lt;</code> et <code>&gt;</code>, comme dans l'exemple

        suivant :</para>

        <programlisting>*&lt;lines=4&gt; Décrivez la lune.

-[O]{0} O

-[P]{1} P

+[V]{2} V</programlisting>

        <para>Lors de l'utilisation de questions ouvertes, les options

        générales suivantes peuvent être intéressantes :</para>

        <variablelist>

          <varlistentry>

            <term>L-OpenText:</term>

            <listitem>

              <para>Texte à ajouter après les questions pour demander aux

              étudiants d'écrire la résponse sur la feuille de réponses

              séparée (dans le cas où celle-ci est utilisée).</para>

            </listitem>

          </varlistentry>

          <varlistentry>

            <term>L-OpenReserved:</term>

            <listitem>

              <para>Texte (court) à ajouter à côté des cases à cocher des

              questions ouvertes, indiquant aux étudiants que ces cases sont

              réservées aux correcteurs.</para>

            </listitem>

          </varlistentry>

        </variablelist>

      </sect3>

    </sect2>

    <sect2>

      <title>Lignes multiples</title>

      <para>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 :</para>

      <programlisting>* Combien font 2

  + 2 ?

- 0

+ 4

- 10</programlisting>

      <para>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 !</para>

      <para>Un problème similaire sera rencontré dans la portion de fichier

      source suivante, où "<code>Chopin:</code>" sera considéré comme une

      définition d'option générale :</para>

      <programlisting>* 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</programlisting>

      <para>La version correcte est la suivante :</para>

      <programlisting>* 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</programlisting>

      <para>Notez enfin que pour passer à la ligne suivante, il faut laisser

      une ligne vide dans le fichier source de l'examen, comme ceci :</para>

      <programlisting>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</programlisting>

    </sect2>

    <sect2>

      <title>Titre</title>

      <para>Vous pouvez insérer un titre en l'entourant de <code>[==</code> et

      <code>==]</code>.</para>

    </sect2>

    <sect2 id="parse_embf">

      <title>Gras, italique</title>

      <para>Les parties du textes à écrire en gras devront être entourées de

      <code>[*</code> et <code>*]</code>. Les parties à mettre en italique

      devront être entourées de <code>[_</code> et <code>_]</code>.</para>

      <programlisting>** Choisissez parmi les expressions suivantes celles

   où le mot en italique est [*un adjectif*].

+ Une balle [_bleue_]

- Un [_livre_] rose

+ Quelle [_belle_] histoire !</programlisting>

    </sect2>

    <sect2 id="parse_images">

      <title>Inclusion d'images</title>

      <para>Vous pouvez inclure des images dans votre document suivant la

      syntaxe suivante :</para>

      <programlisting>![height=2cm]images/oiseau.png!</programlisting>

      <para>Dans cet exemple, l'image <filename>images/zozo.png</filename>

      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 <command>\includegraphics</command> (par exemple,

      <parameter>width=1cm</parameter>, ou

      <parameter>keepaspectratio</parameter>). Pour obtenir une image centrée

      sur une ligne et ayant pour largeur les trois quards de la ligne, on

      utilisera de même :</para>

      <programlisting>!{center}[width=.75\linewidth]images/carte.pdf!</programlisting>

    </sect2>

    <sect2 id="parse_local_latex">

      <title>Petits morceaux de LaTeX</title>

      <para>Vous pouvez inclure quelques segments de code LaTeX dans votre

      description en les incluant entre des double crochets, comme dans

      l'exemple suivant :</para>

      <programlisting>Les questions marquées d'un [[\multiSymbole{}]] peuvent avoir zéro, une ou plusieurs bonnes réponses.</programlisting>

    </sect2>

    <sect2 id="sec.txt-groups">

      <title>Groupes de questions</title>

      <para>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 :</para>

      <programlisting>*( 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. </programlisting>

      <para>Vous pouvez ajouter des options à l'ouverture du groupe, comme

      suit :</para>

      <programlisting>*([shuffle=false,columns=2] Les trois questions suivantes concernent Martin Luther King.</programlisting>

      <para>Les options suivantes sont acceptées :</para>

      <variablelist>

        <varlistentry>

          <term>shuffle=<replaceable>xxx</replaceable></term>

          <listitem>

            <para>En donnant la valeur <replaceable>true</replaceable> ou

            <replaceable>false</replaceable>, on demande à mélanger ou non les

            questions de ce groupe. La valeur par défaut est celle utilisée

            globalement par l'option <option>ShuffleQuestions</option>.</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>columns=<replaceable>n</replaceable></term>

          <listitem>

            <para>Donne le nombre de colonnes dans lesquelles seront mises en

            forme les questions.</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>group=<replaceable>nom</replaceable></term>

          <listitem>

            <para>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).</para>

          </listitem>

        </varlistentry>

        <varlistentry>

          <term>numquestions=<replaceable>n</replaceable></term>

          <listitem>

            <para>Avec cette option, les <replaceable>n</replaceable>

            premières questions du groupes seront utilisées. Si les questions

            sont mélangées, cela permettra de sélectionner

            <replaceable>n</replaceable> questions au hasard.</para>

            <note>

              <para>Les questions utilisant l'option <option>first</option> ou

              <option>last</option> ne sont pas concernées (et sont toujours

              insérées). Par ailleurs, les suites de questions regroupées en

              utilisant l'option <option>next</option> ne comptent que pour

              une seule question.</para>

            </note>

          </listitem>

        </varlistentry>

      </variablelist>

    </sect2>

    <sect2 id="txt-arabic">

      <title>En langue arabe</title>

      <para>La rédaction d'un questionnaire en langue arabe comporte quelques

      spécificités. Vous utiliserez bien entendu l'option</para>

      <programlisting>Lang: AR</programlisting>

      <para>Mais vous devrez également prêter attention aux options

      suivantes :</para>

      <variablelist>

        <varlistentry>

          <term>ArabicFont:</term>

          <listitem>

            <para>C'est la police de caractères qui sera utilisée pour les

            textes en arabe. Par défaut, AMC utilisera

            <emphasis>Rasheeq</emphasis>, une police du projet <ulink

            url="http://arabeyes.org/">ArabEyes</ulink> (disponible dans la

            paquet ttf-arabeyes sur debian et ubuntu par exemple).</para>

          </listitem>

        </varlistentry>

      </variablelist>

      <warning>

        <para>Pour un meilleur fonctionnement et une meilleure portabilité,

        vous devrez également spécifier explicitement la valeur des options

        <option>L-Name</option> et <option>L-Student</option>.</para>

      </warning>

      <note>

        <para>Pour pouvoir insérer des textes en d'autres caractères dans

        votre questionnaire, vous devrez utiliser l'option

        <option>LaTeX</option> pour passer en mode LaTeX, et englober toutes

        les portions de texte en caractères non-arabes par la commande LaTeX

        <command>\textLR</command> comme dans <code>\textLR{la commande

        xelatex}</code>.</para>

      </note>

    </sect2>

    <sect2 id="txt-japanese">

      <title>En japonais</title>

      <para>Vous pourrez construire des questionnaires incluant des caractères

      japonais grâce à l'option</para>

      <programlisting>Lang: JA</programlisting>

      <para>AMC fera les ajustements nécessaires pour permettre un bon rendu

      de ces caractères.</para>

      <warning>

        <para>Dans ce cas, AMC utilisera <command>pTex</command> comme moteur

        LaTeX. Une version <emphasis>récente</emphasis> de

        <command>pTex</command> est nécessaire. La distribution texlive 2009,

        disponible par exemple sur certaines anciennes versions de

        distributions linux, n'est <emphasis>pas</emphasis> suffisante.</para>

      </warning>

    </sect2>

    <sect2>

      <title>Inclusion de fichiers annexes</title>

      <para>Vous pouvez inclure le contenu d'autres fichiers à tout moment

      comme suit :</para>

      <programlisting>IncludeFile: <replaceable>fichier-a-inclure.txt</replaceable></programlisting>

      <warning>

        <para>Faites très attention si le fichier à inclure est utilisé par

        plusieurs projets ! Supposons par exemple que

        <filename>/home/alexis/questions-a.txt</filename> est inclus à la fois

        dans le projet A et le projet B. Vous avez déjà traité le projet A, et

        êtes en train de vous occuper du projet B. Vous ajoutez une questions

        dans le fichier <filename>/home/alexis/questions-a.txt</filename>, et

        vous modifier le barème d'une question qui existait déjà. Si vous

        relancez l'extraction du barème et la notation sur le sujet A, AMC

        verra apparaître une nouvelle question pour laquelle aucune saisie n'a

        été effectuée, ce qui posera des problèmes dans toute la

        notation !</para>

      </warning>

    </sect2>

  </sect1>

  <sect1 id="latex">

    <title>Source au format LaTeX</title>

    <para>Ce paragraphe détaille la rédaction en LaTeX d'une questionnaire à

    choix multiples utilisable par AMC. Si vous avez choisi un autre format de

    fichier source, vous pouvez passer directement au chapitre suivant.</para>

    <para>Un questionnaire à choix multiples peut être décrit sous la forme

    d'une fichier LaTeX utilisant le package

    <package>automultiplechoice</package>. Vous pouvez à tout moment tester le

    fichier LaTeX que vous êtes en train de concevoir en le compilant avec la

    commande <command>latex</command> puis en visualisant le fichier dvi qui

    en résulte.</para>

    <para>Nous commençons par quelques exemples qui permettent d'appréhender

    rapidement la construction de fichiers LaTeX de QCM ; les fichiers tex de

    ces exemples sont fournis avec AMC sous la forme de modèles utilisables en

    créant un nouveau projet de QCM à partir d'un de ces modèles.</para>

    <sect2>

      <title>Un exemple simple</title>

      <para><!--NAME: Exemple simple

DESC: Un exemple simple (issu de la documentation) avec une question simple et une question multiple.--><programlisting

      id="modeles-simple.tex" linenumbering="numbered">\documentclass[a4paper]{article}

\usepackage[utf8x]{inputenc}    <co id="simple.latin1"

            linkends="simple.latin1.exp"/>

\usepackage[T1]{fontenc}

\usepackage[francais,bloc,completemulti]{automultiplechoice}    <co

            id="simple.amc" linkends="simple.amc.exp"/>

\begin{document}

\exemplaire{10}{    <co id="simple.exemplaire"

            linkends="simple.exemplaire.exp"/>

%%% debut de l'en-tête des copies :    <co id="simple.entete"

            linkends="simple.entete.exp"/>

\noindent{\bf QCM  \hfill TEST}

\vspace*{.5cm}

\begin{minipage}{.4\linewidth}

\centering\large\bf Test\\ Examen du 01/01/2008\end{minipage}

\champnom{\fbox{    <co id="simple.champnom" linkends="simple.champnom.exp"/>

                \begin{minipage}{.5\linewidth}

                  Nom et prénom :

                  \vspace*{.5cm}\dotfill

                  \vspace*{1mm}

                \end{minipage}

         }}

\begin{center}\em

Durée : 10 minutes.

  Aucun document n'est autorisé.

  L'usage de la calculatrice est interdit.

  Les questions faisant apparaître le symbole \multiSymbole{} peuvent

  présenter zéro, une ou plusieurs bonnes réponses. Les autres ont

  une unique bonne réponse.

  Des points négatifs pourront être affectés à de \emph{très

    mauvaises} réponses.

\end{center}

\vspace{1ex}

%%% fin de l'en-tête

\begin{question}{prez}    <co id="simple.qr" linkends="simple.qr.exp"/>

  Parmi les personnalités suivantes, laquelle a été présidente de la république française~?

  \begin{reponses}

    \bonne{René Coty}

    \mauvaise{Alain Prost}

    \mauvaise{Marcel Proust}

    \mauvaise{Claude Monet}

  \end{reponses}

\end{question}

\begin{questionmult}{pref}    <co id="simple.qrmult"

            linkends="simple.qrmult.exp"/>

  Parmi les villes suivantes, lesquelles sont des préfectures~?

  \begin{reponses}

    \bonne{Poitiers}

    \mauvaise{Sainte-Menehould}

    \bonne{Avignon}

  \end{reponses}

\end{questionmult}

\clearpage    <co id="simple.clear" linkends="simple.clear.exp"/>

}   <co id="simple.fin" linkends="simple.fin.exp"/>

\end{document}

</programlisting></para>

      <para>Quelques précisions sur cet exemple :</para>

      <para><calloutlist>

          <callout arearefs="simple.latin1" id="simple.latin1.exp">

            <para>Les deux paquets <package>inputenc</package> et

            <package>fontenc</package> permettent d'écrire le texte du

            questionnaire en utilisant l'encodage ISO-8859-1 (latin1). Vous

            pouvez bien entendu les modifier suivant l'encodage que vous

            utilisez.</para>

          </callout>

          <callout arearefs="simple.amc" id="simple.amc.exp">

            <para>Les options utilisées ici pour le paquet LaTeX

            <package>automultiplechoice</package> permettent d'éviter le

            changement de page à l'intérieur des questions

            (<option>bloc</option>) et de compléter automatiquement chaque

            question multiple par une réponse type permettant à l'étudiant

            d'indiquer qu'il considère qu'aucune des réponses proposées n'est

            exacte (<option>completemulti</option>).</para>

          </callout>

          <callout arearefs="simple.exemplaire" id="simple.exemplaire.exp">

            <para>La commande <command>exemplaire</command> permet de

            fabriquer autant d'exemplaires (différents) du questionnaire QCM

            que l'on souhaite (ici, 10). Voir <xref linkend="sec.unecopie"/>

            pour une syntaxe alternative utilisant un environnement.</para>

          </callout>

          <callout arearefs="simple.entete" id="simple.entete.exp">

            <para>Les lignes qui commencent ici permettent la mise en forme de

            l'en-tête de chaque copie.</para>

          </callout>

          <callout arearefs="simple.champnom" id="simple.champnom.exp">

            <para>La commande <command>champnom</command> permet d'indiquer la

            partie du questionnaire dans laquelle chaque étudiant inscrira son

            nom.</para>

          </callout>

          <callout arearefs="simple.qr" id="simple.qr.exp">

            <para>Les environnements <command>question</command> et

            <command>reponses</command> permettent de fabriquer une question à

            choix multiples pour laquelle une unique réponse est correcte. Il

            faut indiquer un identifiant unique de la question (ici :