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

Я заинтересован в создании вики для моего кода научных вычислений на 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
$$

person datapanda    schedule 07.02.2016    source источник
comment
superuser.com?   -  person user3159253    schedule 08.02.2016
comment
@ user3159253 Что ж, это фрагмент кода латексного уравнения, который мне нужно отобразить в вики gitlab, но уценка не может отобразить уравнение. Фактически, визуализируется только текстовый фрагмент.   -  person datapanda    schedule 08.02.2016
comment
Ну ничего страшного в вопросе. Но похоже, что это подходит для другого сайта, потому что речь не идет о программировании или даже инструментах программирования, верно?   -  person user3159253    schedule 08.02.2016
comment
@ user3159253 спасибо, я ищу способ писать уравнения на языке разметки (и gitlab, и github используют язык разметки для readme и wiki). Думаю, это о программировании, и поэтому я отметил сообщества, основанные на markdown, git и gitlab.   -  person datapanda    schedule 08.02.2016


Ответы (2)


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

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

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

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

person salmanulfarzy    schedule 07.02.2017

Обновление от февраля 2017 г.: как описано в sfarzy answer, теперь он интегрирован (запрос на слияние 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, эта интеграция еще не активна.

person VonC    schedule 08.02.2016