يجب أن تكون الرياضيات قابلة للاقتباس

ساهم ميزة
1

لدينا منتدى Discourse لبرنامج علمي، ونستخدم إضافة الرياضيات. للأسف، لا يمكن اقتباس المعادلات الرياضية.

عند تحديد نص معين، تظهر زر “اقتباس”:

image
image1328×324 27.5 KB

عند النقر عليه، تظهر النتيجة التالية:

[quote]
تعريف مركزية القرب:

ci=1N−1N∑j=11dij c_i = \frac{1}{N-1} \sum_{j=1}^N\frac{1}{d_{ij}}
[/quote]

لاحظ أنه في الاقتباس، ظهرت المعادلة الرياضية كنص غريب (غير مقروء) يليه مصدر LaTeX الفعلي، لكنه يفتقر إلى محددات $.

أعتقد أنه لا يوجد حل لهذه المشكلة حاليًا. سيكون من الرائع إذا تم تحسين ذلك في المستقبل.

8 إعجابات
2

ما زال هذا يحدث، ويحدث أيضًا مع الرياضيات المضمنة، كما أفاد أحد الأعضاء في نسختنا:

3 إعجابات
3

ملاحظة: أوافق تمامًا على ضرورة تنظيف هذا الأمر، لكنه يبدو معقدًا للغاية.

سأضع علامة pr-welcome هنا في حال أراد شخص ما يمتلك مهارات متقدمة تجربة ذلك.

7 إعجابات
4

لقد ألقيت نظرة على اقتباس الرياضيات (أفكر في كتابة طلب سحب أو المساهمة في واحد).

أوثق بعض الأفكار والنتائج الأولية هنا.

  • يبدو أن الاقتباس بأكمله يمر عبر هذه المكونات الرئيسية:
  • تأخذ دالة buildQuote كائن منشور - أعتقد أنه وصف JSON كامل للمنشور مثال.

لذا فإن انطباعي الأولي هو أن إحدى هذه النقاط قد تكون قابلة للتصحيح:

  • toMarkdown تطابق العناصر مع علامات HTML المختلفة؛ أعتقد أن mathjax يستخدم عناصر مخصصة قابلة للكشف (ربما ليس عرض SVG)، وربما katex أيضًا؟
  • selectedText يقوم ببعض المطابقة لعناصر مثل كتل التعليمات البرمجية و onebox - قد يكون قادرًا على اكتشاف عناصر mathjax/katex وتحويلها؟ (ملاحظة: ربما يكون من الجيد وجود خطاف أو شيء من هذا القبيل هنا حتى يمكن إضافة منطق التحويل إلى المكون الإضافي discourse-math بدلاً من قاعدة كود discourse الرئيسية).
  • النقاط الأخرى لا تبدو مناسبة مثل هاتين النقطتين.

بعض الأفكار الأخرى حول الأساليب وكيفية الحصول على الرياضيات الخام.

اعتمادًا على كيفية عمل katex / mathjax + svg [1]، أعتقد أن كل مثيل للرياضيات يجب أن يكون له عنصر HTML جذر (ربما يكون هناك أكثر من واحد بسبب وجود بعض العناصر المخفية لسهولة الوصول والأشياء). لذا إذا عرفنا الأماكن التي توجد فيها الرياضيات، فقد نتمكن من تحليل المنشور الخام بحثًا عن مثيلات للمحتوى المحدد بـ $ (ولكن المفسرين صعبون - ربما يوجد واحد بالفعل في قاعدة الكود؟)

بدلاً من ذلك، لدى mathjax على الأقل ميزة النقر بزر الماوس الأيمن > عرض tex وما شابه (والتي يجب أن تكون السلسلة الحرفية بين أزواج $); لست متأكدًا من كيفية ربط ذلك، ولكن إذا كانت هناك طريقة للقيام بذلك لـ mathjax v2 و v3 و katex، فيجب أن يكون من الممكن استخدام ذلك لاستبدال الرياضيات المنسقة المحددة بـ $...$ (ملاحظة: هذا يعمل للرياضيات المضمنة، نحتاج إلى تغطية الحالة للنوع الآخر أيضًا - والذي يستخدم المحددات $$...$$ أو [/.../].)

المشاكل حاليًا:

  • لا أعرف كيفية تنفيذ خطاف أو ما إذا كان هناك شيء أفضل لاستخدامه / طريقة أفضل للقيام بذلك في قاعدة كود discourse.
  • العديد من المجهولات حول mathjax/katex التي تحتاج إلى التحقيق.
    • عناصر HTML - كيف يمكن اكتشافها بشكل موثوق؟
    • كيف يمكن الحصول على كود TeX الخام؟

إذا كان لدى أي شخص أي أفكار أخرى حول مكان / ما يجب تصحيحه، أو طرق تنفيذ أخرى ممكنة، أو أي شيء آخر، فيرجى نشره.

  1. أعتقد أن mathjax + svg غير مدعوم، لذلك ربما لا تكون هذه مشكلة ↩︎

6 إعجابات
6

تمت ترقية Discourse Math بشكل كبير في يناير 2026 إلى إصدار جديد مدمج رسميًا في النواة، مع MathJax 4.1 كإعداد افتراضي و KaTeX كبديل. تشير وثائق المكون الإضافي أيضًا إلى أن KaTeX يتضمن امتداد CopyTex لنسخ مصدر LaTeX.

هل سيكون من المفيد إضافة تصحيح صغير لمكون الثيم (theme-component patch) يحسن تحديد الاقتباسات للمشاركات التي تحتوي على الكثير من المعادلات الرياضية؟

