Отображение латексного уравнения в gitlab wiki с помощью редактора меток

Мне интересно создать wiki для моего научного вычислительного кода на gitlab, который требует от меня написать уравнения и сделать их в wiki в gitlab.

Как это сделать.
Я попытался вставить рендеринг mathjax script, но он не работает.

Можно ли использовать 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
$$

Ответы

Ответ 1

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

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

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

Синтаксис Предварительный просмотр

Ответ 2

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

Оригинальный ответ, февраль 2016 г.. Что касается Mathjax, то был билет запрашивающий его интеграцию в 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, эта интеграция еще не активирована.