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

⚙️ إعدادات doQumentation

قم بتكوين خادم Jupyter المستخدم لتنفيذ تعليمات Python البرمجية في البرامج التعليمية.

البيئة الحالية: غير مكتشف

خلفية الخادم

اختر الخلفية المستخدمة لتنفيذ التعليمات البرمجية:

وضع التنفيذ

اختر ما يحدث عند النقر على تشغيل في صفحات البرامج التعليمية. ينطبق هذا فقط على تنفيذ التعليمات البرمجية المضمنة في هذا الموقع — فتح دفتر ملاحظات في JupyterLab يستخدم وقت تشغيل Qiskit القياسي.

تسري التغييرات في جلسة النواة التالية. إذا كانت التعليمات البرمجية قيد التشغيل، انقر رجوع ثم تشغيل للتطبيق.

حساب IBM Quantum

تعليمات الإعداد وملاحظات الأمان
ملاحظة أمنية: تُخزَّن بيانات الاعتماد كنص عادي في localStorage الخاص بهذا المتصفح، ولموقع هذه اللغة فقط (في موقع لغة أخرى أدخلها من جديد). لا تُوضع أبدًا في ملف تعريف ارتباط (cookie)، لذلك لا تُرسل إلى مضيف الويب. وهي غير مشفّرة ويمكن لإضافات المتصفح أو لأي شخص يصل إلى هذا الجهاز قراءتها. استخدم إعداد انتهاء الصلاحية أدناه للحد من التعرض، واحذف بيانات الاعتماد عند الانتهاء. على الأجهزة المشتركة أو العامة، استخدم بدلاً من ذلك الطريقة اليدوية save_account() الموضحة أدناه.

أدخل بيانات اعتماد IBM Quantum الخاصة بك مرة واحدة هنا. سيتم حقنها تلقائيًا عبر save_account() عند بدء النواة، لذلك لا تحتاج إلى إدخالها في كل دفتر ملاحظات. ينطبق هذا على تنفيذ التعليمات البرمجية المضمنة على هذا الموقع فقط — يتطلب فتح دفتر ملاحظات في JupyterLab استدعاء save_account() يدويًا.

  1. التسجيل في quantum.cloud.ibm.com/registration — لا حاجة لبطاقة ائتمان لأول 30 يومًا
  2. تسجيل الدخول في المثيلات
  3. المثيل — أنشئ مثيلاً مجانيًا من Open Plan في الصفحة الرئيسية إذا لم يكن لديك واحد بعد
  4. رمز API — انقر على أيقونة ملفك الشخصي (أعلى اليمين)، ثم "رمز API". انسخ المفتاح.

للخطوات التفصيلية، راجع دليل IBM إعداد المصادقة (الخطوة 2).

بديل: قم بتشغيل save_account() يدويًا في خلية دفتر ملاحظات

إذا كنت تفضل عدم تخزين بيانات الاعتماد في هذا المتصفح، الصق هذا في أي خلية تعليمات برمجية وقم بتشغيله. يتم حفظ بيانات الاعتماد في التخزين المؤقت لنواة Binder وتُفقد عند انتهاء الجلسة.

from qiskit_ibm_runtime import QiskitRuntimeService
QiskitRuntimeService.save_account(
    token="YOUR_API_TOKEN",
    instance="YOUR_CRN",
    overwrite=True
)

تفضيلات العرض

حجم خط التعليمات البرمجية

14px
from qiskit import QuantumCircuit

المخرجات المحسوبة مسبقًا

تعرض كل صفحة دفتر ملاحظات مخرجات محسوبة مسبقًا (صور وجداول ونصوص) من تشغيلات IBM الأصلية. وعند النقر على Run لتنفيذ التعليمات البرمجية مباشرةً، تُعرض المخرجات الأصلية ونتائجك الحية الجديدة معًا. عطّل هذا المفتاح لإخفاء المخرجات الأصلية أثناء التنفيذ المباشر وإبقاء نتائجك وحدها ظاهرة.

تحذيرات Python

افتراضيًا، يتم قمع تحذيرات Python (إشعارات الإهمال، تلميحات وقت التشغيل) للحصول على مخرجات دفتر ملاحظات أنظف. عطّل هذا لرؤية جميع التحذيرات — مفيد لتصحيح الأخطاء أو معرفة تغييرات API.

إدارة بياناتك

تبقى كل البيانات في متصفحك. على doqumentation.org يُحتفظ بتقدمك وإشاراتك المرجعية وإعداداتك في localStorage وفي ملفات تعريف ارتباط صغيرة تشاركها بين مواقع اللغات؛ تنتقل ملفات تعريف الارتباط هذه إلى مضيف الويب الثابت مع كل طلب صفحة، ولا تصل أبدًا إلى خادم doQumentation. لا توضع بيانات اعتماد IBM Quantum أبدًا في ملف تعريف ارتباط: فهي تبقى في localStorage على موقع اللغة الذي أدخلتها فيه. مسح بيانات المتصفح أو استخدام متصفح/جهاز آخر يبدأ من جديد.

