ENH added a Makefile action to build LR images doc

NelleV · NelleV · commit 32906a815607 · 2016-09-08T09:20:33.000-07:00
- typing make html-small-images now generates low resolution images in the
  documentation.
- makefile now creates symlinks and others
diff --git a/doc/Makefile b/doc/Makefile
@@ -21,7 +21,7 @@ I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
 
 .PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
 
-all: html
+all: prepare html
 
 help:
 	@echo "Please use \`make <target>' where <target> is one of"
@@ -50,12 +50,21 @@ help:
 
 clean:
 	rm -rf $(BUILDDIR)/*
+	rm -rf examples
+	rm -rf users/installing.rst
+	rm -rf _templates/gallery.html
 
 html:
 	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html -W
 	@echo
 	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
 
+html-small-plots:
+	$(SPHINXBUILD) -D plot_formats=png:80 -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html -W
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+
+
 dirhtml:
 	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
 	@echo
@@ -177,3 +186,19 @@ pseudoxml:
 	$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
 	@echo
 	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."
+
+
+prepare: mpl_examples mpl_toolkits/axes_grid1/examples \
+	 mpl_toolkits/axisartist/examples users/installing.rst
+
+mpl_examples: ../examples
+	ln -s $< $@
+
+mpl_toolkits/axes_grid1/examples:
+	ln -s ../../../examples/axes_grid1/ $@
+
+mpl_toolkits/axisartist/examples:
+	ln -s ../../../examples/axisartist/ $@
+
+users/installing.rst: ../INSTALL
+	cp $< $@
