LaTeX в SVG

KaTeX набирает формулу в HTML на сервере, а инструмент помещает этот HTML в SVG foreignObject вместе с таблицей стилей KaTeX и необходимыми формуле файлами шрифтов woff2, встроенными в виде URL данных. Ширина и высота рассчитываются по метрикам шрифта KaTeX и реальной ширине символов этих шрифтов, поэтому холст точно соответствует размеру формулы и имеет небольшие поля.

Изображение отображается в Chrome, Edge, Firefox и Safari — при использовании в качестве элемента img, фона CSS, встроенной разметки SVG или при прямом открытии файла, а также в приложениях на основе браузерного движка. Векторные редакторы и конвертеры, такие как Inkscape, Illustrator, импорт SVG в Figma, librsvg и resvg, не отображают HTML внутри foreignObject, поэтому формула там выглядит пустой.

Ни одна библиотека с разрешительной лицензией в стеке этого инструмента не преобразует формулы KaTeX в контуры глифов, а отдельный наборщик не воспроизведет результат KaTeX. Встраивание самого KaTeX HTML сохраняет точные интервалы и шрифты. Если графическому редактору нужны контуры, откройте SVG в браузере и распечатайте его в PDF: формула останется векторными фигурами, которые редакторы могут импортировать.

В режиме отображения формула набирается как отдельное уравнение: у крупных операторов пределы располагаются сверху и снизу, дроби сохраняют полный размер, а номера \tag разрешены. Встроенный режим использует компактный стиль для формул внутри предложения: дроби становятся меньше, а пределы сумм и интегралов располагаются рядом с ними.

Он задает размер математического шрифта в пикселях — целым числом от 8 до 200; значение по умолчанию — 24. Ширина и высота SVG масштабируются соответственно, поэтому формула размером 48 пикселей вдвое больше формулы размером 24 пикселя. Поскольку результат векторный, его можно масштабировать и позже с помощью CSS.

Поддерживается всё, что поддерживает KaTeX 0.19.1: дроби, корни, суммы и интегралы, матрицы и окружения, например aligned, cases, pmatrix и array, акценты, стрелки, \mathbb, \mathcal, \mathfrak, \text, \color и \tag. Внутри формулы можно задавать собственные макросы с помощью \def или \newcommand. Полные документы, \usepackage, TikZ и команды mhchem \ce недоступны.

Файл не создается, а инструмент сообщает, что именно пошло не так и в каком символе, считая с 1. Он указывает неизвестные команды, несбалансированные фигурные скобки, двойные верхние индексы и команды без аргумента, чтобы вы могли сразу перейти к нужному месту и исправить его.

Длина формулы может составлять до 10,000 символов, макросы могут раскрываться не более 1,000 раз, а размеры, указанные в таких командах, как \rule, \kern и \hspace, ограничены значением 100em. Команды, загружающие или связывающие внешний контент, например \href, \url и \includegraphics, отключены и отображаются как неподдерживаемый красный текст.

Фон прозрачный. Если вставить разметку SVG на страницу HTML, формула примет цвет текста окружающего элемента; в виде файла изображения она будет черной. Используйте \color или \textcolor внутри формулы, чтобы задать цвета, которые везде останутся неизменными.

Каждый файл содержит таблицу стилей KaTeX размером около 24 KB и все используемые в формуле начертания шрифтов в формате base64 woff2, поэтому типичная формула занимает от 75 до 150 KB. Для символов, которых нет в шрифтах KaTeX, например китайских или японских символов внутри \text, используются собственные шрифты средства просмотра. SVG имеет роль img, а исходный код LaTeX указан в его заголовке и атрибуте aria-label для программ чтения с экрана.