بالنسبة للمواقع التي تعتمد بشكل كبير على MathJax مثل Physics with Ethan، فإن الفكرة الأكثر عملية هي:

  1. اعتراض HTML المحدد قبل أن يقوم Discourse بتحويله مرة أخرى إلى Markdown،
  2. العثور على عناصر تغليف المعادلات الرياضية،
  3. استبدالها بمصدر TeX الأصلي ملفوفًا بـ $...$ أو $$...$$،
  4. ثم السماح لـ Discourse بمتابعة بناء الاقتباس.

إليك برنامج نصي محتمل لمكون الثيم سأبدأ به، إذا كان من المفيد تعديل منطقة < /head> أو منطقة JavaScript في ثيم Horizon (أو الافتراضي).


<script type="text/discourse-plugin" version="1.0">
  apiInitializer("1.34.0", (api) => {
    function texFromMathElement(el) {
      // MathJax v3/v4 يخزن المصدر عادةً في عنصر ابن للتعليق التوضيحي (annotation).
      const annotation =
        el.querySelector('annotation[encoding="application/x-tex"]') ||
        el.querySelector('annotation');

      if (annotation?.textContent?.trim()) {
        const tex = annotation.textContent.trim();

        // الاستدلال: غالبًا ما تكون حاويات المعادلات الكتلية (block math wrappers) حاويات عرض.
        const isBlock =
          el.tagName === "MJX-CONTAINER" &&
          (el.getAttribute("display") === "true" ||
            el.getAttribute("display") === "block");

        return isBlock ? `$$\n${tex}\n$$` : `$${tex}$`;
      }

      return null;
    }

    function patchMathInFragment(fragment) {
      const candidates = fragment.querySelectorAll(
        "mjx-container, .math, .katex, .MathJax"
      );

      candidates.forEach((node) => {
        const replacement = texFromMathElement(node);
        if (!replacement) {
          return;
        }

        const textNode = document.createTextNode(replacement);
        node.replaceWith(textNode);
      });

      return fragment;
    }

    api.modifyClass("component:quote-button", {
      pluginId: "ethan-math-quote-fix",

      _selectionChanged() {
        this._super(...arguments);

        try {
          const selection = window.getSelection();
          if (!selection || selection.rangeCount === 0) {
            return;
          }

          const range = selection.getRangeAt(0);
          const fragment = range.cloneContents();
          patchMathInFragment(fragment);

          const container = document.createElement("div");
          container.appendChild(fragment);

          // استبدال المخزن المؤقت الذي يقوم Discourse لاحقًا بتحويله إلى علامات اقتباس markdown.
          if (this.quoteState) {
            this.quoteState.buffer = container.innerHTML;
          }
        } catch (e) {
          // الفشل بهدوء حتى يستمر الاقتباس العادي في العمل.
          console.warn("فشل تصحيح اقتباس المعادلة:", e);
        }
      },
    });
  });
</script>

بعض التحذيرات الهامة:

  • هذا تصحيح عملي، وليس شيئًا وجدته منشورًا بالفعل من قبل Meta. الاستراتيجية الأساسية مستنتجة من مسار الاقتباس الذي يمر عبر HTML المحدد وإلى toMarkdown.
  • من المرجح أن يكون مفيدًا عندما أستخدم موفر MathJax، وهو الإعداد الافتراضي الحالي في Discourse Math، والخيار الذي أستخدمه عادةً.
  • قد يحتاج البرنامج النصي إلى تعديلات صغيرة في المحددات اعتمادًا على ما إذا كانت المعادلة المعروضة ستنتهي كـ mjx-container أو .MathJax أو غلاف آخر. سأقوم بالاختبار على موقع تجريبي، والذي سيكون تثبيتًا قياسيًا جديدًا.
  • من غير المرجح أن يكون مثاليًا لكل حالة حافة، خاصةً التحديدات المختلطة داخل السطر/الكتلة أو المواد المقتبسة المتداخلة.

نظرًا لأن Discourse يدعم الآن رسميًا KaTeX مع CopyTex، هناك مسار آخر وهو التبديل إلى الموفر إذا كانت نقطة الألم الرئيسية لدي هي نسخ مصدر LaTeX بدلاً من دقة العرض. هذا لن يحل تلقائيًا تحديد الاقتباس، ولكنه يعني أن المعادلة المعروضة لديها بالفعل مسار أكثر ملاءمة للنسخ مدمج فيها.

بالنسبة لـ Physics with Ethan، ستكون توصيتي:

  • الاحتفاظ بـ MathJax إذا كنت تقدر التوافق والعرض الغني،
  • إضافة تصحيح صغير لتحديد الاقتباس مثل التصحيح أعلاه،
  • ومعاملته كحل محلي لتحسين جودة الحياة حتى تحصل Meta على حل مناسب في المنبع. حقيقة أن موضوع الميزة لعام 2020 لا يزال مفتوحًا في عام 2026 تشير إلى أن الحل في المنبع قد يظل بطيئًا هنا.

بالنسبة لموقعي الذي يعتمد بشكل كبير على MathJax، Physics with Ethan، أفكر حاليًا في:

  • الاحتفاظ بـ MathJax ما لم يقترح شخص ما أن أتحول إلى KaTeX؟،
  • ربما إضافة تصحيح لتحديد الاقتباس إلى ثيم Horizon، من الأعلى (باستخدام موقع تجريبي).
  • ومعاملته كحل محلي لتحسين جودة الحياة حتى يكون هناك حل مناسب في المنبع. حقيقة أن موضوع الميزة لعام 2020 لا يزال مفتوحًا في عام 2026 تشير إلى أن الحل في المنبع قد يظل بطيئًا هنا.
3 إعجابات