Closed ianhi closed 2 years ago
One day my dream is to have the docs be immediately enabled as interactive via pyodide @martinRenou do you know how far we are from being able to do something like that?
We're pretty close actually :)
I'd really like to have a simple replite console at the beginning of the docs. But this requires widgets to work in JupyterLab console https://github.com/jupyter-widgets/ipywidgets/pull/3004
I'm making some experiments on jupyterlite-sphinx:
https://github.com/martinRenou/jupyterlite-sphinx https://jupyterlite-sphinx.readthedocs.io/en/latest
bump @tacaswell
I'm sorry, I wrote message here (and even checked it off my to-do list) but apparently never hit "send" 🐑 🤦🏻
I think be best path to hosting is to use something like https://github.com/matplotlib/mpl-gui/blob/main/.github/workflows/docs.yml to put the built docs on github. We just this weekend moved to self-hosting the docs on digital ocean (still behind cloudflare as a CDN). We will need to add a web-hook to notify that system when new docs are pushed.
attn @QuLogic
It would be great to add a section on how to make it work on colab:
from google.colab import output
output.enable_custom_widget_manager()
I think be best path to hosting is to use something like https://github.com/matplotlib/mpl-gui/blob/main/.github/workflows/docs.yml to put the built docs on github.
I've added this. I don't suppose there's an easy way to see them rendered on a PR?
We will need to add a web-hook to notify that system when new docs are pushed.
@QuLogic any chance of this (if not already done?) I don't think there's much left to do here
Ok. I think I'm happy with this now. Can someone give a read over to review?
We will need to add a web-hook to notify that system when new docs are pushed.
@QuLogic any chance of this (if not already done?) I don't think there's much left to do here
It will only make sense to do this after you have a branch with built docs in it.
Ok. I think I'm happy with this now. Can someone give a read over to review?
Absent any objections I'm going to merge this. we can always iterate more later
@QuLogic we now have a gh-pages
branch that contains built docs
@QuLogic bump - this will eventually end up at https://matplotlib.org/ipympl correct?
I have the power to add the webhook, but I am unsure what the secret should be.
The secret is just a random set of characters.
Scattered over a few issues there has been mention of the need for a documentation page. This is a first pass at creating one. I think there are lots of great things we can add (e.g. css tricks https://github.com/matplotlib/ipympl/issues/411#issuecomment-998583424) but getting something out there is more important than getting everything in there. I think it's important for users to be able to go to a website to get install instructions rather than a github repo as I suspect that this is lends a sense of stability and officiallness to the project. It also makes it easier to have much more robust sections on installing and contributing.
I think the big question I have is probably primarily for @tacaswell (and also @martinRenou ) which is where should this be hosted? I know how to set things up on readthedocs and so can can easily do that. But this is also a matplotlib subproject (unclear how official that makes things) and does that mean that this shoudl be hosted on matplotlib.org/ipympl? I think that would be my preferred URL if possible.
Other thoughts: