Merge pull request #1257 from ketch/load_tex_macros

New extension: load_tex_macros.

Author: jfbercher

src/jupyter_contrib_nbextensions/nbextensions/load_tex_macros/icon.png

@@ -0,0 +1,7 @@
+Type: Jupyter Notebook Extension
+Name: Load TeX macros
+Description: This extension automatically loads a set of latex commands from the file latexdefs.tex when a notebook is opened.
+Link: readme.md
+Icon: icon.png
+Main: main.js
+Compatibility: 4.x, 5.x

src/jupyter_contrib_nbextensions/nbextensions/load_tex_macros/load_tex_macros.yaml

@@ -0,0 +1,39 @@
+define(function(require, exports, module) {
+    var Jupyter = require('base/js/namespace');
+
+    function loadLatexUserDefs() { 
+        $.get('latexdefs.tex').done(function(data) {
+            data = data.replace(/^/gm, '\$\$\$').replace(/$/gm, '\$\$\$');
+            if ($('#latexdefs').length > 0) $('#latexdefs').remove();
+            $('body').append($('<div/>').attr('id', 'latexdefs').text(data));
+            console.log('latex_envs: loaded user LaTeX definitions latexdefs.tex');
+        }).fail(function() {
+            console.log('load_tex_macros: failed to load user LaTeX definitions latexdefs.tex')
+        });
+    }
+
+    function rerenderMaths() { // probably something like that
+            MathJax.Hub.Queue(
+              ["resetEquationNumbers",MathJax.InputJax.TeX],
+              ["PreProcess", MathJax.Hub],
+              ["Reprocess", MathJax.Hub]
+            );
+    }
+
+    function load_ipython_extension() {
+         "use strict";
+       
+        if (Jupyter.notebook._fully_loaded) {  
+            loadLatexUserDefs();       
+            rerenderMaths(); 
+        } else {
+            $([Jupyter.events]).on("notebook_loaded.Notebook", function() {
+                      loadLatexUserDefs();   
+                      rerenderMaths();  
+            })
+        }
+    }
+    return {
+            load_ipython_extension: load_ipython_extension,
+    };
+})

src/jupyter_contrib_nbextensions/nbextensions/load_tex_macros/main.js

@@ -0,0 +1,17 @@
+
+Purpose
+=======
+This extension loads a tex file whenever a notebook is loaded, then re-runs
+mathjax. It's useful if you have several notebooks that use a common set of latex
+macros, so you don't have to copy the macros to each notebook.
+
+Usage
+=====
+
+Simply put your latex macros in a file named latexdefs.tex, in the same directory as your notebook.
+
+
+Credit
+======
+
+This is derived entirely from the nbextension `jupyter_latex_envs`, with help from its author @jfbercher.