feat: add support for browser-supplied math font (#4119)#4129
Open
yuna0831 wants to merge 3 commits intoKaTeX:mainfrom
Open
feat: add support for browser-supplied math font (#4119)#4129yuna0831 wants to merge 3 commits intoKaTeX:mainfrom
yuna0831 wants to merge 3 commits intoKaTeX:mainfrom
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
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.
What is the previous behavior before this PR?
Previously, KaTeX always required downloading and using its own web fonts (KaTeX_Main, KaTeX_Math, etc.) to render math symbols correctly. There was no built-in option to utilize the native font-family: math supported by modern browsers, which could lead to unnecessary network requests for users who prefer system math fonts.
What is the new behavior after this PR?
This PR introduces a new Sass variable $use-browser-math-font (defaulting to false). When set to true:
It prepends the math keyword to font-family declarations for .katex, .mathnormal, and .mathbf classes.
It suppresses @font-face declarations to prevent the browser from downloading KaTeX web fonts, reducing the initial page load weight.
Browsers supporting the math family will use the system's math font, while others will fallback to standard system fonts (serif).
Closes #4119