build docs in binder

Author: bollwyvl

.binder/environment.yml

@@ -1,8 +1,10 @@
-name: pythreejs
+name: pythreejs-binder
+
 channels:
   - conda-forge
   - nodefaults
-dependencies:
+
+  dependencies:
   # runtimes
   - nodejs >=12,!=13,<15  # prefer LTS
   - pip
@@ -27,3 +29,8 @@ dependencies:
   - matplotlib-base
   - scikit-image
   - scipy
+  # docs
+  - nbsphinx >=0.2.13
+  - nbsphinx-link
+  - sphinx >=1.5
+  - sphinx-rtd-theme

.binder/postBuild

@@ -1,13 +1,25 @@
 #!/usr/bin/env bash
 set -eux
 
+export PIP_DISABLE_PIP_VERSION_CHECK=1
+export PYTHONUNBUFFERED=1
+export PYTHONIOENCODING=utf-8
+
 pushd js
 jlpm --ignore-optional
 popd
 
+# install and validate python environment
 python setup.py sdist
-python -m pip install -v dist/pythreejs*.tar.gz --no-deps --ignore-installed
+python -m pip install -v dist/pythreejs*.tar.gz
+python -m pip install -e .[test,examples,docs] --ignore-installed
+python -m pip check || echo "uh oh"
+
+# build docs
+pushd docs
+make html
+popd
 
-# validate
+# validate extensions
 jupyter nbextension list
 jupyter labextension list