ENH: Add support for gated exercise directives

executablebooks / sphinx-exercise

A Sphinx extension for producing exercise and solution directives.

https://ebp-sphinx-exercise.readthedocs.io

MIT License

19 stars 7 forks source link

ENH: Add support for gated exercise directives #55

Closed mmcky closed 2 years ago

mmcky commented 2 years ago

Describe the problem/need and solution

Similar to gated solution directives implemented in #45 it would be nice to have that same syntax available for exercise directives.

Guide for implementation

Similar to transform structure in #45

Tasks and updates

[ ] required by https://github.com/QuantEcon/lecture-python-programming.myst/pull/176

psychemedia commented 2 years ago

It would be really nice to have abstracted classes for gated directives on which custom directives (including exercise and solution) could build to added gated support.

mmcky commented 2 years ago

I agree @psychemedia -- this is really both a 1 useful way to add execution support to exercise and solutions here, but 2 serves as a prototype for a myst enhancement proposal that I am planning on submitting once the myst-spec enhancement process is up and running.

mmcky commented 2 years ago

this will be closed by #45

psychemedia commented 2 years ago

~~I also wonder - how does the gated admonition relate to things like the emerging official MyST spec? https://github.com/executablebooks/myst-spec/~~ Ah, just saw earlier comment re: a myst enhancement proposal.