<table border="0" cellpadding="5" cellspacing="0" width="100%">
<tr>
<td class="faq">
<br>
!href cmd=new&job=index Introduction
<br>
!href cmd=new&job=debuter Débuter
<br>
!href cmd=new&job=documentation Documentations
<br>
!href cmd=new&job=ressource Ressources disponibles

<br>
<hr noshade>
!href cmd=new&job=classe Classes
<br>
!href cmd=new&job=forum Forum
<br>
!href cmd=new&job=promo Promouvoir
<br>
!href cmd=new&job=edu Pédagogie
<br>
<hr noshade>
!href cmd=new&job=document Documents
<br>
!href cmd=new&job=logiciel Logiciels
<br>
!href cmd=new&job=oef Exercices OEF
<br>
!href cmd=new&job=modtool Modtool
<br>
!href cmd=new&job=graphics Graphiques
<br>
<hr noshade>
!href cmd=new&job=portal Gestion d'un établissement
<br>
!href cmd=new&job=gestion Gestion d'un site
<br>
!href cmd=new&job=knowims KNOWIMS
<br>
!href cmd=new&job=total La FAQ en entier
<br>
<hr noshade>

!href cmd=new&job=link Liens ressources WIMS
<br>
<hr noshade>


</td>
<td valign="top"><table width="100%" class="faq_head"><tr><td class="faq_head2">Modtool</td></tr></table><ol><li><a href="#r_modtool_docu"
>Où se trouve la documentation de Modtool ?</a><a name="q_modtool_docu">&nbsp;</a></li>
<li><a href="#r_modtool_begin"
>Que dois-je faire pour pouvoir développer des modules
avec  Modtool ?</a><a name="q_modtool_begin">&nbsp;</a></li>
<li><a href="#r_modtool_creation"
>Comment puis-je ajouter un fichier dans Modtool ?</a><a name="q_modtool_creation">&nbsp;</a></li>
<li><a href="#r_modtool_module"
>J'ai fait des exercices dans ma classe. Comment les mettre
en module ? </a><a name="q_modtool_module">&nbsp;</a></li>
<li><a href="#r_modtool_oef"
>J'ai mis des exercices 
OEF de ma classe dans un module Modtool et il ne se passe rien ...
</a><a name="q_modtool_oef">&nbsp;</a></li>
<li><a href="#r_modtool_tool"
>Je voudrais faire apparaître un outil en bas de mon
exercice. Comment faire ?</a><a name="q_modtool_tool">&nbsp;</a></li>
<li><a href="#r_modtool_parameter"
>Comment définir des paramètres qui apparaîtraient dans
le menu d'introduction de mes exercices ?</a><a name="q_modtool_parameter">&nbsp;</a></li>
<li><a href="#r_modtool_confparm"
>J'ai créé un module d'exercices OEF qui fonctionne mais 
quand je donne l'adresse directe d'un des exercices à quelqu'un,
les variables aléatoires de l'exercice sont vides.
</a><a name="q_modtool_confparm">&nbsp;</a></li>
<li><a href="#r_modtool_restore"
>J'ai préparé un module en local. Comment puis-je le
mettre sur mon compte développeur ?</a><a name="q_modtool_restore">&nbsp;</a></li>
<li><a href="#r_modtool_devel"
>Comment puis-je modifier un module qui m'appartient afin le corriger ?</a><a name="q_modtool_devel">&nbsp;</a></li>
<li><a href="#r_modtool_transfert"
>Je désire transférer un module de mon  serveur local 
à un autre serveur afin de le publier : </a><a name="q_modtool_transfert">&nbsp;</a></li>
</ol><hr><h3><a href="#q_modtool_docu"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_modtool_docu"
>Où se trouve la documentation de Modtool ?</a></h3>En bas de la 
!href cmd=new&target=wims_exo& page d'accueil
 de WIMS sur le lien
<tt class="d">tech doc</tt> (ou directement 
!href cmd=new&target=wims_exo&module=help/wimsdoc.en Aide Modtool
).

<h3><a href="#q_modtool_begin"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_modtool_begin"
>Que dois-je faire pour pouvoir développer des modules
avec  Modtool ?</a></h3>Demandez un compte par email au gestionnaire du site.

<h3><a href="#q_modtool_creation"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_modtool_creation"
>Comment puis-je ajouter un fichier dans Modtool ?</a></h3>Commencer à taper son nom par exemple <tt
class="e">toto</tt> dans la case adéquate. Si c'est un exercice OEF dans un
module OEF, il doit se trouver dans un dossier <tt
class="e">src</tt>. Donc pour le créer, taper
<pre class="c">
    src/toto.oef
