Github 页中的 Mathjax

Question

我在 Github 开始了一个新项目，因为我需要与人合作，所以我想开始一个像样的文档。我想为此任务使用 Github 页，但文档需要包含许多方程式，例如 https://wec-sim.github.io/WEC-Sim/theory.html.

我在许多在线帖子上看到，Mathjax 提供了一个很好的工具来在浏览器上阅读方程式，并且已链接到 Github 个页面。然而，尽管我尝试了很多不同的策略，但我还无法让我的页面显示任何方程式。

您可以在 https://github.com/enricoande/uuv and the corresponding page at https://enricoande.github.io/uuv/. The page is built from https://github.com/enricoande/uuv/blob/master/docs/README.md 找到我的项目。

最初，我根本无法显示方程式，但可以看到页面中的文字。现在，我什至无法看到该页面。这是在添加文件 https://github.com/enricoande/uuv/blob/master/docs/_layouts/page.html 后发生的，该文件显示为

<script type="text/javascript"
    src="https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
</script>

我看不到我的页面的原因可能是Mathjax太慢了（我在网上找到了关于这方面的评论）？否则，您是否对我可以做些什么来修复页面以显示方程式有什么建议？

如您所见，我是 Github 页和 html 的初学者。

非常感谢任何建议，因为我现在完全被困住了。感谢您的帮助！

Answer 1

如果我在 https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML 打开引用的 JS 文件，我会看到

console.warn('WARNING: cdn.mathjax.org has been retired. Check https://www.mathjax.org/cdn-shutting-down/ for migration tips.')

因此请查看 https://www.mathjax.org/cdn-shutting-down/ 以获取详细的迁移提示。

示例解决方案

<script type="text/javascript" async
  src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?...">
</script>

Answer 2

如果您打开页面的 HTML 源代码，您会发现它只包含脚本标记。

这是预料之中的，因为 your page template 实际上不是模板 -- 因为它必须包含 {{ content }} 或类似的液体模板标签，以便它可以从实际页面中提取内容。

例如，https://github.com/jekyll/jekyll/blob/master/docs/_layouts/page.html有

---
layout: default
---

<section class="standalone">
  <div class="grid">

    <div class="unit whole">
      <article>
        <h1>{{ page.title }}</h1>
        {{ content }}
      </article>
    </div>

    <div class="clear"></div>

  </div>
</section>

然后您必须在您的文档文件夹中创建一个以

开头的 index.html 文件

---
layout: page
---

以便它拉入页面模板（和脚本标签）。

尝试安装 jekyll 并生成默认站点以评估良好的默认设置；有关详细信息，请参阅 the docs。通常，脚本标记出现在页眉、页眉或页脚模板中。

Github 页中的 Mathjax

Mathjax in Github pages

github

mathjax

github-pages