주 콘텐츠로 건너뛰기

기능

doQumentation은 IBM Quantum의 오픈소스 콘텐츠를 라이브 코드 실행, 시뮬레이터 모드, 학습 진행 추적 기능을 갖춘 대화형 학습 플랫폼으로 변환합니다.

콘텐츠 라이브러리

381페이지 콘텐츠

튜토리얼 42개, 가이드 171개, 강좌 페이지 154개, 모듈 14개 — 모두 IBM Quantum의 오픈소스 Qiskit 문서에서 가져온 것입니다.

튜토리얼 찾아보기

업스트림 자동 동기화

IBM의 GitHub 저장소에서 자동으로 동기화되어 튜토리얼과 강좌가 최신 Qiskit 릴리스로 유지됩니다. Last upstream content update: 2026-05-15 (commit 0fa4b3f).

구조화된 탐색

접을 수 있는 카테고리가 있는 자동 생성 사이드바입니다. 튜토리얼, 가이드, 강좌, 모듈 각각 자체 사이드바를 가지고 있습니다.

라이브 코드 실행

실행 / 뒤로 토글

각 노트북 페이지에는 라이브 Jupyter 커널로 모든 코드 셀을 활성화하는 실행 버튼이 있습니다. 뒤로를 클릭하면 정적 뷰로 돌아갑니다.

세 가지 실행 Backend

Binder를 통한 무료 원격 실행(설치 불필요), Docker를 통한 완전 오프라인, 또는 RasQberry Pi에서 자체 호스팅.

Backend 구성

IBM Cloud Code Engine

IBM Cloud 계정에서 서버리스 Jupyter 커널을 실행합니다. Binder의 10~25분 대신 몇 초만에 콜드 스타트가 됩니다. 무료 티어는 월 약 14시간을 제공합니다.

Code Engine 설정

워크숍 모드

최대 50명 참가자로 교실 워크숍을 진행합니다. 여러 Code Engine 인스턴스를 배포하고 단일 URL을 공유하면 참가자가 고정 세션과 자동 장애 조치로 자동 분산됩니다.

워크숍 설정 가이드

워크숍 모니터링

자동 새로고침(30초)이 있는 라이브 대시보드에서 인스턴스별 커널 수, 바쁜 커널, 연결, 메모리 사용량, 업타임을 확인할 수 있습니다. 각 인스턴스는 /stats 엔드포인트를 제공합니다. 스트레스 테스트 스크립트가 수업 시작 전 용량 한계를 찾기 위해 동시 사용자를 시뮬레이션합니다.

설정 대시보드

Google Colab에서 열기

모든 노트북 페이지에는 설치 없이 클라우드에서 실행할 수 있는 'Colab에서 열기' 버튼이 있습니다. 다른 언어로 탐색할 때 번역된 노트북을 엽니다.

셀 실행 피드백

각 셀에 대한 시각적 피드백: 실행 중 황색 테두리, 완료 시 녹색, 오류 시 빨간색. 커널 준비 시 도구 모음에 범례가 표시됩니다.

문맥적 오류 힌트

ModuleNotFoundError, NameError 및 커널 연결 끊김을 자동 감지합니다. 제안된 수정 사항과 함께 셀 아래에 실행 가능한 힌트가 표시됩니다.

원클릭 Pip 설치

누락된 패키지가 감지되면 클릭 가능한 '설치' 버튼이 표시됩니다. 설치가 완료된 후 실패한 셀이 자동으로 다시 실행됩니다.

JupyterLab에서 열기

각 노트북 페이지에는 고급 편집 및 탐색을 위해 JupyterLab에서 전체 .ipynb 파일을 여는 버튼이 있습니다.

모두 실행 및 재시작

모두 실행은 라이브 진행 카운터와 함께 모든 셀을 순서대로 실행합니다. 언제든지 현재 셀 이후에 중지할 수 있습니다. 재시작하면 Binder 세션을 잃지 않고 새 커널을 얻습니다.

