DocAide Documents

Sommaire

Découverte des DocWIMS et utilisation des DocWIMS publiés

• Les plus d'un DocWIMS
• Divers types de DocWIMS
• Navigation dans un document : Pour vous familiariser avec le type DocWIMS, naviguez dans celui-ci ou dans un DocWIMS publié en suivant ces conseils.
• Insertion d'un DocWIMS public dans une classe et feuille d'exercices
• Besoin d'aide pour un exercice
• Premières aides

Composition d'un DocWIMS

Maintenant lancez-vous dans cette œuvre 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).

En suivant les étapes 1 et 2, vous allez créer un document, son sommaire et d'autres pages où vous apprendrez à composer du texte en utilisant un peu d'html pour la mise en forme et un peu de LateX pour les formules. Ensuite d'autres fonctionnalités sont présentées ; n'hésitez pas à consulter l'Aide pour tous détails et options.

1. Créez votre document
2. Comment éditer un document
   • Quelques commandes html
   • Quelques commandes Latex
3. Composition, statut d'un document ...
4. Les commandes spécifiques à WIMS
5. Insertion d'exercices, images, documents, dessins ...
6. Quelques conseils avancés
7. Statut d'un document
8. Déplacer un DocWIMS

Pour la suite de votre apprentissage, consultez le DocAide DocAide Documents II . Vous y trouverez des pistes pour des exemples aléatoires plus élaborés, des dessins dynamiques et des conseils pour l'utilisation de latex2wims.

Les plus d'un DocWIMS

Si un cours en ligne est simplement 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 présentation et son contenu.

Vous pouvez

• mettre de la couleur
• insérer des figures fixes ou animées
• proposer des exemples à données aléatoires
• proposer des exercices WIMS
• faire des liens vers des ressources internet, des videos
• prévoir des zones qui peuvent être cachées ou vues...

Si vous créez le DocWIMS dans votre classe ou votre modtool, il peut être modifié en temps réel.

Un lien vers une video se fait comme dans une page web, bien sûr ! Pour insérer une video de Youtube, choisir partager puis intégrer et copier le code html.

Divers types de DocWIMS

Les DocWIMS publiés

Les DocWIMS publiés sont des cours produits par les enseignants sous leur responsabilité. Ils sont accessibles par la fonction chercher en choisissant "Cours et références" et par le lien Cours et références. Il est possible de les insérer dans votre classe pour les mettre à la disposition des élèves.

Les DocWIMS de votre classe

• présenter une liste de références, des fichiers à télécharger,
• préciser un point du cours avec une figure par exemple,
• offrir une aide ou un corrigé pour un exercice,
• être un guide pour une séance sur machine...

En cliquant sur "Liste de ces documents", vous avez ouvert un pli. Remarquez le fond vert qui le rend plus visible. Les plis permettent de raccourcir une page des digressions.

Les DocWIMS de votre modtool

Navigation dans un document

La navigation dans le document comme dans la classe se fait avec les liens du bandeau supérieur de la page WIMS ou avec les flèches vertes sur les côtés des pages.

Flèches de navigation.

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

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

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

Version imprimable.

La version imprimable permet une impression sans le contexte du navigateur mais aussi de consulter l'ensemble du contenu.
Cliquez sur Version imprimable et sur Version interactive pour revenir.

Insertion d'un DocWIMS public dans une classe

Insertion d'un Doc Wims dans une classe

Vous pouvez insérer dans la classe des cours publiés. Ensuite, vous pouvez le rendre visible ou non. Fiche.

Une page de DocWIMS publié ou non peut être insérée dans une classe comme besoin d'aide .

Feuille d'exercices d'un Doc WIMS.

Quand un DocWIMS est inséré dans une classe, vous pouvez créer automatiquement une feuille comportant tous les exercices du document avec le lien Créer la feuille des exercices du document accessible à l'insertion ou avec le lien Modifier.

Vérifiez l'ordre des exercices, choisissez les points requis et les poids et partagez la feuille si elle est trop longue.

Vous pouvez modifier la présentation de votre classe en définissant des séquences pédagogiques (fiche). Vous pourrez ainsi regrouper un DocWIMS et les feuilles sur un même thème.

Besoin d'aide pour un exercice

Les aide et indication d'un exercice sont conçues par l'auteur de l'exercice. L'indication peut être cachée au moment de l'insertion de l'exercice dans la feuille mais ni l'une, ni l'autre ne sont modifiables hors programmation.

