Convertire un .tex in mathpad
Se hai già corsi LaTeX, non serve riscrivere tutto: Sarmate legge il suo .tex e produce un documento HTML mathpad completo — struttura, definizioni, teoremi, esercizi, bibliografia, figure (compilate in immagini PNG). Recuperi in un colpo solo il rendering responsive, KaTeX, mp-vartable, Python nel browser, senza riscrivere il corso.
Avviare la conversione in 4 passaggi
- Importare il file
Se il suo file non è nel suo drive online, clicca su + Importi un file e scelga il suo
.tex(più, se necessario, il.bibe le cartelle delle immagini — selezionali tutti in una volta). - Aprire nell'editor LaTeX
Clicchi sul nome del file — si apre in
mathpad_tex_edit.php. Clicchi prima su Compila per verificare che il file compili correttamente (altrimenti anche il convertitore si bloccherà). - Avviare il convertitore
Nel selettore del compilatore in alto, scelga sarmateWeb (HTML), poi clicca su Compila. Sarmate legge il file, compila le figure tikz/pstricks/pgfplots, genera un nuovo file
basename_sarmateweb.htmlnella stessa cartella. - Aprire nell'editor mathpad
Compare una piccola notifica con un link Apra nell'editor che carica il file generato in
mathpad_php_edit.php. Lì rifinisci ciò che va rifinito, aggiunga un quiz, una tabella di variazione in scala, un grafico interattivo, un blocco Python.
Ciò che viene convertito automaticamente
| LaTeX | mathpad HTML | Nota |
|---|---|---|
| \chapter{} | <mp-chapter> | con titolo in <mp-title> |
| \section{} / \subsection{} | <mp-section> / <mp-subsection> | Numerazione automatica |
| \begin{definition} … \end | <mp-definition> | idem theorem, property, lemma, remark, method |
| \begin{exercise|exo|exercice} | <mp-exercise> + <mp-statement> | Anche le correzioni vengono catturate (\corrige, \correction) |
| \begin{itemize|enumerate} | <ul> / <ol> | HTML standard |
| \begin{tabular} | <table class="tp-table"> | Colonne e filetti conservati |
| \begin{tikzpicture} | <mp-figure> + PNG | Compilazione sul server in PNG, integrato in mp-figure |
| \begin{pspicture} | <mp-figure> + PNG | idem pstricks |
| \begin{align*} / $...$ / $$...$$ | <mp-align> / $...$ / $$...$$ | Renderizzati da KaTeX nel browser |
| \footnote{} | <mp-footnote> | Raccolte in fondo al capitolo |
| \bibliography{ref} + .bib | <mp-bibliography> | Ogni voce → <mp-cite-entry> |
| \ref{} / \cite{} | <mp-ref target="..."> / <mp-cite ref="..."> | Riferimenti interni ed esterni preservati |
Figure: pipeline PNG
Una figura tikz/pstricks/pgfplots viene isolata sul server in un documento LaTeX minimale, compilata in PDF, convertita in PNG (200 DPI) e incorporata in un <mp-figure> dell'HTML generato. Alla fine ottieni un'immagine PNG nitida che corrisponde pixel per pixel a ciò che mostra il suo PDF, con lo stesso font e gli stessi colori.
Limiti noti
- Pacchetti molto esotici (ad esempio macro auto-modificanti, segnalibri PDF hyperref) vengono aggirati — il convertitore li salta e lascia un commento
<!-- TODO -->. - Immagini con percorso (\includegraphics) devono essere caricate nella stessa posizione del .tex, altrimenti immagine vuota.
- File molto lungo (> 5000 righe): la compilazione dei PNG può richiedere diversi minuti.
- La conversione JSXGraph tikz → mp-jsxgraph non viene ancora fatta automaticamente (a mano).
Conversione tramite un'IA (MCP)
You can trigger the same conversion from your AI assistant (Claude, ChatGPT, Mistral, Gemini, Cursor, Le Chat…) connected to your account through the Sarmate MCP server. Three modes available, with increasing token cost:
- Solo il convertitore — l'IA richiama la conversione e basta, come il pulsante sarmateWeb (HTML) descritto sopra. Quasi nessun token consumato (solo la chiamata allo strumento), veloce, deterministico. Elabora perfettamente la maggior parte dei documenti di matematica scolastici standard.
- Ibrido — l'IA richiama prima il convertitore, poi legge l'HTML generato e lo migliora: corregge i residui KaTeX, completa i pattern non rilevati, adatta un punto alle sue esigenze. Il costo in token varia in base alla profondità della rifinitura — leggero per i documenti puliti, più pesante per quelli con ambienti insoliti. Il miglior compromesso per la maggior parte dei casi delicati.
- 100 % IA — l'IA NON richiama il convertitore — legge il sorgente .tex e produce l'HTML mathpad interamente da sola. Carica prima la specifica dei tag
<mp-*>, poi riscrive lo scheletro completo da zero. Costo in token più elevato (output HTML completo) ma utile per documenti molto esotici che il convertitore probabilmente non elaborerà.
Modificare e arricchire tramite l'IA
Una volta ottenuto il file HTML, può chiedere alla sua IA qualsiasi altra attività in linguaggio libero: « Aggiunga un quiz dopo il teorema dei valori intermedi », « Converti il primo tikz in mp-jsxgraph », « Riscrivi questa osservazione come <mp-box style="info"> », « Traduci il corso in inglese ». L'IA modifica il file direttamente nel suo drive Sarmate tramite MCP.
Avviare la sua prima conversione
Carica il suo .tex nel suo drive Sarmate e clicca su → HTML mathpad. In pochi minuti, il suo corso sarà in un formato responsive, interattivo e leggibile dal telefono.