Notebooks in Sub-Directories

You can organize your notebooks in subdirectories and nbsphinx will take care that relative links to other notebooks, images and other files still work.

Let’s see if links to local images work: Jupyter notebook icon

In [1]:
from IPython.display import Image
Image(filename='../images/notebook_icon.png')
Out[1]:
../_images/subdir_a-notebook-in-a-subdir_2_0.png

Warning:

There may be problems with images in output cells if your source directory contains symbolic links, see issue #49.

A link to a notebook in the parent directory: link.

A link to a local file: link.

A Sub-Section

This is just for testing inter-notebook links, see this section.