I have attempted to give a try of https://github.com/sympy/sympy/pull/24471 https://output.circle-artifacts.com/output/job/d67d6193-7579-47ac-9381-3bfccfba931e/artifacts/0/doc/_build/html/lite/lab/index.html But it looks like there can be permission issues or it prevents the execution of scripts or such that it doesn't work https://circleci.com/docs/build-artifacts/#safe-and-unsafe-content-types I'm not sure that's the issue that can be gone once deployed in docs.sympy.org, but I would like to hear if it is the direction we should go.
On Thursday, January 5, 2023 at 3:01:46 AM UTC+2 asme...@gmail.com wrote: > On Wed, Jan 4, 2023 at 4:49 AM S.Y. Lee <syle...@gmail.com> wrote: > > > > I think that you need to set up server manually from > > > > python -m http.server -d doc/_build/html > > Ah, I didn't realize that it doesn't work without a web server. make > livehtml also starts a server, but it also auto-refreshes whenever it > detects a change, which might not be desired in this case. We can add > 'make server' which just starts a web server without live reloading. > > > > > There are options to use the directive or use the fullscreen > > > > The problem I find is how the sympy version gets picked up. > > Even though I haven't installed anything on root, jupyterlite picks up > sympy 3.11.1 with python 3.10.2 > > so we may need to figure out how to make it pick up the dev build, if > this can be integrated to the sympy documentation. > > That only matters for the dev version of the docs. For the "latest" > version of the docs it will install the latest version of SymPy (there > might be a small lag when we do a release because I think micropip > uses a separate repo from pypi, but I doubt it will be a big issue). > It might be possible using micropip to install from the git master > (see > https://jupyterlite-sphinx.readthedocs.io/en/latest/configuration.html#jupyterlite-config > and > https://jupyterlite.readthedocs.io/en/latest/howto/python/packages.html), > and similarly for PR preview builds. That wouldn't do the right thing > for local development builds. I don't know if there is a way to make > it do what you would expect in that case. I asked about it here > https://github.com/jupyterlite/jupyterlite-sphinx/issues/81. > > > > > On Wednesday, January 4, 2023 at 7:45:00 AM UTC+2 asme...@gmail.com > wrote: > >> > >> Relatedly, I've been looking at > >> https://jupyterlite-sphinx.readthedocs.io/, which lets you embed > >> notebooks into Sphinx documentation which can be executed in the > >> browser. (except I haven't been able to get it working yet. If anyone > >> has any experience with jupyterlite-sphinx please reach out!) > >> > >> I think that would be a great choice for the tutorial. We already have > >> used notebooks in the past, because they are great for interactive > >> exercises, but this would be much simpler than trying to use mybinder > >> or getting everyone to install everything themselves. > >> > >> The other advantage of it is that if we can get it working, we can > >> adapt it and put the tutorial materials in the actual SymPy > >> documentation. I think it would be great to have some interactivity > >> and exercises in the tutorials section of the docs. One of the > >> differences between tutorials and user guides is that tutorials are > >> supposed to provide a directed learning experience (see > >> https://diataxis.fr/tutorials-how-to/). I think having exercises as > >> part of a tutorial, so that it looks more like a course, would help to > >> make this distinction clearer. Right now a lot of what is in our > >> "tutorial" is actually more along the lines of a user guide. > >> > >> Aaron Meurer > >> > >> On Mon, Jan 2, 2023 at 5:11 PM Aaron Meurer <asme...@gmail.com> wrote: > >> > > >> > The CFP for SciPy 2023 is open > >> > https://www.scipy2023.scipy.org/present. The deadline to submit is > >> > February 22. > >> > > >> > Is anyone interested in giving a talk and/or tutorial about SymPy? I > >> > would be interested in proposing a tutorial on SymPy, but only if > >> > others are interested in co-presenting. We have given tutorials about > >> > SymPy at SciPy in the past and they have been generally well received, > >> > so I think it would have a reasonable chance of being accepted. > >> > > >> > If you would be interested in submitting a proposal but are unsure if > >> > you would be able to afford attendance, please email me and we can > >> > discuss financial aid options (note this offer only applies to people > >> > who are active SymPy contributors). > >> > > >> > Aaron Meurer > > > > -- > > You received this message because you are subscribed to the Google > Groups "sympy" group. > > To unsubscribe from this group and stop receiving emails from it, send > an email to sympy+un...@googlegroups.com. > > To view this discussion on the web visit > https://groups.google.com/d/msgid/sympy/996ac370-cff6-4aac-977d-d5f246d43a75n%40googlegroups.com > . > -- You received this message because you are subscribed to the Google Groups "sympy" group. To unsubscribe from this group and stop receiving emails from it, send an email to sympy+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/sympy/d38daf4e-6389-45ad-9387-5ab5a6c6aa6bn%40googlegroups.com.
