Make it possible to have Plugin readmes in the plugin dirs

docs/Makefile

@@ -18,6 +18,11 @@ clean:
 	rm -rf doxyoutput/ api/
 	@$(SPHINXBUILD) -M clean "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
+copy-plugin-readmes:
+	install -d plugins
+	(cd ../plugins; \
+		ls -d * |xargs -n 1 -I % cp %/README.md ../docs/plugins/%.md )
+
 
 examples:
 	install -d examples

docs/_sphinx/copy-plugin-readmes.py

@@ -0,0 +1,11 @@
+"""Crude Sphinx extension to run a makefile step
+"""
+
+import os
+
+
+def config_inited(app, config):
+    os.system('make copy-plugin-readmes')
+
+def setup(app):
+    app.connect('config-inited', config_inited)

docs/conf.py

@@ -37,6 +37,7 @@ extensions = [
 ]
 
 extensions.append('copy-examples')
+extensions.append('copy-plugin-readmes')
 
 
 # Setup the breathe extension