add script to automatically build docs on travis

Author: jiffyclub

.travis.yml

@@ -33,3 +33,6 @@ after_success:
 notifications:
   slack:
     secure: eD/LGUBVwbaFBsBALGmPVerRwF6/PRV3PoBpUYUmL7bKyBJZYwcFCb5t8thZvMF8lcHoF0e5xO7L8DoPuws2+mJCiSDH7QD3oGsLE9DoVMFKsIqvzv0oc6qrWf8LjPqcn3XBnXHOvmogRDaaeTCr8KuYEFtwqmwu3YW0/oWYPWk=
+env:
+  global:
+    - secure: "YCq6pTjxV15fNl0C2xov7bx22/X1YzYq4B347pUn+sywcptTG8Eh4KEKDwV8EPHGm1nExNAigMLTGbnjFqoxg/u7T3hDsewTkZz6Ma93hj3kwx1gDTd/6G8ICT7xHyMrFrHNVYE4ehnJm67M0UmY0K8qk6C7y/bh4xO3Nbg0Q8I="

bin/build_docs.sh

@@ -0,0 +1,61 @@
+#! /usr/bin/env bash
+
+# Copied from github.com/sympy/sympy
+#
+# This file automatically deploys changes to http://synthicity.github.io/activitysim/.
+# This will only happen when building a non-pull request build on the master
+# branch of ActivitySim.
+# It requires an access token which should be present in .travis.yml file.
+#
+# Following is the procedure to get the access token:
+#
+# $ curl -X POST -u <github_username> -H "Content-Type: application/json" -d\
+# "{\"scopes\":[\"public_repo\"],\"note\":\"token for pushing from travis\"}"\
+# https://api.github.com/authorizations
+#
+# It'll give you a JSON response having a key called "token".
+#
+# $ gem install travis
+# $ travis encrypt -r sympy/sympy GH_TOKEN=<token> env.global
+#
+# This will give you an access token("secure"). This helps in creating an
+# environment variable named GH_TOKEN while building.
+#
+# Add this secure code to .travis.yml as described here http://docs.travis-ci.com/user/encryption-keys/
+
+# Exit on error
+set -e
+
+ACTUAL_TRAVIS_JOB_NUMBER=`echo $TRAVIS_JOB_NUMBER| cut -d'.' -f 2`
+
+if [ "$TRAVIS_REPO_SLUG" == "synthicity/activitysim" ] && \
+        [ "$TRAVIS_BRANCH" == "master" ] && \
+        [ "$TRAVIS_PULL_REQUEST" == "false" ] && \
+        [ "$ACTUAL_TRAVIS_JOB_NUMBER" == "1" ]; then
+
+        echo "Installing dependencies"
+        conda install --yes --quiet sphinx numpydoc
+        pip install sphinx_rtd_theme
+
+        echo "Building docs"
+        cd docs
+        make clean
+        make html
+
+        cd ../../
+        echo "Setting git attributes"
+        git config --global user.email "[email protected]"
+        git config --global user.name "Matt Davis"
+
+        echo "Cloning repository"
+        git clone --quiet --single-branch --branch=gh-pages https://${GH_TOKEN}@github.com/synthicity/activitysim.git  gh-pages > /dev/null 2>&1
+
+        cd gh-pages
+        rm -rf *
+        cp -R ../activitysim/docs/_build/html/* ./
+        git add -A .
+
+        git commit -am "Update dev doc after building $TRAVIS_BUILD_NUMBER"
+        echo "Pushing commit"
+        git push -fq origin gh-pages > /dev/null 2>&1
+fi