اعرض معادلات LaTeX كصور

لماذا تعرض المعادلات كصور؟

ينتج LaTeX المعيار الذهبي في تنضيد الرياضيات، لكن المخرجات حبيسة ملفات PDF التي يجمّعها محرك TeX. ومعظم الأماكن التي تحتاج فيها فعلًا إلى عرض الرياضيات، كالعروض التقديمية والمواقع ورسائل الدردشة ومستندات Word وملفات README، لا تستطيع تفسير كود LaTeX المصدري. وعرض معادلتك كصورة يسد هذه الفجوة: تحصل على طباعة بجودة LaTeX بصيغة تعمل في كل مكان.

البديل هو محاكاة العرض بـ JavaScript (KaTeX وMathJax) أو استخدام محرر المعادلات المدمج في معالج النصوص. تغطي مُعرِّضات JavaScript مجموعة فرعية مفيدة من LaTeX لكنها تغفل الحالات الحدية والحزم المخصصة والبيئات المتقدمة. أما محررات المعادلات المدمجة (Microsoft Equation وGoogle Docs) فتنتج طباعة مختلفة بوضوح تتنافر مع مستندات LaTeX. ويتجنب العرض من جهة الخادم بمحرك TeX حقيقي المشكلتين معًا.

مقارنة صيغ المخرجات

لكل صيغة مخرجات نقاط قوة مميزة. PNG هي الخيار الاحتياطي العام، وSVG الأفضل للويب، وPDF مثالية للطباعة، وMathML هي معيار إمكانية الوصول. يلخص الجدول أدناه الفروق الرئيسية لمساعدتك على الاختيار.

خطوة بخطوة: العرض باستخدام FormaTeX

سواء استخدمت الأداة عبر الإنترنت أو REST API، يتبع سير العمل أربع خطوات. توفر الأداة عبر الإنترنت واجهة مرئية لكل خيار، بينما تقبل API المعاملات نفسها كحقول JSON.

خيارات العرض المتقدمة

تعطي الإعدادات الافتراضية نتائج ممتازة في معظم حالات الاستخدام. وعندما تحتاج إلى تحكم دقيق في المخرجات، تتوفر الخيارات التالية في الأداة عبر الإنترنت وفي API. يُمرَّر كل خيار كحقل JSON في جسم طلب API.

يمكن الجمع بين هذه الخيارات بحرية. على سبيل المثال، يمكنك عرض معادلة بيضاء على خلفية شفافة بدقة 300 DPI باستخدام Latin Modern بحجم 14pt مع تحميل الحزمة siunitx، كل ذلك في طلب واحد.

"dpi": 300

"transparent": true

"color": "#ffffff", "bg_color": "#1a1a2e"

"font_size": 14

"font_family": "Latin Modern"

"preamble": "\\newcommand{\\R}{\\mathbb{R}}"

"packages": ["siunitx", "chemformula"]

تضمين المعادلات في الويب

بعد عرض معادلتك، تكون الخطوة التالية تضمينها في صفحة HTML أو تدوينة أو موقع توثيق. هناك ثلاث طرق رئيسية، لكل منها مفاضلات مختلفة في الأداء وإمكانية الوصول وسهولة التكامل.

لمعظم مشاريع الويب، يوفر SVG المضمّن أفضل توازن بين الجودة والأداء. استخدم نهج وسم img عندما تحتاج إلى التحميل الكسول أو التخزين المؤقت عبر CDN. واختر MathML عندما يكون الامتثال لإمكانية الوصول (WCAG وSection 508) مطلوبًا.

<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 120 40">
  <!-- SVG content from the API response -->
</svg>

<img
  src="https://api.formatex.io/api/v1/render/equation?latex=E%3Dmc%5E%7B2%7D&format=svg"
  alt="E equals m c squared"
  width="120"
  height="40"
  loading="lazy"
/>

<math xmlns="http://www.w3.org/1998/Math/MathML" display="block">
  <mi>E</mi>
  <mo>=</mo>
  <mi>m</mi>
  <msup><mi>c</mi><mn>2</mn></msup>
</math>

استخدام API

تقبل API العرض الخاصة بمعادلات FormaTeX طلب POST بجسم JSON. صادق باستخدام رمز Bearer (مفتاح API الخاص بك، الذي تنشئه من لوحة التحكم ). يحتوي جسم الاستجابة على بايتات الصورة المعروضة. للاطلاع على توثيق API الكامل ومكتبات العميل، راجع دليل Python API و مرجع cURL .

فيما يلي مثالان: أمر cURL لعرض PNG بدقة 300 DPI بخلفية شفافة، وأمر cURL لعرض SVG لتكامل غاوس.

# Render a LaTeX equation as a transparent PNG at 300 DPI
curl -X POST https://api.formatex.io/api/v1/render/equation \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "latex": "E = mc^{2}",
    "format": "png",
    "dpi": 300,
    "transparent": true
  }' \
  --output equation.png

# Render a LaTeX equation as an inline SVG
curl -X POST https://api.formatex.io/api/v1/render/equation \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "latex": "\\int_{0}^{\\infty} e^{-x^2} \\, dx = \\frac{\\sqrt{\\pi}}{2}",
    "format": "svg",
    "font_size": 14
  }' \
  --output equation.svg

#!/bin/bash
EQUATIONS=("E = mc^{2}" "a^2 + b^2 = c^2" "\\sum_{n=1}^{\\infty} \\frac{1}{n^2} = \\frac{\\pi^2}{6}")
API_KEY="YOUR_API_KEY"

for i in "${!EQUATIONS[@]}"; do
  curl -s -X POST https://api.formatex.io/api/v1/render/equation \
    -H "Authorization: Bearer $API_KEY" \
    -H "Content-Type: application/json" \
    -d "{\"latex\": \"${EQUATIONS[$i]}\", \"format\": \"png\", \"dpi\": 300}" \
    --output "equation_$i.png"
  echo "Rendered equation_$i.png"
done

import requests

response = requests.post(
    "https://api.formatex.io/api/v1/render/equation",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "latex": r"\nabla \times \mathbf{E} = -\frac{\partial \mathbf{B}}{\partial t}",
        "format": "svg",
        "font_size": 14,
    },
)

with open("maxwell.svg", "wb") as f:
    f.write(response.content)

print(f"Status: {response.status_code}, saved maxwell.svg")

FormaTeX مقابل البدائل

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

تنتج أدوات الخادم (FormaTeX وCodeCogs وLaTeX2Image وQuickLaTeX) مخرجات مطابقة لـ LaTeX المجمّع لأنها تشغّل محرك TeX حقيقيًا. أما أدوات العميل (KaTeX وMathJax) فتعرض في المتصفح باستخدام JavaScript وتغطي مجموعة فرعية كبيرة لكنها غير كاملة من LaTeX. لمقارنة تفصيلية، راجع المقارنة الكاملة لمُعرِّضات المعادلات .

الخلاصة: إذا كنت تحتاج إلى مخرجات LaTeX مطابقة بالبكسل مع دعم كامل للحزم وREST API، فـ FormaTeX هو الخيار الأكمل. وإذا كنت تحتاج فقط إلى العرض المضمّن في المتصفح ولا تتطلب صورًا قابلة للتنزيل، فإن KaTeX (الأسرع) أو MathJax (الأوسع تغطية لـ LaTeX) خياران مفتوحا المصدر ممتازان.

الأسئلة الشائعة

أدلة وأدوات ذات صلة