replace external MathJax CDN with local offline-ready version (fixes #44) #593
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
MathJax 2.x relies on dynamic asset loading (fonts, configs) and cannot be bundled into a single JS file. We added copy-webpack-plugin to copy the library files intact from node_modules to the static directory, enabling offline functionality. Relate to sio2project#44
This change adds CopyPlugin to move the library from node_modules to static files, enabling offline support. Relate to sio2project#44
Updated `MATHJAX_LOCATION` to point to local static files instead of external CDN, enabling offline usage. Added `dist_webpack` to `STATICFILES_DIRS` to ensure Django can serve assets copied by Webpack. Injected inline MathJax configuration in `base.html` to explicitly enable single-dollar ($) delimiters, as the default configuration disables them. Relate to sio2project#44
twalen
reviewed
Dec 3, 2025
package.json
Outdated
| "jquery": "^1.12.4", | ||
| "js-cookie": "^3.0.5", | ||
| "marked": "^15.0.7", | ||
| "mathjax": "^2.7.9", |
Contributor
There was a problem hiding this comment.
it would be nice to upgrade, the latest version is 4.0.0
twalen
reviewed
Dec 3, 2025
…st 4.x beta. This modernizes the math rendering engine, improving performance, accessibility, and loading times. Key changes: - Updated `package.json` to install `mathjax@4`. - Modified `webpack.config.js` to copy the new MathJax distribution structure (excluding source files) to `dist_webpack`. - Updated `settings.py` to point `MATHJAX_LOCATION` to the new entry point (`tex-chtml.js`). - Refactored `base.html` configuration to use the new `window.MathJax` object API. - Enabled single-dollar (`$`) delimiters for inline math to maintain backward compatibility with existing problem statements. - Added `tex2jax_ignore/process` class mappings to ensure legacy content with specific ignore classes still renders correctly.
twalen
approved these changes
Dec 10, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This merge integrates MathJax directly into the application using Webpack, removing the dependency on CloudFlare CDN. This ensures the platform is fully functional in offline deployment scenarios.
Key changes:
mathjax(v2.7) to package.json and configured CopyPlugin in Webpack to serve assets locally fromdist_webpack.settings.pyto pointMATHJAX_LOCATIONto local static files.base.htmlto enable single-dollar ($) delimiters for inline math, which were previously unsupported by the default CDN configuration.dist_webpacktoSTATICFILES_DIRSto allow Django to discover the new assets.Closes #44
Relate to #586