Voilà¶
Voilà converts a Jupyter Notebook into an interactive dashboard that allows you to share your work with others. It is secure and customizable, giving you control over what your readers experience.
Deployment mode¶
The application is served in two modes:
Development: as a Jupyter Notebook extension (default).
Production: as a standalone application, by specifying a Jupyter Notebook via the Notebook parameter.
Dependencies¶
For information on how to use the Dependencies parameter, please refer to the Initialization - Bash script, Initialization - Conda packages, and Initialization - pip packages section of the documentation.
Select a template¶
Voilà uses nbconvert
to convert Jupyter notebooks into an HTML dashboard. nbconvert
has a rich templating system that allows to customize the way in which the notebook is converted into HTML. There are six templates pre-installed in the app, which can be selected in production mode via the Template parameter:
A new Voilà template project can be generated using Cookiecutter.
Note
Customized templates must be copied within the $VOILA_TEMPLATE_DIR
folder, by executing a Bash script imported via the Dependencies parameter.
A new template, say mytemplate
, can be selected in production mode by setting the Configuration parameter: template=mytemplate
.
Add multiple settings¶
The Configuration parameter allows the user to implement multiple Voilà configuration settings at the same time. By default this parameter accepts a single string in the format:
<config-key>=<config-value>
.
This is equivalent to set the option: --VoilaConfiguration.<config-key>=<config-value>
.
The latter can be generalized by appending additional configuration options to the first string. For example, the following values of the Configuration parameter provide the same settings:
file_whitelist=['.*'] --template mytemplate
or
file_whitelist=['.*'] --VoilaConfiguration.template=mytemplate
or
template=mytemplate --VoilaConfiguration.file_whitelist=['.*']
.
Contents