Include MathJax only if there are formulas on the page

• I’ve read the contribution guidelines and agree with them

I want to suggest an idea and checked that …

• … to my best knowledge, my idea wouldn’t break something for other users
• … the documentation does not mention anything about my idea
• … there are no open or closed issues that are related to my idea

Description

MkDocs includes tex-mml-chtml.js into every page which is an additional ~752Kb transfer. Serving the MathJax-specific JS only if rendered page contains $...$ blocks will save close to the megabyte per page.

Use Cases

Any case where serving additional traffic is undesirable. Which is… Every case?

Screenshots / Mockups

N/A

[savchenko]

@facelessuser , Works like a charm, thank you!

@squidfunk ,

we have an automatic integration for Mermaid in place (#2170), but not for MathJax. Maybe worth considering.

Solution from Isaac works well, however having this happening automatically is easier / less confusing for an end-user. Depends on the complexity of implementation I reckon; certainly your call.

[facelessuser]

Ah, the problem is that you are including it in extra_javascript , which will include it on every page. I actually include it at the end of the page that I want to have MathJax. I do this via the Snippets extension: https://facelessuser.github.io/pymdown-extensions/extensions/snippets/.

1. I point Snippets to my _snippets folder: https://github.com/facelessuser/pymdown-extensions/blob/master/mkdocs.yml#L131

2. And then I place this at the bottom of the page I want to use MathJax:

   ---8<---
   mathjax.txt
   ---8<---
   

You can see that mathjax.txt contains my config and the MathJax lib: https://github.com/facelessuser/pymdown-extensions/blob/master/docs/src/markdown/_snippets/mathjax.txt