Mathjax在Github的页面

问题描述：

我已经在Github开始了一个新项目，因为我需要与人员合作，所以我想创建一个体面的文档。我想为此任务使用Github Pages，但文档需要包含许多等式，例如https://wec-sim.github.io/WEC-Sim/theory.html。Mathjax在Github的页面

我在网上阅读了大量文章，Mathjax提供了一个很好的工具来阅读浏览器上的方程，并且已经链接到Github页面。不过，尽管我试图遵循许多不同的策略，但我还是无法让页面显示任何方程式。

您可以在我的项目https://github.com/enricoande/uuv和相应的页面https://enricoande.github.io/uuv/找到我的项目。该页面是从https://github.com/enricoande/uuv/blob/master/docs/README.md构建的。

最初，我根本无法显示方程式，但可以看到Page中的文本。现在，我甚至无法看到该页面。这已经添加文件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的初学者。

任何建议都很好，因为我现在完全卡住了。感谢您的帮助！

答

如果你打开网页的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。通常，脚本标签出现在头部，页眉或页脚模板中。

谢谢你的帮助。从你的解决方案中，我清楚地明白，我的页面肯定存在html问题。如果我按照您的建议修改'page.html'，页面会再次显示。所以，这显然是我最初的'page.html'导致页面无法正确显示（没有MathJax我没有该文件，我猜GitHub必须使用模板）。 –

我从Jekyll GitHub目录中获得它的挂钩。但是，这是一个更复杂的项目。如果我只想从一个独特的MD文件“README.md”开始，那么在标题之后如何指定在'page.html'中指定它来读取？它是“{{content}}”命令吗？此外，我应该在哪里放置''（注意，这是从上面的帖子中的MathJax读取的命令）？在'

'之前？谢谢！ –

@Enrico我怀疑只是使用'{{content}}'并添加脚本标签应该工作fin; MathJax脚本标记可以在内容之前或之后执行，MathJax不介意 –

答

'之前？谢谢！ –

答

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

console.warn（ '警告：。cdn.mathjax.org已经退役检查https://www.mathjax.org/cdn-shutting-down/迁移提示'）

因此，请检查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>

谢谢！你是对的：我没有注意到该页面已经迁移。 –

不幸的是，我认为我也有一个html问题，正如@Peter Krautzberger指出的那样。 –

Mathjax在Github的页面

相关推荐