Sarmate.net Sarmate.net
Accueil Fonctionnalités Offres Documentation Contact
Connexion Inscription
Pratique 10 min

Convertir un .tex en mathpad

Si vous avez déjà des cours LaTeX, pas besoin de tout réécrire : Sarmate lit votre .tex et produit un document HTML mathpad complet — structure, définitions, théorèmes, exercices, bibliographie, figures (compilées en images PNG). Vous récupérez d'un coup le rendu responsive, KaTeX, mp-vartable, Python dans le navigateur, sans réécrire le cours.

Lancer la conversion en 4 étapes

  1. Importer le fichier Si votre fichier n'est pas dans votre drive en ligne, cliquez sur + Importer un fichier et choisissez votre .tex (plus, le cas échéant, le .bib et les dossiers d'images — sélectionnez le tout en une fois).
  2. Ouvrir dans l'éditeur LaTeX Cliquez sur le nom du fichier — il s'ouvre dans mathpad_tex_edit.php. Cliquez d'abord sur Compiler pour vérifier que le fichier compile proprement (sinon le convertisseur va aussi caler).
  3. Lancer le convertisseur Dans le sélecteur de compilateur en haut, choisissez sarmateWeb (HTML), puis cliquez sur Compiler. Sarmate lit le fichier, compile les figures tikz/pstricks/pgfplots, génère un nouveau fichier basename_sarmateweb.html dans le même dossier.
  4. Ouvrir dans l'éditeur mathpad Une petite notification apparaît avec un lien Ouvrir dans l'éditeur qui charge le fichier généré dans mathpad_php_edit.php. Vous y affinez ce qui doit l'être, ajoutez un quiz, un tableau de variations à l'échelle, un graphique interactif, un bloc Python.

Ce qui est converti automatiquement

LaTeXmathpad HTMLNote
\chapter{}<mp-chapter>avec titre dans <mp-title>
\section{} / \subsection{}<mp-section> / <mp-subsection>Numérotation auto
\begin{definition} … \end<mp-definition>idem theorem, property, lemma, remark, method
\begin{exercise|exo|exercice}<mp-exercise> + <mp-statement>Les corrections sont aussi captées (\corrige, \correction)
\begin{itemize|enumerate}<ul> / <ol>HTML standard
\begin{tabular}<table class="tp-table">Colonnes et filets conservés
\begin{tikzpicture}<mp-figure> + PNGCompilation serveur en PNG, intégré dans mp-figure
\begin{pspicture}<mp-figure> + PNGidem pstricks
\begin{align*} / $...$ / $$...$$<mp-align> / $...$ / $$...$$Rendus par KaTeX dans le navigateur
\footnote{}<mp-footnote>Rassemblées en bas du chapitre
\bibliography{ref} + .bib<mp-bibliography>Chaque entrée → <mp-cite-entry>
\ref{} / \cite{}<mp-ref target="..."> / <mp-cite ref="...">Références internes et externes préservées
Commandes personnalisées Le convertisseur reconnaît les patterns classiques d'un large éventail de templates scolaires français (APMEP, MPSI, Terminale spé, ST2S, avec leurs variantes de packages exercice, de thèmes theorem, etc.). Si un \newcommand vous semble exotique, signalez-nous les patterns que vous utilisez — le convertisseur se durcit au fil des projets.

Figures : pipeline PNG

Une figure tikz/pstricks/pgfplots est isolée sur le serveur dans un document LaTeX minimal, compilée en PDF, convertie en PNG (200 DPI) et embarquée dans une <mp-figure> du HTML généré. Vous obtenez au final une image PNG nette qui correspond au pixel près à ce que votre PDF affiche, avec la même police et les mêmes couleurs.

Quand réécrire un tikz en JSXGraph ? Si la figure est simple (courbe de fonction, deux points, un cercle), la réécrire en mp-jsxgraph donne un résultat encore plus léger, net au zoom, modifiable ensuite. Pour une figure complexe (plusieurs couches de décorations tikz, hachures, marqueurs), la PNG produite par le convertisseur reste la solution la plus solide.

Limites connues

Si la conversion échoue La modale affiche un message d'erreur avec un bloc debug dépliable (chemins serveur, paquet incriminé, ligne en erreur). Cause fréquente : un paquet non reconnu dans le préambule — retirez-le du .tex et réessayez, ou signalez-nous le pattern pour que le convertisseur l'apprenne.

Conversion via une IA (MCP)

Vous pouvez déclencher la même conversion depuis votre assistant IA (Claude, ChatGPT, Mistral, Gemini, Cursor, Le Chat…) connecté à votre compte via le serveur MCP Sarmate. Trois modes disponibles, coût en tokens croissant :

Configurer MCP pour Sarmate Un guide dédié vous accompagne pas à pas pour brancher Claude, ChatGPT, Gemini, Mistral ou Cursor à votre drive Sarmate : documentation MCP complète pour Sarmate (jeton Bearer, configuration par client, outils compatibles).
  1. Convertisseur seul — l'IA appelle la conversion et c'est tout, comme le bouton sarmateWeb (HTML) décrit plus haut. Quasi aucun token consommé (juste l'appel à l'outil), rapide, déterministe. Traite parfaitement la majorité des documents math scolaires standards.
  2. Hybride — l'IA appelle d'abord le convertisseur, puis lit le HTML généré et l'améliore : elle corrige les résidus KaTeX, complète les patterns non détectés, adapte un endroit à vos exigences. Le coût en tokens varie avec la profondeur du polish — léger pour les documents propres, plus lourd pour ceux avec des environnements inhabituels. Meilleur compromis pour la majorité des cas délicats.
  3. 100 % IA — l'IA n'appelle PAS le convertisseur — elle lit la source .tex et produit le HTML mathpad entièrement elle-même. Elle charge d'abord la spécification des balises <mp-*>, puis réécrit le squelette complet from scratch. Coût en tokens le plus élevé (sortie HTML complète) mais utile pour des documents très exotiques que le convertisseur ne traitera probablement pas.
Quel mode choisir ? L'IA doit vous proposer les trois modes avant de lancer la conversion, avec l'ordre de grandeur de son propre coût en tokens (variable selon le modèle : Claude, GPT, Le Chat…). Vous décidez selon votre budget. En cas de doute : l'hybride offre le meilleur rapport coût/qualité.

Éditer et enrichir via l'IA

Une fois le fichier HTML obtenu, vous pouvez demander n'importe quelle tâche supplémentaire à votre IA en langage libre : « Ajoute un quiz après le théorème des valeurs intermédiaires », « Convertis le premier tikz en mp-jsxgraph », « Réécris cette remarque en <mp-box style="info"> », « Traduis le cours en anglais ». L'IA modifie le fichier directement dans votre drive Sarmate via MCP.

Lancer votre première conversion

Uploadez votre .tex dans votre drive Sarmate et cliquez sur → HTML mathpad. En quelques minutes, votre cours est dans un format responsive, interactif, lisible depuis votre téléphone.