Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[IMPORTANT] MathJax CDN end-of-life & suggested changes to third-party extensions #39

Closed
pkra opened this issue Apr 11, 2017 · 7 comments

Comments

@pkra
Copy link
Contributor

pkra commented Apr 11, 2017

As you may have heard, will be shutting down the CDN hosting at cdn.mathjax.org on April 30, cf. https://www.mathjax.org/cdn-shutting-down/.

As part of this, we need to migrate the third party extensions to a different setup.

We decided that the current repository structure will be retired in favor of separate repositories (one per extensions).

This repository will continue to provide documentation on existing third party extensions.

Suggested changes for maintainers

  • Create a separate repository for your extension
    • If you're worknig on a fork of this repository, you can trim your fork, e.g., using this guide.
  • Update the loadComplete calls to individual prefixes,
    • Please don't use [Contrib] but use unique prefixes such as [MyExtension]
    • Note: a clash of your prefix with another extension's prefix will usually mean that people can't use both extensions at the same time.
  • Tag individual releases to allow version specific loading.
  • Submit your extensions to a free CDN such as cdnjs or jsdelivr
    • alternatively extensions can be loaded from rawgit.com
mhchem added a commit to mhchem/MathJax-mhchem that referenced this issue Apr 11, 2017
- MathJax CDN shutting down on April 30, 2017
  https://www.mathjax.org/cdn-shutting-down/
- Change loadComplete, remove [Contrib]
  mathjax/MathJax-third-party-extensions#39
- Prepare to move to cdnjs
@pkra
Copy link
Contributor Author

pkra commented Apr 19, 2017

@pkra
Copy link
Contributor Author

pkra commented Apr 24, 2017

https://github.com/Edraak/arabic-mathjax-dev has been updated and can be used with, e.g., rawgit now.

@burnpanck
Copy link
Contributor

Actually, there is a better guide on how to create a separate repository using git filter-branch:
Splitting a subfolder out into a new repository. The link posted in the original issue description explains how to remove particular files from a repository using git filter-branch.

@pkra
Copy link
Contributor Author

pkra commented Jun 14, 2017

siunitx has been updated and move to https://github.com/burnpanck/MathJax-siunitx

@ickc
Copy link
Contributor

ickc commented Sep 4, 2017

In light of this, I probably will retire my physics.js.

It started out 2.5 yrs ago to port the commands used in the Physics package to MathJax, using only macros. But I then realized something cannot be done without truly learning Javascript, and I don't see myself learning it in the near future.

And then I don't think the Physics package is popular at all. If anyone else is using the physics.js, please let me know, but I think I'm the only user of it. And even in the LaTeX world, it isn't really a popular package (I haven't met any other people using it except in the project I started so the others have to...). Well, another indication is if this is truly useful to anyone, some Javascript programmers probably would have already contributed and fill in the missing features.

Lastly, if I understand it correctly, these 3rd party extensions will not be centralized anymore, right? I'd like to hear more about this, especially how to catalog the 3rd party extensions together for discovery. I'd imagine it would be much easier if there's a centralized GitHub Organization for these 3rd party repositories than everyone hosting on their own. Alternatively, at least http://docs.mathjax.org/en/latest/options/ThirdParty.html should keep a record of it. Personally, I wouldn't use anything that doesn't have an official recognition. And also, this repository is how I discovered the siunitx MathJax package.

@pkra
Copy link
Contributor Author

pkra commented Sep 5, 2017

And then I don't think the Physics package is popular at all. If anyone else is using the physics.js, please let me know, but I think I'm the only user of it. And even in the LaTeX world, it isn't really a popular package (I haven't met any other people using it except in the project I started so the others have to...). Well, another indication is if this is truly useful to anyone, some Javascript programmers probably would have already contributed and fill in the missing features.

I would like to encourage you to post to the MathJax User Group to announce that you are looking for somebody to take maintenance over the project.

Lastly, if I understand it correctly, these 3rd party extensions will not be centralized anymore, right?

There won't be centralized hosting anymore but the README in this repo documents well-known third party extensions.

Personally, I wouldn't use anything that doesn't have an official recognition.

Third party extensions never had any official standing. We do not provide any guarantees on the code nor do we provide any kind of end-user support for them (we do try to help their developers where we can).

@pkra
Copy link
Contributor Author

pkra commented Oct 2, 2017

Closing this since it should now be old news.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants