coderefinery / sphinx-lesson

Sphinx extension for creating CodeRefinery lessons
https://coderefinery.github.io/sphinx-lesson/
MIT License
14 stars 20 forks source link

The exercise list doesn't work with links in the exercises #83

Closed rkdarst closed 2 years ago

rkdarst commented 2 years ago

At least I see one error if you try to put a link in there:

[...]
  File "/home/rkdarst/git/testing/venv/lib/python3.9/site-packages/docutils/nodes.py", line 227, in walkabout
    visitor.dispatch_departure(self)
  File "/home/rkdarst/git/testing/venv/lib/python3.9/site-packages/sphinx/util/docutils.py", line 520, in dispatch_departure
    super().dispatch_departure(node)
  File "/home/rkdarst/git/testing/venv/lib/python3.9/site-packages/docutils/nodes.py", line 2008, in dispatch_departure
    return method(node)
  File "/home/rkdarst/git/testing/venv/lib/python3.9/site-packages/docutils/nodes.py", line 2030, in unknown_departure
    raise NotImplementedError(
NotImplementedError: <class 'sphinx.writers.html5.HTML5Translator'> departing unknown node type: pending_xref

No solution yet, not sure what the problem is. I guess it is somehow related to duplicating the admonition nodes and that's somehow messing up the HTML generation.

rkdarst commented 2 years ago

If anyone sees places where internal links do work, let me know.

(external links, HTML, instead of :doc: or {doc}, links, do work. It is somehow related to the internal integrity checking, I guess.)