تقدم التعلم

تظهر علامة ✓ في الشريط الجانبي للصفحات التي تمت زيارتها. وتعرض صفحات دفاتر الملاحظات </>: رمادي قبل الزيارة، وأزرق بعد الزيارة، وأخضر بعد تشغيل تعليمات برمجية فيها.

لم يتم تتبع أي تقدم بعد. قم بزيارة البرامج التعليمية والأدلة لبدء التتبع.

الإشارات المرجعية

لا توجد إشارات مرجعية بعد. استخدم زر الإشارة المرجعية في أي صفحة لحفظها هنا.

العرض والواجهة

الجلسات وبيانات الاعتماد

إعادة تعيين كل شيء

إزالة جميع البيانات المحفوظة بما في ذلك التقدم والإشارات المرجعية وتفضيلات العرض وبيانات الاعتماد.

الإعدادات المتقدمة

IBM Cloud Code Engine

يوفر IBM Cloud Code Engine نواة Jupyter سريعة وبدون خادم مدعومة بحساب IBM Cloud الخاص بك. يستغرق التشغيل ثوانٍ بدلاً من دقائق. تغطي الطبقة المجانية ~14 ساعة/شهر.

تعليمات الإعداد
  1. أنشئ حساب IBM Cloud على cloud.ibm.com (الطبقة المجانية متاحة)
  2. اذهب إلى IBM Cloud Code Engine console وأنشئ مشروعًا جديدًا في منطقتك المفضلة
  3. أنشئ تطبيقًا جديدًا بصورة ghcr.io/janlahmann/doqumentation-codeengine:latest، منفذ الاستماع 8080
    التحديد: 1 vCPU / 2 GB لمستخدم واحد، 8 vCPU / 16 GB لورش العمل (حتى 80 مستخدمًا)
  4. اضبط متغيرات البيئة: JUPYTER_TOKEN لرمز آمن (حد أدنى 32 حرفًا) وCORS_ORIGIN لنطاقك (مثل https://doqumentation.org)

لتفاصيل تحديد حجم ورشة العمل، انظر وثائق إعداد ورشة العمل.

حزم Binder

عند التشغيل على GitHub Pages، يتم تنفيذ التعليمات البرمجية عبر MyBinder. تتضمن بيئة Binder حزم Qiskit الأساسية مثبتة مسبقًا:

qiskit[visualization], qiskit-aer,
qiskit-ibm-runtime, pylatexenc,
qiskit-ibm-catalog, qiskit-addon-utils, pyscf

تتطلب بعض دفاتر الملاحظات حزمًا إضافية. يمكنك تثبيتها عند الطلب عن طريق تشغيل هذا في خلية تعليمات برمجية:

!pip install -q <package>

أو قم بتثبيت جميع الحزم الاختيارية دفعة واحدة:

!pip install -q scipy scikit-learn qiskit-ibm-transpiler \
  qiskit-experiments plotly sympy qiskit-serverless \
  qiskit-addon-sqd qiskit-addon-mpf \
  qiskit-addon-aqc-tensor[aer,quimb-jax] \
  qiskit-addon-obp qiskit-addon-cutting ffsim \
  gem-suite python-sat

مساعدة الإعداد

إعداد RasQberry

يشغّل RasQberry حاوية doQumentation (راجع إعداد Docker أدناه). افتح الموقع من عنوان Pi، المنفذ 8080، وستعمل التعليمات البرمجية على Pi دون أي إعداد إضافي.

دليل ورشة العمل دون اتصال: شغّل صفًا دراسيًا من جهاز Raspberry Pi واحد

إعداد Jupyter المحلي

ابدأ خادم Jupyter يقبل هذا الموقع فقط، برمز تختاره أنت، ثم أدخل عنوانه URL ورمزه ضمن الخادم المخصص أعلاه:

jupyter server --ServerApp.token='choose-a-long-token' \
  --ServerApp.allow_origin='https://doqumentation.org' \
  --ServerApp.disable_check_xsrf=True

إعداد Docker

يقوم حاوية Docker بإنشاء رمز Jupyter عشوائي عند بدء التشغيل. يعمل تنفيذ التعليمات البرمجية عبر الموقع (المنفذ 8080) تلقائيًا — لا حاجة للرمز. الرمز مطلوب فقط للوصول المباشر إلى JupyterLab على المنفذ 8888.

لاسترداد الرمز من سجلات الحاوية:

podman logs doq | grep "Jupyter token"

لتعيين رمز ثابت:

podman run -d --name doq --restart unless-stopped \
  -e JUPYTER_TOKEN=choose-a-token \
  -p 8080:80 -p 127.0.0.1:8888:8888 \
  ghcr.io/janlahmann/doqumentation:jupyter

خادم بعيد

بالنسبة للخوادم البعيدة، تأكد من تكوين CORS للسماح بالاتصالات من هذا الموقع. أضف ما يلي إلى jupyter_server_config.py الخاص بك:

c.ServerApp.allow_origin = 'https://doqumentation.org'
c.ServerApp.allow_credentials = True