DocAide Documents

Sommaire

Vous lisez un document WIMS (ou DocWIMS) qui va vous guider dans l'utilisation et la production de DocWIMS.

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

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
  3. Conseils pour la composition d'un DocWIMS
  4. Les commandes spécifiques à WIMS
  5. Insertion d'exercices, images, documents, dessins ...
  6. Exemples aléatoires, programmation ...
  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.


Convention de ce document :

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

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

Vous pouvez créer de petits documents dans votre classe pour un usage ponctuel. Ils peuvent Vous trouverez des exemples dans la classe ouverte postbac L1 mathématiques.
  1. Guides
    • Liens vers des DocWims utiles : "résumés de cours"
    • Guide de travail : "les fonctions trigonométriques réciproques"
  2. Rappels de cours
    • "Formules de Taylor" complété en cours de séance.
    • Notations o et O pour préciser les notations de WIMS.

Les DocWims de votre modtool

Si vous avez un espace de développement Modtool, vous pouvez insérer les DocWIms que vous préparez dans votre classe. Inversement les DocWims composés dans votre classe peuvent être envoyés dans votre Modtool (voir cette page ).

Navigation dans un DocWIMS

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

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

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

L' aide de WIMS est accessible par le lien Aide quand vous êtes en train d'éditer un DocWims dans votre classe. Vous y trouverez en particulier la syntaxe de toutes les commandes spécifiques aux DocWIms, par exemple \fold, \link ... Vous pouvez même voir le source de cette aide qui est un DocWims bien sûr !

Les tutoriels

Les tutoriels DocAide Documents et DocAide Documents II sont des DocWIMS publiés accessibles depuis l'accueil WIMS de votre serveur préféré.
Cliquez sur le lien Tutoriels du menu Documentation ou entrez le mot wimshelp dans le moteur de recherche.

Les fiches WIMS EDU

Vous pouvez retrouver les fiches sur le site de WIMS EDU (lien dans la colonne de droite). En particulier :

Créez votre document

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

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


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

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

Tableaux

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>
1 2
3 4
On peut ajouter des attributs à 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>

Titre 1 Titre 2
1 2
3 4
On peut aussi utiliser des attributs prédéfinis auxquelles vous pouvez rajouter des améliorations :
 <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>
 
Titre 1 Titre 2
1 2
3 4
 <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>
Titre 1 Titre 2
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

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


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.

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}\)

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 :
.aide {
 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="aide"> Apprenez votre cours avant de faire les exercices !</div>

Conseils pour la composition d'un DocWIMS


Règles de la version imprimable :

La version imprimable ne se déroule pas selon l'ordre de navigation défini par les préc. et suiv.. Les blocs apparaissent si et seulement s'il y a un lien vers eux dans leur parent et ils apparaissent dans l'ordre des liens.

Application aux figures GeoGebra : Si les figures interactives GeoGebra apparaissent dans la version imprimable, elles disparaissent à l'impression.
Pour pallier ce manque, on peut définir un bloc figimp par un lien sous la figure interactive (dans le bloc figure par exemple), y insérer une version fixe imprimable de la figure et définir figure comme le parent de figimp. Le bloc figimp ne gênera pas la navigation mais apparaîtra à l'impression.

Les commandes spécifiques à 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