L'enseignant qui utilise un exercice dans une feuille peut à tout moment (même après l'activation de la feuille) proposer une aide à l'étudiant qui a résolu l'exercice (juste ou faux). Cette aide (appelée ici besoin d'aide) peut être un exercice plus simple, un outil, une entrée du glossaire ou une page de DocWIMS (publié ou non).

L'article sur le site de WIMS EDU présente la fonctionnalité besoin d'aide. et voici la fiche pour le besoin d'aide. Pour insérer un DocWIMS de la classe comme besoin d'aide, lisez l'aide du besoin d'aide (lien dans le fenêtre de paramétrage de l'exercice)

Premières aides

La référence

Les tutoriels

Les fiches WIMS EDU

• Insérer un document publié dans sa classe ,
• Créer un document I ,
• Créer un document II,
• Besoin d'aide
• Transférer un DocWIMS de sa classe vers son modtool. ,

Créez votre 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 cliquez 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 d'un document de la classe vers un compte Modtool est possible par le lien transfert dans la page des propriétés du document.

Comment éditer un document

Le DocWIMS s'édite bloc par bloc dans la fenêtre d'édition. Un éditeur d'html et de commandes WIMS est disponible. 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.

• Quelques commandes html
• Quels styles définir ?
• Où mettre les styles ?
• Quelques commandes Latex

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

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

 <p>paragraphe</p>
<p class="wimscenter">pour centrer</p>
ou
<div class="wimscenter">pour centrer</div>
 <ul>
   <li>liste</li>
   <li>liste</li>
 </ul>
 <ol>
  <li>liste numérotée</li>
  <li>liste encore</li>
 </ol>
<span style="color:purple;">en violet</span>
<span style="font-weight:bold;">En gras</span>
<span class="wims_emph">Mise en valeur avec les couleurs du serveur</span>

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

Tableaux

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

 <table style="text-align:center;width:50%; background-color:yellow;">
   <tr>
     <th>Titre 1</th>
     <th>Titre 2</th>
   </tr>
   <tr>
     <td>1</td>
     <td>2</td>
   </tr>
   <tr>
     <td style="color:red">3</td>
     <td>4</td>
   </tr> 
 </table>

 <table class="wimsborder wimscenter">
   <tr>
     <th>Titre 1</th>
     <th>Titre 2</th>
   </tr>
   <tr>
     <td>1</td>
     <td>2</td>
   </tr>
   <tr>
     <td>3</td>
     <td>4</td>
   </tr> 
 </table>
 

 <table class="wimsnoborder wimscenter" style="background-color:yellow;">
   <tr>
     <th>Titre 1</th>
     <th>Titre 2</th>
   </tr>
   <tr>
     <td>1</td>
     <td>2</td>
   </tr>
   <tr>
     <td style="color:red">3</td>
     <td>4</td>
   </tr> 
 </table>

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

Styles prédéfinis dans WIMS

• <span class="wims_color1">Aide 1</span> Aide 1
• <span class="wims_color2">Aide 2</span> Aide 2
• <span class="wims_color3">Aide 3</span> Aide 3
• <span class="wims_emph">important</span> important

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.
  • Si vous avez un compte Modtool, la validation est désormais possible en ligne (dépend des serveurs) ; voir aussi dans les fiches de WIMS EDU les erreurs classiques. lien
• Quelques possibilités à noter :
  • Pour faire un titre de paragraphe : <h3>Les bases</h3>
  • 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 et permet surtout de pouvoir facilement changer de style sans devoir aller sur toutes les pages.
  • Pour faire un magnifique fond vert à vos théorèmes, ajouter dans l'entête du document (entre <style> 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 le document, les paragraphes, les titres

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

Définition d'une classe

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

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

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

Ce paragraphe est important.

Pour un paragraphe ou une partie

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

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

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> 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 :

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

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]$ et \(\rbrack A,B \rpar\) donne $]A,B)$

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.
• Concevez la taille des pages (bloc) en fonction de la taille de l'écran et des objectifs pédagogiques. Pensez à la structuration et à la navigation dans le contenu
• 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.
• Inutile de mettre main comme suivant ou précédent. Par contre, le fait mentionné dans le bloc 1 que le bloc 1 soit le précédent du bloc 2 ne dispense pas d'indiquer dans le bloc2 qu'il est le suivant du bloc1.
• 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.

Les commandes spécifiques à WIMS

Commandes de mise en forme

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

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

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

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

• Insertion d'une image (jpeg,gif,png), d'un fichier PDF, d'un document audio ...
• Lien vers un site
• Lien vers des exercices
• Lien vers un autre document WIMS
• Insertion d'un dessin
• Insertion d'une notion ou d'un exemple du glossaire
• Insertion d'un lien vers un questionnaire

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

Image

Le quatrième bouton de l'éditeur d'html écrit la syntaxe d'insertion automatiquement.

• lien vers le fichier jentilez.jpg.

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

  ou

       \href{jentilez.jpg}{lien}
  

• affichage de l'image dans la page. La commande alt propose un texte alternatif à l'image ; il est conseillé de la mettre même avec un texte vide pour la lecture des non voyants.

       <img src="\filedir/myfile.jpg" alt="image">
  

  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">
  

Autres fichiers

De la même manière, vous pouvez insérer tous types de fichiers : textes, images, musiques, etc. Le dernier bouton de l'éditeur d'html écrit la syntaxe d'insertion automatiquement. Précisez le suffixe du fichier pour un meilleur téléchargement.

Lien vers un site

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

Le troisième bouton de l'éditeur d'html écrit cette syntaxe automatiquement.

Lien vers des exercices

