Switch to Sphinx for building website

[redeboer]

Solution: #2 (comment)

---

For some reason, the cells on the HTML output are not shown with output.
https://shenvitor.github.io/sympy-playground/

Probably you have to set some settings in the myst.yml, but not sure what. Have a look at https://mystmd.org/guide/integrating-jupyter, for instance.

[redeboer]

Looks like you need to add the --execute flag here:

sympy-playground/.github/workflows/deploy.yml

Line 39 in 5993484

run: myst build --html

[shenvitor]

The problem is even after adding the tag "raises-exception" in Jupyter notebook.
The MyST MD does not recognize it and stopped and cause error.
They mentioned they fixed: jupyter-book/mystmd#873
But seems like it still doesn't work in our case

See error: https://github.com/shenvitor/sympy-playground/actions/runs/8707079086/job/23881241237#step:6:28

[redeboer]

Yeah I would switch back to Sphinx and related MyST packages, in particular https://myst-nb.rtfd.io. Jupyter Book is also an option: easier to use, but a bit slower release cycle.

The challenge with using higher-level Sphinx extensions like MyST-NB, is that you have to configure through a conf.py file. Have a look at AmpForm's configuration, for instance. Or to become more familiar with conf.py files, write your own by generating a first template with sphinx-quickstart.

[redeboer]

Of course, pixi remove mystmd etc and pixi add the relevant Sphinx packages/extensions.