在GitLab Wiki中使用Markdown编辑器显示LaTeX公式

Question

我有兴趣在GitLab上为我的科学计算代码构建一个维基，这需要我编写方程并在GitLab维基中呈现它们。

如何操作？
我尝试粘贴MathJax渲染脚本，但不起作用。

能否以任何方式使用KaTeX？

$$
  \partial_t \int_{\Omega} \mathbf{q} d \Omega =
  \int_{\partial \Omega} \mathbf{f} (
  \mathbf{q}) \cdot \mathbf{n}d \partial
  \Omega - \int_{\Omega} hg \nabla z_b
$$

- datapanda

---

http://superuser.com？ - user3159253

@user3159253以上是一段LaTeX方程式的代码片段，我需要在GitLab维基上呈现它，但Markdown无法呈现这个方程式。实际上呈现的是文本片段本身。 - datapanda

问题本身没有错。但是似乎更适合发布在其他网站，因为它与编程或编程工具无关，对吧？ - user3159253

@user3159253 谢谢，我想要的是一种在Markdown语言中编写方程的方法（GitLab和GitHub都使用Markdown语言来编写自述文件和维基页面）。所以我猜这与编程有关，因此我标记了Markdown、Git和GitLab社区。 - datapanda

Answer 1

使用反引号，从GitLab CE 8.15开始支持使用KaTex。

相关文档位于此处，并且相关讨论在合并请求 8003中。

以下是在GitLab中使用方程的当前方法：

- salmanulfarzy

---

不幸的是，它与外部的Markdown编辑器不兼容，只能在Gitlab中正确渲染。这会引起问题。这也引发了关于更改的讨论。但截至今天，它还没有改变。 - Paloha

Answer 2

2017年2月更新：正如sfarzy在答案中所记录的那样，这已经被整合进去了（合并请求8003）

---

原始回答，2016年2月：关于Mathjax，在2014年有一个请求将其整合到GitLab中（还有PR 5280）

如果您可以访问自己的GitLab服务器，您可以自己集成Mathjax（来源：Zhiyong Johnny Zhang）

创建文件/home/git/gitlab/app/views/layouts/_mathjax.html.haml，例如：

sudo -u git nano /home/git/gitlab/app/views/layouts/_mathjax.html.haml

with the following content:

:javascript
  (function() {
    var ga = document.createElement('script');
    ga.type = 'text/javascript';
    ga.async = true;
    ga.src = ('https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML');
    var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
  })();

然后编辑文件_head.html.haml，并将其更改为以下内容（第一行已经存在，第二行是新添加的）：

= render 'layouts/piwik' if extra_config.has_key?('piwik_url') && extra_config.has_key?('piwik_site_id')
= render 'layouts/mathjax'

但是，如果你想在gitlab.com上发布它，这个集成还没有被激活。

- VonC