« Notation TeX » : différence entre les versions

De MoodleDocs
Aller à :navigation, rechercher
Accueil ► Gestion du contenu ►Filtres ► Notation TeX
Filtres
Aucun résumé des modifications
 
(6 versions intermédiaires par un autre utilisateur non affichées)
Ligne 1 : Ligne 1 :
{{Travail en cours}}
{{Filtres}}
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.
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.


Ligne 28 : Ligne 28 :
Emplacement : lien vers Notation TeX dans ''Administration > Administration du site > Plugins > Filtres > Gérer les filtres''
Emplacement : lien vers Notation TeX dans ''Administration > Administration du site > Plugins > Filtres > Gérer les filtres''


The TeX filter settings page are primarily intended to adjust the operation of the LaTeX renderer. The defaults for the three path settings are selected according to the detection of the operating system on which Moodle is running. These are simply suggested common values - Moodle does not check that the binaries actually exist at these locations. More recent versions of Moodle show a green tick or a red cross next to the path setting - this shows that the binary exists at that location (only). The settings have no effect on the operation of the MimeTex binary (used if any of these binaries are not found).
Les réglages du filtre TeX permettent d'ajuster le fonctionnement du moteur de rendu LaTeX. Les réglages par défaut pour les chemins d'accès aux trois exécutables sont sélectionnés en fonction du système d'exploitation du serveur sur lequel Moodle est installé. Ce sont des valeurs communes suggérées. Moodle ne vérifie pas si les exécutables sont réellement installés à ces emplacements. Les versions récentes de Moodle affichent une marque ''vu'' ou une croix à côté du réglage des chemins, montrant si l'exécutable est présent ou non à cet emplacement. Les réglages n'ont aucun effet sur le fonctionnement de MimeTex (qui est utilisé si les exécutables ci-dessus ne sont pas trouvés).


=== Installation des exécutables ===
=== Installation des exécutables ===


