[Feb/March] Issue / Bug Reduction Drive

[mmcky]

We are planning to focus on issue and bug reduction during February ( after the merge of myst-parser and myst-nb updates), along with some review of developer documentation etc. This issue is a place for priority triage that we can all edit and comment on. It would be great if this top level comment cell remains the list of issues for focus on.

---

ANU

jupyter-book:

A high priority enhancement request

• Side notes with references to text jupyter-book#598

Contact: @AakashGfude

• Fail to build pdf with pdflatex when notebook is in a subdirectory jupyter-book#1100 (comment)
• Images reference incorrect when root file is in subdirectory  jupyter-book#1636

sphinx-exercise:

Contact: @mmcky

• docs should include that sphinx_book_theme is required sphinx-exercise#38
• Finalise Embed executable code inside of exercise solutions (Prototyping) sphinx-exercise#24 and document gated directives [Status: (21st Feb): Trying to figure out how to catch exceptions in the test framework when using app.build() to run a sphinx build without throwing an error from pytest]
• mathjax loading on per page basis causes issue for nodes containing math in reference only sphinx-exercise#40
• Update documentation for working with :ref: and :numref: via resolving pending_xref etc.

sphinx-book-theme:

Contact: @AakashGfude

• Allow the left navigation menu to collapse at the "part" level sphinx-book-theme#460
• Put uncompiled assets in translations in a proper directory adhering to sphinx-theme-builder sphinx-book-theme#475

Contact: @choldgraf

• Nested admonitions are CSS styled incorrectly sphinx-book-theme#331
• REMOVE: Theme-specific API styling to re-use PyData sphinx-book-theme#486
• FIX: Tooltip hover remain bug sphinx-book-theme#484

[choldgraf]

Hey all - I wanted to note a bunch of other bugs that we've closed in the book theme and in Jupyter Book this month - a lot of that was knocked out by the recent theme refactor:

• hover opacity does not work for anchors in spans sphinx-book-theme#176
• sphinx-book-theme.css imported twice, can't override styles sphinx-book-theme#496
• Main content section extra scroll-bar appears sometimes sphinx-book-theme#186
• margin-caption overlap other margin objects sphinx-book-theme#276
• Colab links always show up by default sphinx-book-theme#209
• Improve CSS for API documentation sphinx-book-theme#307
• Button tooltips do not dissapear after pressing the button sphinx-book-theme#407
• Nested admonitions are CSS styled incorrectly sphinx-book-theme#331
• Left ToC open on mobile during page load sphinx-book-theme#366
• Fix regressions with a few extensions sphinx-book-theme#476
• Fullscreen mode doesn't work in Safari sphinx-book-theme#477