使用markdown编辑器在gitlab wiki中显示乳胶方程式

时间:2016-02-07 22:01:01

标签: markdown gitlab gitlab-ci

我有兴趣在gitlab上为我的科学计算代码构建一个wiki,它需要我编写方程式并在gitlab中的wiki中进行渲染。

如何做到这一点 我试图粘贴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
$$

2 个答案:

答案 0 :(得分:14)

GitLab使用代码反引号支持GitLab CE 8.15中的KaTex。

文档是here和 相关讨论见merge request 8003

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

Syntax Preview

答案 1 :(得分:2)

2017年2月更新:正如sfarzy answer中所述,现已整合(merge request 8003

原始答案,2016年2月:关于Mathjax,有一个ticket requesting its integration in 2014(也是PR 5280

如果您有权访问自己的gitlab服务器,则could integrate Mathjax yourself(来源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
  

具有以下内容:

: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上发布它,这个集成还没有激活。