</pre>
Puis dans la fenêtre qui apparaît faire un copier-coller de votre
exercice.

<h3><a href="#q_modtool_module"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_modtool_module"
>J'ai fait des exercices dans ma classe. Comment les mettre
en module ? </a></h3>
<ol><li>Créer un nouveau module dans Modtool de catégorie OEF
(remplir les champs <tt class="d">Description</tt>, <tt class="d">Mots clés</tt>...)
</li><li>Copier les sources un par un dans le module : pour cela, pour chacun,
trouver un nom de fichier (court et significatif) par exemple <tt class="e">toto</tt> ;
mettre  dans le champ <tt class="d">Ajouter un autre fichier :</tt> 
le nom <tt class="e">src/toto.oef</tt>.
 (<tt class="e">src</tt> est en fait un nom de répertoire dans lequel doivent être 
 toutes les sources d'exercice OEF). 
 </li>
 <li>Tester le module (après chaque ajout d'un fichier source).
 </li>
 <li>Modifier éventuellement le fichier <tt class="e">endhook</tt>
</ol>

<h3><a href="#q_modtool_oef"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_modtool_oef"
>J'ai mis des exercices 
OEF de ma classe dans un module Modtool et il ne se passe rien ...
</a></h3>Avez-vous bien cliqué sur <tt class="d">oef</tt> lors de la création
du module ?  Si vous n'obtenez pas le menu d'introduction auquel vous êtes habitué, 
c'est certainement 
non. Vous avez dû cliquer simplement sur <tt class="d">Exercice</tt> et vous avez 
le prototype d'un module d'exercices totalement libres ... mais dans lequel vous
ne pourrez pas mettre des sources d'exercices OEF. Dans ce cas, vous
n'avez plus qu'à recréer un nouveau module de catégorie OEF ...
<p>La deuxième possibilité est que vous avez bien créé un module d'exercices OEF, mais que
vous n'avez pas appelé votre fichier du bon nom : <tt class="d">src/toto.oef</tt> 
où vous remplacez <tt class="d">toto</tt>  par ce que vous voulez (évitez quand
même les mots trop longs, les accents et les ponctuations).
<p>
<h3><a href="#q_modtool_tool"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_modtool_tool"
>Je voudrais faire apparaître un outil en bas de mon
exercice. Comment faire ?</a></h3>Lorsque vous créez votre module d'exercices OEF, mettez
dans
un fichier <tt class="e">endhook.phtml</tt> l'adresse de l'exercice de la
manière suivante :
<pre class="c">
    &#33;if $status=waiting
      &#33;read tool.phtml number/calcnum.fr linear/matrix.fr
    &#33;endif
</pre>
Dans l'exemple, apparaîtront deux outils.

<h3><a href="#q_modtool_parameter"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_modtool_parameter"
>Comment définir des paramètres qui apparaîtraient dans
le menu d'introduction de mes exercices ?</a></h3>C'est utile pour éviter de recopier un exercice pour ne
changer qu'un paramètre : éviter les exercices "copiés-collés" facilitera
les améliorations et corrections ultérieures.
<p>Il faut créer un fichier <tt class="e">introhook.phtml</tt>, par exemple
<pre class="c">
    &lt;tr>&lt;td align="center">Niveau de difficulté&lt;/td&gt;
    &lt;td>
      &#33;formbar confparm1 from 1 to 3
      Taille du graphe
    &lt;/td>&lt;/tr>
</pre>
L'utilisateur voit un formulaire lui demandant la "Taille du graphe", et
peut répondre un entier compris entre 1 et 3. Il n'est pas obligé de
rentrer une valeur.
(On se trouve dans un tableau HTML, dont on vient de définir une ligne.)
Attention les seuls noms autorisés pour ces variables sont les mot-clés
<tt class="c">confparm</tt><em>n</em> où <em>n</em> est un entier de 1 à 5.
<p>Dans les sources de l'exercice, on peut alors définir certaines des données à
l'aide de <tt class="c">\confparm1</tt>. Ne pas oublier de les définir aussi
si <tt class="c">\confparm1</tt> n'a pas de valeur. Par exemple dans le
fichier <tt class="e">toto.oef</tt>
<pre class="c">
    \integer{ n = \confparm1=?  randint(3..4)  }
    \integer{ n = \confparm1=1? randint(3..4)  }
    \integer{ n = \confparm1=2? randint(5..7)  }
    \integer{ n = \confparm1=3? randint(10..12)}
</pre>
On peut utiliser d'autres types de paramètres. Par exemple,
<pre class="c">
    &lt;tr>&lt;td align="center">Choix d'animal&lt;/td>
    &lt;td>
      &#33;formbar confparm1 list A,B,C prompt Loup, Chèvre, Chou
    &lt;/td>&lt;/tr>
</pre>
Le paramètre <tt class="c">\confparm1</tt> vaut ici
<tt class="c">A</tt>, <tt class="c">B</tt> ou <tt class="c">C</tt>.
En remplaçant <tt class="c">formbar</tt> par <tt class="c">formcheckbox</tt>,
on autorise la sélection de plusieurs animaux.
<p>On peut même faire entrer à l'utilisateur une variable. Voici un exemple pris 
dans l'exercice <tt class="d">Classification périodique</tt>
<pre class="c">
    &lt;tr><&lt;td align=center>Exclure les éléments au-dessus du numéro&lt;/td>&lt;td>
    &lt;tr>&lt;td align=center>ou une liste de numéros&lt;br>des éléments à tester :
    &lt;/td>&lt;td>
    &lt;input size=40 name=confparm4>&lt;/td>&lt;/tr>
</pre>
<h3><a href="#q_modtool_confparm"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_modtool_confparm"
>J'ai créé un module d'exercices OEF qui fonctionne mais 
quand je donne l'adresse directe d'un des exercices à quelqu'un,
les variables aléatoires de l'exercice sont vides.
</a></h3>Peut-être avez-vous utilisé un paramètre
<tt class="c">confparm</tt>. 
Dans ce cas, il faut absolument donner une valeur par défaut à 
tous les variables aléatoires qui en dépendent.

<h3><a href="#q_modtool_restore"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_modtool_restore"
>J'ai préparé un module en local. Comment puis-je le
mettre sur mon compte développeur ?</a></h3>Lorsque on veut transférer un module préparé en local
(impérativement sous forme d'archive <tt>.tgz</tt>) vers un serveur
WIMS, l'archive doit avoir un nom du type
<tt class="d">modtool-</tt><em>n</em><tt class="d">.tgz</tt>, où <em>n</em>
est un entier, sinon WIMS ne le reconnaît pas. La méthode conseillée,
si ce n'est imposée (et de toute façon la plus simple) est 
de faire une sauvegarde à partir de votre compte Modtool. 
 
<h3><a href="#q_modtool_devel"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_modtool_devel"
>Comment puis-je modifier un module qui m'appartient afin le corriger ?</a></h3>Ce qui suit concerne un module qui vous appartient et demande que vous ayez un 
compte développeur. 
<ul><li>Entrer dans son compte <tt class="e">Modtool</tt>
ou plus exactement <tt class="e">Modules à part entière</tt>. 
</li><li>Aller dans le module choisi et cliquer sur le lien
<tt class="e">Copier dans Modtool</tt> en bas de page.
</li><li>Modifier le module par modtool.
</li><li>Vérifier les différences par <tt class="e">Check diff</tt>, tester, etc.
</li><li> Publier  en version stable.
</li><li> Effacer le module dans le compte <tt class="e">Modtool</tt>
</li></ul>

<h3><a href="#q_modtool_transfert"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_modtool_transfert"
>Je désire transférer un module de mon  serveur local 
à un autre serveur afin de le publier : </a></h3>
<ul><li>Vous devez enregistrer impérativement ce module avec un
nom du type: <tt class="e">zone~categorie~nom.lang</tt> en faisant la 
sauvegarde par Modtool (lien <tt class="d">Sauvegarde</tt>). 
Modtool crée alors un fichier 
compacté
<tt class="e">modtool-zone~categorie~nom.lang.tgz</tt> : par exemple
<tt class="e">H5~algebra~oefsecdg.fr</tt>
et
<tt class="e">modtool-H5~algebra~oefsecdg.fr.tgz</tt>.
Pour un module nouveau que vous ne désirez pas publier encore,
utiliser la zone <tt class="e">test</tt>. 
</li><li>
Ainsi, vous pourrez restaurer/transférer votre module dans Modtool
sur un  autre serveur. Il faut bien sûr que vous ayez demandé
un compte développeur. 
</li><li>
Si vous désirez publier en version publique votre module, c'est-à-dire le rendre
accessible à tous les serveurs WIMS qui le désirent, adressez-vous à <script language="javascript1.1" type="text/javascript">var nom='xiao', sit='unice.fr', nick='Xiao Gang'; writeMail();</script><noscript>Xiao Gang</noscript>, 
Vous devez alors lui fournir
l'adresse  IP fixe du serveur WIMS à partir de laquelle vous publierez. 
</li></ul>
Si vous désirez publier votre module en local (et non en version
publique), utilisez la zone <tt class="d">local</tt>. Vous devez alors demander 
au gestionnaire du site un compte développeur local.
<p>

 </td></tr></table>

!tail
