Texvc PHP Alternative/fr

Vue d'ensemble
MediaWiki utilise un programme supplémentaire, Texvc, pour transformer les expressions mathématiques en des images, ce qui est plus pratique pour l'affichage. Malheureusement, texvc doit être compilé et est écrit en Ocaml, ce qui peut causer un problème pour la majorité des hôtes publics même si toutes les autres conditions sont remplies (ghostscript, latec, etc). Ce contournement remplace le code de présentation de maths par une version PHP intégrée, effectuant toutes les manipulations d'images, les rendus, etc. que Texvc ferait normalement.

Limitations
Ce "hack" ne vous dispense, pas d'utiliser "latex", "dvips", et "convert" (ces trois commandes unix sont nécessaires), mais d'avoir à obtenir l'accès pour pouvoir installer Ocaml et pour compiler texvc. Bien que ce hack conserve la mise en cache de l'image, la plupart des autres fonctionnalités disponibles pour le rendu mathématique ont été perdues et de légères différences apparaissent entre l'image finale et l'image de sortie. Une différence notable est que seules des images sont produites, le projet MyMCAT ne s'intéressait pas aux sorties MathML ou texte des formules, et ces options ont donc été supprimées.



Comment ça marche
En gros, dans Math.php, la fonction d'affichage ne comporte plus d'appels à texvc et PHP fait tous les appels directement aux fonctions nécessaires.



Comment l'installer
Voici ci-dessous une copie de la source dans Math.php. Vous devrez vous assurer que vous avez un répertoire en état de marche et que les commandes shell fonctionnent correctement pour que ceci marche. Si vous avez précédemment essayé d'installer texvc, il faut remplacer le Math.php dans includes/Math.php. Si il n'existe pas encore, vous devriez le créer avec les éléments ci-dessous.ßß



Bogues connus
À part que les paramètres ne peuvent pas être passés à ce script, et que le rendu est parfois légèrement différent d'autres rendus latex, il y a quelques autres problèmes mineurs: - Parfois des avertissements PHP sont affichés sur la page lorsque vous affichez des maths. Je crois avoir ce problème car je fais ma gestion de fichiers dans /usr/temp, ce qui n'est pas vraiment le bon endroit. Cet avertissement n'apparaît qu'une seule fois et le rendu reste correct. - Si vous supprimez manuellement toutes les images dans le dossier cache vous obtenez des avertissements la première fois que Math.php doit les afficher à nouveau mais, encore une fois, le rendu reste correct et les avertissements disparaissent.



Paquet nécessaire Texlive
Pour ceux qui ne savent pas comment tex fonctionne, si vous utilisez texlive pour créer du latex qui marche, vous devrez aussi installer certain packages:
 * "graphics"
 * "pst-plot"
 * "xkeyval"
 * "PSTricks"
 * "multido"

Et peut-être d'autres selon comment vous avez installé texlive.



Exemple actif
Ce travail a été effectué pour MyMCAT. Vous purvez voir un exemple spécifique du rendu sur Le Passage Railgun.

Remerciements
Ce hack est basé sur l'article du journal linux http://www.linuxjournal.com/article/7870 par Titus Barik.