Notation TeX

Remarque : cet article est en cours de rédaction. N'hésitez pas à le compléter. Veuillez utiliser la page de discussion ou un forum adéquat de Moodle en français pour vos recommandations et suggestions d'améliorations.

Une fois activé, le filtre Notation TeX permet d'afficher des formules mathématiques sous la forme d'images à partir d'expressions en langage TeX saisies entre deux délimiteurs appropriés. Le filtre utilise trois programmes sur le serveur pour accomplir ce travail. Si ces programmes ne sont pas disponibles, Moodle fournit une alternative passable au moyen de MimeTeX. Des versions de MimeTeX pour Linux (glib2.3), Windows, Mac OS X et FreeBSD sont incluses dans la distribution standard de Moodle.

Il y a par ailleurs d'autre technologies permettant d'afficher du code TeX.

Méthodes et utilisation

Il convient de noter, afin d'éviter des confusions, que le filtre Notation TeX dispose de deux méthodes pour convertir le code TeX en images. La méthode la meilleure utilise une combinaison de trois programmes, dont l'installation doit être effectuée sur le serveur en plus de Moodle (pour autant qu'ils ne soient pas déjà présents) et la configuration effectuée correctement. La page des réglages du filtre correspond totalement à cette méthode. Si ceci ne fonctionne pas pour quelque raison que ce soit, le filtre utilisera un autre programme, appelé MimeTeX, inclus dans la distribution standard de Moodle (on peut aussi compiler et installer soi-même MathTeX, le grand frère de MimeTeX, avec quelque compétence en administration système).

Avant tout, vous devez activer le filtre Notation TeX en allant sur Administration > Administration du site > Plugins > Filtres.

Une fois le filtre activé et configuré adéquatement, vous pouvez l'utiliser en saisissant une expression TeX entre deux paires de dollars ($$), par exemple :

   $$ \sqrt{x + y} $$

Si l'affichage ne se fait pas correctement, voyez la section ci-dessous sur le débogage.

MimeTeX

Moodle utilise un programme MimeTeX (situé dans le dossier filters/tex) s'il ne peut pas trouver les programmes dvips, convert et latex. Des versions de MimeTeX sont disponibles pour diverses versions de divers systèmes d'exploitation. Le filtre TeX utilise le programme pour le système adéquat. Votre serveur web doit être configuré de sorte à pouvoir lancer des exécutables depuis cet emplacement.

Le manuel de MimeTeX est disponible, mais destiné à des administrateurs système, et ne traite pas de l'environnement Moodle.

Il est conseillé de n'utiliser MimeTeX seulement si l'installation d'une véritable distribution de LaTeX n'est pas possible sur votre serveur, car la qualité des résultats n'est de loin pas optimale.

Débogage du filtre TeX

Le filtre TeX possède un script de débogage (qui sera en outre plus utile si vous activez en plus le débogage de Moodle) qui pourra vous aider si vous rencontrez des problèmes. L'accès à ce script se fait au moyen de l'URL ci-dessous :

  http://votre.moodle.fr/filter/tex/texdebug.php

Vous pouvez saisir manuellement cette URL. Avec les permissions nécessaires, les images TeX rendues incorrectement auront un lien vers le script. Sur les versions récentes de Moodle, seuls les administrateurs peuvent avoir accès à cet utilitaire.