Subversion Repositories wimsdev

<h3>Hiding image names</h3>

<h3>Cacher le nom d'images</h3>

If your exercise requires recognition of a randomly picked picture, the file

Si l'exercice demande de reconnaître une image prise au hasard, le nom de l'image peut donner

name of the picture might give clue to the exercise. In order to hide this

une indication à l'exercice. Pour cacher ce nom d'image, vous pouvez écrire dans les parties

Then on the browser, the student will see

Ainsi dans le source de la page html, l'étudiant pourra voir

The true file name is thus hidden to the student.

Le vrai nom de l'image est ainsi caché.

<p><b>Note</b>. Do not use directly the WIMS command <span class="tt wims_code_words">rename</span> to

<p><b>Remarque</b>. N'utilisez pas directement la commande WIMS <em>rename</em> pour

process the file name, or the exercise would not work correctly under saved

traiter le nom de fichier, sinon l'exercice ne fonctionnera pas correctement dans

environment.

l'environnement sauvegardé. D'autre part, le nom sera changé uniquement dans le

<h3>Multi-step exercises</h3>

<h3>Exercices à plusieurs étapes</h3>

Multi-step exercises can be defined via the command <span class="tt wims_code_variable">\steps</span>. For

Des exercices à plusieurs étapes peuvent être conçus grâce à la commande

