Follow up on GH-116

* Include docs in source distributions
* Prevent docs deploy job from failing when there's nothing to commit

.github/workflows/docs.yml

@@ -4,12 +4,10 @@ on:
   push:
     branches:
     - master
-    paths-ignore:
+    paths:
-    - examples/**
+    - .github/workflows/*
-    - tests/**
+    - docs/**
-    - LICENSE
+    - src/**
-    - README.md
-    - .*.yml
 
 jobs:
   docs:
@@ -62,5 +60,7 @@ jobs:
 
         rm -r docs
         git add .
-        git commit -m "Build at $(date --iso-8601=seconds)"
+        if git commit -m "Build at $(date --iso-8601=seconds)"
-        git push origin gh-pages
+        then
+          git push origin gh-pages
+        fi

MANIFEST.in

@@ -1,6 +1,9 @@
 include CMakeLists.txt
 recursive-include src *.h *.pxd *.pyx
 
+graft docs
+prune docs/build
+
 include tox.ini
 recursive-include tests *.py
 recursive-include examples *.py

docs/source/conf.py

@@ -19,7 +19,7 @@ napoleon_google_docstring = False
 default_role = 'py:obj'
 
 # Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
+templates_path = ['templates']
 
 # List of patterns, relative to source directory, that match
 # files and directories to ignore when looking for source files.