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

KaTeX broken on github.io due to Kramdown upgrade #28

Open
AE1020 opened this issue Aug 17, 2020 · 0 comments
Open

KaTeX broken on github.io due to Kramdown upgrade #28

AE1020 opened this issue Aug 17, 2020 · 0 comments

Comments

@AE1020
Copy link

AE1020 commented Aug 17, 2020

Hello, I am a fan of the Contrast theme :-)

I noticed that the equations stopped working in the Jekyll generation process. Someone wrote an article on this problem.

It points to the culprit being this change to kramdown:

gettalong/kramdown@c3acf8d

(Though the change was in April, the breakage was more recent. I do see that github.io upgraded to Jekyll 3.9.0 which came out this month, so maybe they took that moment to bump the kramdown version too?)

In that change, it can be seen that lines related to support for KaTeX in the documentation are gone. So this means that server-side support for putting on the <script> tags is probably not happening. Fixes seem to be:

  1. A new version of KaTeX working without the tags (maybe this exists already?)
  2. Code up a shim script to put the tags on client-side in JS
  3. Put the tags on manually in the page source
  4. Switch to MathJax

Since I'm not really using the feature on my "blog" (only two articles at this moment), I took lazy option 3. But hopefully this information will save time for others looking into it!

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

1 participant