Travis-CI configuration

Just add a .travis.yml file, like you would do for your unit-tests.

language: python
branches:
  only:
  - master
install:
- pip install pelican ghp-import
script:
- make publish github

In order to avoid the blog to be updated by changes on the draft branch, only commits of master trigger updates.

Travis authentication on Github

Since it will push to the gh-pages branch of your repo, it has to authenticate on Github. For this, we use a OAuth token, that can be created and revoked from the GitHub applications page.

In order to keep it secret with Travis, we use their Ruby application to encrypt it :

sudo apt-get install ruby1.9.1-dev build-essential
sudo gem install travis

travis encrypt GH_TOKEN=your_token

A new block will be added to .travis.yml.

env:
  global:
    secure: NWjh6sCvmjuX...yWo=

Push on Github pages

I modified the Makefile provided in Pelican.

It uses ghp-import to build the branch from the output folder and pushes quietly with force via HTTPS using the token variable.

github: publish

  ghp-import -n $(OUTPUTDIR)
  @git push -fq https://${GH_TOKEN}@github.com/$(TRAVIS_REPO_SLUG).git gh-pages > /dev/null

Use leading @ to remove command from output, thanks Ryan Peck!

Also disable pull request builds in Travis to prevent the blog being updated by a pull request (thanks Andrew Aitken !).

Custom domain

Github expects a CNAME file. Pelican provides a simple way to create it using extra paths, controlled via settings :

STATIC_PATHS = ['images', 'extra/CNAME']
EXTRA_PATH_METADATA = {'extra/CNAME': {'path': 'CNAME'},}

If any doubt, just have a look the repository of this blog...