====== Integrate Mathjax with Gitlab ======

A quick (not the best way, though) way to integrate Mathjax with Gitlab. Tested on Gitlab 7.9.4 and Gitlab shell 2.6.0.

Create the file /home/git/gitlab/app/views/layouts/_mathjax.html.haml, e.g.,

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

with the following content

<code>
: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);
  })();
</code>

Then edit the file _head.html.haml 

<code>sudo -u git nano /home/git/gitlab/app/views/layouts/_head.html.haml</code>

and change to the following (the first line already existed and the second line was newly added:

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

Note one can control the use of mathjax just like the use of piwik.

Then restart gitlab using

<code>
sudo service gitlab restart
</code>
{{tag>}}

~~LINKBACK~~
~~DISCUSSION~~