add ghp-import features to push to github pages easily

docs/index.rst

@@ -63,4 +63,5 @@ A french version of the documentation is available at :doc:`fr/index`.
    pelican-themes
    importer
    faq
+   tips
    contribute

docs/tips.rst

@@ -0,0 +1,33 @@
+Tips
+####
+
+Here are some tips about pelican, which you might find useful.
+
+Publishing to github
+====================
+
+Github comes with an interesting "pages" feature: you can upload things there
+and it will be available directly from their servers. As pelican is a static
+file generator, we can take advantage of this.
+
+The excellent `ghp-import <https://github.com/davisp/ghp-import>`_ makes this
+eally easy. You would have to install it::
+
+    $ pip install ghp-import
+
+Then, considering a repository containing your articles, you would simply have
+to run pelican and upload the output to github::
+
+    $ pelican -s pelican.conf.py .
+    $ ghp-import output
+    $ git push origin gh-pages
+
+And that's it.
+
+If you want you can put that directly into a post commit hook, so each time you
+commit, your blog is up to date on github!
+
+Put the following into `.git/hooks/post-commit`::
+
+    pelican -s pelican.conf.py . && ghp-import output && git push origin
+    gh-pages

tools/pelican-quickstart

@@ -55,7 +55,11 @@ ssh_upload: $$(OUTPUTDIR)/index.html
 ftp_upload: $$(OUTPUTDIR)/index.html
 \tlftp ftp://$$(FTP_USER)@$$(FTP_HOST) -e "mirror -R $$(OUTPUT_DIR)/* $$(FTP_TARGET_DIR) ; quit"
 
-.PHONY: html help clean ftp_upload ssh_upload dropbox_upload
+github: $$(OUTPUTDIR)/index.html
+\tghp-import $$(OUTPUTDIR)
+\tgit push origin gh-pages
+
+.PHONY: html help clean ftp_upload ssh_upload dropbox_upload github
     ''',
 
     'pelican.conf.py': '''#!/usr/bin/env python