DocAide Documents

Sommaire

Vous lisez un document WIMS qui va vous guider dans la production d'un document WIMS.

Si un document en ligne est simpement la transposition sur l'écran d'un polycopié papier, il est moins confortable d'utilisation donc il est moins intéressant. Par contre si vous concevez un document en ligne avec toutes les possibilités offertes par WIMS au service de votre pédagogie, alors vous améliorez votre document : mettez de la couleur, concevez la taille des pages (bloc) en fonction de la taille de l'écran et des objectifs pédagogiques, faites des liens vers des ressources internet, vers des exercices, insérez des figures, des graphiques, proposez une navigation aisée dans le contenu, concevez des exemples aléatoires, prévoyez des zones qui peuvent être cachées ou vues...

Pour vous familiariser avec le type document WIMS, naviguez un peu dans celui-ci en suivant les conseils de navigation .

Maintenant lancez vous dans cette oeuvre de création sans hésiter ! Tout devient très simple quand on a commencé, WIMS balise très bien les étapes du processus ; en particulier, dès que le document est créé, vous avez droit à la documentation (cliquer sur Aide dans la barre WIMS). Les étapes de votre apprentissage :

1. Création d'un document
2. Comment éditer un document
3. Mise en forme spécifique à WIMS
4. Insertion d'exercices, images, documents, dessins ...
5. Insertion d'exemples à données aléatoires
6. Composition, statut d'un document ...

Convention de ce document :

• Aide est un faux lien : il vous indique que vous devez cliquer sur un tel lien dans votre document.
• \def{integer n = 2} indique un exemple de code (à retaper).
• Notes et Participants indique une phrase que vous devez retrouver dans la fenêtre WIMS dont on parle.
• toto désigne un fichier dont le nom est toto

Navigation dans un document

La navigation dans le document comme dans la classe se fait avec la barre WIMS. Les flèches de

Vous venez de cliquer sur l'image d'un lien utile de WIMS, c'est un faux lien, le vrai est sur la barre de navigation de WIMS

agissent comme les flèches du navigateur, elles gardent la mémoire de votre voyage. Les autres commandes

Vous venez de cliquer sur l'image d'un lien utile de WIMS, c'est un faux lien, le vrai est sur la barre de navigation de WIMS

,

Vous venez de cliquer sur l'image d'un lien utile de WIMS, c'est un faux lien, le vrai est sur la barre de navigation de WIMS

et

Vous venez de cliquer sur l'image d'un lien utile de WIMS, c'est un faux lien, le vrai est sur la barre de navigation de WIMS

sont programmées par l'auteur du document et vous guident selon son projet. (

Vous venez de cliquer sur l'image d'un lien utile de WIMS, c'est un faux lien, le vrai est sur la barre de navigation de WIMS

renvoie au sommaire et les autres ...)

Exercice : Visiter ce document (sans nécessairement lire en détail le contenu des parties) et dessiner sa carte.

graphe à dessiner

Création d'un document

