JupyterLab Extension

개요

Quarto JupyterLab 확장은 Quarto 마크다운을 사용하는 JupyterLab 노트북에서 마크다운 셀의 내용을 올바르게 표시할 수 있게 해줍니다. 예를 들어 Quarto JupyterLab 확장을 설치하면 노트북에서 콜아웃, Div, Mermaid 차트 등의 요소는 물론 다른 Quarto 요소(문서 프론트매터를 제목 블록으로 표시하는 기능 포함)의 렌더링 미리보기가 표시됩니다.

확장 설치

설치는 사용하는 JupyterLab 버전에 따라 다릅니다:

Quarto JupyterLab 확장은 다음 두 가지 방법 중 하나로 설치할 수 있습니다:

  1. JupyterLab UI에서: Extension Manager에서 ’Quarto’를 검색해 jupyterlab-quarto 확장을 설치합니다. 완료되면 페이지를 새로고침하라는 안내가 표시됩니다.

    Jupyter Lab Extension Manager에서 검색 상자에 'quarto'가 입력되어 있고, 검색 결과로 'jupyterlab-quarto' 이름의 확장이 표시된 화면.

  2. pip 사용:

    플랫폼 | 명령 |
    Mac/Linux 
    Terminal
    python3 -m pip install jupyterlab-quarto
    Windows 
    Terminal
    py -m pip install jupyterlab-quarto

Quarto JupyterLab 확장은 다음 두 가지 방법 중 하나로 설치할 수 있습니다:

  1. pip을 사용해 jupyterlab-quarto를 다음과 같이 설치합니다:

    플랫폼 | 명령 |
    Mac/Linux 
    Terminal
    python3 -m pip install jupyterlab-quarto==0.1.45
    Windows 
    Terminal
    py -m pip install jupyterlab-quarto==0.1.45

    이 방법은 전통적인 Python 패키징을 활용하고 JupyterLab을 다시 빌드할 필요가 없으므로, JupyterLab Quarto 확장을 설치할 때 권장되는 방식입니다.

  2. JupyterLab UI에서 Extension Manager를 사용해 ’Quarto’를 검색하고 @quarto/jupyterlab-quarto 확장을 설치할 수도 있습니다. 설치를 완료하려면 JupyterLab을 다시 빌드해야 합니다(Quarto 확장을 설치한 뒤 완료하라는 안내가 표시됩니다).

확장 사용

Quarto 확장은 설치 후 노트북의 마크다운 셀 내용을 자동으로 렌더링합니다. Quarto 전용 마크다운이 없는 셀은 정상적으로 렌더링되고, Quarto 전용 마크다운이 포함된 셀은 더 사용하기 쉬운 형태로 미리보기가 표시됩니다.

Note

노트북에 표시되는 Quarto 콘텐츠는 실제 렌더링 출력과 정확히 일치하지 않습니다. 예를 들어 노트북에 표시되는 콜아웃은 마크다운에 지정한 콜아웃 옵션에 따라 표시가 바뀌지 않습니다.

확장 비활성화

  1. pip으로 Quarto JupyterLab 확장을 설치했다면 다음 명령으로 확장을 비활성화하거나 활성화할 수 있습니다.

    확장을 비활성화하려면 다음 명령을 사용하세요:

    플랫폼 | 명령 |
    Mac/Linux 
    Terminal
    python3 -m jupyter labextension disable jupyterlab-quarto
    Windows 
    Terminal
    py -m jupyter labextension disable jupyterlab-quarto

    확장을 활성화하려면 다음 명령을 사용하세요:

    플랫폼 | 명령 |
    Mac/Linux 
    Terminal
    python3 -m jupyter labextension enable jupyterlab-quarto
    Windows 
    Terminal
    py -m jupyter labextension enable jupyterlab-quarto

  2. JupyterLab Notebook Extension Manager로 Quarto JupyterLab 확장을 설치했다면 UI에서 직접 확장을 비활성화하거나 활성화할 수 있습니다.

확장 제거

  1. pip으로 확장을 설치했다면 다음과 같이 pip으로 Quarto 확장을 제거할 수 있습니다.

    플랫폼 | 명령 |
    Mac/Linux 
    Terminal
    python3 -m pip uninstall jupyterlab-quarto
    Windows 
    Terminal
    py -m pip uninstall jupyterlab-quarto

  2. JupyterLab Notebook Extension Manager로 확장을 설치했다면 Extension Manager에서 확장을 제거하세요. 제거를 완료하려면 JupyterLab을 다시 빌드해야 합니다(Quarto 확장을 제거하면 완료하라는 안내가 표시됩니다).

이슈 보고

Quarto JupyterLab 확장과 관련된 이슈는 여기로 알려주세요.