IBM Quantum 통합

자격 증명 저장소

IBM Quantum API 토큰과 CRN을 설정에 한 번 저장하세요. 브라우저에 로컬로 저장되며 보안을 위해 7일 자동 만료됩니다.

자격 증명 설정

자동 주입

시작 시 자격 증명이 커널에 자동으로 주입됩니다. 더 이상 모든 노트북에 토큰을 붙여넣을 필요가 없습니다 — 그냥 실행을 클릭하세요.

시뮬레이터 모드

IBM Quantum 계정 없이 모든 노트북을 실행하세요. 이상적인 시뮬레이션을 위한 AerSimulator를 선택하거나 실제 기기 노이즈를 모델링하는 수십 개의 FakeBackend 중 선택하세요. 설정이 필요 없습니다.

시뮬레이터 활성화

실행 모드 배지

도구 모음에 활성 모드(예: 'FakeSherbrooke') 또는 'IBM Quantum'이 표시되어 코드가 어떻게 실행되는지 항상 알 수 있습니다.

학습 및 진도

진도 추적

방문한 페이지는 사이드바에 체크 표시(✓)가 생깁니다. 실행된 노트북은 재생 표시(▶)가 생깁니다. 콘텐츠를 통한 학습 여정을 추적하세요.

카테고리 배지

각 사이드바 카테고리에 '3/10'과 같은 배지가 표시되어 진행 상황을 한눈에 볼 수 있습니다. 클릭하면 섹션별 진행 상황이 지워집니다.

읽기 재개

홈 페이지에 마지막으로 방문한 페이지와 방문 시간이 포함된 '중단한 곳에서 계속하기' 카드가 표시됩니다.

홈으로 이동

북마크

페이지에 별표를 눌러 북마크하세요. 북마크는 홈 페이지에 표시됩니다. 로컬에 저장되며 최대 50페이지입니다.

북마크 보기

최근 페이지

홈 페이지에 빠른 접근을 위해 최근 방문한 5개 페이지가 표시됩니다.

홈으로 이동

디스플레이 설정

코드 글꼴 크기(10~22px) 조정, 정적 셀 출력 토글, 더 깔끔한 출력을 위한 Python 경고 억제 기능을 사용하세요.

디스플레이 조정

온보딩 팁

처음 방문하는 사용자는 노트북 페이지에서 "실행을 클릭하여 코드를 라이브로 실행하세요"와 같은 상황별 팁을 봅니다. 팁은 몇 번 방문 후 자동으로 사라집니다.

다국어

20개 언어

전체 사이트는 독일어, 일본어, 스페인어, 프랑스어 등 20개 언어로 이용 가능합니다. 각 언어는 번역된 UI가 있는 고유한 서브도메인에서 실행됩니다.

자동 폴백

번역되지 않은 페이지는 독자 언어의 배너와 함께 영어로 표시되므로 어떤 페이지도 없어지는 일이 없습니다.

검색, UI 및 배포

로컬 검색

전체 381페이지에 걸친 전문 검색, 오프라인에서도 작동합니다. 입력하는 즉시 결과가 표시됩니다.

다크 모드

다크 모드를 완전히 지원합니다. 회로 다이어그램과 Matplotlib 출력이 가독성을 위해 자동으로 반전됩니다.

동영상 삽입

안정적인 재생을 위한 YouTube 강좌 동영상. YouTube를 사용할 수 없을 때 IBM Video로 대체됩니다.

Docker 배포

GitHub Container Registry에 CI/CD가 포함된 다단계 Docker 빌드. 전체 스택(웹사이트 + Jupyter) 또는 경량 정적 이미지.

모바일 반응형

햄버거 네비게이션, 가로 코드 스크롤, 반응형 카드 그리드. 휴대폰과 태블릿에서 작동합니다.

수식 렌더링

모든 콘텐츠 페이지에서 빠르고 고품질의 LaTeX 수학 렌더링을 위한 KaTeX — 방정식, 행렬, 양자 표기법.