install mathjax to profile by default, instead of IPython tree

The destination is now configurable, and the default no longer requires admin access.

Also defaults to current mathjax 2.0

IPython/external/mathjax.py

@@ -23,18 +23,18 b' import urllib2'
 import tempfile
 import tarfile
 
-from IPython.frontend.html import notebook as nbmod
+from IPython.utils.path import locate_profile
 
 #-----------------------------------------------------------------------------
 # Imports
 #-----------------------------------------------------------------------------
 
-def install_mathjax(tag='v1.1', replace=False):
+def install_mathjax(tag='v2.0', replace=False, dest=None):
     """Download and install MathJax for offline use.
     
-    This will install mathjax to the 'static' dir in the IPython notebook
-    package, so it will fail if the caller does not have write access
-    to that location.
+    You can use this to install mathjax to a location on your static file
+    path. This includes the `static` directory within your IPython profile,
+    which is the default location for this install.
     
     MathJax is a ~15MB download, and ~150MB installed.
     
@@ -43,23 +43,34 b" def install_mathjax(tag='v1.1', replace=False):"
     
     replace : bool [False]
         Whether to remove and replace an existing install.
-    tag : str ['v1.1']
-        Which tag to download. Default is 'v1.1', the current stable release,
-        but alternatives include 'v1.1a' and 'master'.
+    tag : str ['v2.0']
+        Which tag to download. Default is 'v2.0', the current stable release,
+        but alternatives include 'v1.1' and 'master'.
+    dest : path
+        The path to the directory in which mathjax will be installed.
+        The default is `IPYTHONDIR/profile_default/static`.
+        dest must be on your notebook static_path when you run the notebook server.
+        The default location works for this.
     """
-    mathjax_url = "https://github.com/mathjax/MathJax/tarball/%s"%tag
     
-    nbdir = os.path.dirname(os.path.abspath(nbmod.__file__))
-    static = os.path.join(nbdir, 'static')
+    mathjax_url = "https://github.com/mathjax/MathJax/tarball/%s" % tag
+    
+    if dest is None:
+        dest = os.path.join(locate_profile('default'), 'static')
+    
+    if not os.path.exists(dest):
+        os.mkdir(dest)
+    
+    static = dest
     dest = os.path.join(static, 'mathjax')
     
     # check for existence and permissions
     if not os.access(static, os.W_OK):
-        raise IOError("Need have write access to %s"%static)
+        raise IOError("Need have write access to %s" % static)
     if os.path.exists(dest):
         if replace:
             if not os.access(dest, os.W_OK):
-                raise IOError("Need have write access to %s"%dest)
+                raise IOError("Need have write access to %s" % dest)
             print "removing previous MathJax install"
             shutil.rmtree(dest)
         else:
@@ -67,13 +78,13 b" def install_mathjax(tag='v1.1', replace=False):"
             return
     
     # download mathjax
-    print "Downloading mathjax source..."
+    print "Downloading mathjax source from %s ..." % mathjax_url
     response = urllib2.urlopen(mathjax_url)
     print "done"
     # use 'r|gz' stream mode, because socket file-like objects can't seek:
     tar = tarfile.open(fileobj=response.fp, mode='r|gz')
     topdir = tar.firstmember.path
-    print "Extracting to %s"%dest
+    print "Extracting to %s" % dest
     tar.extractall(static)
     # it will be mathjax-MathJax-<sha>, rename to just mathjax
     os.rename(os.path.join(static, topdir), dest)