setup Travis continuous integration (CI) to update daily

[bbest]

While at rOpenSci runconf17, initially describing this at ropensci-archive/cityquant#1

[bbest]

Resources

• How to set up TravisCI for projects that push back to github
• Improving automatic document production with R | Locke Data
  • Automated documentation hosting on github via Travis-CI | Locke Data
• bookdown - Github & Travis
• Travis CI:
  • Cron Jobs
  • Getting started
  • Building an R Project
  • Encryption keys

Steps

In these steps below replace:

• bbest with your Github username
• SustainSB with your Github username or organization containing the repository
• sustainsb.github.io with your Github repository

1. Add R dependencies into DESCRIPTION file.

2. Turn on repository in your Travis profile, eg travis-ci.org/profile/bbest.

3. Add .travis.yml file to root of your repository, eg .travis.yml which executes _render.sh &
   _push.sh.

4. Trigger your first build with a git push and check Travis at travis-ci.org/SustainSB/sustainsb.github.io.

5. Add badge to top of README.md (note Travis URLs are case sensitive):

[![](https://api.travis-ci.org/SustainSB/sustainsb.github.io.svg?branch=master)](https://travis-ci.org/SustainSB/sustainsb.github.io)

1. Create Personal Access Token at github.com/settings/tokens and paste value into file outside repo, eg ~/.gh-token_sustainsb-push.

2. Add encrypted Github token to .travis.yml and git push to enable the `_push:

travis init
echo GH_TOKEN=`cat ~/.gh-token_sustainsb-push` | travis encrypt --add

[bbest]

Yay, working!

https://travis-ci.org/SustainSB/sustainsb.github.io/builds/241735700

[bbest]

Now git commit logs $TRAVIS_EVENT_TYPE, so far either cron or push: