doQumentation
doQumentation přidává bohatý, uživatelsky přívětivý open-source frontend ke kompletní knihovně open-source tutoriálů, kurzů a dokumentace IBM Quantum.
Open-source obsah IBM Quantum
IBM poskytuje bohaté výukové materiály o kvantovém výpočetnictví — vše open-source pod licencí CC BY-SA 4.0:
- Learning — Strukturované kurzy od základů kvantového výpočetnictví po pokročilá témata
- Tutorials — Přes 40 tutoriálů o transpilaci, zmírnění chyb a dalším
- Documentation — Průvodci a reference API pro Qiskit
- Source repo — Veškerý obsah na GitHubu
Jejich Quantum Platform je vždy aktuální a dobře navržená — nejlepší místo pro čtení, učení a vyhledávání informací.
Co tento projekt přidává
Dokumentace Qiskit od IBM je open-source (CC BY-SA 4.0), ale jejich webová aplikace není. doQumentation přidává open-source frontend s živým spouštěním kódu, automatickým vkládáním přihlašovacích údajů a simulátorovým režimem.
Nasaditelný kdekoliv — od GitHub Pages přes Docker až po RasQberry. Viz všechny funkce.
Až budeš připraven na víc
doQumentation ti pomáhá udělat první kroky s Qiskitem — číst, spouštět kód a prozkoumávat — aniž bys musel cokoli instalovat. Až budeš chtít pokročit dál, přejdi na oficiální platformu IBM:
- Spouštěj na skutečném hardwaru — vytvoř si bezplatný účet IBM Cloud a instanci Open Plan, abys mohl spouštět obvody na skutečných kvantových počítačích.
- Nejnovější obsah — vzdělávací platforma Qiskit od IBM má nejnovější kurzy, tutoriály a doplňky (některé z nich nemusí být v doQumentation ještě k dispozici).
- Vyvíjej lokálně — nainstaluj si Qiskit na svůj vlastní notebook pro vážnější vývojářskou práci.
Postaveno na open-source dokumentaci IBM Quantum. Děkujeme týmu IBM Quantum za to, že tento obsah zpřístupňuje volně pod licencí CC BY-SA 4.0.
Jak začít
Nováček v kvantovém výpočetnictví? Začni kurzem. Qiskit už znáš? Přejdi rovnou na tutoriál nebo průvodce.
Nemáš účet IBM Quantum? Zapni Simulátorový režim v Nastavení, abys mohl spouštět veškerý kód bez registrace.
Spouštění kódu
Klikni Run na libovolném bloku kódu. První kliknutí spustí kernel Jupyter přes Binder nebo IBM Code Engine. Poté jsou spuštění okamžitá.
-
Simulátorový režim (bez účtu) — Zapni Simulátorový režim, abys mohl spouštět všechny notebooky s AerSimulator nebo FakeBackends s modelem šumu. Žádné nastavení není potřeba.
-
Hardware IBM Quantum — Zadej svůj API token a CRN v Nastavení jednou — přihlašovací údaje se automaticky vkládají při každém spuštění. Vytvoř si bezplatný účet, pokud ho ještě nemáš.
Dostupné backendy pro spouštění
Každý tutoriál má spustitelné bloky kódu. Klikni Run a spusť je pomocí jednoho ze čtyř backendů:
- Binder (výchozí na GitHub Pages) — Zdarma vzdálený kernel Jupyter přes mybinder.org
- IBM Code Engine — Bezserverový Jupyter na tvém IBM Cloud účtu. Cold start v sekundách místo minut. Nastavit
- Lokální Jupyter (Docker / RasQberry) — Připojuje se k lokálnímu serveru Jupyter s předinstalovaným Qiskit
- Vlastní server — Nasměruj na libovolný Jupyter endpoint v Nastavení
Když je dostupných více backendů, vyber který použít v Nastavení.
Možnosti nasazení
doQumentation je k dispozici jako:
- GitHub Pages — Statický web s Binder nebo IBM Code Engine pro vzdálené spouštění kódu
- Docker — Plný stack lokálně, schopný fungovat offline
- RasQberry — Self-hosted na Raspberry Pi s lokálním kernelem Jupyter
Spusť lokálně s Podman / Docker
Nainstaluj Podman Desktop nebo Docker Desktop (Mac / Windows / Linux), pak spusť:
# Full stack: site + Jupyter + Qiskit (~3 GB)
podman run -p 8080:80 -p 8888:8888 ghcr.io/janlahmann/doqumentation:jupyter
Otevři http://localhost:8080 — spouštění kódu funguje lokálně, žádné čekání na Binder.
Pro odlehčenou verzi bez lokálního spouštění kódu (~60 MB):
# Static site only — code execution still works via Binder
podman run -p 8080:80 ghcr.io/janlahmann/doqumentation:latest
Používáš Docker? Stačí nahradit podman za docker — příkazy jsou identické. Obrazy jsou multi-arch (linux/amd64 + linux/arm64), takže Apple Silicon Macy fungují nativně.