Gemini, WordPress, scritture matematiche e KaTeX

di

Dialogo con Gemini.

Ciao, stiamo pubblicando gli articoli in WordPress, ma c’è un enorme problema con il copiare le espressioni matematiche. Hai qualche proposta?

Il problema nasce dal fatto che l’editor a blocchi (Gutenberg) di WordPress non interpreta nativamente la sintassi matematica (LaTeX o MathML); se si incolla da Word, PDF o editor esterni, WordPress tenta di convertire le formule in codice HTML destrutturato o immagini rasterizzate sgranate.

1. Rendering client-side con KaTeX (La soluzione più efficiente)

Invece di incollare immagini o formattazioni ricche, il metodo standard consiste nell’incollare il testo in formato sorgente LaTeX delimitato da dollari ($...$ per formule inline, $$...$$ per formule in blocco centrato) e lasciare che il browser dell’utente renderizzi la grafica vettoriale al volo.

  • Vantaggio: KaTeX è sincrono e sensibilmente più rapido di MathJax, azzerando i ritardi di caricamento del layout (CLS).
  • Via Plugin: Installare un plugin leggero come KaTeX (es. di Liam Carberry) che abilita l’elaborazione automatica degli shortcode o dei delimitatori.
  • Via Codice (functions.php): Se si preferisce evitare plugin superflui, basta accodare lo script e il foglio di stile di KaTeX da CDN nell’hook wp_enqueue_scripts, aggiungendo l’estensione auto-render per parsare automaticamente i blocchi di testo.

2. Blocchi dedicati in Gutenberg

Se chi redige i post preferisce vedere l’anteprima visiva durante la scrittura:

  • Utilizzare un plugin di blocchi dedicati come WP QuickLaTeX o estensioni Gutenberg per blocchi KaTeX/MathJax.
  • Consentono di inserire un blocco “Math” in cui incollare direttamente la sintassi TeX, visualizzando l’anteprima corretta prima della pubblicazione.

3. Gestione del formato sorgente (Pipeline di importazione)

Il modo migliore di procedere dipende da dove provengono i documenti:

  • Da file LaTeX (.tex) o Markdown: La soluzione più pulita è convertire l’intero articolo in formato HTML pulito o blocchi Gutenberg tramite Pandoc:pandoc articolo.tex -f latex -t html --mathjax -o articolo.htmlIl file HTML risultante può essere incollato direttamente in un blocco “HTML personalizzato” o convertito in blocchi nativi.
  • Da Microsoft Word (.docx): Word memorizza le formule in formato OMML. Il semplice copia-incolla copia metadati proprietari illeggibili per il web. In questo caso, passare il file .docx attraverso Pandoc converte automaticamente le formule native di Word in sintassi LaTeX pulita:pandoc documento.docx -f docx -t markdown -s -o output.md

Da quale formato state copiando i testi attuali (documenti Word, file .tex compilati, appunti in Markdown o PDF)? Sapere la sorgente permette di impostare il flusso di conversione più rapido ed evitare di ritoccare le formule una ad una.

I documenti provengono solo dal tuo contesto: la box di Gemini…

Il problema con il copia-incolla diretto dall’interfaccia di Gemini nasce da due fattori distinti:

  1. La selezione con il cursore: Selezionando il testo a schermo con il mouse, il browser copia il codice HTML/SVG o MathML generato dal motore grafico di Gemini. Gutenberg non sa interpretarlo e lo incolla come frammenti HTML rotti o testo deformato.
  2. Il rendering mancante in WordPress: Se invece copi il testo sorgente, WordPress riceve formule in formato LaTeX grezzo ($...$ o $$...$$) che il tema tratta come semplice testo piatto, senza renderizzarle.

1. La procedura corretta per copiare da Gemini

  • Usa il pulsante “Copia” in basso: Non selezionare il testo trascinando il mouse. Clicca sull’icona degli appunti (pulsante Copia) situata sotto la risposta di Gemini. Questo copia negli appunti il Markdown originale pulito con i delimitatori LaTeX intatti, evitando di trascinare il layout HTML sporco.
  • Oppure chiedi l’output in blocco codice: Puoi chiedermi esplicitamente di racchiudere l’intero articolo in un blocco di codice (```). In questo modo il testo non viene renderizzato nell’interfaccia e puoi copiarlo integro senza interferenze del browser.

2. Configurare WordPress per interpretare il testo copiato

Una volta incollato il testo con la sintassi LaTeX standard ($...$ per formule inline, $$...$$ per formule su riga propria), WordPress ha solo bisogno di un motore che le renderizzi graficamente ai visitatori.

  • Opzione più leggera (Consigliata) – Plugin KaTeX:
    • Installa il plugin KaTeX (sviluppato da Liam Carberry o simili).
    • Attiva l’opzione per il parsing automatico dei delimitatori standard ($...$ e $$...$$).
    • Incolla il testo copiato da Gemini direttamente nei normali blocchi di testo/paragrafo di Gutenberg. WordPress lascerà il testo invariato nel database e KaTeX renderizzerà le formule in vettoriale ultrarapido sul front-end.
  • Opzione per anteprima in Gutenberg – Blocco Math dedicato:
    • Installa un’estensione come MathBlock o WP QuickLaTeX.
    • Permette di inserire un blocco /math in Gutenberg in cui incollare l’espressione, mostrando l’anteprima visuale direttamente nell’editor prima di pubblicare.
  • Opzione shortcode (Nessuna configurazione delicata):
    • Se usi plugin come Jetpack o QuickLaTeX che usano shortcode proprietari (es. formula), dimmelo prima di generare l’articolo: genererò il testo già formattato con i tag esatti richiesti dal tuo plugin, così ti basterà incollarlo.

Vuoi che i prossimi testi siano formattati direttamente per uno shortcode specifico (es. ...), oppure preferisci adottare il parsing automatico di KaTeX con $ ... $?

Ottimo, grazie: ho installato KaTeX e userò l’icona copia.

Perfetto. Un piccolo accorgimento tecnico: molti plugin KaTeX hanno l’elaborazione del dollaro singolo ($...$) disattivata di default nelle impostazioni per evitare conflitti con i simboli di valuta, richiedendo invece \( ... \) per l’inline oppure $$...$$ per il blocco.

Per verificare subito se il parser è attivo e configurato a dovere, puoi incollare questa stringa di test in un articolo di prova:

  • Formula inline: $E = mc^2$
  • Formula a blocco:
    \int_{-\infty}^{\infty} e^{-x^2} \, dx = \sqrt{\pi}

Verifica: Visualizza l’anteprima o la pagina pubblicata nel browser (non l’editor di bozza): se le espressioni appaiono con il font tipografico matematico e i simboli d’integrazione vettoriali, il sistema funziona. In caso contrario (se vedi ancora i dollari di testo grezzo), entra nelle impostazioni del plugin KaTeX in WordPress e spunta l’opzione per abilitare il parsing del delimitatore $.