DOC: Add script to randomly link to a gallery image.

doc/source/random_gallery.py

@@ -0,0 +1,51 @@
+# Generate a javascript snippet that links to a random gallery example
+
+import os
+import glob
+
+base = os.path.abspath(os.path.dirname(__file__))
+example_dir = os.path.join(base, 'auto_examples')
+js_fn = os.path.join(base, '_static/random.js')
+
+javascript = '''\
+
+   function insert_gallery() {
+       var images = {{IMAGES}};
+       var links = {{LINKS}};
+
+       ix = Math.floor(Math.random() * images.length);
+       document.write(
+'{{GALLERY_DIV}}'.replace('IMG', images[ix]).replace('URL', links[ix])
+       );
+
+       console.log('{{GALLERY_DIV}}'.replace('IMG', images[ix]).replace('URL', links[ix]));
+   };
+
+'''
+
+gallery_div = '''\
+<div class="gallery_image">
+      <a href="URL"><img src="IMG"/></a>
+</div>\
+'''
+
+examples = glob.glob(os.path.join(example_dir, 'plot_*.py'))
+
+images, links = [], []
+image_url = 'http://scikits-image.org/docs/dev/_images/%s.png'
+link_url = 'http://scikits-image.org/docs/dev/auto_examples/plot_%s.html'
+
+for e in examples:
+    e = os.path.basename(e)
+    e = e[:-len('.py')]
+
+    images.append(image_url % e)
+    links.append(link_url % e)
+
+javascript = javascript.replace('{{IMAGES}}', str(images))
+javascript = javascript.replace('{{LINKS}}', str(links))
+javascript = javascript.replace('{{GALLERY_DIV}}', ''.join(gallery_div.split('\n')))
+
+f = open(js_fn, 'w')
+f.write(javascript)
+f.close()