المحرر

تضمين دائرة على موقع آخر

ضع مشروعًا محفوظًا يعمل داخل تدوينة أو موقع فصل أو ملف README، مع الكود من صف المشاركة «تضمين».

احصل على الكود

  1. سجّل الدخول واحفظ المشروع. التضمين يشير إلى مشروع في حسابك، لذا لا يمكن تضمين مشروع محفوظ في هذا المتصفح فقط.
  2. اضغط «مشاركة»، ثم «تضمين» أسفل النافذة.
  3. اضبط الحجم والخيارات. المعاينة تحتها هي التضمين نفسه.
  4. اختر HTML أو Markdown أو رابطًا، واضغط «نسخ الكود»، ثم ألصقه في صفحتك.

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

الخيارات

الخيار الاختيارات
العرض عرض الأعمدة (الافتراضي)، أو 480 أو 600 أو 800 px
الارتفاع (px) من 200 إلى 1200؛ الافتراضي 400
المظهر نظام القارئ، أو فاتح أو داكن
يفتح على الدائرة، أو الكود، أو كليهما جنبًا إلى جنب
يفتح الكود على الملف الرئيسي أو تبويب آخر، للمشروع متعدد الملفات
يبدأ التشغيل عند ظهوره على الشاشة مفعّل افتراضيًا
إخفاء الكود معطّل افتراضيًا؛ عند تفعيله يختفي تبويب الكود تمامًا
إظهار «انسخها وعدّلها في Mokxi» مفعّل افتراضيًا

الصيغ الثلاث:

  • HTML هو <iframe> يناسب WordPress وGhost وNotion وحقل التضمين في Medium وأي صفحة ويب.
  • Markdown يناسب ملف README في GitHub، الذي لا يعرض الإطارات: صورة للمشروع ترتبط بصفحته، حيث يعمل.
  • الرابط هو عنوان التضمين المباشر، لأي شيء يضمّن بالرابط.

يبدو HTML هكذا:

<iframe src="https://mokxi.com/embed/abc123" width="100%" height="400"
  style="border:0;max-width:100%;border-radius:8px" loading="lazy"
  title="Traffic light, running in Mokxi"></iframe>

تُكتب الخيارات في العنوان، فيمكنك أيضًا تغييرها يدويًا: theme=dark أو view=code أو view=split أو autorun=0 أو height=480 أو hideCode=1 أو start=notes.h وedit=0. أي شيء لا يفهمه التضمين يعود إلى الافتراضي، لذا يستمر التضمين الملصوق في العمل.

ما يراه قرّاؤك

  • الدائرة، مع زر تشغيل يتحول إلى إيقاف أثناء التشغيل.
  • تبويبا «الدائرة» و«الكود»، أو كلاهما جنبًا إلى جنب، ما لم تخفِ الكود.
  • «انسخها وعدّلها في Mokxi»، الذي يفتح نسخة خاصة بهم في المحرر.

الدائرة تشغّل الكود الخاص بك. عندما تفتح أداة التضمين، يبني Mokxi البرنامج لكل لوحة ويخزّنه، ويقول السطر تحت المعاينة جاهز: التضمين يشغّل الكود الخاص بك. اللوحة التي تعذّر بناؤها تعرض «افتح في Mokxi للتشغيل» في التضمين بدلًا من تشغيل أي شيء آخر. اضغط «تشغيل» في المحرر للتحقق من الكود، ثم افتح التضمين مرة أخرى.

يعرض التضمين الدائرة وهي تعمل. لضغط أزرارها أو قراءة المخرج التسلسلي أو تغيير الكود، يفتح القارئ المشروع في Mokxi.

مع تفعيل «يبدأ التشغيل عند ظهوره على الشاشة»، تبدأ الدائرة عندما يصل الإطار إلى الشاشة، ولا يُنزّل المحاكي إلا حينها. تبقى الصفحة التي تضم عدة تضمينات سريعة. والقارئ الذي يطلب نظامه تقليل الحركة يحصل على زر التشغيل بدلًا من ذلك.

الباقات والشارة

التضمين متاح في كل الباقات. في الباقة المجانية يحمل التضمين سطرًا واحدًا هادئًا تحت الدائرة: Made with Mokxi · Build your own. باقتا Pro وClassroom والسعر الطلابي تضمّنان بلا سطر، وكذلك تجربة Pro. عمل طالب في فصل أو طفل لا يظهر عليه السطر أو زر «انسخها وعدّلها في Mokxi» أبدًا.

يمكن تضمين المشاريع المدمجة أيضًا، عبر /embed/example/<name>، مثل https://mokxi.com/embed/example/traffic-light. تضمين مشروع مدمج يحمل السطر نفسه على كل موقع عدا موقع Mokxi نفسه.

صفحة المشروع العام تحمل كود التضمين جاهزًا للنسخ، تحت قائمة القطع: «ضع هذه الدائرة في صفحتك».

إذا لم يعمل

  • «هذا المشروع خاص أو لم يعد موجودًا.» أصبح المشروع خاصًا أو حُذف. أعد مستوى الوصول إلى «الرابط» أو «المعرض» في نافذة المشاركة، وسيعمل الكود نفسه مرة أخرى.
  • «افتح في Mokxi للتشغيل» على لوحة. عُدّل كودها ولا يوجد بناء مخزّن له. افتح المشروع، واضغط «تشغيل»، ثم افتح «مشاركة» و«تضمين» مرة أخرى.
  • الإطار فارغ في ملف README. لا يعرض GitHub الإطارات: استخدم صيغة Markdown.
  • التغييرات لا تظهر. يعرض التضمين المشروع كما هو محفوظ الآن. احفظ، ثم أعد تحميل الصفحة التي فيها التضمين.