<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">Documents</td></tr></table><ol><li><a href="#r_document_def"
>Qu'est-ce qu'un document ?</a><a name="q_document_def">&nbsp;</a></li>
<li><a href="#r_document_interet"
>Quel intérêt y a-t-il à faire un document  WIMS
plutôt que des pages html ?
</a><a name="q_document_interet">&nbsp;</a></li>
<li><a href="#r_info_documents"
>Où est la documentation pour commencer un document ?</a><a name="q_info_documents">&nbsp;</a></li>
<li><a href="#r_document_bon"
>Pouvez-vous me conseiller sur la lisibilité d'un document
?</a><a name="q_document_bon">&nbsp;</a></li>
<li><a href="#r_document_print"
>Comment imprimer un document ?</a><a name="q_document_print">&nbsp;</a></li>
<li><a href="#r_begin_pdf"
>Je voudrais mettre dans ma classe des fichiers pdf ou des images. 
Est-ce possible ?</a><a name="q_begin_pdf">&nbsp;</a></li>
<li><a href="#r_document_style"
>Comment homogénéiser la présentation des documents ?</a><a name="q_document_style">&nbsp;</a></li>
<li><a href="#r_document_fold"
>Comment déplier ou replier une partie d'un document ?</a><a name="q_document_fold">&nbsp;</a></li>
<li><a href="#r_document_applet"
>J'ai des applets sur un autre site, comment les
intégrer à un document ?</a><a name="q_document_applet">&nbsp;</a></li>
<li><a href="#r_document_parent"
>Comment classer les pages d'un document ?</a><a name="q_document_parent">&nbsp;</a></li>
<li><a href="#r_document_tex"
>Les formules TeX débordent. Que faire ?</a><a name="q_document_tex">&nbsp;</a></li>
<li><a href="#r_document_bogue"
>J'ai fait une erreur de syntaxe et je n'arrive plus à
ouvrir mon document.
</a><a name="q_document_bogue">&nbsp;</a></li>
<li><a href="#r_document_fold"
>Comment déplier ou replier une partie d'un document ?</a><a name="q_document_fold">&nbsp;</a></li>
<li><a href="#r_document_input"
>Dans un document, comment demander au lecteur
d'entrer un paramètre ?
</a><a name="q_document_input">&nbsp;</a></li>
<li><a href="#r_document_link"
>J'ai fait un document dans ma classe, comment le citer ? </a><a name="q_document_link">&nbsp;</a></li>
<li><a href="#r_document_pdf_bad"
>J'ai chargé un fichier pdf, ai fait un copier-coller du lien 
indiqué dans le document et le lien n'apparaît pas sur le nom du fichier. </a><a name="q_document_pdf_bad">&nbsp;</a></li>
</ol><hr><h3><a href="#q_document_def"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_document_def"
>Qu'est-ce qu'un document ?</a></h3>
Un document WIMS est un ensemble de pages html qui utilise les
possibilités de WIMS comme la génération d'exemples à la volée. Ils
peuvent être utilisés comme cours. Truffés de liens sur des exercices, ils
peuvent permettre de faire le lien entre le cours et la pratique.

<h3><a href="#q_document_interet"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_document_interet"
>Quel intérêt y a-t-il à faire un document  WIMS
plutôt que des pages html ?
</a></h3>On peut inclure des exemples qui peuvent être renouvelés
par le lecteur. Cela demande quelquefois un peu de travail mais le résultat
en vaut la peine ! On peut aussi faire des liens directs sur des exercices,
ou sur des outils. Les possibilités de <tt class="d">déplier</tt> et <tt
class="d">replier</tt> (avec <tt class="d">\fold</tt>) permettent à l'élève
de se concentrer sur le plan, sur un théorème sans sa démonstration ou au
contraire sur sa démonstration.

<h3><a href="#q_info_documents"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_info_documents"
>Où est la documentation pour commencer un document ?</a></h3>Créez d'abord le 
!href cmd=new&target=wims_exo&module=adm/doc.fr&+job=creat& document
 (depuis la
page d'accueil d'une classe, ou la page des documents interactifs du
site WIMS). On trouve alors un lien vers une aide spécifique.
Vous pouvez aussi commencer en lisant le document 
On peut aussi regarder
le document

!href cmd=new&target=wims_exo&module=adm/doc.fr&+job=creat& document
 que vous pouvez aussi trouver dans la page d'accueil
à la rubrique <tt class="d">Misc documents interactifs</tt>.
<h3><a href="#q_document_bon"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_document_bon"
>Pouvez-vous me conseiller sur la lisibilité d'un document
?</a></h3>
Evitez les pages trop longues. Les grandes pages avec TeX surtout
mettent un certain temps à sortir. Les écrans ne sont pas tous très grands.
L'utilisation de <tt class="c">fold</tt> permet que le lecteur puisse déplier
ou replier une partie du cours selon ce qui l'intéresse. Utiliser les
possibilités de générations aléatoires d'exemples pour le rendre plus vivant.

<h3><a href="#q_document_print"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_document_print"
>Comment imprimer un document ?</a></h3>
Passer en <tt class="d">version imprimable</tt>. Si
vous êtes rédacteur, regardez la version imprimable pour détecter
des erreurs de syntaxe css ou html. Il vaut mieux vérifier par
exemple qu'elle prend bien toutes les pages et qu'il n'y a pas
d'orphelin et que l'ordre est à peu près correct. La version
imprimable est faite de manière récursive : une page et tous celles dont
cette page est le parent, puis la suivante...

