LaTeX SVG-vé alakítása

A KaTeX a képletet HTML-re szedi a szerveren, az eszköz pedig ezt a HTML-t SVG foreignObject elembe csomagolja a KaTeX stíluslapjával és a képlethez szükséges woff2 betűkészlet-fájlokkal együtt, data URL-ként beágyazva. A szélesség és a magasság a KaTeX betűmetrikáiból és a betűkészletek tényleges karakter-szélességéből származik, így a vászon kis margóval illeszkedik a képlethez.

Megjelenik a Chrome, Edge, Firefox és Safari böngészőben, akár img elemként, CSS háttérként, soron belüli SVG-jelölésként használja, akár közvetlenül nyitja meg a fájlt; böngészőmotorra épülő alkalmazásokban is működik. Az olyan vektorszerkesztők és konverterek, mint az Inkscape, az Illustrator, a Figma SVG-importja, a librsvg és a resvg nem jelenítik meg a HTML tartalmát a foreignObject elemen belül, ezért a képlet üresen jelenik meg.

Ennek az eszköznek a technológiai csomagjában nincs olyan megengedő licencű könyvtár, amely a KaTeX matematikai képleteit glifakontúrokká alakítaná, egy külön szedőprogram pedig nem adná vissza a KaTeX kimenetét. A KaTeX saját HTML beágyazása megőrzi a pontos térközöket és betűtípusokat. Ha egy vektorszerkesztőnek körvonalakra van szüksége, nyissa meg az SVG-t egy böngészőben, és nyomtassa PDF-be; így a képlet vektoros alakzatként marad meg, amelyet a szerkesztők importálni tudnak.

A display mód önálló egyenletként szedi a képletet: a nagy operátorok határai fölé és alá kerülnek, a törtek teljes méretűek maradnak, és a \tag számozás is használható. Az inline mód a mondatba illesztett képletekhez való tömör szövegstílust használja, kisebb törtekkel, valamint az összegek és integrálok mellé helyezett határokkal.

A matematikai betűk méretét állítja be képpontban, 8 és 200 között, egész számként; az alapértelmezett érték 24. Az SVG szélessége és magassága ezzel együtt változik, ezért egy 48 képpont méretű képlet kétszer akkora, mint egy 24 képpont méretű. Mivel az eredmény vektoros, később is átméretezheti a CSS segítségével.

Minden, amit a KaTeX 0.19.1 támogat: törtek, gyökök, összegek és integrálok, mátrixok, valamint olyan környezetek, mint az aligned, cases, pmatrix és array, ékezetek, nyilak, \mathbb, \mathcal, \mathfrak, \text, \color és \tag. Saját makrókat is definiálhat a \def vagy a \newcommand segítségével a képleten belül. Teljes dokumentumok, a \usepackage, a TikZ és az mhchem \ce parancsai nem használhatók.

Nem készül fájl, az eszköz pedig megmondja, mi romlott el, és melyik karakterhelyen, az 1-től számítva. Megnevezi az ismeretlen parancsokat, a kiegyensúlyozatlan kapcsos zárójeleket, a dupla felső indexeket és az argumentum nélküli parancsokat, így rögtön a hibás helyre ugorhat és kijavíthatja.

A képlet legfeljebb 10,000 karakter hosszú lehet, a makrók legfeljebb 1,000 alkalommal bonthatók ki, a \rule, \kern és \hspace jellegű parancsoknak megadott méretek felső határa pedig 100em. A külső tartalmat betöltő vagy arra hivatkozó parancsok, például a \href, a \url és a \includegraphics le vannak tiltva, és nem támogatott, piros szövegként jelennek meg.

A háttér átlátszó. Ha az SVG jelölését beilleszti egy HTML oldalra, a képlet a környező elem szövegszínét veszi fel; képfájlként pedig feketén jelenik meg. A képleten belül a \color vagy a \textcolor paranccsal olyan színeket állíthat be, amelyek mindenhol változatlanok maradnak.

Minden fájl tartalmazza a KaTeX körülbelül 24 KB-os stíluslapját, valamint az összes használt betűkészletet base64 woff2 formátumban, így egy tipikus képlet 75–150 KB. A KaTeX betűkészleteiből hiányzó karakterek, például a \text részeként használt kínai vagy japán karakterek, a megjelenítő saját betűkészleteit használják. Az SVG role értéke img, címe a LaTeX-forrás, és képernyőolvasók számára aria-label attribútumot is tartalmaz.