تحويل LaTeX إلى SVG

ينضّد KaTeX الصيغة إلى HTML على الخادم، ثم تضع الأداة ذلك HTML داخل foreignObject في SVG مع ورقة أنماط KaTeX وملفات الخط woff2 التي تحتاج إليها الصيغة، مضمّنةً كعناوين URL للبيانات. يُستمد العرض والارتفاع من مقاييس خط KaTeX والعروض الفعلية لمحارف هذه الخطوط، لذا تلائم مساحة الرسم الصيغة مع هامش صغير.

يُعرض بشكل صحيح في Chrome وEdge وFirefox وSafari، سواء استخدمته كعنصر img أو كخلفية CSS أو كترميز SVG مضمن أو فتحت الملف مباشرة، وكذلك في التطبيقات المبنية على محرك متصفح. لا تعرض برامج تحرير المتجهات ومحولات الصيغ مثل Inkscape وIllustrator واستيراد SVG في Figma وlibrsvg وresvg محتوى HTML داخل foreignObject، لذا تظهر الصيغة فارغة فيها.

لا توجد مكتبة بترخيص متساهل ضمن مجموعة الأدوات هذه تُنسّق رياضيات KaTeX على هيئة حدود رموز، كما أن أداة تنضيد منفصلة لن تطابق مخرجات KaTeX. يضمن تضمين HTML الخاص بـ KaTeX الحفاظ على التباعد والخطوط كما هي تمامًا. إذا كان محرر الرسوم المتجهة يحتاج إلى حدود، فافتح 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 وأوامر \ce الخاصة بـ mhchem غير متاحة.

لن يُنتج أي ملف، وستوضح لك الأداة موضع الخطأ والحرف الذي وقع عنده، مع بدء العد من 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 على role بقيمة img، ومصدر LaTeX ضمن العنوان، وaria-label لقارئات الشاشة.