Hot to create blog in Pelican, hosted on github pages
Create repo
Firstly, create a github page by creating a github repository and name it USERNAME.github.io
git clone https://github.com/USERNAME/USERNAME.github.io.git cd USERNAME.github.io.git python -m virtualenv --no-site-packages -p /usr/bin/python .env source .env/bin/activate git checkout -b source pip install pelican pip install Markdown pip install ghp-import git clone --recursive https://github.com/getpelican/pelican-plugins git clone --recursive https://github.com/getpelican/pelican-themes pelican-quickstart
Answer some questions .... > Where do you want to create your new web site? [.] > What will be the title of this web site? Buttermilch > Who will be the author of this web site? Tony Stark > What will be the default language of this web site? [en] > Do you want to specify a URL prefix? e.g., http://example.com (Y/n) n > Do you want to enable article pagination? (Y/n) > How many articles per page do you want? [10] > Do you want to generate a Fabfile/Makefile ... and publishing? (Y/n) > Do you want an auto-reload & simpleHTTP ... and site development? (Y/n) > Do you want to upload your website using FTP? (y/N) > Do you want to upload your website using SSH? (y/N) > Do you want to upload your website using Dropbox? (y/N) > Do you want to upload your website using S3? (y/N) > Do you want to upload your website using Rackspace Cloud Files? (y/N)
Edit pelicanconf.py
configure plugins ... setup nessesary python packages ...
Create a Markdown Post
vi content/test.md
Title: Buttermilch is awesome Date: 2013-08-22 16:08 Category: Python Tags: python Author: Tony Stark Summary: Buttermilch is super cool. Buttermilch is super cool.
Create a rst Post
vi content/test1.rst
My super title ############## :date: 2010-10-03 10:20 :modified: 2010-10-04 18:40 :tags: thats, awesome :category: yeah :slug: my-super-post :authors: Alexis Metaireau, Conan Doyle :summary: Short version for index and feeds Buttermilch is super cool.
Test your localhost site
make html make serve
Save and push to github
git branch gh-pages ghp-import output git checkout master git merge gh-pages git push --all
ENJOI!