انتقل إلى المحتوى الرئيسي
هذا المشروع في مرحلة تجريبية. وجدت خطأ؟ افتح مشكلة على GitHub. لديك سؤال أو فكرة؟ اسأل في Discussions — نحب سماع ملاحظاتك!
كيف جودة الترجمة في هذه الصفحة؟

doQumentation

تعلّم الحوسبة الكمومية مع دروس ودورات Qiskit من IBM، وشغّل الكود هنا مباشرة في متصفحك. لا حاجة إلى تثبيت ولا إلى حساب للبدء.

نظام Qiskit البيئي — doQumentation عضو في نظام Qiskit البيئي

البدء​

هل أنت جديد على الحوسبة الكمومية؟ ابدأ بالدورة. هل أنت على دراية بـ Qiskit بالفعل؟ انتقل مباشرة إلى درس تعليمي أو دليل إرشادي.

لا حاجة إلى حساب IBM Quantum. يعمل الكود افتراضيًا على محاكي مدمج. أضف مفتاح API الخاص بك في الإعدادات فقط إذا أردت استخدام عتاد كمومي حقيقي.

تنفيذ الكود​

انقر على Run في أي كتلة برمجية. النقرة الأولى تبدأ نواة Jupyter عبر Binder أو IBM Code Engine. بعد ذلك، يكون التنفيذ فوريًا.

  • وضع المحاكاة (دون الحاجة إلى حساب) — مفعّل افتراضيًا: يعمل الكود على AerSimulator أو على FakeBackends ذات نماذج الضوضاء التي يمكنك اختيارها في الإعدادات. الصفحات التي تحتاج إلى عتاد IBM Quantum أو إلى خدمات IBM السحابية تنبّهك إلى ذلك عند تشغيلها.

  • أجهزة IBM Quantum — أدخل رمز API و CRN في الإعدادات مرة واحدة — يتم حقن بيانات الاعتماد تلقائيًا في كل تشغيل. أنشئ حسابًا مجانيًا إذا لم يكن لديك حساب.

الخلفيات المتاحة للتنفيذ

كل درس تعليمي يحتوي على كتل برمجية قابلة للتنفيذ. انقر على Run لتنفيذها باستخدام إحدى الخلفيات الأربع:

  1. Binder (الافتراضي على GitHub Pages) — نواة Jupyter عن بُعد مجانية عبر mybinder.org

  2. IBM Code Engine — Jupyter بدون خادم على حساب IBM Cloud الخاص بك. البدء البارد في ثوانٍ بدلاً من دقائق. الإعداد

  3. Jupyter محلي (Docker / RasQberry) — يتصل بخادم Jupyter المحلي مع Qiskit مثبت مسبقًا

  4. خادم مخصص — حدّد أي نقطة نهاية Jupyter في الإعدادات

عند توفر خلفيات متعددة، اختر الخلفية المراد استخدامها من الإعدادات.

خيارات النشر

يتوفر doQumentation بالصيغ التالية:

  • GitHub Pages — موقع ثابت مع Binder أو IBM Code Engine لتنفيذ الكود عن بُعد

  • Docker — حزمة كاملة محليًا، قادر على العمل بدون إنترنت

  • RasQberry — مستضاف ذاتيًا على Raspberry Pi مع نواة Jupyter محلية

التشغيل محليًا باستخدام Podman / Docker

ثبّت Podman Desktop أو Docker Desktop (Mac / Windows / Linux)، ثم شغّل:

# Full stack: site + Jupyter + Qiskit (~3 GB)
podman run -p 8080:80 -p 8888:8888 ghcr.io/janlahmann/doqumentation:jupyter

افتح http://localhost:8080 — تنفيذ الكود يعمل محليًا، بدون وقت انتظار Binder.

هل تستخدم Docker بدلاً من ذلك؟ فقط استبدل podman بـ docker — الأوامر متطابقة. الصور متعددة البنيات (linux/amd64 + linux/arm64)، لذا تعمل أجهزة Apple Silicon Mac بشكل أصلي.

حول الموقع والشكر​

المحتوى مفتوح المصدر من IBM Quantum​

توفر IBM ثروة من المواد التعليمية في الحوسبة الكمومية — وجميعها مفتوحة المصدر بموجب ترخيص CC BY-SA 4.0:

منصة Quantum الخاصة بهم محدّثة دائمًا وحسنة التصميم — وهي أفضل مكان للقراءة والتعلم والمرجع.

ما يضيفه هذا المشروع​

وثائق Qiskit من IBM مفتوحة المصدر (CC BY-SA 4.0)، لكن تطبيق الويب الخاص بهم ليس كذلك. يضيف doQumentation واجهة أمامية مفتوحة المصدر مع تنفيذ مباشر للكود وحقن تلقائي لبيانات الاعتماد ووضع المحاكاة.

قابل للنشر في أي مكان — من GitHub Pages إلى Docker إلى RasQberry. انظر جميع الميزات.

عندما تكون مستعدًا للمزيد​

يساعدك doQumentation على اتخاذ خطواتك الأولى مع Qiskit — القراءة وتشغيل الكود والاستكشاف — دون تثبيت أي شيء. ومع تقدمك، توجه إلى منصة IBM الرسمية:

  • التشغيل على أجهزة حقيقية — أنشئ حساب IBM Cloud مجاني ونسخة Open Plan لتنفيذ الدوائر على حواسيب كمومية حقيقية.

  • أحدث المحتوى — تحتوي منصة Qiskit التعليمية من IBM على أحدث الدورات والدروس التعليمية والإضافات (قد لا يكون بعضها متاحًا بعد في doQumentation).

  • التطوير محليًا — قم بتثبيت Qiskit على حاسوبك المحمول للعمل التطويري الجاد.

مبني على وثائق IBM Quantum مفتوحة المصدر. شكرًا لفريق IBM Quantum على إتاحة هذا المحتوى بحرية بموجب رخصة CC BY-SA 4.0.