r - KaTeX 与 bookdown + gitbook

Question

我正在构建一个 bookdown 项目，并将其呈现为带有大量数学页面的 gitbook，并且呈现缓慢。我想用 KaTeX而不是 mathJax 来呈现我的数学，但我不知道如何让它工作。有一个gitbook plugin所以它应该是可能的，但我不太知道如何将它与 bookdown 集成。

在我的 index.Rmd文件我试过以下:

---
site: bookdown::bookdown_site
output:
  bookdown::gitbook:
    pandoc_args: [--katex]
    mathjax: NULL
    includes:
      in_header: katex.html
documentclass: book
---

哪里 katex.html由 KaTeX 的样式表和主题组成。

<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.7.1/katex.min.css" integrity="sha384-wITovz90syo1dJWVh32uuETPVEtGigN07tkttEqPv+uR2SE/mbQcG7ATL28aI9H0" crossorigin="anonymous">
<script src="https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.7.1/katex.min.js" integrity="sha384-/y1Nn9+QQAipbNQWU65krzJralCnuOasHncUFXGkdwntGeSvQicrYkiUBwsgUqc1" crossorigin="anonymous"></script>

但是，数学不会被渲染(除了一些仍然由 MathJax 渲染的部分)。



有什么办法可以让我预订与 KaTeX 一起工作吗？

Answer 1

您似乎没有阅读 KaTeX 文档。 KaTeX 不会自动渲染你的数学表达式。见Automatic rendering of math on a page部分在 Github 上的自述文件中。简而言之，您必须加载 auto-render.min.js并添加一个事件来呈现数学，例如在您的 katex.html ， 你需要:

<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.7.1/katex.min.css" integrity="sha384-wITovz90syo1dJWVh32uuETPVEtGigN07tkttEqPv+uR2SE/mbQcG7ATL28aI9H0" crossorigin="anonymous">
<script src="https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.7.1/katex.min.js" integrity="sha384-/y1Nn9+QQAipbNQWU65krzJralCnuOasHncUFXGkdwntGeSvQicrYkiUBwsgUqc1" crossorigin="anonymous"></script>

<script src="https://cdnjs.cloudflare.com/ajax/libs/KaTeX/0.7.1/contrib/auto-render.min.js" integrity="sha384-dq1/gEHSxPZQ7DdrM82ID4YVol9BYyU7GbWlIwnwyPzotpoc57wDw/guX8EaYGPx" crossorigin="anonymous"></script>
<script>
  document.addEventListener("DOMContentLoaded", function() {
    renderMathInElement(document.body);
  });
</script>

要在 bookdown gitbook 输出中禁用 MathJax，您需要设置 math: false在 YAML 中，例如

---
site: bookdown::bookdown_site
output:
  bookdown::gitbook:
    pandoc_args: [--katex]
    mathjax: NULL
    includes:
      in_header: katex.html
documentclass: book
math: false
---