代码之家  ›  专栏  ›  技术社区  ›  Enrico Anderlini

Github页面中的Mathjax

  •  5
  • Enrico Anderlini  · 技术社区  · 7 年前

    我在Github中启动了一个新项目,由于我需要与人合作,我想开始一个像样的文档。我想使用Github页面来完成这项任务,但文档将需要包括许多等式,例如 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的初学者。

    任何建议都非常感谢,因为我现在完全被卡住了。谢谢你的帮助!

    2 回复  |  直到 7 年前
        1
  •  2
  •   Bernard Vander Beken Harald Coppoolse    7 年前

    https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML ,我明白了

    安慰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>
    
        2
  •  1
  •   Peter Krautzberger    7 年前

    如果打开页面的HTML源代码,您会注意到它只包含script标记。

    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 了解更多信息。通常,脚本标记出现在页眉、页眉或页脚模板中。