Jupyter Book 확장 만들기

아티클
02/06/2025

중요하다

Azure Data Studio는 2026년 2월 28일에 사용 중지됩니다. Visual Studio Code을 사용하는 것을 권장합니다. Visual Studio Code로 마이그레이션하는 방법에 대한 자세한 내용은 Azure Data Studio에 무슨 일이 일어나고 있는지 확인하세요.

이 자습서에서는 새 Jupyter Book Azure Data Studio 확장을 만드는 방법을 보여 줍니다. 확장에는 Azure Data Studio에서 열고 실행할 수 있는 샘플 Jupyter book이 제공됩니다.

이 문서에서는 다음 방법을 알아봅니다.

확장 프로젝트를 만듭니다.
확장 생성기를 설치합니다.
Jupyter Book 확장 만들기
확장을 실행합니다.
확장을 패키지합니다.
마켓플레이스에 확장 게시

사용된 API

bookTreeView.openBook

확장 사용 사례

Jupyter Book 확장을 만드는 데는 몇 가지 다양한 이유가 있습니다.

구성 및 섹션화된 대화형 설명서 공유
전체 book 공유(Notebook과 유사하지만 Azure Data Studio를 통해 배포됨)
버전 및 Jupyter Book 업데이트 추적

Jupyter Book과 Notebook 확장의 주요 차이점은 Jupyter Book에서 조직을 제공한다는 점입니다. Jupyter Book에서 수십 개의 Notebook을 다른 장으로 분할할 수 있지만 Notebook 확장은 적은 수의 개별 Notebook을 배송하기 위한 것입니다.

필수 조건

Azure Data Studio는 Visual Studio Code와 동일한 프레임워크를 기준으로 하므로 Azure Data Studio 확장은 Visual Studio Code를 사용하여 빌드됩니다. 시작하려면 다음 구성이 필요합니다.

에서 설치되고 사용할 수 있는 $PATH. Node.js에는 확장 생성기를 설치하는 데 사용되는 Node.js 패키지 관리자인 npm이 포함되어 있습니다.
확장을 변경하고 확장을 디버그하는 Visual Studio Code 입니다.
azuredatastudio이 경로에 있는지 확인합니다. Windows의 경우 setup.exe 경로에 추가 옵션을 선택해야 합니다. Mac 또는 Linux의 경우 Azure Data Studio의 명령 팔레트에서 Install 'azuredatastudio' command in PATH를 실행합니다.

확장 생성기를 설치합니다.

확장을 만드는 프로세스를 간소화하기 위해 Yeoman을 사용하여 확장 생성기를 빌드했습니다. 설치하려면 명령 프롬프트에서 다음 명령을 실행합니다.

npm install -g yo generator-azuredatastudio

확장을 만듭니다.

확장을 만들려면

다음 명령을 사용하여 확장 생성기를 시작합니다.

yo azuredatastudio
확장 유형 목록에서 새 Jupyter Book을 선택합니다.
확장 프로그램 이름을 입력하는 단계를 따르세요. 이 자습서에서는 Book 테스트를 사용합니다. 그런 다음 게시자 이름을 입력합니다. 이 자습서에서는 Microsoft를 사용합니다. 마지막으로 설명을 추가합니다.

기존 Jupyter Book을 제공하거나, 제공된 샘플 북을 사용하거나, 새 Jupyter Book을 만들도록 선택합니다. 세 가지 옵션이 모두 표시됩니다.

기존 Book 제공

이미 만든 Book을 이동하려면 Book 내용이 있는 폴더에 대한 절대 파일 경로를 제공합니다. 그런 다음 확장에 대해 알아보고 이동할 준비가 될 수 있습니다.

기존 Book을 보여 주는 스크린샷

샘플 Book 사용

기존 Book이나 Notebook이 없는 경우 생성기에서 제공된 샘플을 사용할 수 있습니다.

Jupyter Book 샘플을 보여주는 스크린샷.

샘플 Book은 간단한 Jupyter Book의 모양을 보여 줍니다. Jupyter Book을 사용자 지정하는 방법을 알아보려면 기존 Notebook을 사용하여 새 Book을 만드는 방법에 대한 다음 섹션을 참조하세요.

새 Book 만들기

Jupyter Book에 패키지할 Notebook이 있는 경우 패키지가 가능합니다. 생성기는 Book의 장을 원하는지, 그렇다면 얼마나 많은 제목을 원하는지 묻습니다. 선택 프로세스는 여기와 같습니다. 스페이스바를 사용하여 각 챕터에 배치하려는 Notebook을 선택합니다.

Jupyter Book을 만드는 프로세스를 보여 주는 스크린샷

이전 단계를 완료하면 새 Jupyter Book이 있는 새 폴더가 만들어집니다. Visual Studio Code에서 폴더를 엽니다. 이제 Jupyter Book 확장을 전달할 준비가 되었습니다.

확장 이해하기

현재 프로젝트는 다음과 같을 것입니다.

확장 파일 구조를 보여 주는 스크린샷

