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

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

console.warn（＆＃39;警告：cdn.mathjax.org已经停用。请查看https://www.mathjax.org/cdn-shutting-down/了解迁移提示。＆＃39;）

请检查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>

然后，您必须在docs文件夹中创建一个以

开头的index.html文件

---
layout: page
---

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

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

Github页面中的Mathjax

2 个答案: