generate docs on every build, publish on tagged builds

fixes watson-developer-cloud#161

Author: nfriedly

.travis.yml

@@ -6,7 +6,14 @@ node_js:
 - stable
 script:
 - npm test
+- npm run doc
 after_success:
 - npm run coveralls
+- jsdoc/publish.sh
 before_install:
-- '[ "${TRAVIS_PULL_REQUEST}" = "false" ] && openssl aes-256-cbc -K $encrypted_cb4d3d070e32_key -iv $encrypted_cb4d3d070e32_iv -in auth.js.enc -out test/resources/auth.js -d || true'
+- '[ "${TRAVIS_PULL_REQUEST}" = "false" ] && openssl aes-256-cbc -K $encrypted_cb4d3d070e32_key
+  -iv $encrypted_cb4d3d070e32_iv -in auth.js.enc -out test/resources/auth.js -d ||
+  true'
+env:
+  global:
+    secure: I50FnfubwiZlol5Qs9tXPVACGbs+SG2dJLjpbzeio0Hl666d/hDuvf7IFwqqaRjQkmK2TdIjaGLMOgHxh/GGAoYf7LfZqjDID/tAhgoFOYiZwiPj66Z82F9P9cega2nkNW+125NzPuU3rhSCByG8+K/PMH/5JxPwPMoAYNLQjWc=

jsdoc/publish.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+
+# based on http://benlimmer.com/2013/12/26/automatically-publish-javadoc-to-gh-pages-with-travis-ci/
+# todo: add    && [ "$TRAVIS_TAG" != "" ] after confirming it works otherwise
+
+if [ "$TRAVIS_REPO_SLUG" == "watson-developer-cloud/node-sdk" ] && [ "$TRAVIS_PULL_REQUEST" == "false" ] && [ "$TRAVIS_BRANCH" == "master" ] && [ "$TRAVIS_TAG" ]; then
+
+  echo "Publishing JSDoc..."
+
+  git config --global user.email "[email protected]"
+  git config --global user.name "travis-ci"
+  git clone --quiet --branch=gh-pages https://${GH_TOKEN}@github.com/watson-developer-cloud/node-sdk gh-pages > /dev/null
+
+  pushd gh-pages
+    cp -Rf ../doc/watson-developer-cloud/* ./
+    git add -f .
+    git commit -m "JSDdoc for $TRAVIS_TAG"
+    git push -fq origin gh-pages > /dev/null
+  popd
+
+  echo -e "Published JSDoc for $TRAVIS_TAG to gh-pages.\n"
+
+else
+
+  echo -e "Not publishing docs for tag $TRAVIS_TAG on branch $TRAVIS_BRANCH of repo $TRAVIS_REPO_SLUG"
+
+fi