MathJax icon indicating copy to clipboard operation
MathJax copied to clipboard

Can we migrated to MathJax.v3.2 version from V2

Open rkanumola opened this issue 1 year ago • 2 comments

As per the https://docs.mathjax.org/en/v3.2-latest/upgrading/v2.html

MathJax v3 is still a work in progress; not all features of version 2 have been converted to version 3 yet, and some may not be. MathJax v2 will continue to be maintained as we work to move more features into version 3, but MathJax v2 likely will not see much further development, just maintenance, once MathJax v3 is fully converted.

So, as we are planning to upgrade, this will be having backward compatibility for our customers? Please help us and suggest in this regard.

Ref: https://github.com/mathjax/MathJax-docs/issues/327

rkanumola avatar Aug 09 '23 11:08 rkanumola

I don't know what features from version 2 you are using, so it is hard to tell you for sure.

The features from version 2 that are not yet ported to v3 are listed in the Upgrading to v3 documentation. The first two bullet points in that section are included in v4 (currently in beta release), so the most important ones will be available in v4 soon.

If you are currently just loading MathJax.js (with a configuration file and perhaps in-line configuration), then the change to v3 should be straight-forward. There is a configuration converter you can use to get the equivalent v3 configuration from your v2 ones, so that should help. See the changes in loading MathJax section for more details.

The javascript API for v3 is significantly different from the v2 one, so if you are doing more complicated interaction with MathJax (like making calls to MathJax.Hub), those will need to be changed. This is described in the API changes section. There is a v2 compatibility example that might cover your needs of your interaction with MathJax is not too complicated.

The other sections in that v2 upgrading document you link to describe other changes between the versions, so you should read through it to see whether anything you are doing might need to be updated for v3.

dpvc avatar Aug 10 '23 00:08 dpvc

Thanks @dpvc for transferring the issue to have more visibility.

Thank you so much for the detailed explanation of our query on migrating to V3, we will look into it and take a decision accordingly. We will post the questions later, based on our progress on the same if any.

rkanumola avatar Nov 12 '23 03:11 rkanumola