Lumaktaw sa pangunahing nilalaman

doQumentation

Ang doQumentation ay nagdadagdag ng feature-rich, user-friendly, open-source na frontend sa kumpletong open-source na mga tutorial, kurso, at dokumentasyon library ng IBM Quantum.

42Mga Tutorial
171Mga Gabay
154Mga pahina ng kurso
14Mga Modyul

Ang open-source na nilalaman ng IBM Quantum​

Nagbibigay ang IBM ng napakaraming quantum computing na materyales sa pag-aaral — lahat ay open source sa ilalim ng CC BY-SA 4.0:

  • Learning — Mga nakaayos na kurso mula sa mga basic ng quantum hanggang sa mga advanced na paksa
  • Tutorials — 40+ na mga tutorial tungkol sa transpilation, error mitigation, at iba pa
  • Documentation — Mga gabay at API reference para sa Qiskit
  • Source repo — Lahat ng nilalaman sa GitHub

Ang kanilang Quantum Platform ay palaging napapanahon at magandang-disenyo — ang pinakamahusay na lugar para sa pagbabasa, pag-aaral, at reference.

Ano ang idadagdag ng proyektong ito​

Ang Qiskit documentation ng IBM ay open source (CC BY-SA 4.0), ngunit ang kanilang web application ay hindi. Ang doQumentation ay nagdadagdag ng open-source na frontend na may live code execution, awtomatikong credential injection, at simulator mode.

Pwedeng i-deploy kahit saan — mula sa GitHub Pages hanggang sa Docker hanggang sa RasQberry. Tingnan ang lahat ng features.

Pagsisimula​

Bago sa quantum computing? Magsimula sa kurso. Pamilyar na ba sa Qiskit? Tumalon na sa isang tutorial o gabay.

Walang IBM Quantum account? I-enable ang Simulator Mode sa Settings upang magpatakbo ng lahat ng code nang hindi nag-sign up.

KursoBasics of Quantum InformationMagsimula dito — nakaayos na kurso mula sa single systems hanggang entanglementTutorialHello World: Ang Iyong Unang Quantum CircuitSariling intro ng doQumentation — bumuo ng Bell state, patakbuhin sa tatlong paraanGabayHello WorldGetting-started guide ng IBM — ang iyong unang Qiskit programTutorialCHSH InequalityMagpatakbo ng Bell test sa isang quantum computerTutorialAdvanced Techniques for QAOAPagbutihin ang performance ng QAOA sa malaking sukat gamit ang mga advanced na optimization techniques

Pagpapatakbo ng code​

Mag-click ng Run sa kahit anong code block. Ang unang click ay magsisimula ng libreng Jupyter kernel sa pamamagitan ng Binder or IBM Code Engine (1–2 min). Pagkatapos noon, instant na ang mga pagpapatakbo.

  • Simulator Mode (walang kailangang account) — I-enable ang Simulator Mode upang magpatakbo ng lahat ng notebooks gamit ang AerSimulator o noise-model FakeBackends. Walang kailangang setup.

  • IBM Quantum Hardware — Ilagay ang inyong API token at CRN sa Settings nang isang beses lamang — ang mga credentials ay awtomatikong ini-inject sa bawat pagpapatakbo. Gumawa ng libreng account kung wala pa kayong account.

Available na mga execution backend

Bawat tutorial ay may mga executable code blocks. Mag-click ng Run upang magpatakbo gamit ang isa sa tatlong backend:

  1. Binder (default sa GitHub Pages) — Libreng remote Jupyter kernel sa pamamagitan ng mybinder.org
  2. Local Jupyter (Docker / RasQberry) — Kumokonekta sa lokal na Jupyter server na may pre-installed na Qiskit
  3. Custom server — Ituro sa kahit anong Jupyter endpoint sa Settings

When multiple backends are available, choose which one to use from Settings.

Mga opsyon sa deployment

Ang doQumentation ay available bilang:

Magpatakbo nang lokal gamit ang Podman / Docker

Mag-install ng Podman Desktop o Docker Desktop (Mac / Windows / Linux), pagkatapos ay magpatakbo ng:

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

Buksan ang http://localhost:8080 — gumagana ang code execution nang lokal, walang paghihintay sa Binder.

Para sa magaan na bersyon na walang lokal na code execution (~60 MB):

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

Gumagamit ng Docker? Palitan lamang ang podman ng docker — pareho ang mga command. Ang mga image ay multi-arch (linux/amd64 + linux/arm64), kaya gumagana nang natural ang Apple Silicon Macs.