ReadTheDocs notebook rendering broken

[matthew-brett]

As of a few weeks ago, when I go to, for example, this page:

https://jupyter-notebook.readthedocs.io/en/stable/examples/Notebook/Notebook%20Basics.html

the nbconvert rendering appears to have failed, and the page shows the JSON for the notebook instead of the rendered HTML. This is true for other pages on the site. Is there a problem with the nbconvert rendering of the doc build?

[meeseeksmachine]

This issue has been mentioned on Jupyter Community Forum. There might be relevant details there:

https://discourse.jupyter.org/t/error-in-jupyter-readthedocs-page-rendering/11038/4

[kevin-bates]

Hi @matthew-brett - this looks like it might be related to an issue we recently addressed via #6200 (and #6201). I think you'll find the master and latest docs show a more well-rendered examples section.

Please close this issue if you feel they sufficiently address your concern, otherwise let us know what is lacking and we'll see if it can be addressed (and keep this issue open). I believe the stable version of the docs will be updated upon the next release (but that's purely an assumption on my part as I'm not very familiar with read-the-docs itself).

[matthew-brett]

Surely it would be a good idea to fix the stable docs now rather when there is some future release? The stable docs are the ones the user will most likely reach.

[matthew-brett]

I'm happy to do that if someone gives me permission.

[blink1073]

What is your username on RTD @matthew-brett?

[matthew-brett]

I login via Github - so I think it's matthew-brett.

Are there instructions on building and deploying the docs, somewhere?

[kevin-bates]

Are there instructions on building and deploying the docs, somewhere?

What exists is in the contributing portion of the docs: https://jupyter-notebook.readthedocs.io/en/latest/contributing.html#building-the-documentation.

I login via Github - so I think it's matthew-brett.

I've gone ahead and added you as an RTD maintainer. Thanks for looking at this. I'm curious how one goes about adjusting how the stable meta-tag works because I don't see it. We might find it easier to just produce a 6.4.5 release.

[matthew-brett]

It would be happy for me if y'all could produce a release - I wasn't looking forward to investigating workarounds for RTD ...

[kevin-bates]

No worries, can't blame you there. I'm assuming I can remove you from the RTD maintainers - are you okay with that?

I'll look into a release and would hope to trigger it sometime today, if not, this week. Thanks for your patience.

[matthew-brett]

Yes, of course, please feel free to remove me if you're already on the case ... and thanks.

[kevin-bates]

Special thanks to @blink1073 for producing the 6.4.5 release!

@matthew-brett - You should find the stable docs appropriately render the examples: https://jupyter-notebook.readthedocs.io/en/stable/examples/Notebook/examples_index.html

[matthew-brett]

Thanks very much for resolving that.