WIP: demo of how to use index.ipynb with current nbsite

[ceball]

1. Move toctree from doc/index.rst to a new file, doc/_index.rst
2. Move doc/index.rst's content to examples/index.ipynb (and convert to markdown)
3. Include index.ipynb and _index.rst in index.rst
4. Commit doc/index.rst and doc/_index.rst and examples/index.ipynb.
5. When you run nbsite_nbpagebuild.py ioam parambokeh ./examples ./doc with current nbsite, it will overwrite doc/index.rst. Restore it from git, then continue with the rest of the doc build.

[jbednar]

Is the procedure the same when it's not at the root, e.g. tutorial/index.ipynb?

[ceball]

Yes, it's the same.

[jbednar]

What's the reason for step 1, if you are including it in step 3? Why not just leave the toctree where it is, in index.rst? If it really needs to be in a separate file, presumably that file would be toctree.rst or _toctree.rst?