PyMC4 conversion and site rebuild (#8)

Now using mkdocs instead of jupyter and custom HTML.

Author: ericmjl

.gitignore

@@ -3,6 +3,7 @@
 figures/*
 .vscode/*
 src/*
+*.md.tmp
 
 # Byte-compiled / optimized / DLL files
 __pycache__/

.pre-commit-config.yaml

@@ -7,9 +7,9 @@ repos:
     -   id: trailing-whitespace
     -   id: end-of-file-fixer
     -   id: check-yaml
-    -   id: check-added-large-files
--   repo: https://github.com/kynan/nbstripout
-    rev: master
-    hooks:
-    -   id: nbstripout
-        files: ".ipynb"
+#     -   id: check-added-large-files
+# -   repo: https://github.com/kynan/nbstripout
+#     rev: master
+#     hooks:
+#     -   id: nbstripout
+#         files: ".ipynb"

.travis.yml

@@ -17,19 +17,22 @@ install:
 
   # Install Python and required packages.
   - conda env create -f environment.yml
-  - source activate bayesian
+  - source activate bayesian-analysis-recipes
 
   # Ensure that the kernel is installed into the compute environment.
-  - python -m ipykernel install --user --name bayesian
+  - python -m ipykernel install --user --name bayesian-analysis-recipes
 
 script:
   # Create the docs directory. This is where we will be publishing from
   # (see the "deploy" section below).
-  - mkdir -p docs
+  # - mkdir -p docs
   # All notebooks that need to be converted are inside nbconvert_config.py
   # We have to call on --execute - without doing so, the execution config
   # inside nbconvert_config.py won't run.
-  - jupyter nbconvert --config nbconvert_config.py --execute
+  # - jupyter nbconvert --config nbconvert_config.py --execute
+
+  # Build docs using mkdocs
+  - mkdocs build
 
 
 # This is an example to deploy to a branch through Travis.
@@ -42,7 +45,7 @@ deploy:
   on:
     branch: master
   # Take the docs/ directory
-  local-dir: docs
+  local-dir: site
   # Publish to the gh-pages branch
   target-branch: gh-pages
   verbose: true

Makefile

@@ -1,9 +1,11 @@
+.PHONY: docs
+
 execute_params = --execute --ExecutePreprocessor.timeout=600
 
 RAWNBS = $(wildcard notebooks/*.ipynb)
 HTMLS =  $(patsubst notebooks/%.ipynb, ../docs/%.html, $(rawnbs))
 
-docs:
+htmldocs:
 	jupyter nbconvert notebooks/bayesian-estimation-multi-sample.ipynb --output ../docs/bayesian-estimation-multi-sample.html
 	jupyter nbconvert notebooks/degrees-of-freedom.ipynb --output ../docs/degrees-of-freedom.html
 	jupyter nbconvert notebooks/dirichlet-multinomial-bayesian-proportions.ipynb --output ../docs/dirichlet-multinomial-bayesian-proportions.html
@@ -13,3 +15,6 @@ docs:
 
 html: $(HTMLS)
 	jupyter nbconvert $< --output $@
+
+docs:
+	mkdocs serve