DOC: move documentation into github pages

Author: matthew-brett

Makefile

@@ -3,7 +3,7 @@ HTML_DIR=build/html
 LATEX_DIR=build/latex
 WWW_DIR=build/website
 DOCSRC_DIR=doc
-SF_USER ?= matthewbrett
+GITHUB_REPO=https://github.com/nipy/nibabel
 #
 # The Python executable to be used
 #
@@ -121,23 +121,23 @@ gitwash-update: build
 # Website
 #
 
-website: website-stamp
-website-stamp: $(WWW_DIR) htmldoc pdfdoc
+html: html-stamp
+html-stamp: $(WWW_DIR) htmldoc
 	cp -r $(HTML_DIR)/* $(WWW_DIR)
-	cp $(LATEX_DIR)/*.pdf $(WWW_DIR)
 	touch $@
 
+pdf: pdf-stamp
+pdf-stamp: $(WWW_DIR) pdfdoc
+	cp $(LATEX_DIR)/*.pdf $(WWW_DIR)
+	touch $@
 
-upload-website: website
-	rsync -rzhvp --delete --chmod=Dg+s,g+rw $(WWW_DIR)/* \
-		web.sourceforge.net:/home/groups/n/ni/niftilib/htdocs/nibabel/
-
-# This one udates for the specific user named at the top of the makefile
-upload-htmldoc: htmldoc upload-htmldoc-$(SF_USER)
+website: website-stamp
+website-stamp: $(WWW_DIR) html-stamp pdf-stamp
+	cp -r $(HTML_DIR)/* $(WWW_DIR)
+	touch $@
 
-upload-htmldoc-%: htmldoc
-	rsync -rzhvp --delete --chmod=Dg+s,g+rw $(HTML_DIR)/* \
-		$*,[email protected]:/home/groups/n/ni/nipy/htdocs/nibabel/
+upload-html: html-stamp
+	./doc/tools/upload-gh-pages.sh $(WWW_DIR) $(GITHUB_REPO)
 
 #
 # Sources

doc/tools/upload-gh-pages.sh

@@ -0,0 +1,23 @@
+#!/bin/bash
+# Upload website to gh-pages
+HTML_DIR=$1
+if [ -z "$HTML_DIR" ]; then
+    echo "Need to specify build directory"
+    exit 1
+fi
+UPSTREAM_REPO=$2
+if [ -z "$UPSTREAM_REPO" ]; then
+    echo "Need to specify upstream repo"
+    exit 1
+fi
+cd $HTML_DIR
+git init
+git checkout -b gh-pages
+git add *
+# A nojekyll file is needed to tell github that this is *not* a jekyll site:
+touch .nojekyll
+git add .nojekyll
+git commit -a -m "Documentation build - no history"
+git remote add origin $UPSTREAM_REPO
+git push origin gh-pages --force
+rm -rf .git  # Yes