<h3><a href="#q_begin_pdf"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_begin_pdf"
>Je voudrais mettre dans ma classe des fichiers pdf ou des images. 
Est-ce possible ?</a></h3>Oui, pour cela,  si vous ne l'avez pas encore fait, créez un
document dans votre classe, éditez sa page d'entrée et sauvegardez-la
(même si vous n'avez rien écrit), allez à <tt class="d">Propriétés</tt>,
puis <tt class="d">Liste de blocs du document</tt>. Il y a écrit :
<tt class="d">Dépôt de fichier</tt>. Il ne vous reste plus qu'à parcourir
votre ordinateur à la recherche du fameux fichier. On vous indique alors
l'adresse que vous devez mettre. Recopiez-la dans la page (bloc) du
document que vous désirez. Pour tester, vous devez d'abord refermer le
document, puis le rouvrir. De la même manière, vous pouvez insérer tout
type de fichiers: textes, images, musiques, etc.

<h3><a href="#q_document_style"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_document_style"
>Comment homogénéiser la présentation des documents ?</a></h3>
Vous pouvez ajouter votre style valable pour tout le document : pour
cela, aller à <tt class="d">Propriétés du document</tt> et copier
votre fichier de style ou son adresse url. Par exemple,
<pre class="c">
    &lt;style type="text/css"> &lt;!--
    H1, H2 { color: #000088; font-family: Verdana, Arial, sans-serif; }
    body {font-family: Arial, Geneva, sans-serif, Verdana; }
    div.cours {
      background-color : #faffe6;
      margin : 0 5%;
      padding : 3%;
      border-width : thin;
    }
    -->&lt;/style>
</pre>
Vous pouvez aussi ajouter de la même manière du code JavaScript. Si vous êtes
un développeur régulier et soumettez vos modules à la distribution, demandez
que votre page de style soit incluse dans la distribution.

<h3><a href="#q_document_fold"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_document_fold"
>Comment déplier ou replier une partie d'un document ?</a></h3>La commande <tt class="c">fold</tt> permet de
<tt class="d">déplier</tt> et <tt class="d">replier</tt> une partie
d'un document.

<h3><a href="#q_document_applet"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_document_applet"
>J'ai des applets sur un autre site, comment les
intégrer à un document ?</a></h3>Il suffit de mettre l'adresse url des applets.

<h3><a href="#q_document_parent"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_document_parent"
>Comment classer les pages d'un document ?</a></h3>
L'option <tt class="d">parent</tt> permet d'établir une hiérarchie entre les
pages d'un document en plus des options usuelles <tt class="d">précédent</tt>
et <tt class="d">suivant</tt> (par défaut, le <tt class="d">parent</tt> est
<tt class="d">main</tt>). C'est commode pour gérer des "chapitres" et des
tables de matières de chapitre.

<h3><a href="#q_document_tex"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_document_tex"
>Les formules TeX débordent. Que faire ?</a></h3>
Il vaut mieux couper les formules TeX un peu longues,
<tt class="c">\(...) = \(...)</tt>, plutôt que <tt class="c">\(... =
...)</tt>. Cela laisse au navigateur le choix de les mettre sur la même
ligne ou non selon la taille de la fenêtre.

<h3><a href="#q_document_bogue"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_document_bogue"
>J'ai fait une erreur de syntaxe et je n'arrive plus à
ouvrir mon document.
</a></h3>Si l'erreur se trouve sur la première page
<tt class="d">main</tt>, le seul moyen risque d'être de demander au
gestionnaire du site. Aussi, mieux vaut éviter de programmer
sur la première page et se contenter de textes et html

<h3><a href="#q_document_fold"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_document_fold"
>Comment déplier ou replier une partie d'un document ?</a></h3>La commande <tt class="c">fold</tt> permet de
<tt class="d">déplier</tt> et <tt class="d">replier</tt> une partie
d'un document.

<h3><a href="#q_document_input"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_document_input"
>Dans un document, comment demander au lecteur
d'entrer un paramètre ?
</a></h3>Voici un exemple où le paramètre à entrer est un entier :
<pre class="c">
    \def{integer n = randint(2..9)}
    \form{.}{exemple}{ n  =
      &lt;input size = 6 name = parm1 value = "\parm1">
      &lt;input type = hidden value = OK>
    }
    \def{integer value = \parm1}
    \def{integer  n = \value issametext NaN ? \parm1: \value}
</pre>
Par défaut, l'entier <i>n</i> sera un  entier entre 2 et 9.
<p>
<h3><a href="#q_document_link"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_document_link"
>J'ai fait un document dans ma classe, comment le citer ? </a></h3>Dans un autre document,  si le document cité a le numéro
<tt class="d">c9</tt> : <tt class="d">\link{c9/main}</tt>
 On peut aussi remplacer  <tt class="d">main</tt>
le nom d'un autre bloc si on veut aller à une page particulière. 

<h3><a href="#q_document_pdf_bad"><img alt="up" border=0 width=27 height=27 src="gifs/arrows/up1.32.gif"></a><a name="r_document_pdf_bad"
>J'ai chargé un fichier pdf, ai fait un copier-coller du lien 
indiqué dans le document et le lien n'apparaît pas sur le nom du fichier. </a></h3>Si vous avez fait un copier-coller du lien indiqué, il est possible
que le blanc ait été mal codé. Par exemple, qu'il ait été codé comme 
<tt class="c">&lt;| &gt;  &lt;M- &gt;  160,  Hex a0,  Octal 240</tt> (un vrai blanc est codé
<tt class="c">&lt; &gt;  32,  Hex 20,  Octal 040  </tt>), dixit VIM !
Enlevez les blancs et remettez-les !
<p>

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

!tail
