Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

extra docs for running scripts #373

Merged
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
9 changes: 9 additions & 0 deletions docs/source/customize.rst
Expand Up @@ -216,3 +216,12 @@ configured to use a specific kernel for each language::

In this case it will use the `xeus-python
<https://github.com/QuantStack/xeus-python/>`_. kernel to run `.py` files.

Note that the script will be executed as notebook with a single cell, meaning
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Note that the script will be executed as notebook with a single cell, meaning
Note that the script will be executed as a notebook with a single cell, meaning

that only the last expression will be printed as output. Use the Jupyter
display mechanism to output any text or rich output such as Jupyter widgets. For
Python this would be a call to `IPython.display.display`.

Using `Jupytext <https://github.com/mwouts/jupytext>`_ is another way to support
script files. After installing jupytext, voila will see script files as if they
are notebooks, and requires no extra configuration.