In-line math not rendering in Jupyter Book

[amyheather]

In-line math (e.g. $k_{limit}$) renders without issue in the .ipynb files, but does not in the rendered Jupyter Book.

Does not fix: Updating all packages did not resolve the issue.

Potential fix: Can use alternative in-line math, for example:

{math}`k_{limit}`

This renders without issue in the Jupyter Book - but the downside is that it will not render if just viewing the .ipynb files.

[TomMonks]

@amyheather should we just switch to Quarto?!

[amyheather]

😏

[TomMonks]

Fixed in Jupyterbook using dollarmath. Keep as is!

[amyheather]

@TomMonks Reopen issue? Still not rendering properly.

I think this could be related to how JupyterBook cannot handle dollarmath and plotly on the same page? From https://jupyterbook.org/en/stable/interactive/interactive.html:

Including plotly plots in a Jupyter Book page is currently not compatible with the dollarmath syntax extension (mathematical notation written between two “$” characters). If you are trying to include both plotly plots and mathematical notation within the same page, and finding that plotly plots are not being rendered, this may be the cause. Try removing all use of the dollarmath syntax within the page and rebuilding the book.

Remaining issue:

[TomMonks]

oh dear. This was fixed with dollar math. Let me have a look.

[TomMonks]

@amyheather removing the plotly output does fix it.

Maybe the way forward is to have a 2nd page for showing the basic confidence interval method as a chart

[amyheather]

Or quarto? Votes in favour would be

(1) pretty

(2) (more importantly of course) can easily generate function reference section - e.g. https://lintquarto.github.io/lintquarto/pages/api/

Although also, that solution is also good, if want to stick with jupyter book.