\exercise{module=U1/analysis/graphder.fr&cmd=new}{module dérivée graphique}
\exercise{module=U1/geometry/oefpolyedsemireg.fr&cmd=new&exo=nomplaton}{exercice particulier du module polyèdre}
\tool{module=tool/number/calcnum.fr}{outil}
\adm{module=adm/createxo}{Lien vers la page d'accueil de createxo}

On peut aussi mettre un lien vers un exercice qui est inséré dans une feuille de la classe. Consultez le paragraphe Syntaxe des Commandes de l'aide.

Lien vers un autre document WIMS

Lien vers 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

Lien vers un document ou une page particulière d'un document

\doc{module=help/teacher/docexalea.fr}
\doc{module=help/teacher/docexalea.fr&+block=cache}{Exemples aléatoires à solution cachée}

Le premier lien envoie sur le sommaire du DocAide DocAide Documents II (c'est celui-ci). Le second vers la page "Exemples aléatoires à solution cachée" qui est écrite dans le bloc cache (voir le lien en action à la fin de cette page).

L'adresse du document se trouve dans la fenêtre A propos comme pour un exercice (voir Lien vers des exercices ). On trouve le nom de block de la page qui doit être la cible du lien dans son adresse dans la barre de navigation.

Lien à l'intérieur d'un document WIMS

Tout est écrit dans le pli \link de la page Syntaxe des commandes de l'aide des documents accessible par ce lien mais aussi par le lien Aide du bandeau lors de la composition du document.

Une fonctionnalité particulière de la commande \link

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

Insertion d'un dessin

La syntaxe des dessins WIMS est la même que dans les exercices. Pour la liste des commande et d'autres exemples, on peut consulter l'Aide des documents (Syntaxe des commandes, partie 7), l'aide de Createxo et le DocAide Exercices OEF .
Pour des exemples aléatoires de dessin et l'insertion de figures GeoGebra, il est utile de consulter le DocAide DocAide Documents II .

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

Insertion d'une notion ou d'un exemple du glossaire

Une notion

\glossary{mathematics/analysis/fr/affine_function}

Un exemple avec génération aléatoire provenant du glossaire

\glossary{mathematics/analysis/fr/affine_function_1}
\reload{Nouveaux exemples}{exemple1}

Insertion d'un lien vers un questionnaire

Répondre à ce questionnaire en ligne.

Répondre à ce \adm{module=adm/vote&job=read&vote=1}{questionnaire en ligne.}

Quelques conseils avancés

Un exemple simple

 <a id="pgcd"> </a>
  \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.

  \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" style="width:20px;height:20px;">}

Pour aller plus loin

Vous pouvez demander au lecteur d'entrer une valeur : Insertion d'un formulaire .

Vous pouvez choisir de cacher la solution d'un exemple aléatoire dans un pli. Cela demande un peu de technique. Voyez la partie du DocAide Documents II sur les exemples aléatoires à solution cachée.

Statut d'un document

Seul l'enseignant de la classe peut créer un document et modifier ses propriétés. Il peut décider du droit d'accès au document par les participants de la classe (modifiable dans les propriétés du document)

• Ni lecture ni écriture. Les participants ignorent totalement l'existence du document. C'est en particulier le mode de choix quand le document est en préparation.
• Lecture mais pas écriture. C'est le mode d'accès habituel d'un document de cours.
• Lecture et écriture. Dans ce cas le document peut être modifié librement par tout participant de la classe, et il n'y aura aucune trace de qui a fait quoi. On peut ainsi en faire un espace de bavardage.

Plus généralement, lisez aussi les parties 3, 4 et 9 de l' aide des DocWIMS .

Déplacer un DocWIMS

Modtool et classe

Un document de votre espace de développement Modtool peut être inséré dans une classe comme n'importe quel Doc Wims. Il suffit d'aller dans votre Modtool depuis la classe, de tester le DocWIMS et d'utiliser le lien Insérer dans la classe.

Un DocWims composé dans votre classe peut être envoyé dans votre Modtool en utilisant le lien transfert dans la page propriétés du document. fiche.

Transfert d'une classe à l'autre

Dans l'archive d'une classe, un DocWims est un dossier nommé c3 selon son ordre de création dans la classe (visible dans la page propriétés). Pour transférer un DocWims d'une classe A à une autre B, il suffit de

1. Faire une archive de chaque classe ;
2. Décompacter l'archive de la classe A et nommer classA le dossier obtenu ;
3. Décompacter l'archive de la classe B et nommer classB le dossier obtenu ;
4. Consulter dans le dossier doc de la classB, le nombre de documents, par exemple 5 ;
5. Ouvrir le dossier doc de la classA, copier le dossier c3 (par exemple) ;
6. Renommer c6 le dossier c3 s'il y a déjà 5 documents dans la classe B ;
7. Insérer le dossier c6 dans le dossier doc de classB ;
8. Compacter le dossier classB ;
9. Restaurer (tout sauf le compte enseignant) la classe B avec le nouveau dossier compacté classB ;
10. Dans la page Config/maintenance, actualiser l'index des documents.