انتقل إلى المحتوى الرئيسي

doQumentation

يضيف doQumentation واجهة أمامية مفتوحة المصدر غنية بالميزات وسهلة الاستخدام لمكتبة IBM Quantum الكاملة من الدروس التعليمية والدورات والوثائق مفتوحة المصدر.

42درس تعليمي
171دليل إرشادي
154صفحة دورة
14وحدة

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

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

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

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

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

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

البدء​

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

ليس لديك حساب IBM Quantum؟ فعّل وضع المحاكاة في الإعدادات لتشغيل جميع الأكواد دون الحاجة للتسجيل.

دورةأساسيات المعلومات الكموميةابدأ من هنا — دورة منظمة من الأنظمة المفردة إلى التشابك الكموميدرس تعليميHello World: أول دائرة كمومية لكمقدمة doQumentation الخاصة — أنشئ حالة Bell وشغّلها بثلاث طرقدليلHello Worldدليل البدء من IBM — أول برنامج Qiskit لكدرس تعليميمتباينة CHSHأجرِ اختبار Bell على حاسوب كموميدرس تعليميتقنيات متقدمة لـ QAOAحسّن أداء QAOA على نطاق واسع باستخدام تقنيات تحسين متقدمة

تنفيذ الكود​

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

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

  • أجهزة 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.

للحصول على نسخة خفيفة بدون تنفيذ كود محلي (~60 MB):

# Static site only — code execution still works via Binder
podman run -p 8080:80 ghcr.io/janlahmann/doqumentation:latest

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