Mode d’emploi
Le plugin prend en charge les formules mathématiques au format Tex dans les contenus SPIP.
Par exemple
Si on note $dm$ la masse du tronçon et $\ddot{y}$ son accélération alors le principe de la dynamique nous donne une première relation :
$$
d\vec{F} = dm \ddot{\vec{y}}
$$
Mais comme le signe $
qui délimite les formules au format Tex est un signe commun qui peut être présent dans du contenu éditorial sans indiquer une formule mathématique, il faut encadrer les contenus que l’on veut traiter par une balise <math>...</math>
La plupart du temps, si vous n’avez pas de signe $
autre dans votre texte, vous pouvez encadrer tout le texte
<math>
Si on note $dm$ la masse du tronçon et $\ddot{y}$ son accélération alors le principe de la dynamique nous donne une première relation :
$$
d\vec{F} = dm \ddot{\vec{y}}
$$
</math>
Et les formules seront ainsi transformées comme suit
Par ailleurs sur chaque formule un menu contextuel disponible au clic droit vous permet d’exporter la formule dans le format Tex ou MathML, ainsi que d’accéder à d’autres options
Modèle <math|f=...>
Alternativement à la syntaxe historique de SPIP, il est possible aussi d’utiliser un modèle pour insérer des formules inline sour la forme <math|f=...votre_formule en latex...>
Exemple
<math|f=t=\frac{d}{V_{A}+V_{B}}=\frac{70}{80+60}=\frac{70}{140}=0,5\ h=30\ minutes→12h\ 30\ min>
donne
Cette syntaxe est issue du plugin mathjax_latex, qui devient obsolète par la même occasion, tous les utilisateurs pouvant utiliser ce plugin MathJax et l’une ou l’autre syntaxe selon leur préférence
Configuration
Le plugin peut-être configuré pour utiliser la version CDN de mathjax (par défaut) ou une version téléchargée dans le dossier lib/ de votre site
Configuration avancée de MathJax 3
Si vous voulez utiliser la librairie MathJax de façon avancée, au delà de ce qui est prévu par le plugin, vous pouvez surcharger le fichier js/mathjax-config.json en en mettant une copie dans votre dossier squelettes/ et le modifier à votre guise pour y ajouter les options que vous souhaitez.
Par ailleurs, le plugin utilise par défaut le composant tex-chtml via le fichier tex-chtml.js https://docs.mathjax.org/en/latest/web/components/combined.html#tex-chtml Si votre usage le nécessite vous pouvez utiliser un autre composant, via un define dans votre fichier mes_options.php
define('_MATHJAX_LIB_COMPONENTS','tex-svg.js');
Le plugin chargera alors ce composant à la place de celui par défaut
Discussions par date d’activité
3 discussions
Bonjour,
je viens de passer à spip4.1(et à php8.1 pour cette occasion)) et votre plugin est compatible, après avoir changé sa borne de compatibilité, il fonctionne ; avec cependant sans doute encore le problème que j’ai signalé quand on met du LaTeX dans une description d’une image.
Pouvez-vous faire le changement de bornes de compatibilité, [3.0.0 ;4.1.*] ?
Merci encore une fois pour ce plugin qui nous permet d’utiliser de belles formules mathématiques.
Cordialement,
Je viens de sortir la version v1.4.0 compatible avec SPIP 4
Merci de vérifier si vous ne recontrez pas de bugs
Bonjour,
merci pour cette mise à jour qui fonctionne correctement sur les articles que j’ai regardé. Par exemple :
https://www.apmep-iledefrance.fr/Statistiques-en-IUT
Cependant, il y a toujours le bug signalé en août 2021 dans la description des images (par contre il n’y a pas ce bug dans le texte des articles, comme celui ci-dessus). Par exemple, la description de la Figure 2 de cet article :
https://www.apmep-iledefrance.fr/Les-fractions-comme-objet-geometrique-les-rectangles-elastiques-poses-1re
En fait,
$\frac{-2}{-3}$
ne fonctionne pas et si on veut correctement affiché la fraction dans la description d’un document, il faut rajouter des échappements pour les accolades :$\frac\{-2\}\{-3\}$
. C’est ce que j’ai fait pour les autres images, comme la Figure 3.Cordialement,
Michel Suquet
J ’ai juste fait la maintenance de base
Merci pour le rapport de bug. Il faudrait que les auteurs regardent en détail.
Sinon il me semble qu’il existe aussi un syntaxe avec 2 « $ » pour passer des formules à la ligne .
Cela donnerait donc
$$\frac{-2}{-3}$$
oui, cela permet de centrer une formule sur une ligne. C’est d’ailleurs utilisé dans l’article « statistiques en IUT ».
Savez-vous comment contacter les auteurs de ce plugin ?
En postant sur ce forum c’est déjà bien :) Sinon vous pouvez écrire un ticket sur la forge :
https://git.spip.net/spip-contrib-extensions/mathjax/issues
Essayez d’être le plus précis possible. Merci.
Je veux bien écrire un ticket mais je n’ai pas de compte et le bouton « créer un compte » n’est pas actif.
lire https://www.spip.net/fr_article825.html#S-inscrire-sur-git-spip-net
je me suis inscrit mais je ne peux pas me connecter. Je ne sais pas pourquoi.
Les auteurs du plugin ne lisent pas les messages sur la page du plugin ?
Cordialement,
C’est du logiciel libre ... Les auteurs n’ont pas forcement la disponibilité pour mettre à jour tous les plugins. Il faut qu’une äme charitable qui se penche sur votre bug :)
Pour commencer, j’’ai crée le ticket pour vous
https://git.spip.net/spip-contrib-extensions/mathjax/issues/2
OK pour le logiciel libre, je suis tout à fait d’accord.
Et merci pour le ticket. J’aimerai bien savoir comment mettre les mains dans le cambouis et j’espère pouvoir le faire à partir du mois de janvier car je serai à la retraite. Reste à trouver une âme charitable qui pourra me montrer comment programmer un plugin pour spip ; ce ne doit pas être très compliqué, une fois qu’on a pigé 2/3 trucs :-)
Cordialement,
Hello Michel
Un bon moyen pour commencer
https://programmer.spip.net/
Ensuite ne pas hésiter à aller sur IRC ou sur les listes
Les liens (listés en peu en vrac)
https://www.spip.net/site65
Lire aussi
Bonjour,
ce message juste pour dire que le bug a été corrigé : voir le ticket à ce sujet et la discussion associée pour les explications.
J’ai supprimé les échappements devant les
{
et les}
et maintenant ça marche®.C’est Maïeul qui a repéré le bug (de spip) et l’a corrigé : merci à lui !
Cordialement,
Michel Suquet
Merci pour le retour !
Répondre à ce message
Bonjour,
je viens de mettre à jour, sur un spip4.1, le plugin en version 1.5 (c’est celui qui est proposé pour la mise à jour) et il y a une erreur :
Erreur d’exécution ../prive/objets/contenu/article.html | File […]/plugins/auto/mathjax/v1.5.0/inc/math.php Line 87 : Call to undefined function str_contains()
Sur cette page :
https://test.apmep.fr/Concours-Advance
je vois qu’il y a un problème avec le squelette qu’on utilise :
Erreur d’exécution plugins/spipr-dane-noisettes/noisettes/article-contenu.html | File […]/plugins/auto/mathjax/v1.5.0/inc/math.php Line 87 : Call to undefined function str_contains()
Ainsi que sur cette page :
https://test.apmep.fr/Annales-des-concours-niveau-Terminale
1 Erreur d’exécution plugins/spipr-dane-noisettes/noisettes/rubrique-texte.html | File […]/plugins/auto/mathjax/v1.5.0/inc/math.php Line 87 : Call to undefined function str_contains() 2 Erreur d’exécution plugins/auto/metasplus/v2.4.5/inclure/metasplus/dist.html | File […]/plugins/auto/mathjax/v1.5.0/inc/math.php Line 87 : Call to undefined function str_contains()
S’il faut plus de détails, merci de m’indiquer lesquels sont nécessaires.
Cordialement,
Michel Suquet
Hop,
effectivement c’est une fonction disponible uniquement en PHP 8 ou spip 4.2, mais pas en SPIP 4.1 + PHP 7.4.
J’ai ouvert un ticket en ce sens, pour que cerdic qui a bossé dessus il y a peu soit au courant.
Pour résoudre ce problème, si on passe en php8 cela suffit ?
À+,
Michel Suquet
on est passé en php8.1 sur notre site de test et avec la version 2.0.0 du plugin : c’est bon, plus d’erreur. On va faire de même sur le site officiel.
Qu’apporte la 2.0.0 par rapport à la 1.5.0 ?
Répondre à ce message
Bonjour,
Je viens de faire une mise à jour de SPIP 4.0 vers 4.1 puis 4.2 et je me retrouve dans une configuration où MathJax ne fonctionne que si je désactive la compression des scripts javascript.
J’héberge en local ma bibliothèque MathJax dans lib/mathjax/ (sans passer par un CDN).
Dans le cas où je désactive la compression des scripts, je n’ai aucune erreur dans la console du navigateur (juste un warning)
Dans le cas où j’active la compression des scripts, j’ai deux erreurs 404 qui apparaissent.
GET https://poivron-robotique.fr/extensions/MathMenu.js?V=2.7.8
GET https://poivron-robotique.fr/extensions/MathZoom.js?V=2.7.8
Au lieu d’aller chercher les scripts dans example.com/lib/mathjax/extension, la requête pointe vers example.com/extension
Quelqu’un a une solution pour ce soucis ?
Répondre à ce message
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires : |