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.