example, if you define (among parameters)

 <span class="tt wims_code_variable">\steps</span>. Par exemple, si vous définissez (parmi d'autres paramètres)

the exercise will be presented with 3 steps, the first asks for a multiple

l'exercice sera présenté en trois étapes, la première proposant

choice (choice 1) and a freestyle reply (reply 1), the second a multiple

un choix multiple (choice 1) et une réponse de type <span class="tt wims_code_words">reply</span> (reply 1),

choice and two freestyle replies, etc.

la seconde proposant un choix multiple et deux réponses de type <span class="tt wims_code_words">reply</span>, etc.

</p><p>

<p>

The content of <span class="tt wims_code_variable">\steps</span> accepts (earlier-defined) parameters as well as

L'argument de <span class="tt wims_code_variable">\steps</span> accepte des paramètres définis auparavant aussi bien que des définitions

conditional definitions, in the same way as the definition of parameters.

conditionnelles de la même manière que pour la définition de paramètres. Cela permet

fields (according to random variations of parameters), even in the case

de présenter des champs de réponses sélectivement selon des variations aléatoires de

where there is only one step.

paramètres, même dans le cas où il n'y a qu'une seule étape.

</p><p>

</p><p>

It is to be noted that if a user makes a mistake in

Il faut noter que si une erreur est faite à une étape, les étapes suivantes ne sont pas

an early step, subsequent steps will not be presented (and will be

proposées et sont donc considérées comme fausses.

</p><p>

</p><p>

The current step number is available to the statement of the exercise,

Le numéro de l'étape en cours est accessible dans le champ <span class="tt wims_code_words">statement</span>

via the variable

dans la variable

<span class="tt wims_code_variable">\step</span> which takes successively the values of 1,2,... when the user

<span class="tt wims_code_variable">\step</span> qui prend donc successivement les valeurs

advances in his/her answering.

 1,2,... à mesure que l'utilisateur avances dans ses réponses.

</p><p>

</p><p>

To make dynamic multi-step exercises (steps varying with student answers), you

(étapes variant selon les réponses de l'étudiant), vous pouvez utiliser

can use the command <span class="tt wims_code_words">\nextstep{...}</span>. The content of

la commande <span class="tt wims_code_variable">\nextstep{...}</span>. L'argument de

<span class="tt wims_code_variable">\nextstep</span> is the similar to <span class="tt wims_code_variable">\steps</span> but only the first line

<span class="tt wims_code_variable">\nextstep</span> est semblable à celui de <span class="tt wims_code_variable">\steps</span> mais seule la première

is effective. It is useful only when the content is given by a variable

ligne est effective. Elle n'est utile que si cet argument est une variable qui change

which is changed by post-reply parameter definitions. The exercise stops when

après avec les définitions de paramètres après soumission.

the content of <span class="tt wims_code_variable">\nextstep</span> is empty at some step.

L'exercice s'arrête quand le contenu de <span class="tt wims_code_variable">\nextstep</span> est vide.

</p><p>

</p><p>

In any case, at most one declaration <span class="tt wims_code_variable">\steps</span> or <span class="tt wims_code_variable">\nextstep</span>

Dans tous les cas, une seule déclaration parmi <span class="tt wims_code_variable">\steps</span> ou <span class="tt wims_code_variable">\nextstep</span>

should appear in an OEF source.

doit apparaître dans un source OEF.

<h3>Preprocessed sources</h3>

<h3>Fichiers source prétraités</h3>

This feature is not available for Createxo. You can use it if you write OEF

Cette fonctionnalité n'est pas disponible pour Createxo. Vous pouvez

(and Deductio) exercises under Modtool.

l'utiliser si vous écrivez des exercices OEF (et Deductio) sous Modtool.

It allows you to include common portions of codes into several oef files.

Elle vous permet d'inclure des parties de codes communes dans plusieurs fichiers OEF.

You can also use it to make batch generation of several oefs from one

Vous pouvez également l'utiliser pour fabriquer par lots plusieurs oef à partir d'un

pre-source, each differing from the others by some macro definitions.

pré-source, chacun différant des autres par quelques définitions de macros.

To use this feature, a subdirectory cpp/ should be created under src. Put

Pour utiliser cette possibilité, un sous-répertoire cpp/ doit être créée sous src. Y mettre

into it pre-source files with extension .cpp. In these files, you can add

les fichiers de pré-source d'extension .cpp. Dans ces fichiers, vous pouvez ajouter

cpp directives like <span class="tt wims_code_words">#include</span>, <span class="tt wims_code_words">#define</span>

des directives cpp comme <span class="tt wims_code_words">#include</span>,

or <span class="tt wims_code_words">#if</span>.

<span class="tt wims_code_words">#define</span> ou

(Please refer to cpp

<span class="tt wims_code_words">#if</span>. (Veuillez vous référer aux

manual and c specification for details of the syntax.)

manuels cpp et aux spécifications c pour les détails de la syntaxe.)

</p><p>

</p><p>

The first line of the cpp file must define a list of targets, in the format

La première ligne du fichier cpp doit définir une liste de cibles (targets), dans le format

<pre>

</p><pre>

target=targ1 targ2 targ3 ...

target=targ1 targ2 targ3 ...

</pre>

</pre>

This line means that this cpp file should generate targ1.oef, targ2.oef, etc.

Cette ligne indique que ce fichier cpp doit fabriquer targ1.oef, targ2.oef, etc

appended to the output names). When generating the target file <em>targ1</em>, a macro

(l'extension .oef sera donc ajoutée aux noms de sortie). Lors de la génération du fichier

<em>TARGET_targ1</em> is defined.

cible <em>targ1.oef</em>, une macro <em>TARGET_targ1</em> est définie.

Therefore in the cpp source file, you can add lines like

Par conséquent, dans le source cpp, vous pouvez ajouter des lignes comme

<pre>

<pre>

in order to make the contents target-dependent.

afin de rendre le contenu dépendant de la cible.

The name of the file (in the example,

Le nom du fichier (dans l'exemple

<span class="tt wims_code_words">targ1</span>, ...)

<span class="tt wims_code_words">targ1</span>, ...) est accessible par la variable

In the following example, the title of the exercise will be

Dans l'exemple suivant, le titre de l'exercice sera

Include files should also be put into the src/cpp directory, with extension

Les fichiers <span class="tt wims_code_words">include</span> doivent également être placés dans le répertoire src/cpp, avec extension

.inc. A line

.inc. Une ligne

<pre>

</p><pre>

will insert the content of common.inc into the generated oef file.

va insérer le contenu de common.inc dans le fichier généré OEF.

Please note that for security reasons, it is prohibited to specify

Veuillez noter que pour des raisons de sécurité, il est interdit de

directories of include files.

spécifier des répertoires de fichiers include.

<p>

<p>

A special remark: cpp gets confused when your file contains single or double

Une remarque spéciale: cpp s'embrouille lorsque votre fichier contient dans le texte

quotes in the text that are not closed. In this case, you can protect the

des apostrophes ou guillemets qui ne sont pas fermés. Dans ce cas, vous pouvez protéger

commands containing such texts by c comments (<span class="tt">/* ... */</span>).

les commandes contenant ces textes par des commentaires C (<span class="tt wims_code_words">/* ... */</span>).

</p>

</p>

<span class="wims_warning">$wims_name_warning</span> : In the commands beginning by # as in

<span class="wims_warning">$wims_name_warning</span> : Dans les commandes commençant par # comme dans

<span class="tt">#include</span>, the character <span class="tt">#</span> must be the

<span class="tt">#include</span>, le caractère <span class="tt">#</span> doit être le

first character of the line. You must not

premier caractère de la ligne. Il ne faut pas non plus utiliser

use <span class="tt">#</span> as a character comment.

<span class="tt">#</span> comme caractère de commentaires.

<h3>Exercise environment</h3>

<h3>Environnement dans un exercice</h3>

A special variable <span class="tt wims_code_variable">\oefenv</span> can be used to test the environment of

La variable spéciale <span class="tt wims_code_variable">\oefenv</span> est utilisée pour tester un exercice

an exercise (if it is not redefined within the exercise).

(si elle n'est pas redéfinie dans l'exercice).

<p>

<p>

For the time being, the only testable content of the variable is the word

Pour l'instant, le seul contenu possible de cette variable est le mot

``debug''. This word appears within <span class="tt wims_code_variable">\oefenv</span> in the following

``debug''. Ce mot apparaît à l'intérieur de <span class="tt wims_code_variable">\oefenv</span>

situations:

dans les situations suivantes.

</p><ol>

<ol>

<li>When it is executed within Createxo.</li>

<li>quand l'exercice est exécuté à l'intérieur de Createxo ;</li>

<li>When it is under test in Modtool, by the developer himself.</li>

<li>quand il est testé dans Modtool par le développeur lui-même</li>

<li>When it is a class exercise and is executed by the supervisor.</li>

<li>quand l'exercice est dans une classe et exécuté par l'administrateur de la classe.

<p>Note that in these cases, the good reply will appear as default in the input

Dans ces cas, la bonne réponse apparaît par défaut dans les champs de réponse

fields of many types, allowing you to see what the exercise expects without

si vous le demandez, vous permettant de voir ce que l'exercice attend comme

typing into the fields.

réponse sans avoir besoin de remplir vous-même les champs.

</p><p>

<p>

You may add debugging informations into your exercise using things like

Vous pouvez ajouter des informations de débogage à l'intérieur de votre exercice

\if{debug iswordof \oefenv}{debugging informations to add into}

\if{debug iswordof \oefenv}{informations de débogage à ajouter ici}

These debugging informations will be automatically shown when the exercise

Ces informations sont alors automatiquement montrées quand l'exercice

is under test, and automatically hidden when students work on it.

est sous test et automatiquement cachées quand les étudiants y travaillent.