Отображение уравнения latex в GitLab wiki с помощью редактора markdown

Я заинтересован в создании wiki для моего научного вычислительного кода на gitlab, которому нужно, чтобы я писал уравнения и отображал их в wiki в 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
$$

2 ответов


GitLab поддерживает KaTex от GitLab CE 8.15 с помощью кодовых обратных палочек.

документация здесь и Соответствующие обсуждения ведутся запрос слияния 8003.

вот текущий способ использования уравнений в GitLab

Syntax Preview


Обновление Февраля. 2017: как описано в sfarzy ' s ответ, теперь это интегрировано (запрос слияния 8003)


оригинальный ответ, февраля. 2016: что касается Mathjax было!--19-->билет с просьбой о его интеграции в 2014 (кроме PR 5280)

если у вас есть доступ к вашему собственному серверу gitlab, вы может интегрировать Mathjax самостоятельно (источник Чжиен Джонни Чжан)

создать файл /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 эта интеграция пока не активна.