=====Documents=====
====Qu'est-ce qu'un document ?====




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.


====Quel intérêt y a-t-il à faire un document  WIMS plutôt que des pages html ? ====



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  ''déplier'' et  ''replier'' (avec  ''\fold'') 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.


====Où est la documentation pour commencer un document ?====



Créez d'abord le [[http://wims.auto.u-psud.fr/wims/wims.cgi?lang=fr&+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
[[http://wims.auto.u-psud.fr/wims/wims.cgi?lang=fr&+module=adm/doc.fr&+job=creat& |document]] que vous pouvez aussi trouver dans la page d'accueil
à la rubrique  ''Misc documents interactifs''.

====Pouvez-vous me conseiller sur la lisibilité d'un document ?====




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  ''fold'' 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.


====Comment imprimer un document ?====




Passer en  ''version imprimable''. 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...


====Je voudrais mettre dans ma classe des fichiers pdf ou des images.  Est-ce possible ?====



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 à  ''Propriétés'',
puis  ''Liste de blocs du document''. Il y a écrit :
 ''Dépôt de fichier''. 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.


====Comment homogénéiser la présentation des documents ?====




Vous pouvez ajouter votre style valable pour tout le document : pour
cela, aller à  ''Propriétés du document'' et copier
votre fichier de style ou son adresse url. Par exemple,

   
    <style type= text/css > <!--
    H1, H2 { color: navy; 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;
    }
    --></style>


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.


====Comment déplier ou replier une partie d'un document ?====



La commande  ''fold'' permet de
 ''déplier'' et  ''replier'' une partie
d'un document.


====J'ai des applets sur un autre site, comment les intégrer à un document ?====



Il suffit de mettre l'adresse url des applets.


====Comment classer les pages d'un document ?====




L'option  ''parent'' permet d'établir une hiérarchie entre les
pages d'un document en plus des options usuelles  ''précédent''
et  ''suivant'' (par défaut, le  ''parent'' est
 ''main''). C'est commode pour gérer des  chapitres  et des
tables de matières de chapitre.


====Les formules TeX débordent. Que faire ?====




Il vaut mieux couper les formules TeX un peu longues,
 ''\(...) = \(...)'', plutôt que  ''\(... =
...)''. Cela laisse au navigateur le choix de les mettre sur la même
ligne ou non selon la taille de la fenêtre.


====J'ai fait une erreur de syntaxe et je n'arrive plus à ouvrir mon document. ====



Si l'erreur se trouve sur la première page
 ''main'', 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


====Comment déplier ou replier une partie d'un document ?====



La commande  ''fold'' permet de
 ''déplier'' et  ''replier'' une partie
d'un document.


====Dans un document, comment demander au lecteur d'entrer un paramètre ? ====



Voici un exemple où le paramètre à entrer est un entier :

   
    \def{integer n = randint(2..9)}
    \form{.}{exemple}{ n  =
      <input size = 6 name = parm1 value =  \parm1 >
      <input type = hidden value = OK>
    }
    \def{integer value = \parm1}
    \def{integer  n = \value issametext NaN ? \parm1: \value}


Par défaut, l'entier //n// sera un  entier entre 2 et 9.






====J'ai fait un document dans ma classe, comment le citer ? ====



Dans un autre document,  si le document cité a le numéro
 ''c9'' :  ''\link{c9/main}''
 On peut aussi remplacer   ''main''
le nom d'un autre bloc si on veut aller à une page particulière. 


====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. ====



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 ><| >  <M- >  160,  Hex a0,  Octal 240</tt> (un vrai blanc est codé
<tt class= c >< >  32,  Hex 20,  Octal 040  </tt>), dixit VIM !
Enlevez les blancs et remettez-les !