voila
v0.5.8
대화형 위젯을 사용하여 라이브 Jupyter 노트북을 렌더링합니다.
Voilà는 Jupyter 노트북을 독립형 웹 애플리케이션으로 전환합니다.
일반적인 HTML 변환 노트북과 달리 Voilà tornado 애플리케이션에 연결하는 각 사용자는 Jupyter 대화형 위젯의 변경 사항에 대한 콜백을 실행할 수 있는 전용 Jupyter 커널을 얻습니다.
기본적으로 Voilà는 프런트 엔드의 실행 요청을 허용하지 않아 임의 코드 실행을 방지합니다.
기본적으로 Voilà는 렌더링된 노트북에서 입력 셀을 제거하는 strip_sources 옵션으로 실행됩니다.
Voilà는 conda-forge의 mamba(또는 conda) 패키지 관리자를 사용하여 설치할 수 있습니다.
mamba install -c conda-forge voila
또는 PyPI에서
pip install voila
Voilà는 측면 창에 노트북의 Voilà 미리보기를 표시하는 JupyterLab 확장 기능을 제공합니다.
JupyterLab 3.0부터 pip install voila 사용하여 voila 를 설치하면 확장 프로그램이 자동으로 설치 됩니다.
소스에서 확장을 설치하려면 다음 명령을 실행하세요.
jupyter labextension install @voila-dashboards/jupyterlab-preview
bqplot 예제 노트북을 독립형 앱으로 렌더링하려면 voila bqplot.ipynb 실행하세요. jupyter 노트북 디렉터리를 제공하려면 인수 없이 voila 실행하세요.
예를 들어 Voilà를 사용하여 이 저장소에서 예제 노트북 bqplot.ipynb 를 렌더링하려면 먼저 이 노트북의 요구 사항으로 현재 환경을 업데이트할 수 있습니다(이 경우 conda 환경에서 다음을 사용하여 노트북을 렌더링합니다).
mamba env update -f .binder/environment.yml cd notebooks/ voila bqplot.ipynb
더 많은 명령줄 옵션(예: 대체 포트 번호 지정)을 보려면 voila --help 실행하세요.
notebook 또는 jupyter_server 에 대한 서버 확장으로Voilà는 노트북 서버 또는 jupyter_server와 함께 Jupyter 서버 확장으로 사용할 수도 있습니다.
Jupyter 서버 확장을 설치하려면 다음을 실행하세요.
jupyter serverextension enable voila jupyter server extension enable voila
Jupyter 서버를 실행할 때 voila 접미사가 붙은 기본 URL에서 Voilà 앱에 액세스할 수 있습니다.
Voilà 사용을 시작하려면 전체 문서를 확인하세요.
https://voila.readthedocs.io/
다음 두 가지 예는 명령줄 통합에서 독립형 Jupyter 노트북을 별도의 앱으로 전환할 수 있는 방법을 보여줍니다.
strip_sources 옵션이 False 로 설정된 경우 Jupyter 노트북의 소스가 Voilà 앱에 표시될 수 있습니다.
Voilà는 Jupyter 표준 형식 및 프로토콜을 기반으로 구축되었으며 노트북의 프로그래밍 언어에 구애받지 않습니다. 이 예에서는 C++ Jupyter 커널 xeus-cling 및 xleaflet 프로젝트로 구동되는 Voilà 애플리케이션의 예를 제시합니다.
Voilà 갤러리는 Voilà 및 Jupyter 위젯으로 구축된 라이브 대시보드 및 애플리케이션 모음입니다.
대부분의 예제는 ipywidgets, ipyleaflet, ipyvolume, bqplot 및 ipympl과 같은 위젯 라이브러리를 사용하며 전적으로 노트북을 기반으로 복잡한 웹 애플리케이션을 구축하는 방법을 보여줍니다.
voila-gallery/gallery 저장소에 나열된 단계에 따라 새로운 예제를 갤러리에 추가할 수 있습니다.
개발 환경에 기여하고 설정하는 방법을 알아보려면 CONTRIBUTING.md를 참조하세요.
Voilà는 nbconvert 및 jupyter_server에 의존합니다.
우리는 모든 기여자가 자신의 기여에 대한 저작권을 유지할 수 있는 공유 저작권 모델을 사용합니다.
이 소프트웨어는 BSD-3-Clause 라이센스에 따라 라이센스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.
