Re-include missing notebooks (#206)

The documentation includes some "template" jupyter notebooks, which need to be compiled using `scripts/make_notebook.py` into a teaching + solution version.

This did not happen on readthedocs, and @giovannipizzi accidentally removed the compiled version of these notebooks from the git repository.
This PR now causes them to be built on RTD.

.travis.yml

@@ -23,7 +23,7 @@ env:
   matrix:
     - BUILD: docs
       TARGET: html
-      SPHINXOPTS: -W
+      SPHINXOPTS: -nW
     - BUILD: docs
       TARGET: latexpdf
     - BUILD: pre-commit
@@ -35,8 +35,6 @@ install:
 script: 
   - >
     if [ "$BUILD" == "docs" ]; then 
-     # -C docs: switch to docs/ directory
-      make -C docs pre-docs
       make -C docs $TARGET
     else
       pre-commit install

docs/conf.py

@@ -15,6 +15,9 @@
 from __future__ import print_function
 from __future__ import absolute_import
 
+import os
+import subprocess
+
 # -- General configuration -----------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
@@ -352,3 +355,12 @@ def setup(app):
 intersphinx_mapping = {
     'aiida': ('http://aiida-core.readthedocs.org/en/latest/', None)
 }
+
+# Compile all things needed before building the docs
+# For instance, convert the notebook templates to actual tutorial and solution versions
+print(
+    subprocess.check_output([
+        'make', '-C',
+        os.path.dirname(os.path.realpath(__file__)), 'pre-docs'
+    ],
+                            universal_newlines=True))