LaTeX у MathML
Перетворіть формулу LaTeX на розмітку MathML за допомогою KaTeX 0.19.1. Результат — один елемент math із презентаційним MathML і початковою формулою LaTeX в анотації, у блоковому або вбудованому режимі; його можна вставити в документи HTML, EPUB або XML. У поточних версіях Chrome, Edge, Firefox і Safari MathML відображається нативно, а програми читання з екрана можуть озвучувати формули, тож вони залишаються доступними без жодного JavaScript.
Поширені запитання
Який вигляд має результат?
Ви отримуєте один елемент math у просторі імен MathML з обгорткою semantics. Усередині міститься презентаційний MathML, побудований з таких елементів, як mi, mn, mo, mfrac, msup і mtable, а за ним — анотація з кодуванням application/x-tex, що містить початковий код LaTeX. У блоковому режимі до елемента math додається display="block".
Де можна використовувати MathML?
Вставте його безпосередньо на сторінку HTML5, у книгу EPUB 3, XHTML або формат XML, як-от JATS чи DocBook. Багато редакторів рівнянь і офісних пакетів також можуть імпортувати MathML, тож це зручний формат обміну між інструментами, які не підтримують LaTeX.
Чи відображають браузери MathML?
Так. Chrome і Edge, починаючи з версії 109, а також Firefox і Safari відображають MathML нативно, без скриптів і таблиць стилів. Браузери відображають його власними математичними шрифтами, тому вигляд трохи відрізняється від HTML KaTeX, але структура й правила інтервалів однакові.
Чим відрізняються блоковий і вбудований режими?
У блоковому режимі формула позначається атрибутом display="block" і задається як окреме рівняння з повнорозмірними дробами та межами великих операторів зверху й знизу. У вбудованому режимі цей атрибут не додається, а формула набирається компактним стилем для звичайного тексту.
Чи зберігається початковий код LaTeX?
Так. KaTeX зберігає вихідний код в елементі annotation усередині обгортки semantics. Браузери його не відображають, але засоби копіювання й інші конвертери можуть використати його, щоб відновити точний код LaTeX. Видаліть елемент annotation, якщо не хочете зберігати вихідний код у документі.
Які команди LaTeX підтримуються?
Усі команди, які підтримує KaTeX 0.19.1, зокрема дроби, корені, матриці, середовища, як-от aligned, cases і array, акценти, стрілки, команди шрифтів на кшталт \mathbb і \mathcal, а також \text і \tag. Працюють і макроси, визначені за допомогою \def або \newcommand у формулі. Повні документи, \usepackage і команди mhchem \ce недоступні.
Що станеться, якщо у формулі є помилка?
MathML не повертається. Інструмент повідомляє про проблему й символ, у якому вона виникла; нумерація починається з 1. Наприклад, це може бути невідома команда, незакрита фігурна дужка, подвійний верхній індекс або команда без аргументу.
Чи є якісь обмеження?
Формула може містити не більше ніж 10,000 символів, макроси можуть розгортатися не більше ніж 1,000 разів, а розміри для команд на кшталт \rule і \kern обмежені значенням 100em. Команди, що пов’язують із зовнішнім вмістом або завантажують його, як-от \href, \url і \includegraphics, вимкнені й відображаються як непідтримуваний текст.
Чи підходить MathML для забезпечення доступності?
Так. Програми читання з екрана, як-от VoiceOver, NVDA і JAWS, можуть читати MathML і давати змогу читачам послідовно переходити між частинами формули — на відміну від зображень. Зберігати формули в MathML, а не у вигляді зображень, — один із найпростіших способів зробити технічний вміст доступним.
Чим це відрізняється від звичайного результату KaTeX?
На вебсторінці KaTeX зазвичай виводить стилізований HTML для відображення, а також прихований MathML для програм читання з екрана. Цей інструмент повертає лише частину MathML — саме так, як її генерує KaTeX, без обгорткового span, таблиці стилів чи шрифтів, тож вона працює всюди, де підтримується MathML.