Use absolute URLs to svg images instead of bundling them

Generated docs are not "portable" if we try to bundle the svg illustrations.
Simply link directly to the versions I've uploaded on github.

Author: bluss

docgen/mkdocs.py

@@ -50,8 +50,8 @@ def dest_dir():
 
 def doc_home():
     return P.dirname(sys.argv[0])
-def image_dir():
 
+def image_dir():
     return P.join(doc_home(), "images")
 
 def mkdocs():
@@ -64,10 +64,8 @@ def mkdocs():
                   % (docdir, version(crate)))
     dest = dest_dir()
     target_doc = P.join(target_dir(), "doc")
-    images_dir = image_dir()
     run_shell("rm -rvf ./%s" % dest)
     run_shell("cp -r %s %s" % (target_doc, dest))
-    run_shell("cp %s/*.svg %s/ndarray/" % (images_dir, dest))
     run_shell("cat %s/custom.css >> %s/main.css" % (doc_home(), dest))
     # remove empty files
     run_shell("find %s -size 0 -delete" % (dest, ))

src/impl_methods.rs

@@ -519,7 +519,7 @@ impl<A, S, D> ArrayBase<S, D> where S: Data<Elem=A>, D: Dimension
     ///
     /// **Panics** if `axis` is out of bounds.
     ///
-    /// <img src="axis_iter.svg" height="250px">
+    /// <img src="https://bluss.github.io/ndarray/images/axis_iter.svg" height="250px">
     pub fn axis_iter(&self, axis: Axis) -> AxisIter<A, D::Smaller>
         where D: RemoveAxis,
     {

src/impl_views.rs

@@ -81,7 +81,7 @@ impl<'a, A, D> ArrayBase<ViewRepr<&'a A>, D>
     /// Below, an illustration of `.split_at(Axis(2), 2)` on
     /// an array with shape 3 × 5 × 5.
     ///
-    /// <img src="split_at.svg" width="300px" height="271px">
+    /// <img src="https://bluss.github.io/ndarray/images/split_at.svg" width="300px" height="271px">
     pub fn split_at(self, axis: Axis, index: Ix)
         -> (Self, Self)
     {