<div dir="ltr"><div>nbviewer is a great utility for showing notebooks. However, when you start to get a collection of notebooks, it can be difficult to use nbviewer usefully. To solve this issue, we wrote a couple of Python programs to create Index.ipynb files for directories, and SiteMap.ipynb to index all of the notebooks. (We hope that this is in the spirit of what nbviewer was intended).</div>
<div><br></div><div>Features:</div><div><br></div><div>* If you have a README.md in a directory, it will be added as a cell in the Index.ipynb</div><div>* Each Index creates links to subfolders with Index.ipynbfiles  and to notebooks in the folder</div>
<div>* Allows you to add a header to each page</div><div><br></div><div>The code is quite basic at this point, but we'll revise and incorporate new features and better structure as we develop it.</div><div><br></div><div>
Here is our SiteMap and toplevel Index:   </div><div><br></div><a href="http://nbviewer.ipython.org/urls/bitbucket.org/ipre/calico/raw/master/notebooks/SiteMap.ipynb">http://nbviewer.ipython.org/urls/bitbucket.org/ipre/calico/raw/master/notebooks/SiteMap.ipynb</a><br>
<div><br></div><div><a href="http://nbviewer.ipython.org/urls/bitbucket.org/ipre/calico/raw/master/notebooks/Index.ipynb">http://nbviewer.ipython.org/urls/bitbucket.org/ipre/calico/raw/master/notebooks/Index.ipynb</a><br>
</div><div><br></div><div>The code is here:</div><div><br></div><div><a href="https://bitbucket.org/ipre/calico/src/master/notebooks/make.py">https://bitbucket.org/ipre/calico/src/master/notebooks/make.py</a><br></div><div>
<a href="https://bitbucket.org/ipre/calico/src/master/notebooks/code2notebook.py">https://bitbucket.org/ipre/calico/src/master/notebooks/code2notebook.py</a><br></div><div><br></div><div>Limitations: currently no links back to top; you have to update the cached nbviewer version (using url + "?create=1") outside of this code.</div>
<div><br></div><div>Ideas/suggestions welcomed; hope this can be of use,</div><div><br></div><div>-Doug</div></div>