Github 页面中的 Mathjax

Question

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

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

您可以在https://github.com/enricoande/uuv找到我的项目，并在https://enricoande.github.io/uuv/找到相应的页面。该页面是从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

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

这是预期的，因为您的页面模板实际上并不是模板 - 因为它必须包含{{ 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在 docs 文件夹中创建一个以以下开头的文件

---
layout: page
---

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

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