Da LaTeX a SVG

KaTeX compone la formula in HTML sul server e lo strumento racchiude tale HTML in un foreignObject SVG insieme al foglio di stile di KaTeX e ai file di caratteri woff2 necessari alla formula, incorporati come URL di dati. Larghezza e altezza derivano dalle metriche dei caratteri di KaTeX e dalla larghezza effettiva dei glifi di quei caratteri, così la tela si adatta alla formula con un piccolo margine.

Viene visualizzato in Chrome, Edge, Firefox e Safari, sia che lo usiate come elemento img, come sfondo CSS, come markup SVG inline o aprendo direttamente il file, nonché nelle app basate su un motore browser. Gli editor vettoriali e i convertitori come Inkscape, Illustrator, l'importazione SVG di Figma, librsvg e resvg non eseguono il rendering di HTML all'interno di foreignObject, quindi la formula appare vuota.

Nessuna libreria con licenza permissiva nello stack di questo strumento dispone le formule matematiche di KaTeX come contorni di glifi, e un compositore tipografico separato non riprodurrebbe l'output di KaTeX. Incorporare HTML mantiene esattamente spaziatura e caratteri. Se un editor vettoriale richiede i contorni, aprite l'SVG in un browser e stampatelo in PDF: la formula rimane composta da forme vettoriali che gli editor possono importare.

La modalità display compone la formula come equazione indipendente: gli operatori grandi hanno i limiti sopra e sotto, le frazioni mantengono le dimensioni normali e sono ammessi i numeri \tag. La modalità inline usa lo stile compatto del testo, pensato per le formule all'interno di una frase, con frazioni più piccole e limiti posizionati accanto a somme e integrali.

Imposta la dimensione del carattere matematico in pixel, da 8 a 200, come numero intero; il valore predefinito è 24. Larghezza e altezza dell'SVG aumentano in proporzione, quindi una formula renderizzata a 48 pixel è grande il doppio rispetto a una a 24. Poiché il risultato è basato su vettori, potete ridimensionarlo in seguito con CSS.

Tutti quelli supportati da KaTeX 0.19.1: frazioni, radici, somme e integrali, matrici e ambienti come aligned, cases, pmatrix e array, accenti, frecce, \mathbb, \mathcal, \mathfrak, \text, \color e \tag. Potete definire macro personalizzate con \def o \newcommand all'interno della formula. I documenti completi, \usepackage, TikZ e i comandi \ce di mhchem non sono disponibili.

Non viene prodotto alcun file e lo strumento indica che cosa è andato storto e in quale carattere, contando da 1. Segnala i comandi sconosciuti, le parentesi graffe non bilanciate, i doppi apici e i comandi a cui manca un argomento, così potete passare direttamente al punto interessato e correggerlo.

Una formula può contenere fino a 10,000 caratteri, le macro possono espandersi al massimo 1,000 volte e le dimensioni indicate a comandi come \rule, \kern e \hspace sono limitate a 100em. I comandi che caricano o collegano contenuti esterni, come \href, \url e \includegraphics, sono disattivati e appaiono come testo rosso non supportato.

Lo sfondo è trasparente. Quando incollate il markup SVG in una pagina HTML, la formula assume il colore del testo dell'elemento circostante; come file immagine, invece, viene disegnata in nero. Usate \color o \textcolor all'interno della formula per impostare colori che rimangano invariati ovunque.

Ogni file include il foglio di stile di KaTeX, di circa 24 KB, e tutti i caratteri usati dalla formula incorporati come woff2 in base64: una formula tipica occupa da 75 a 150 KB. Per i caratteri non inclusi nei font di KaTeX, come il cinese o il giapponese all'interno di \text, vengono usati i font del visualizzatore. L'SVG ha il ruolo img, con il sorgente LaTeX come titolo e aria-label per gli screen reader.