이 vsc-extension-quickstart.md 파일은 중요한 파일에 대한 참조를 제공합니다. README.md 파일은 새 확장에 대한 설명서를 제공할 수 있습니다. package.json, jupyter-book.ts, content 및 toc.yml 파일에 유의하세요. content 폴더는 모든 Notebook 또는 markdown 파일을 보유합니다. 확장 생성기를 통해 사용자 지정 Jupyter Book을 만들도록 선택한 경우 Jupyter Book의 toc.yml 구조와 자동 생성됩니다.

생성기를 사용하여 Book을 만들고 Book의 장을 선택한 경우 폴더 구조는 약간 다르게 보일 것입니다. content 폴더에 있는 markdown 및 Jupyter Notebook 파일 대신 챕터에 대해 선택한 제목에 해당하는 하위 폴더가 있습니다.

게시하지 않으려는 파일 또는 폴더가 있는 경우 해당 이름을 .vscodeignore 파일에 포함할 수 있습니다.

새로 구성된 확장이 수행하는 작업 jupyter-book.ts을 이해해 보겠습니다.

// This function is called when you run the command `Launch Book: Test Book` from the
// command palette in Azure Data Studio. If you want any additional functionality
// to occur when you launch the book, add it to the activate function.
export function activate(context: vscode.ExtensionContext) {
    context.subscriptions.push(vscode.commands.registerCommand('launchBook.test-book', () => {
        processNotebooks();
    }));

    // Add other code here if you want to register another command.
}

activate 함수는 확장의 주요 작업입니다. 등록할 명령이 activate 명령과 비슷하게 launchBook.test-book 함수 내에 표시되어야 합니다. processNotebooks 함수 내에서 Jupyter Book을 보유하고 확장 폴더를 매개 변수로 사용하여 bookTreeView.openBook를 호출 하는 확장 폴더를 찾습니다.

또한 package.json 파일은 확장명 명령을 등록하는 데 중요한 역할을 합니다.

"activationEvents": [
		"onCommand:launchBook.test-book"
	],
	"main": "./out/notebook.js",
	"contributes": {
		"commands": [
			{
				"command": "launchBook.test-book",
				"title": "Launch Book: Test Book"
			}
		]
	}

활성화 이벤트 onCommand는 명령을 호출할 때 등록한 함수를 트리거합니다. 추가 사용자 지정이 가능한 몇 가지 다른 활성화 이벤트가 있습니다. 자세한 내용은 활성화 이벤트를 참조하세요.

확장을 패키지합니다.

다른 사용자와 공유하려면 확장명을 단일 파일로 패키지해야 합니다. 확장을 Azure Data Studio 확장 마켓플레이스에 게시하거나 팀 또는 커뮤니티와 공유할 수 있습니다. 이 단계를 수행하려면 명령줄에서 다른 npm 패키지를 설치해야 합니다.

npm install -g vsce

원하는 대로 README.md 파일을 편집합니다. 그런 다음 확장의 기본 디렉터리로 이동하여 vsce package를 실행 합니다. 필요에 따라 리포지토리를 확장에 연결하거나 리포지토리 없이 계속할 수 있습니다. 파일을 추가하려면 package.json 파일에 비슷한 줄을 추가합니다.

"repository": {
    "type": "git",
    "url": "https://github.com/laurajjiang/testbook.git"
}

이러한 줄이 추가되면 my test-book-0.0.1.vsix 파일이 만들어지고, Azure Data Studio에 설치할 준비가 됩니다.

확장 실행

확장을 실행하고 테스트하려면 Azure Data Studio를 열고 Ctrl+Shift+P를 선택하여 명령 팔레트를 엽니다. 확장 프로그램 명령 찾기: VSIX에서 확장 설치하고 새 확장 프로그램이 들어 있는 폴더로 이동합니다. 이제 Azure Data Studio의 확장 패널에 표시됩니다.

VSIX 설치를 보여 주는 스크린샷

명령 팔레트를 다시 열고, 등록한 명령 Book 시작: 테스트 Notebook을 찾으세요. 실행 시 확장으로 패키지한 Jupyter Book을 열어야 합니다.

Notebook 명령을 보여주는 스크린샷.

축하합니다! 이제 첫 번째 Jupyter Book 확장을 빌드하고 이동할 수 있습니다. Jupyter Books에 대한 자세한 내용은 Jupyter가 포함된 Book을 참조 하세요.

Marketplace에 확장 게시

Azure Data Studio 확장 마켓플레이스는 생성 중에 있습니다. 게시하려면 확장 VSIX를 어딘가(예: GitHub 릴리스 페이지)에 호스팅합니다. 확장 정보를 사용하여 이 JSON 파일을 업데이트하는 끌어오기 요청을 제출합니다.

다음 단계

이 자습서에서는 다음 작업 방법을 알아보았습니다.

확장 프로젝트를 만듭니다.
확장 생성기를 설치합니다.
Jupyter Book 확장 만들기
확장을 패키지합니다.
마켓플레이스에 확장 게시

이 문서를 읽은 후에는 Azure Data Studio 커뮤니티와 공유하려는 Jupyter Books에 대한 아이디어를 얻게 되기를 바랍니다.

아이디어가 있지만 시작하는 방법을 잘 모르는 경우 이슈를 열거나 azuredatastudio에 있는 팀에 트윗하세요.

자세한 내용은 Visual Studio Code 확장 가이드에서 모든 기존 API 및 패턴을 설명합니다.

다음을 통해 공유