Sha256: 856f77897e5b53bdcfcd6082f0c5c4c1a3f3e4c78805a87fff69907e98f7765c

Contents?: true

Size: 1.25 KB

Versions: 13

Compression:

Stored size: 1.25 KB

Contents

# How to update MathJax

Our intention is to bundle a SLIM MathJax in gollum, so that gollum can work
offline with latex equations without bloating the gollum release tarball.

1. Clone the customized mathjax-cleaner from
   https://github.com/programfan/mathjax-cleaner

      git clone https://github.com/programfan/MathJax-grunt-cleaner

2. Install node, npm and grunt. Most of the time the package manager is
   enough. In case the package manager does not yet provide these packages,
   follow the instructions on https://www.gruntjs.net.

3. Install mathjax-cleaner dependencies.

      cd MathJax-grunt-cleaner && npm install 

4. Download latest mathjax release from
   https://github.com/mathjax/mathjax/releases and unzip to the
   directory of MathJax-grunt-cleaner.

5. Prepare grunt environments

      cp Gruntfile.js MathJax-x.y.z
      cp -r node_modules MathJax-x.y.z

6. Slimify mathjax

      cd MathJax-x.y.z && grunt && cd ..
      
7. Remove old mathjax (careful!)

     rm -rf ${GOLLUM_ROOT}/lib/gollum/public/gollum/javascript/MathJax

8. Replace bundled mathjax with newly generated one

      cp MathJax-x.y.z ${GOLLUM_ROOT}/lib/gollum/public/gollum/javascript/MathJax

9. Update mathjax version in ${GOLLUM_ROOT}/lib/gollum/templates/layout.mustache

Version data entries

13 entries across 13 versions & 1 rubygems

Version Path
gollum-5.3.3 lib/gollum/public/gollum/javascript/HOWTO_UPDATE_MATHJAX.md
gollum-5.3.2 lib/gollum/public/gollum/javascript/HOWTO_UPDATE_MATHJAX.md
gollum-5.3.1 lib/gollum/public/gollum/javascript/HOWTO_UPDATE_MATHJAX.md
gollum-5.3.0 lib/gollum/public/gollum/javascript/HOWTO_UPDATE_MATHJAX.md
gollum-5.2.3 lib/gollum/public/gollum/javascript/HOWTO_UPDATE_MATHJAX.md
gollum-5.2.2 lib/gollum/public/gollum/javascript/HOWTO_UPDATE_MATHJAX.md
gollum-5.2.1 lib/gollum/public/gollum/javascript/HOWTO_UPDATE_MATHJAX.md
gollum-5.2 lib/gollum/public/gollum/javascript/HOWTO_UPDATE_MATHJAX.md
gollum-5.1.2 lib/gollum/public/gollum/javascript/HOWTO_UPDATE_MATHJAX.md
gollum-5.1.1 lib/gollum/public/gollum/javascript/HOWTO_UPDATE_MATHJAX.md
gollum-5.1 lib/gollum/public/gollum/javascript/HOWTO_UPDATE_MATHJAX.md
gollum-5.0.1 lib/gollum/public/gollum/javascript/HOWTO_UPDATE_MATHJAX.md
gollum-5.0.0 lib/gollum/public/gollum/javascript/HOWTO_UPDATE_MATHJAX.md