Create an examples section in the Sphinx docs showing thebe working with popular libraries with custom outputs

[moorepants]

Many libraries implement custom outputs for rich display in Jupyter Notebook and Jupyter Lab, but they don't always display as expected with thebe. Some of these require some user tweaks to get working with thebe and sometimes there is a thebe issue that may prevent them from working. We can start by moving the things in the examples/ directory to the Sphinx docs in docs and then open PRs for new Sphinx pages showing off other libraries. Here are a list of some libraries:

• move examples/ to docs/examples/ and format for sphinx
• bokeh
• bpplot
• ipycytoscape
• ipyleaflet: Documentation page with ipyleaflet example #265
• ipympl
• plotly: 📚 DOCS: Added a plotly example. #269
• pythreejs: Added a documentation page with a pythreejs example. #262

You'll probably have to find a repo setup for repo2docker for each library that has the libraries properly installed (usually on that library's page) and use that for the page in the sphinx docs.

[moorepants]

@sandertyu created this repo showing some libraries that do and don't work that may be helpful. Some of that info could be transferred here to this issue if needed: https://github.com/sandertyu/widgetstuffs

[moorepants]

One other useful note is that many of these libraries can display custom Jupyter output that is essentially static wrt to the attached kernel (after the cell has been run) but that many examples also show off the interactive Jupyter widget functionality that is not static wrt to the attached kernel. The later may have more issues working than the former, so getting the former to work is the best starting point.

[moorepants]

I'm working on a pythreejs page.

[celine168]

Noah and I are working on ipympl and ipyleaflet I believe.

[moorepants]

gonna try plotly now

[celine168]

I'm working on ipycytoscape as well, forgot to mention that.

[celine168]

As an update to these can be checked off:

• ipympl
• ipytoscape
• bqplot

[moorepants]

Done!

[moorepants]

There is an issue open for bokey support #112, so I'm closing this.