技術ブログを静的ページジェネレータPelicanで始めることにした

$ git clone git@github.com:raimon49/raimon49.github.io.git
$ cd raimon49.github.io
$ git checkout -b source

$ pyenv virtualenv 2.7.8 venv-2.7.8-pelican
$ pyenv local venv-2.7.8-pelican

$ pip install pelican markdown fabric
$ pip list
blinker (1.3)
docutils (0.12)
ecdsa (0.11)
Fabric (1.10.0)
feedgenerator (1.7)
Jinja2 (2.7.3)
Markdown (2.5.1)
MarkupSafe (0.23)
paramiko (1.15.1)
pelican (3.5.0)
pip (1.5.6)
pycrypto (2.6.1)
Pygments (1.6)
python-dateutil (2.2)
pytz (2014.9)
setuptools (3.6)
six (1.8.0)
Unidecode (0.04.16)
wsgiref (0.1.2)

$ pelican-quickstart
Welcome to pelican-quickstart v3.5.0.

This script will help you create a new Pelican-based website.

Please answer the following questions so this script can generate the files
needed by Pelican.


> Where do you want to create your new web site? [.] .
> What will be the title of this web site? Steel Dragon 14106
> Who will be the author of this web site? raimon
> What will be the default language of this web site? [en] ja
> Do you want to specify a URL prefix? e.g., http://example.com   (Y/n) y
> What is your URL prefix? (see above example; no trailing slash) http://raimon49.github.io
> Do you want to enable article pagination? (Y/n) y
> How many articles per page do you want? [10] 10
> Do you want to generate a Fabfile/Makefile to automate generation and publishing? (Y/n) y
> Do you want an auto-reload & simpleHTTP script to assist with theme and site development? (Y/n) y
> Do you want to upload your website using FTP? (y/N) n
> Do you want to upload your website using SSH? (y/N) n
> Do you want to upload your website using Dropbox? (y/N) n
> Do you want to upload your website using S3? (y/N) n
> Do you want to upload your website using Rackspace Cloud Files? (y/N) n
> Do you want to upload your website using GitHub Pages? (y/N) y
> Is this your personal page (username.github.io)? (y/N) y
Done. Your new project is available at /home/raimon49/works/git/raimon49.github.io

# Atom/RSS Feedの生成に必要
SITEURL = 'http://raimon49.github.io'
# SITEURLが指定されているとローカルサーバでもリンクに使われてしまうので
# ローカルサーバのプレビュー時は相対リンクするように指定
RELATIVE_URLS = True

# SITEURL/YYYY/MM/DD/Markdown fileというルールでURLを発行
ARTICLE_PATHS = ['blog']
ARTICLE_SAVE_AS = '{date:%Y}/{date:%m}/{date:%d}/{slug}.html'
ARTICLE_URL = '{date:%Y}/{date:%m}/{date:%d}/{slug}.html'

# ブログ記事の日付フォーマットを指定
TIMEZONE = 'Asia/Tokyo'
DATE_FORMATS = {
    'en': '%a, %d %b %Y',
    'ja': '%Y-%m-%d(%a)',
}

# ブログのデザインテーマを指定（後述）
THEME = './vendor/pelican-sober'

# ブログのRSSフィードを全文配信
FEED_ALL_RSS = 'feeds/all.rss.xml'

# Social widget
SOCIAL = (('GitHub', 'https://github.com/raimon49'),
          ('Twitter', 'https://twitter.com/raimon49'),
          ('Last.fm', 'http://www.lastfm.jp/user/raimon_49'),
          ('Website', 'http://sangoukan.xrea.jp/'),)

$ git submodule add git://github.com/fle/pelican-sober.git vendor/pelican-sober

$ make html
$ make serve

$ fab build
$ fab serve

# 2つをまとめてやってくれる
$ fab reserve

$ fab rebuild
[localhost] local: rm -rf output
[localhost] local: mkdir output
[localhost] local: pelican -s pelicanconf.py
Done: Processed 1 article(s), 0 draft(s) and 0 page(s) in 0.15 seconds.

# 現在のoutputディレクトリの内容をgh-pagesというローカルブランチに反映する
$ pip install ghp-import
$ ghp-import output

# コミットされた内容をリモートpushする
$ git checkout gh-pages
$ git push -f origin gh-pages:master

# sourceブランチで記事を編集
$ git checkout source
$ vim content/blog/2014/11/09/start-tech-blog-by-pelican.md
$ git commit -a
$ git push origin source

# GitHub Pagesに反映
$ fab rebuild
$ ghp-import
$ git checkout gh-pages
$ git push gh-pages:master