LaTeX till SVG

KaTeX formaterar formeln till HTML på servern, och verktyget omsluter den HTML i ett SVG foreignObject tillsammans med KaTeX:s formatmall och de woff2-teckensnittsfiler som formeln behöver, inbäddade som data-URL:er. Bredden och höjden hämtas från KaTeX:s teckenmått och teckensnittens faktiska glyfbredd, så att arbetsytan rymmer formeln med en liten marginal.

Den visas i Chrome, Edge, Firefox och Safari, oavsett om du använder den som ett img-element, en CSS-bakgrund, infogad SVG-kod eller öppnar filen direkt, och i appar som bygger på en webbläsarmotor. Vektorgrafikredigerare och konverterare som Inkscape, Illustrator, Figma:s SVG-import, librsvg och resvg återger inte HTML inuti foreignObject, så formeln visas tom där.

Inget bibliotek med tillåtande licens i verktygets teknikstack kan rendera KaTeX:s matematik som glyfkonturer, och en separat sättningsmotor skulle inte ge samma resultat som KaTeX. Att bädda in KaTeX:s egen HTML bevarar exakt radavstånd och typsnitt. Om du behöver konturer i en vektorgrafikredigerare kan du öppna SVG-filen i en webbläsare och skriva ut den som PDF, vilket bevarar formeln som vektorformer som redigeringsprogram kan importera.

I visningsläget sätts formeln som en fristående ekvation: stora operatorer får sina gränser ovanför och under, bråk behåller full storlek och \tag-nummer tillåts. Inline-läget använder den kompakta textstilen som är avsedd för formler inuti en mening, med mindre bråk och gränser bredvid summor och integraler.

Den anger storleken på matematikens teckensnitt i pixlar, från 8 till 200, som ett heltal, med 24 som standardvärde. SVG-filens bredd och höjd skalas med den, så en formel som renderas i 48 pixlar är dubbelt så stor som en i 24. Eftersom resultatet är vektorbaserat kan du fortfarande skala det senare med CSS.

Allt som KaTeX 0.19.1 stöder: bråk, rötter, summor och integraler, matriser och miljöer som aligned, cases, pmatrix och array, accenter, pilar, \mathbb, \mathcal, \mathfrak, \text, \color och \tag. Du kan definiera egna makron med \def eller \newcommand i formeln. Fullständiga dokument, \usepackage, TikZ och mhchems \ce-kommandon är inte tillgängliga.

Ingen fil skapas, och verktyget talar om vad som gick fel och vid vilket tecken, räknat från 1. Det anger okända kommandon, obalanserade klammerparenteser, dubbla upphöjda index och kommandon som saknar ett argument, så att du kan gå direkt till rätt ställe och åtgärda det.

En formel kan vara upp till 10,000 tecken lång, makron får expanderas högst 1,000 gånger och storlekar som anges till kommandon som \rule, \kern och \hspace begränsas till 100em. Kommandon som läser in eller länkar till externt innehåll, som \href, \url och \includegraphics, är inaktiverade och visas som röd text som inte stöds.

Bakgrunden är genomskinlig. När du klistrar in SVG-koden på en HTML-sida får formeln den omgivande elementets textfärg, och som bildfil ritas den i svart. Använd \color eller \textcolor i formeln för att ange färger som förblir desamma överallt.

Varje fil innehåller KaTeX:s formatmall på cirka 24 KB och varje teckensnitt som formeln använder i base64 woff2-format, så en typisk formel är 75 till 150 KB. Tecken som saknas i KaTeX:s typsnitt, till exempel kinesiska eller japanska i \text, använder visningsprogrammets egna typsnitt. SVG-filen har rollen img, med LaTeX-källan som titel och aria-label för skärmläsare.