diff --git a/project-words.txt b/project-words.txt index 2151d4883770..e244339141a0 100644 --- a/project-words.txt +++ b/project-words.txt @@ -48,6 +48,7 @@ Csapo Csvg Dabit dabit +daiji Daishi Datagit datagit @@ -148,6 +149,7 @@ Markprompt markprompt Massoud mathjax +mathml maxlynch maxresdefault MDAST @@ -310,6 +312,8 @@ swizzlable Sébastien Tagkey Teik +Temml +temml Therox thisweekinreact toplevel diff --git a/website/docs/guides/markdown-features/markdown-features-math-equations.mdx b/website/docs/guides/markdown-features/markdown-features-math-equations.mdx index 0fd9543d8ef0..e671a1ef98fc 100644 --- a/website/docs/guides/markdown-features/markdown-features-math-equations.mdx +++ b/website/docs/guides/markdown-features/markdown-features-math-equations.mdx @@ -202,3 +202,24 @@ export default { ], }; ``` + +You can use the third-party [@tats-u/docusaurus-plugin-copy-katex-assets](https://github.com/tats-u/docusarusu-copy-katex-assets) plugin to copy the `katex.min.css` and `fonts` directory to your site's `assets` directory. + +### MathML or Temml instead of KaTeX {#mathml} + +You can use the [`@daiji256/rehype-mathml`](https://www.npmjs.com/package/@daiji256/rehype-mathml) plugin instead of `rehype-katex`: + +- When you want to use another math font other than Latin Modern Math +- When you want to reduce the download size to a minimum by compromising with local fonts +- When you want to reduce the number of files to be served +- When you want to use $LaTeX$ syntax available not in KaTeX but in Temml + +After installing and activating the plugin, [put Temml assets](https://temml.org/docs/en/administration) in your site's `static` directory, and replace the stylesheet's `href` from the CDN URL of `katex.min.css` to your local path of the Temml CSS (say, `/temml/temml.min.css`) in `docusaurus.config.js`. + +You can use the third-party [@tats-u/docusaurus-plugin-copy-temml-assets](https://github.com/tats-u/docusaurus-copy-temml-assets) plugin to copy the Temml assets to your site's `assets` directory. + +:::note + +Temml recommends the Latin Modern font for better display, but its WOFF2 font file is larger than the entire KaTeX font bundle. Unless you prefer fonts other than Latin Modern (e.g. local fonts or [Noto Sans Math](https://fonts.google.com/noto/specimen/Noto+Sans+Math)) or the compliance to the standards, or need the support of TeX features supported only by Temml, KaTeX is the better choice. + +::: diff --git a/website/versioned_docs/version-3.6.3/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-3.6.3/guides/markdown-features/markdown-features-math-equations.mdx index 178ef2fd9a3e..556457bf100f 100644 --- a/website/versioned_docs/version-3.6.3/guides/markdown-features/markdown-features-math-equations.mdx +++ b/website/versioned_docs/version-3.6.3/guides/markdown-features/markdown-features-math-equations.mdx @@ -200,3 +200,24 @@ export default { ], }; ``` + +You can use the third-party [@tats-u/docusaurus-plugin-copy-katex-assets](https://github.com/tats-u/docusarusu-copy-katex-assets) plugin to copy the `katex.min.css` and `fonts` directory to your site's `assets` directory. + +### MathML or Temml instead of KaTeX {#mathml} + +You can use the [`@daiji256/rehype-mathml`](https://www.npmjs.com/package/@daiji256/rehype-mathml) plugin instead of `rehype-katex`: + +- When you want to use another math font other than Latin Modern Math +- When you want to reduce the download size to a minimum by compromising with local fonts +- When you want to reduce the number of files to be served +- When you want to use $LaTeX$ syntax available not in KaTeX but in Temml + +After installing and activating the plugin, [put Temml assets](https://temml.org/docs/en/administration) in your site's `static` directory, and replace the stylesheet's `href` from the CDN URL of `katex.min.css` to your local path of the Temml CSS (say, `/temml/temml.min.css`) in `docusaurus.config.js`. + +You can use the third-party [@tats-u/docusaurus-plugin-copy-temml-assets](https://github.com/tats-u/docusaurus-copy-temml-assets) plugin to copy the Temml assets to your site's `assets` directory. + +:::note + +Temml recommends the Latin Modern font for better display, but its WOFF2 font file is larger than the entire KaTeX font bundle. Unless you prefer fonts other than Latin Modern (e.g. local fonts or [Noto Sans Math](https://fonts.google.com/noto/specimen/Noto+Sans+Math)) or the compliance to the standards, or need the support of TeX features supported only by Temml, KaTeX is the better choice. + +::: diff --git a/website/versioned_docs/version-3.7.0/guides/markdown-features/markdown-features-math-equations.mdx b/website/versioned_docs/version-3.7.0/guides/markdown-features/markdown-features-math-equations.mdx index 178ef2fd9a3e..556457bf100f 100644 --- a/website/versioned_docs/version-3.7.0/guides/markdown-features/markdown-features-math-equations.mdx +++ b/website/versioned_docs/version-3.7.0/guides/markdown-features/markdown-features-math-equations.mdx @@ -200,3 +200,24 @@ export default { ], }; ``` + +You can use the third-party [@tats-u/docusaurus-plugin-copy-katex-assets](https://github.com/tats-u/docusarusu-copy-katex-assets) plugin to copy the `katex.min.css` and `fonts` directory to your site's `assets` directory. + +### MathML or Temml instead of KaTeX {#mathml} + +You can use the [`@daiji256/rehype-mathml`](https://www.npmjs.com/package/@daiji256/rehype-mathml) plugin instead of `rehype-katex`: + +- When you want to use another math font other than Latin Modern Math +- When you want to reduce the download size to a minimum by compromising with local fonts +- When you want to reduce the number of files to be served +- When you want to use $LaTeX$ syntax available not in KaTeX but in Temml + +After installing and activating the plugin, [put Temml assets](https://temml.org/docs/en/administration) in your site's `static` directory, and replace the stylesheet's `href` from the CDN URL of `katex.min.css` to your local path of the Temml CSS (say, `/temml/temml.min.css`) in `docusaurus.config.js`. + +You can use the third-party [@tats-u/docusaurus-plugin-copy-temml-assets](https://github.com/tats-u/docusaurus-copy-temml-assets) plugin to copy the Temml assets to your site's `assets` directory. + +:::note + +Temml recommends the Latin Modern font for better display, but its WOFF2 font file is larger than the entire KaTeX font bundle. Unless you prefer fonts other than Latin Modern (e.g. local fonts or [Noto Sans Math](https://fonts.google.com/noto/specimen/Noto+Sans+Math)) or the compliance to the standards, or need the support of TeX features supported only by Temml, KaTeX is the better choice. + +:::