Gitlab 页面 mathjax

Gitlab pages mathjax

我正在使用 Gitlab Pages 来托管使用 Sphinx 生成的文档。

是否可以使用 Gitlab Pages 使用 MathJax 渲染数学?根据我的测试,未呈现方程式。我需要安装 MathJax 和 doc 才能让它工作吗?生成的文档在本地计算机上正确呈现。

没有。来自:https://docs.gitlab.com/ee/user/project/pages/getting_started_part_one.html#static-sites

GitLab Pages only supports static websites, meaning, your output files must be HTML, CSS, and JavaScript only.

您可以通过本地计算机上的过程呈现静态站点并将结果推送到您的存储库,或者使用 GitLab CI 进行持续集成,这将取决于您。这是一个 blog post,其中 GitLab 使用 Nanoc 而不是 Sphinx,但您可以在 CI.

中替换它

我没有使用 Sphinx,而是使用不同的 gitlab 页面静态站点生成器。 用 mathjax 渲染对我来说工作得很好。 我不需要做任何特别的事情,我的 <head> 元素中只有以下代码片段:

<script type="text/javascript" id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js">
</script>