This depends on your platform, but for a typical install you are going to need a LaTeX implementation. On modern Linux implementations you should look for the 'texlive' package (e.g. ''apt-get install texlive'') although a Windows version is available (see [http://www.tug.org/texlive/doc/texlive-en/texlive-en.html Tex Live]). It is highly unlikely that you will have all these binaries as part of a standard install. If you cannot find texlive you may have to install LaTeX, Ghostscript and ImageMagick separately. While not endorsed by Moodle.org, a simple installation binary for Windows is [http://miktex.org/| MikTeX].   
Cette étape dépend du système d'exploitation de votre serveur. De manière générale, vous aurez besoin d'une distribution de LaTeX. Sur un serveur Linux moderne, il s'agira de ''TeX Live'' (par exemple ''apt-get install texlive''). TeX Live est aussi disponible pour Windows (voir [http://www.tug.org/texlive/doc/texlive-fr/texlive-fr.html TeX Live]). Si TeX Live n'est pas disponible pour votre plateforme, il vous faudra installer LaTeX, Ghostscript et ImageMagick séparement. Sous Windows, vous pouvez aussi installer  [http://miktex.org/| MikTeX].   


The filter settings page will try to guess the most likely location for the binary files depending on the detected platform. If correct, green ticks will appear against each setting. If red crosses appear you will need to check and modify the settings as required. A simple check is made to establish if the binaries exist at the given paths. A tick or a cross is displayed alongside each as a result. Note that this does not check that the application actually works, just that it is there.
Certains systèmes fournissent les polices dans des paquetages séparés. En cas de problèmes d'affichage, assurez-vous que toutes les polices nécessaires soient installées. Voyez en particulier si le paquetage des polices ''extra'', qui comprend les polices mathématiques, est installé.
 
Some systems supply the fonts as separate packages. If you are having problems make sure you have all the fonts you need installed. You may need to track down an 'extra' fonts package to get the required maths fonts.


=== Préambule LaTeX ===
=== Préambule LaTeX ===


Enables the LaTeX preamble to be specified. The default should work for most users, but you may need to change it to support non-latin character sets etc. Please see the LaTeX documentation for further details.
Ce champ permet d'indiquer un préambule LaTeX. Le préambule indiqué par défaut fonctionne pour la plupart des utilisateurs. Vous pouvez le modifier pour supporter d'autres encodages, etc. Veuillez consulter la documentation de LaTeX pour plus de détails.


=== Couleur transparente ===
=== Couleur transparente ===


This should be set to your normal text background colour. The default setting is #FFFFFF (i.e., white).  
Devrait correspondre à la couleur de fond du texte normal. Le réglage par défaut #FFFFFF, c'est-à-dire blanc.  


=== Densité ===
=== Densité ===


This setting effects the size of the resulting image. The default setting is 120 pixels, and it produces an image of  reasonable quality, but for some complicated equations, this still may not be enough. It may be that anything less is not going to produce an image of sufficient quality but the image size can be controlled by the TeX encoding when the page is rendered.
Ce réglage modifie la taille de l'image résultante. Le réglage par défaut est 120 pixels, ce qui permet la production d'une image de qualité acceptable. Mais pour certaines équations compliquées, ce ne sera peut-être pas suffisant. Il n'est pas conseiller d'indiquer une valeur inférieure à 120 pixels.


=== Chemin d'accès du logiciel ''latex'' ===
=== Chemin d'accès du logiciel ''latex'' ===


Path to standard latex binary.
Le chemin vers l'exécutable ''latex''.


On Unix based systems it is normally "/usr/bin/latex". On a MacOS X, the path is "/usr/texbin/".
*Sur les systèmes Unix ou Linux, c'est habituellement « /usr/bin/latex ».
 
*Sur Mac OS X, le chemin est « /usr/texbin/latex ».
In Windows, using MiKTeX, it is usually something like C:\texmf\miktex\bin\latex.exe
*Sous Windows, avec MiKTeX, c'est normalement quelque chose comme « C:\texmf\miktex\bin\latex.exe ».


=== Chemin d'accès du logiciel ''dvips'' ===
=== Chemin d'accès du logiciel ''dvips'' ===


Path to standard dvips binary - generally distributed as part of a LaTeX system.
Le chemin vers l'exécutable ''dvips'', en général faisant partie de la distribution d'un système LaTeX.


On Unix based systems it is normally "/usr/bin/dvips". On a MacOS X, the path is "/usr/texbin/".
*Sur les systèmes Unix ou Linux, c'est habituellement « /usr/bin/dvips ».
 
*Sur Mac OS X, le chemin est « /usr/texbin/dvips ».
On Windows using MikTeX is is usually something like C:\texmf\miktex\bin\dvips.exe
*Sous Windows, avec MiKTeX, c'est normalement quelque chose comme « C:\texmf\miktex\bin\dvips.exe ».


=== Chemin d'accès du logiciel ''convert'' ===
=== Chemin d'accès du logiciel ''convert'' ===


Path to standard convert binary. This is distributed as part of the Ghostscript system, or ImageMagick in Linux.
Le chemin vers l'exécutable ''convert''. Cet exécutable s'installe généralement avec Ghostscript ou ImageMagick.


On Unix based systems it is normally "/usr/bin/convert". On a Mac OS X, the path is "/usr/local/bin/".
*Sur les systèmes Unix ou Linux, c'est habituellement « /usr/bin/convert ».
 
*Sur Mac OS X, le chemin est « /usr/local/bin/convert ».
On a Windows based PC the path is something like C:\Program Files\ImageMagick\convert.exe (for ImageMagick, but something else for GhostScript.)
*Sous Windows, avec MiKTeX, c'est normalement quelque chose comme « C:\Program Files\ImageMagick\convert.exe », si vous avez installé ImageMagick. Ce sera autre chose avec GhostScript.


== Débogage du filtre TeX ==
== Débogage du filtre TeX ==
Ligne 81 : Ligne 79 :


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.
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.
==Voir aussi==
* [[Utilisation de la notation TeX]]

Dernière version du 6 juin 2019 à 12:45

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.

Réglages

Emplacement : lien vers Notation TeX dans Administration > Administration du site > Plugins > Filtres > Gérer les filtres

Les réglages du filtre TeX permettent d'ajuster le fonctionnement du moteur de rendu LaTeX. Les réglages par défaut pour les chemins d'accès aux trois exécutables sont sélectionnés en fonction du système d'exploitation du serveur sur lequel Moodle est installé. Ce sont des valeurs communes suggérées. Moodle ne vérifie pas si les exécutables sont réellement installés à ces emplacements. Les versions récentes de Moodle affichent une marque vu ou une croix à côté du réglage des chemins, montrant si l'exécutable est présent ou non à cet emplacement. Les réglages n'ont aucun effet sur le fonctionnement de MimeTex (qui est utilisé si les exécutables ci-dessus ne sont pas trouvés).

Installation des exécutables

Cette étape dépend du système d'exploitation de votre serveur. De manière générale, vous aurez besoin d'une distribution de LaTeX. Sur un serveur Linux moderne, il s'agira de TeX Live (par exemple apt-get install texlive). TeX Live est aussi disponible pour Windows (voir TeX Live). Si TeX Live n'est pas disponible pour votre plateforme, il vous faudra installer LaTeX, Ghostscript et ImageMagick séparement. Sous Windows, vous pouvez aussi installer MikTeX.

Certains systèmes fournissent les polices dans des paquetages séparés. En cas de problèmes d'affichage, assurez-vous que toutes les polices nécessaires soient installées. Voyez en particulier si le paquetage des polices extra, qui comprend les polices mathématiques, est installé.

Préambule LaTeX

Ce champ permet d'indiquer un préambule LaTeX. Le préambule indiqué par défaut fonctionne pour la plupart des utilisateurs. Vous pouvez le modifier pour supporter d'autres encodages, etc. Veuillez consulter la documentation de LaTeX pour plus de détails.

Couleur transparente

Devrait correspondre à la couleur de fond du texte normal. Le réglage par défaut #FFFFFF, c'est-à-dire blanc.

Densité

Ce réglage modifie la taille de l'image résultante. Le réglage par défaut est 120 pixels, ce qui permet la production d'une image de qualité acceptable. Mais pour certaines équations compliquées, ce ne sera peut-être pas suffisant. Il n'est pas conseiller d'indiquer une valeur inférieure à 120 pixels.

Chemin d'accès du logiciel latex

Le chemin vers l'exécutable latex.

  • Sur les systèmes Unix ou Linux, c'est habituellement « /usr/bin/latex ».
  • Sur Mac OS X, le chemin est « /usr/texbin/latex ».
  • Sous Windows, avec MiKTeX, c'est normalement quelque chose comme « C:\texmf\miktex\bin\latex.exe ».

Chemin d'accès du logiciel dvips

Le chemin vers l'exécutable dvips, en général faisant partie de la distribution d'un système LaTeX.

  • Sur les systèmes Unix ou Linux, c'est habituellement « /usr/bin/dvips ».
  • Sur Mac OS X, le chemin est « /usr/texbin/dvips ».
  • Sous Windows, avec MiKTeX, c'est normalement quelque chose comme « C:\texmf\miktex\bin\dvips.exe ».

Chemin d'accès du logiciel convert

Le chemin vers l'exécutable convert. Cet exécutable s'installe généralement avec Ghostscript ou ImageMagick.

  • Sur les systèmes Unix ou Linux, c'est habituellement « /usr/bin/convert ».
  • Sur Mac OS X, le chemin est « /usr/local/bin/convert ».
  • Sous Windows, avec MiKTeX, c'est normalement quelque chose comme « C:\Program Files\ImageMagick\convert.exe », si vous avez installé ImageMagick. Ce sera autre chose avec GhostScript.

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.

Voir aussi

Récupérée de « https://docs.moodle.org/4x/fr/index.php?title=Notation_TeX&oldid=16209 »
Powered by MediaWiki