Le wiki de WIMS EDU

L'association WIMS EDU a ouvert ce wiki afin de favoriser les collaborations entre utilisateurs de WIMS.

Outils pour utilisateurs

Outils du site


faq:document

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

faq:document [22/11/2011 22:07] (Version actuelle)
Ligne 1: Ligne 1:
 +=====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 !
 +
 +
 +
 +
 +
 +
 +
  
faq/document.txt · Dernière modification: 22/11/2011 22:07 (modification externe)