我正在使用 Gitlab Pages 来托管使用 Sphinx 生成的文档。
是否可以使用 Gitlab Pages 使用 MathJax 渲染数学?根据我的测试,没有渲染方程式。我需要安装 MathJax 和 doc 才能使其正常工作吗?生成的文档在本地机器上正确呈现。
我正在使用 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 仅支持静态网站,这意味着您的输出文件必须仅为 HTML、CSS 和 JavaScript。
您可以通过本地计算机上的流程渲染静态站点并将结果推送到您的存储库或使用 GitLab CI 进行持续集成。这是一篇博客文章,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>