在哪里插入 MathJax 脚本,以便在使用 Jekyll 时它在 GitHub 页面上呈现?

问题描述 投票:0回答:1

我正在尝试将 MathJax 集成到我正在使用 Github Pages 和 Jekyll 构建的数学网站中,无论我尝试做什么,它都不会在 LaTeX 中呈现,即使我在本地构建也是如此。例如,我总是得到“\(x)\”而不是 LaTeX x。

我尝试从他们的网站粘贴 MathJax javascript

<script src="https://polyfill.io/v3/polyfill.min.js?features=es6"></script>
<script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>

问题是,无论我粘贴到哪里,它都不会渲染。我尝试从

base.html
复制
_layouts
文件并将其粘贴到此文件中,但无济于事。我也尝试过从
head.html
放入
_includes
,但还是不行。我还确保根据我在网上阅读的内容添加
markdown: kramdown
mathjax: true
。我真的需要一些帮助,我已经花了几个小时在这上面,而且我对网页设计非常陌生(并且只想要一个地方来发布一些旧笔记)。

html jekyll github-pages mathjax
1个回答
0
投票

要集成 MathJax 以在 GitHub Pages 上托管的 Jekyll 站点中渲染 LaTeX 方程,您需要确保 MathJax 已正确加载到您的页面上。具体方法如下:

创建布局文件:如果您还没有布局文件,请为页面创建一个布局文件。通常,这是“_layouts/default.html”。

插入 MathJax 脚本:将 MathJax 脚本粘贴到布局文件的

<head>
部分。确保将其包含在结束
</head>
标签之前。

    <!DOCTYPE html>
    <html>
    <head>
      <!-- Other head elements -->
    
      <!-- MathJax script -->
      <script src="https://polyfill.io/v3/polyfill.min.js?features=es6"></script>
      <script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
    </head>
    <body>
      <!-- Content of your page -->
    </body>
    </html>

确保正确配置:确保您的 _config.yml 文件包含 MathJax 与 Kramdown(Jekyll 使用的 Markdown 解析器)配合使用所需的配置。包括以下行:

markdown: kramdown
kramdown:
  math_engine: mathjax

使用适当的 Markdown 语法:在编写帖子或页面时,请确保对内联和块级数学方程使用正确的 Markdown 语法。对于内联方程,使用 ( ... ) 或 $ ... $,对于块级方程,使用 [ ... ] 或 $$ ... $$。

通过这些步骤,MathJax 应该正确集成到您的 Jekyll 站点中,并且 LaTeX 方程应该在 GitHub Pages 上正确呈现。进行这些更改后,在将更改推送到 GitHub 之前在本地测试您的网站,以确保一切按预期工作。

© www.soinside.com 2019 - 2024. All rights reserved.