Installation und Nutzung

Installation

voilà kann installiert werden mit:

$ pipenv run voila docs/jupyter/ipywidgets/examples.ipynb
pipenv install voila
Installing voila…

Successfully installed jupyter-server-0.1.1 jupyterlab-pygments-0.1.0 voila-0.1.10

Starten

… als eigenständige Anwendung

Ihr könnt die Installation überprüfen,z.B. mit:

$ pipenv run voila docs/workspace/jupyter/ipywidgets/examples.ipynb

[Voila] Voila is running at:
http://localhost:8866/

Hierbei sollte sich euer Standardbrowser öffnen und die ipywidget-Beispiele aus unserem Tutorial anzeigen:

Voilà-Beispiel examples.ipynb

Alternativ könnt ihr euch auch ein Verzeichnis anzeigen lassen mit allen darin enthaltenen Notebooks:

$ pipenv run voila docs/workspace/jupyter/ipywidgets

Voilà-Beispiel für eine Verzeichnisansicht

Es ist auch möglich, sich den Quellcode anzeigen zu lassen mit:

$ pipenv run voila --strip_sources=False docs/workspace/jupyter/ipywidgets/examples.ipynb

Bemerkung

Beachtet, dass der Code nur angezeigt wird. Voilà erlaubt Benutzern nicht, den Code zu bearbeiten oder auszuführen.

Voilà-Beispiel mit Quellcode

Üblicherweise wird das light-Theme verwendet; ihr könnt jedoch auch das dark-Theme auswählen:

$ pipenv run voila --theme=dark docs/workspace/jupyter/ipywidgets/examples.ipynb

… als Erweiterung des Jupyter-Server

Alternativ könnt ihr voilà auch als Erweiterung des Jupyter-Server starten:

$ pipenv run jupyter notebook

Anschließend könnt ihr voilà aufrufen, z.B. unter der URL http://localhost:8888/voila.