عنصر الصيغة

الترميز الرياضي والعلمي — الكسور، والأسس، والرموز السفلية، والحروف اليونانية، والصيغ الكيميائية عبر \ce{...} — يُعرض على الخادم في صورة مع نص بديل حقيقي، إذ لا يوجد تطبيق بريد يُنضّد الرياضيات الحقيقية.

آلية العمل

يأخذ العنصر سلسلة ترميز صغيرة شبيهة بـ LaTeX (مثل \frac{-b \pm \sqrt{b^2-4ac}}{2a}) ويعرضها على الخادم في صورة PNG عبر GET /api/formula. وهي نقطة نهاية موقَّعة مبنية على أدوات التنقيط وترميز PNG نفسها المكتوبة من الصفر التي تستخدمها عناصر مخططات التحليلات أصلًا: فلا توجد مكتبة رياضيات تعمل في المتصفح إطلاقًا، ولا أي اعتمادية npm خلف العارض.

محتوى الصيغة ثابت بمجرد كتابته، على عكس صورة GIF للعدّاد التنازلي التي يجب إعادة توليدها مع كل عرض لتبقى حيّة. لذا يُوقَّع طلب العرض بأكمله (الترميز، ووضع العرض، واللون) داخل رابط URL نفسه، ولا تحتاج نقطة النهاية إلى أي قراءة من Firestore — إذ تحمل الاستجابة ترويسة تخزين مؤقت ثابتة وطويلة الأمد.

تغطي صياغة الترميز الكسور، والأسس (^)، والرموز السفلية (_)، والجذور التربيعية، والحروف اليونانية، والدوال المسمّاة (\sin، \lim، \log، وغيرها)، ورموز المجموعات والمنطق (\forall، \in، \cup، \neg، وغيرها)، والعوامل الشائعة. يُتعرَّف على \left(/\right( لكنهما يُعرضان بالحجم العادي بدلًا من تحجيمهما تلقائيًا وفق محتواهما، إذ إن هذا عارض صور نقطية صغير، لا محرك TeX كامل. ويعيد \text{...} الكتابة إلى كلمات عادية في منتصف الصيغة لتسمية حدٍّ ما.

للصيغ الكيميائية ماكرو خاص بها \ce{...}: وهو مجموعة فرعية صغيرة شبيهة بـ mhchem. تُكتب أعداد العناصر رموزًا سفلية تلقائيًا (يُعرض H2O مع 2 سفلية)، وتُكتب الشحنات الأيونية اللاحقة رموزًا علوية تلقائيًا (H3O+، SO4^2-)، ويُعرض -> سهمَ تفاعل. وهذا يعني أن \ce{2H2 + O2 -> 2H2O} لا يتطلب منك كتابة ^/_ يدويًا لكل عدد ذرات وشحنة.

الصياغة التي لا يتعرّف عليها المحلّل — مستندات LaTeX الكاملة، والحزم، والمصفوفات، والجداول — لا تُفشل الإرسال أبدًا. بل تتراجع إلى عرض سلسلة الترميز الخام نصًا حرفيًا عاديًا بدلًا من ذلك. ويُفرض هذا الضمان على مستويين: فالمحلّل نفسه يحوّل الماكروهات غير المعروفة إلى نص حرفي، واستدعاء العارض الخارجي لا يُطلق خطأً أبدًا حتى في حالة تخطيط حدّية.

تُخطَّط الصورة بمقياس يناسب وضع عرضها: أكبر في وضع الكتلة، وأصغر في الوضع المضمَّن. ويتناقص المقياس تلقائيًا إذا كانت الصورة ستتجاوز ميزانية الحجم الآمنة للبريد. تتسع معظم الصيغ من المحاولة الأولى؛ ولا يحتاج إلى مقياس أصغر إلا تعبير طويل على نحو غير معتاد، أما التعبير المفرط فيُثبَّت عند الحد الأدنى للمقياس بدلًا من الدوران في حلقة لا نهائية.

يحمل وسم <img> المعروض سمتَي width/height صريحتين محسوبتين من مرحلة التخطيط تلك، فلا يقفز التخطيط في Outlook وتطبيقات البريد الأخرى أثناء تحميل الصورة. والأهم أنه يحمل أيضًا سمة alt مضبوطة على سلسلة الترميز الخام نفسها. فلا تبقى الصيغة أبدًا حبيسة صورة بلا مكافئ نصي في تطبيق بريد يحظر الصور أو لدى قارئ شاشة لا يستطيع تحليل صورة نقطية.

الحقول القابلة للضبط:

الترميز (شبيه بـ LaTeX) — نص الصيغة، بحد أقصى 300 حرف (تُقتطع القيمة الزائدة الطول بصمت قبل العرض، ولا تُفشل الإرسال أبدًا).
وضع العرض — مضمَّن (صغير، يقع داخل سطر نصي) أو كتلة (أكبر، في سطر مستقل).
المحاذاة — يسار، أو وسط، أو يمين (لا أثر لها فعليًا إلا في وضع الكتلة).
اللون — لون خط الترميز؛ والقيمة غير الصالحة أو الفارغة تتراجع إلى اللون الافتراضي القريب من الأسود الخاص بالعارض، بدلًا من أن تصل إلى نقطة النهاية الموقَّعة بقيمة سترفضها.
لون الخلفية، والحشو، والحدّ، واستدارة الزوايا على البطاقة.

الترميز الفارغ لا يُعرض على الإطلاق بدلًا من أن يُعرض صورة فارغة — فالعنصر ببساطة لا يُخرج شيئًا إذا لم يكن هناك نص يُنضَّد.

الصياغة المدعومة

كل مثال أدناه صورة موقَّعة حقيقية وحيّة من نقطة النهاية الفعلية /api/formula، لا نموذج تصميمي، فما تراه هنا هو تمامًا ما يعرضه البريد الوارد لدى المستلم. وأي شيء غير مدرج في هذه القائمة (مستندات LaTeX الكاملة، والحزم، والمصفوفات، والجداول، وعلامات التشكيل مثل \bar/\hat، وعلامات الحذف مثل \dots) لا يُتعرَّف عليه. بل يُعرض حرفيًا بنصه المكتوب نفسه بدلًا من إفشال الإرسال، فيكون واضحًا عادةً في المعاينة أن ماكرو ما غير مدعوم.

Fractions

\frac{a+b}{c-d}

$\frac{a+b}{c-d}$

Exponents and subscripts

a_n = a_1 + (n-1)d

Square roots, nested with a fraction

\sigma = \sqrt{\frac{1}{n}\sum (x_i - \mu)^2}

$\sigma = \sqrt{\frac{1}{n}\sum (x_i - \mu)^2}$

The quadratic formula — fractions, ±, and a square root together

x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}

$x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}$