• Ouvrez une nouvelle fenêtre ou un nouvel onglet pour aller dans votre classe.
• Sur la page de garde, cliquez sur ajouter un document.
• Donnez un titre au document mais n'écrivez rien dans la fenêtre entête (vous saurez bientôt quoi écrire).
• Ensuite créez le bloc principal ou page d'entrée (main) de votre document, donnez-lui un titre (sommaire par exemple)
• Dans la fenêtre d'édition, écrivez le texte ( Attention !

  L'avertissement n'a plus lieu d'être mais comme le pli est donné en exemple, je le laisse.

  )
  

  \link{html}
  
  \link{latex}{J'écris des mathématiques}

• Enregistrez.
• Consultez le premier paragraphe de l'Aide.
• Vous êtes invité(e) à créer deux nouveaux blocs.
  • Créez le bloc html : donnez-lui le titre Ecrire en html et choisissez son précédent et son suivant.
  • Ensuite cliquer sur sup ou hist pour revenir à la page précédente et créer le second.
  • Créez le bloc latex : donnez-lui le titre Composer des formules mathématiques et choisissez son précédent et son suivant.
• Revenez au sommaire et comparez les deux liens.
• Consultez la liste des blocs (Autres blocs).
• Vous pouvez mettre dans un bloc le contenu d'un fichier en cliquant sur Insérer un fichier

.

Nous avons vu ici comment créer un document dans une classe. Il est possible aussi de le créer dans un compte Modtool, la gestion du document est ensuite la même (voir DocAide Modules d'exercices OEF ). Le transfert de la classe vers un compte Modtool demande pour l'instant l'intervention du gestionnaire d'un serveur wims ou l'utilisation de votre installation privée si vous en avez une.

Comment éditer un document

Un document s'édite bloc par bloc dans la fenêtre d'édition. Il est plus commode et vivement recommandé d'écrire son texte dans son éditeur favori puis de le copier dans la fenêtre (vous gardez ainsi une copie de vos textes en attendant une sauvegarde de la classe). La mise en forme du texte se fait grâce à des commandes html et les formules mathématiques se composent avec Latex . Consultez le deuxième paragraphe de l'Aide.

Dans votre partie Ecrire en html, faites les exercices d' html et dans la partie Composer des formules mathématiques les exercices de Latex .

Quelques commandes html

Votre navigateur ou divers logiciels vous permettent de composer des pages web en html. La commande source de la page vous permet d'accèder au code d'une page et donc de découvrir comment coder certaines mises en forme.

Les bases

Voici quelques bases qui vous suffiront pour commencer ( Attention !

L'avertissement n'a plus lieu d'être mais comme le pli est donné en exemple, je le laisse.

).
Une balise html s'ouvre et se ferme.

 <br> aller à la ligne
 <p>paragraphe</p>
<center>pour centrer</center>
 <ul>
   <li>liste</li>
   <li>liste</li>
 </ul>
 <ol>
  <li>liste numérotée</li>
  <li>liste encore</li>
 </ol>

 <font color="purple">en violet</font>
 <b>En gras</b>)

Exercice : Ecrivez votre liste de courses en changeant de couleur selon les produits. Donnez-lui un titre centré en gras.

L'html permet la mise en forme de tableaux

 <table>
   <tr>
     <td>1</td>
     <td>2</td>
   </tr>
   <tr>
     <td>3</td>
     <td>4</td>
   </tr> 
 </table>

ou avec des attributs à table

 <table align="center" border =1 bgcolor="yellow" width="50%">
   <tr align="center">
     <td>1</td>
     <td>2</td>
   </tr>
   <tr align="center">
     <td>3</td>
     <td>4</td>
   </tr> 
 </table>

1	2
3	4

.

Exercice : Essayez de créer un tableau avec les valeurs de deux fonctions en trois points donnés.

Pour faire plus

• Des documents en ligne :
  • Un cours d'html en ligne qui vous présente d'autres balises avec des exemples.
  • Un tutorial.
• Quelques possibilités à noter :
  • Pour faire un titre de paragraphe : <h2>Les bases</h2>
  • La définition de styles dans la fenêtre entête du document (dans la page propriétés) donne une fière allure à votre document. Par exemple, copiez ceci dans la fenêtre entête du document de votre document.

      <style type="text/css">
      body  {font-family: Arial, Helvetica, sans-serif;font-size: 100% ;
      background-color: #FFFFCC;}
     </style>
    

  • Pour faire un magnifique fond vert à vos théorèmes, ajouter dans l'entête du document (entre <style type="text/css"> et </style>) les lignes suivantes :

    .prop
    	{
    	margin: 0% 8% 0% 8%;
    	width: 50%;
    	padding: 2%;
    	background-color: #E8E4D8;
    	}
    

    ensuite vous utilisez la balise <p class="prop">Enoncé de la proposition</p>.

• Un peu plus sur les styles css
  • Quels styles définir ?
  • Où mettre les styles ?

Quels styles définir ?

Pour simplifier la mise en forme du document, il est important de raisonner avec des styles. On définit un style pour les théorèmes, un pour les plis, un pour les noms de fichiers etc… On les appelle à chaque fois qu'on en a besoin, le choix des caractéristiques est fait une seule fois et peut être modifié en un seul endroit (voir Où mettre les styles ? ).

Pour le document, les paragraphes, les titres

Pour le document on peut choisir la couleur du fond, la police de caractères, sa taille, sa couleur, ...

body	{
   font-family: Helvetica, Arial, sans-serif;
   font-size: 100%;
   background-color: #FFFFCC;
}

Ici on définit un style pour la balise body qui existe déjà.

On peut définir l'indentation de tous les paragraphes par : p {text-ident: 1.3em;}

En html, les titres ont des styles définis par défaut. Dans les documents WIMS, le titre du document est en h1, les titres des blocs en h3, le h2 est disponible pour vos titres de paragraphe. Chaque style de titre peut être redéfini dans l'entête du document :

h3 {
   font-size: 130%;
   text-align: center;
   color: green;
 }

Définition d'une classe

On définit une classe par un nom commençant par un point, puis entre accolades ses caractéristiques, séparées par des point-virgules. Une classe qui définit les caractéristiques des caractères peut être appelée pour un mot ou un paragraphe.

.c   { 
   color: #c52d2d;
   font-size:100%;
   font-weight: bold;
}

Pour quelques mots, on peut écrire :

Le style <span class="c">c</span> indique un mot important.

pour

le style c indique un mot important.

Pour un paragraphe, on écrit :

<p class="c">Ce paragraphe est important.</p>

pour

Ce paragraphe est important.

Pour un paragraphe ou une partie

Le style peut définir le fond d'un paragraphe (<p class="ccc"> …</p >) ou d'une division qui peut comporter plusieurs paragraphes (<div class="ccc">…</div >). La balise pre indique une partie où la mise en forme est conservée.

Le style suivant est celui des encadrés verts de code :

	.ccc {
	   margin: 0% 3% 0% 3%;
	   width: 90%;
	   padding: 2%;
	   background-color: #CCFFCC;
	   color: #c52d2d;
	   font-weight: bold; }
	 

Dans l'exemple suivant, on définit un style de division pour faire un fond au théorème :

.thm {
		margin: 0% 8% 0% 8%;
		width: 80%;
		padding: 2%;
		background-color: #E8E4D8;
		}

Il vaut mieux définir la largeur (width) de façon relative avec un pourcentage. Le margin donne la répartiion des marges entre la couleur et le reste. Le  padding indique la marge intérieure à la couleur de fond. Evidemment, le total 2m+w+2p doit faire 100 %.

Pour en savoir plus.

Où mettre les styles ?

Dans une balise

<div style="
  margin: 0% 2% 0% 2%;
  width: 94%;
  padding: 2%;
  background-color: #CCFFCC;
">

Dans un document wims.

La définition de styles dans la fenêtre entête du document (dans la page propriétés) donne une fière allure à votre document. Copiez vos styles entre <style type="text/css"> et </style>

Dans une classe

L'apparence de votre classe se décide globalement dans apparence (dans la page configuration et maintenance). Le thème de style de la classe change la disposition et les couleurs de toutes les pages de la classe. Essayez en sauvant à chaque fois.

Dans style sheet css, vous pouvez ne rien choisir (----), choisir la feuille associer au thème (-thème-). Vous pouvez aussi définir votre style dans la dernière case, par exemple :

.intro {
  margin: 0% 2% 0% 2%;
  width: 94%;
  padding: 2%;
  background-color: #CCFFCC;
}

Vous devez alors choisir class dans style sheet css.

Alors pour définir un fond de couleur pour les introductions de feuilles, il suffira de rédiger le message ainsi :

<div class="intro"> Apprenez votre cours avant de faire les exercices !</div>

Quelques commandes Latex

Les formules Latex s'écrivent entre \( et ). Lisez la partie symboles et formules mathématiques de l'Aide.

Tester dans votre partie Composer des formules mathématiques ( Attention !

L'avertissement n'a plus lieu d'être mais comme le pli est donné en exemple, je le laisse.

) :

  \(2*e_2)
  \(4+-1*x+1*y)
  \(3 4)
  \([1,2;3,4])
  \(e_1 + 3 e_2)
  \(\int_0^x  (x^4+x^2) dx)
  \(\frac{1}{x^2+1})
  \(\vec{e_1})
  \(\sqrt{2})
  \(\sqrt[3]{2})

• pour un angle : \(\widehat{ABC}) donne $\widehat{\mathrm{ABC}}$
• pour un vecteur : \(\ vec u ) donne $\stackrel{\rightharpoonup }{u}$
• pour une flèche plus longue : \(\overrightarrow{AB}) donne $\overrightarrow{\mathrm{AB}}$
• pour faire de crochets : \(\lbrack -5,+5 \rbrack) donne $[-5,+5]$

Il vaut mieux couper les formules Tex un peu longues, ainsi

\(2 \times 2) = \(2 + 2) 

cela laisse au navigateur le choix de les mettre sur la même ligne ou non selon la taille de la fenêtre.

Mise en forme spécifique à WIMS

Dans la partie 5 de l'Aide : Syntaxe des commandes, vous trouverez toutes les commandes spécifiques de WIMS.

Commandes de mise en forme

Vous avez déjà utilisé \link.

La commande \embed permet de mettre en plusieurs endroits le même contenu (par exemple l'énoncé d'un théorème) en éditant un seul bloc.

Différents plis

Pour faire un pli, vous pouvez utiliser la commande \fold de plusieurs façons.
Le contenu du pli Remarque dans Quelques commandes Latex est dans le même bloc :

   \fold{}{Remarque }{Contenu de la partie une fois dépliée.}

Dans ce cas, aucun autre fichier n'est créé, les styles css ne passent pas très bien...

Le pli Attention ! apparaît plusieurs fois et est édité dans un autre bloc :

   \fold{nom}{Attention}
   \fold{nom} 

Un nouveau fichier est créé qui s'appelle nom. Avec la première ligne, son titre est "Attention", avec la seconde son titre sera le même que le titre du bloc.

Exercice : Créez un bloc pgcd à partir de la partie Composer des formules mathématiques dont le titre sera Exercice sur le pgcd. Son texte sera l'exercice sur le pgcd proposé un peu plus loin avec un pli pour présenter le code.

Pour commenter

  \comment{Ca marche !}

Insertion d'exercices, images, documents, dessins ...

Dans la partie 5 de l'Aide : Syntaxe des commandes, vous trouverez toutes les commandes spécifiques de WIMS. Dans la partie 7 pour les dessins.

Insertion d'une image (jpeg,gif,png), d'un fichier PDF, d'un document audio ...

Pour insérer un fichier de ce style, allez dans Autres blocs, cliquez sur Dépôt de fichier. Il ne vous reste plus qu'à parcourir votre ordinateur à la recherche du fameux fichier. WIMS vous indique alors la commande à recopier dans la page (bloc) du document. Par exemple :

    <a href="\filedir/jentilez.jpg">jentilez.jpg</a>
    <img src="\filedir/myfile.jpg"> 

La première formule est un lien vers le fichier jentilez.jpg. La deuxième affiche l'image dans la page. Le texte suivant permet d'encadrer l'image, de régler sa taille et de proposer un texte alternatif.

    <img style="border: 2px solid blue; width: 80%;"alt="image"src="\filedir/image.jpg"> 

Pour tester, vous devez d'abord refermer le document, puis le rouvrir.
De la même manière, vous pouvez insérer tous types de fichiers : textes, images, musiques, etc.

Son

• Un peu de musique !
• Exercice de solfège :

  Quel intervalle est-ce ?

  Une fois que vous avez cliqué sur le lien précédent, cliquez ensuite sur Encore une fois puis sur Quel intervalle .. et recommencez. Vous reconnaitrez peut-être une octave.

Lien vers un site

Le code

<a  target="wims_external"  href="http://www.mathkang.org/">site du Kangourou des mathématiques</a>

crée un lien vers le site du Kangourou des mathématiques.

Lien vers des exercices

Dans un document, vous pouvez créer un lien vers un exercice de la distribution ou un outil. Essayez :

  \exercise{cmd=new&module=U1/analysis/graphder.fr}{exercice}
  \tool{module=tool/number/calcnum.fr}{outil}
  \exercise{module=H3/stat/docstat.fr}{document}
  \adm{module=adm/createxo}{commentaire}

Lien vers un autre document

Par exemple si vous voulez faire un lien sur les documents d'aide

\doc{module=help/student/docetud.fr} pour aider les étudiants
\doc{module=help/teacher/docdocument} pour créer un document de cours (ce document !)
\doc{module=help/teacher/docexooef} pour créer des exercices)
\doc{module=help/developer/docmodtooloef} pour créer un module d'exercices OEF

   \link{bloc}{titre}{ancre}{parm1=1&parm2=2}

Insertion d'un dessin

  \draw{200,200}{
   xrange -2,2
   yrange -2,2
   lines blue, 1,1,-1,1,-1,-1,1,-1,1,1
   fill 0,0,green
  }

Insertion d'exemples à données aléatoires

Pour les questions traitées ici, voyez aussi l'Aide 7 et 8.

Un exemple simple

Vous pouvez insérer :

Le pgcd des entiers 7566 et 13033 est égal à 1.

grâce au code suivant :

 <a name=pgcd>
  \def{integer n = randint(1000..200000)}
  \def{integer m = randint(1000..200000)}
  \def{integer p = gcd(\n , \m)}
  Le pgcd des entiers \n et \m est égal à \p.
  \reload{Recommencez}{pgcd}

Définition d'une variable.

On définit les variables différemment que dans les exercices.

  \def{integer a =  8}

Programmation

 
   \for{i = 1 to 10}{ \i , }

   \def{ text n = randitem( exercice, exercices) }
   \if{\n issametext exercice}{Un}{Des}\n
 

   \reload{<img src = "gifs/doc/etoile.gif" alt = "rechargez" width = "20" height = "20">}

Insertion d'un formulaire

Cacher la solution dans un exemple

Composition, statut d'un document ...

• Il est commode d'éditer son document dans son éditeur préféré puis de le copier dans la fenêtre d'édition WIMS pour tester l'effet. Le travail est plus confortable et vous en gardez une copie.
• Evitez les pages trop longues, quitte à les faire grossir à l'aide des plis (\fold). Les écrans ne sont pas tous très grands. Le lecteur peut déplier ou replier les remarques, les digressions, les solutions...
  Les grandes pages avec TeX mettent un certain temps à sortir.
• Pensez à l'option sup = parent en plus de précédent et suivant (par défaut, il est sur main). C'est en fait extrêmement commode pour gérer des "chapitres" et des tables des matières de chapitres.
• Pensez à la version imprimable, même si elle ne peut être parfaite (elle permet de détecter les erreurs de syntaxe css ou html : si le fond devient bleu à partir d'un certain temps ou se met à devenir de plus en plus étroit ...) Vérifiez par exemple qu'elle prend bien toutes les pages, qu'il n'y a pas d'orphelin et que l'ordre est à peu près correct.
• Lisez les parties 3, 4 et 9 de l'Aide.