A Normal reStructuredText File¶
This is a normal RST file.
Note
Those still work!
Links to Notebooks¶
Links to notebooks can be easily created: A Notebook in a Sub-Directory (the notebook title is used as link text). You can also use an alternative text. Relative links to notebooks in subdirectories are possible.
The above links were created with (note that the .ipynb
file extension has
to be stripped):
:doc:`subdir/another`
:doc:`an alternative text <subdir/another>`
Sphinx Directives for Jupyter Notebook Cells¶
For comparison, this is a “normal” Sphinx code block using ipython3
syntax highlighting:
%file helloworld.py
#!/usr/bin/env python3
print('Hello, world!')
The nbsphinx
extension provides custom directives to show notebook cells:
In [42]:
6 * 7
Out[42]:
42
This was created with
.. nbinput:: ipython3
:execution-count: 42
6 * 7
.. nboutput::
:execution-count: 42
42