Greek letters

\Delta = b^2 - 4ac

$\Delta = b^2 - 4ac$

Named functions and limits (upright, not italicized)

\lim_{x \to 0} \frac{\sin x}{x} = 1

$\lim_{x \to 0} \frac{\sin x}{x} = 1$

Set and logic symbols

\forall x \in S,\ x^2 \geq 0

$\forall x \in S,\ x^2 \geq 0$

\left(/\right) delimiters — recognized, but not auto-scaled to their contents

y = \left(x+1\right)^2

$y = \left(x+1\right)^2$

\text{...} for a label mid-formula

d = 5\text{ mi}

$d = 5\text{ mi}$

Chemical formulas via \ce{...} — auto-subscripted atom counts, a reaction arrow

\ce{2H2 + O2 -> 2H2O}

$\ce{2H2 + O2 -> 2H2O}$

\ce{...} — auto-superscripted ionic charges

\ce{SO4^2-}

$\ce{SO4^2-}$

أمثلة

Subject

This week in study group: the quadratic formula

تنضّد رسالة ملخّص لحصة كيمياء تفاعلًا موزونًا مضمَّنًا في جملة: «التمثيل الضوئي: \ce{6CO2 + 6H2O -> C6H12O6 + 6O2}» بجوار النص التوضيحي مباشرة. راجع التعليم لمعرفة كيف تتكامل الصيغة مع الواجب والاختبار ومجموعة البطاقات التعليمية في ملخّص صفّي. وتُدرج مجموعة مسائل فيزياء الصيغة التربيعية في وضع الكتلة في سطر مستقل، بحجم أكبر وفي الوسط، قبل مثال محلول. وتستخدم نشرة إحصائية صيغة قصيرة مضمَّنة مثل \mu = \frac{\sum x_i}{n} في منتصف الجملة دون الإخلال بانسياب الفقرة المحيطة. لاحظ أنها \mu لا \bar{x}: فماكروهات علامات التشكيل مثل \bar/\hat ليست ضمن قائمة الصياغة المدعومة أعلاه، لذا فالحرف اليوناني العادي هو البديل الآمن للمتوسط حيثما احتجت إليه.

كيف يبدو البديل الثابت

<div style="margin:8px 0;text-align:left">
  <img src="https://mailinapp.com/api/formula?d=eyJub3RhdGlvbiI6...&s=abc123..."
       width="184" height="52" alt="E = mc^2"
       style="display:inline-block;max-width:100%;height:auto;vertical-align:middle" />
</div>

لا يوجد إلا مستوى عرض واحد — وسم <img> موقَّع يحمل نصه البديل alt دائمًا سلسلة الترميز الدقيقة، فتبقى الصيغة مفهومة حتى حيث لا تُحمَّل الصورة نفسها.

عنصر الصيغة

آلية العمل

الصياغة المدعومة

أمثلة

كيف يبدو البديل الثابت

انظر أيضًا