Hi Anne, For converting existing thematic tutorials to Jupyter notebooks, there isn’t a fully automatic one-click workflow at the moment, but there are a couple of practical options:
- The thematic tutorials are written in reStructuredText and built with Sphinx. One approach is to extract the executable Sage code blocks and convert them to notebooks using tools like "jupytext" (RST ↔ notebook) or "sphinx-nbconvert", with some manual cleanup for narrative text and directives. - Another option is to rebuild the tutorial content directly as a ".sagews" or ".ipynb" by copying code blocks and adapting the exposition incrementally; this is how some Sage tutorial notebooks have been created in the past. Regarding the broken links: you’re right — some of the URLs under "thematic_tutorials/" appear to be outdated. In particular, paths like "/prep/Symbolics-and-Basic-Plotting.html" no longer exist in the current documentation tree. This is likely due to documentation reorganization over time without updating the index page. It would probably be worth opening a Trac issue (or GitHub issue, depending on the current workflow) to: - audit the thematic tutorial index, - fix or redirect broken links, and - possibly clarify which tutorials are still actively maintained. If there’s interest, converting selected thematic tutorials into maintained Jupyter notebooks could also be a nice documentation improvement project. Best regards, Vishwas On Fri, 9 Jan, 2026, 2:45 am Anne Schilling, <[email protected]> wrote: > Hi All, > > I was wondering whether there is an easy way to convert an existing > thematic tutorial (for example > https://doc.sagemath.org/html/en/thematic_tutorials/tutorial-objects-and-classes.html#tutorial-objects-and-classes > ) to a Jupyter notebook? > > Also, I noticed that several links on the site > https://doc.sagemath.org/html/en/thematic_tutorials/index.html > are broken. For example > https://doc.sagemath.org/html/en/prep/Symbolics-and-Basic-Plotting.html > does not seem to exist. > > Best wishes, > > Anne > > -- > You received this message because you are subscribed to the Google Groups > "sage-devel" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To view this discussion visit > https://groups.google.com/d/msgid/sage-devel/c11703c3-0832-4374-93c4-da5b99563650n%40googlegroups.com > <https://groups.google.com/d/msgid/sage-devel/c11703c3-0832-4374-93c4-da5b99563650n%40googlegroups.com?utm_medium=email&utm_source=footer> > . > -- You received this message because you are subscribed to the Google Groups "sage-devel" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To view this discussion visit https://groups.google.com/d/msgid/sage-devel/CAPEXzoSQsL%3DY3YrUMCJoJzKSGNhU1bT6gMcMt5MiTF1Z973-zA%40mail.gmail.com.
