LaTeX إلى MathML
حوّل صيغة LaTeX إلى ترميز MathML باستخدام KaTeX 0.19.1. تكون النتيجة عنصر math واحدًا يحتوي على MathML للعرض، مع الاحتفاظ بصيغة LaTeX الأصلية في تعليق توضيحي، في وضع العرض أو السطر، وجاهزًا للصق في مستندات HTML أو EPUB أو XML. يعرض MathML بشكل أصلي في الإصدارات الحالية من Chrome وEdge وFirefox وSafari، كما تقرؤه قارئات الشاشة بصوت عالٍ، لتظل صيغك متاحة دون أي JavaScript.
الأسئلة الشائعة
كيف يبدو الإخراج؟
تحصل على عنصر math واحد ضمن مساحة أسماء MathML مع غلاف semantics. يحتوي العنصر على MathML للعرض مُنشأ من عناصر مثل mi وmn وmo وmfrac وmsup وmtable، يتبعه تعليق توضيحي بترميز application/x-tex يضم صيغة LaTeX الأصلية. يضيف وضع العرض display="block" إلى عنصر math.
أين يمكنني استخدام 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 وأوامر \ce الخاصة بـ mhchem غير متاحة.
ماذا يحدث إذا احتوى التعبير على خطأ؟
لن تُعاد أي 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.