move to default build dir

docs/Makefile

@@ -19,14 +19,7 @@ help:
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
 clean:
-	rm -rf api
-	rm -rf user-guide/examples/*.zip
-	rm -rf user-guide/examples/*.rst
-	rm -rf user-guide/examples/*/*.ipynb
-	rm -rf user-guide/examples/*/*.py.md5
-	rm -rf user-guide/examples/*/*.pickle
-	rm -rf user-guide/examples/*/*.rst
-	rm -rf user-guide/examples/*/images
+	rm -rf api auto_examples
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
 
 

docs/conf.py

@@ -4,7 +4,7 @@
 # ctapipe documentation build configuration file, created by
 # sphinx-quickstart on Fri Jan  6 10:22:58 2017.
 #
-# This file is execfile()d with the current directory set to its
+# Thi file is execfile()d with the current directory set to its
 # containing dir.
 #
 # Note that not all possible configuration values are present in this
@@ -152,9 +152,6 @@ def setup(app):
     "examples_dirs": [
         "user-guide/examples",
     ],  # path to your example scripts
-    "gallery_dirs": [
-        "user-guide/examples",
-    ],  # path to where to save gallery generated output
     "subsection_order": ExplicitOrder(
         [
             "user-guide/examples/tutorials",
@@ -165,8 +162,8 @@ def setup(app):
     ),
     "within_subsection_order": FileNameSortKey,
     "nested_sections": False,
-    # "copyfile_regex": r".*\.rst|.*\.png|.*\.json",
     "filename_pattern": r".*\.py",
+    "copyfile_regex": r".*\.png",
     "promote_jupyter_magic": True,
     "line_numbers": True,
     "default_thumb_file": "_static/ctapipe_logo.png",
@@ -227,9 +224,12 @@ def setup(app):
     ".DS_Store",
     "**.ipynb_checkpoints",
     "changes",
-    "user-guide/examples/*/*.ipynb",
-    "user-guide/examples/*/*.py",
     "user-guide/examples/*/README.rst",
+    "user-guide/examples/README.rst",
+    "auto_examples/index.rst",
+    "auto_examples/*/*.py.md5",
+    "auto_examples/*/*.py",
+    "auto_examples/*/*.ipynb",
 ]
 
 # The name of the Pygments (syntax highlighting) style to use.

docs/user-guide/examples/index.rst

@@ -0,0 +1 @@
+.. include:: ../../auto_examples/index.rst