דלג לתוכן הראשי
פרויקט זה בשלב בטא. מצאת באג? פתח issue ב-GitHub. יש שאלה או רעיון? שאל ב-Discussions — נשמח לשמוע ממך!
מה איכות התרגום בדף זה?

⚙️ הגדרות doQumentation

הגדר את שרת Jupyter המשמש להרצת קוד Python בהדרכות.

סביבה נוכחית: לא זוהה

Backend שרת

בחר איזה backend להשתמש להרצת קוד:

מצב הרצה

בחר מה קורה כשלוחצים על הרץ בדפי הדרכה. זה חל על הרצת קוד מוטמע באתר זה בלבד — פתיחת מחברת ב-JupyterLab משתמשת בזמן ריצה הסטנדרטי של Qiskit.

שינויים נכנסים לתוקף בסשן הגרעין הבא. אם הקוד רץ, לחץ על חזרה ואז על הרץ להחיל.

חשבון IBM Quantum

הוראות הגדרה והערות אבטחה
הערת אבטחה: האישורים נשמרים כטקסט רגיל ב-localStorage של הדפדפן הזה, באתר של השפה הזו בלבד (באתר של שפה אחרת צריך להזין אותם שוב). הם אינם נשמרים בעוגייה, ולכן לא נשלחים לשרת האירוח. הם אינם מוצפנים, ותוספים של הדפדפן או כל מי שיש לו גישה למכשיר הזה יכולים לקרוא אותם. השתמש בהגדרת התפוגה שלמטה כדי להגביל את החשיפה, ומחק את האישורים כשתסיים. במחשבים משותפים או ציבוריים עדיף להשתמש בשיטה הידנית עם save_account() המתוארת למטה.

הזן את פרטי הזדהות IBM Quantum פעם אחת כאן. הם יוזרקו אוטומטית דרך save_account() כשהגרעין מתחיל, כך שאין צורך להזין אותם בכל מחברת. זה חל על הרצת קוד מוטמע באתר זה בלבד — פתיחת מחברת ב-JupyterLab דורשת קריאה ל-save_account() ידנית.

  1. הרשם ב-quantum.cloud.ibm.com/registration — לא נדרש כרטיס אשראי ל-30 הימים הראשונים
  2. התחבר ב-מופעים
  3. מופע — צור מופע Open Plan חינמי ב-דף הבית אם אין לך עדיין
  4. API Token — לחץ על סמל הפרופיל שלך (למעלה מימין), ואז "API token". העתק את המפתח.

לשלבים מפורטים, ראה מדריך הגדר אימות של 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 מהיר וserverless בחשבון 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 ל-workshops (עד 80 משתמשים)
  4. הגדר משתני סביבה: JUPYTER_TOKEN לטוקן מאובטח (מינימום 32 תווים) ו-CORS_ORIGIN לדומיין שלך (למשל https://doqumentation.org)

לפרטי גודל workshop, ראה תיעוד הגדרת workshop.

חבילות 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