Lire et écrire des maths dans SPIP
Ceci est une revue de mathématiques, il est souhaitable de pouvoir y mettre des formules (en quantité limitée si possible). On a choisi d’utiliser la librairie jsMath : voici comment faire.
En bref
On utilise un système appelé jsMath. L’auteur d’un article tape simplement comme il ferait du TeX, avec des maths entre dollars, entre doubles dollars pour centrer. On peut mélanger à volonté la syntaxe SPIP et la syntaxe (La)TeX. Un petit exemple, saisissons le code SPIP suivant :
Une mesure positive $\mu$ sur $\mathbb R$ est appelée
{mesure de probabilité} si elle est de masse totale $1$,
ce qui signifie :
$$\int_{\mathbb R} \mu(\mathrm{d}x)=1.$$
On obtient le résultat suivant : Une mesure positive \mu sur \mathbb R est appelée mesure de probabilité si elle est de masse totale 1, ce qui signifie :
Pour les lecteurs
Comme son nom l’indique, jsMath repose sur JavaScript. Les visiteurs qui ne disposent pas de JavaScript (ils ne sont pas nombreux !) verront simplement le code-source en TeX. Ensuite, de deux choses l’une :
- Si le visiteur n’a rien installé de particulier, il verra les formules s’afficher correctement sous forme d’assemblages d’images (une image par caractère) téléchargées une par une depuis le serveur. Ça marche plus ou moins bien suivant la configuration de navigateur, mais dans tous les cas c’est déjà mieux que le mode <math> de SPIP.
- Si le visiteur choisit d’installer les polices mathématiques Computer Modern (disponibles en TrueType, avec un lien fourni par le bouton jsMath en bas à droite de la page), il bénéficiera d’un affichage beaucoup plus rapide, et de qualité bien meilleure - identique à du PDF fabriqué par LaTeX ! Il pourra de plus imprimer un article avec la même qualité.
Comment installer les fontes ?
Il suffit de télécharger l’une des archives TeX-fonts-XX.zip sur cette page (qui est en anglais). Selon votre système :
- Sous Windows : choisir TeX-fonts-25.zip, le désarchiver et installer les fontes qu’il contient ;
- Sous Mac OS X : choisir TeX-fonts-15.zip, le désarchiver et installer les fontes qu’il contient dans le dossier « fonts » du répertoire Bibliothèque ;
- Sous Linux : choisir l’un des fichiers, le désarchiver, et mettre les fichiers qu’il contient dans le répertoire $HOME/.fonts (à créer en cas de besoin).
Pour les auteurs
Il suffit de taper les maths comme dans (La)TeX, en entourant les formules inline de dollars et les formules centrées de doubles dollars (la notation LaTeX, qui utilise backslash-parenthèse ou backslash-crochet, fonctionne aussi). Le plugin interprète aussi certaines commandes TeX, pour faciliter le copier-coller depuis un fichier (La)TeX : essentiellement les accents et certaines commndes de mise en forme.
À terme, il est prévu que le copier-coller de code source LaTeX (sans commandes personnelles) fonctionne disons à 99%, ce qui permettra d’incorporer l’historique d’Images des Maths au site de manière agréable. En attendant, le but principal est de permettre à un matheux de contribuer au site sans apprendre toutes les finesses de SPIP. Ce qui est prévu dans un avenir plus ou moins proche :
- Écriture d’une FAQ/d’un manuel.
- Gestion des environnements (itemize, enumerate ...)
- Sectionnement LaTeX (\section ...)
Documentation technique
Tout passe par un plugin de SPIP appelé jsMath. Il est sur spip-zone ; la version courante correspond à jsMath 3.6a, et vous pouvez la télécharger ici.
Sa configuration se fait par le plugin CFG (disponible sur SPIP-contrib etc.). Quelques points à savoir si vous souhaitez vous en servir sur un site sous SPIP : le plugin contient la partie javascript de jsMath (le numéro de version du plugin suit la version de la librairie), mais il faut se préoccuper des polices Computer Modern (et éventuellement des symboles supplémentaires). Il y a en gros trois solutions dont aucune n’est parfaite :
- Ne rien installer. L’utilisateur doit se procurer les versions TrueType nécessaires pour pouvoir afficher les formules (le lien est fourni par le plugin), sinon il verra du code-source TeX accompagné d’un message d’erreur ;
- Installer les version « sprite » (une image par 128 caractères, et le navigateur se charge de découper en caractères à l’affichage). Sauf que c’est plein de bugs sur certains navigateurs ;
- Installer les versions « une image par caractère » (c’est ce qui est fait sur ce site). L’avantage est que du coup on voit les formules correctement sur tous les navigateurs ; par contre il faut compter une vingtaine de Mo rien que pour les fontes de base.
Pour tout commentaire, vous pouvez m’écrire un mail.


Syndication (RSS)