Step0. 前言
其實早在很久之前，就一直聽聞 Github 可以透過靜態頁面的方式來寫網誌。但終沒有認真的找個時間好好的研究，剛好這一次的每週活動是需要練習寫文章，也就藉著這次的機會，順便研究一下到底要怎麼透過 Github 來寫網誌。
Step1. 安裝 Pelican 和建立 git repository
首先必須先安裝 Pelican 和 ghp-import，我們可以非常簡單地透過 pip 來安裝。
$ pip install pelican ghp-import
Pelican 提供兩種編寫文章的格式，分別是 reStructuredText 跟 Markdown，因為我自己本身對 Markdown比較熟悉，所以這邊我選擇使用 Markdown，一樣透過 pip 來安裝 Markdown。
$ pip install Markdown
安裝完所需要的軟體，再來我們需要在 Github 上建立一個空的 git 資料庫(repository)。 不知道怎麼建立 git 資料庫的人，可以參考這裡。 記得這個資料庫的命名一定要是以下這種形式：
https://github.com/username/username.github.io
接著我們就把它 clone 下來吧！
$ git clone https://github.com/username/username.github.io blog
$ cd blog
Step2. 建立 Content branch
因為我們是使用 Markdown 格式寫完文章，再透過 Pelican 幫我們產生出靜態網頁所需要的資源， 一般來說我們會建議把 Markdown 格式的原始文件另外存放在另一個 branch 裡，這樣在管理上會簡單許多。
$ git checkout -b content
Switched to a new branch 'content'
Step3. 設定 Pelican
現在我們要開始對 Pelican 做設定，Pelican 提供了一個快速的設定工具 pelican-quickstart，只要依序回答完問題，就可以完成設定了。
$ pelican-quickstart
Welcome to pelican-quickstart v4.2.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? suzuke's blog
> Who will be the author of this web site? suzuke
> What will be the default language of this web site? [zh]
> Do you want to specify a URL prefix? e.g., https://example.com (Y/n) n
> Do you want to enable article pagination? (Y/n)
> How many articles per page do you want? [10]
> What is your time zone? [Europe/Paris] Asia/Taipei
> Do you want to generate a tasks.py/Makefile to automate generation and publishing? (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)
> 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 /Users/username/blog
設定完之後，可以看一下現在目前的資料夾內是長這個樣子的。每個檔案的功能可以到 Pelican文件 查詢。
$ ls
Makefile content/ develop_server.sh*
fabfile.py output/ pelicanconf.py
publishconf.py
最後再將這些 Pelican 產生出來的檔案，都 commit 和 push 到 content branch上吧，這樣我們就完成了前置的設定囉。
$ git add .
$ git commit -m 'initial pelican commit to content'
$ git push origin content
Step4. 編寫你的第一篇文章
恭喜你可以開始建立跟編寫你的第一篇文章囉！ 這邊我們也順便把 關於我 的頁面也都一併建立出來吧。
$ cd content
$ mkdir pages images
$ cp /Users/username/SecretStash/HotPhotoOfMe.jpg images
$ touch first-post.md
$ touch pages/about.md
用文字編輯器打開 first-post.md 來編寫你的文章，格式如下，詳細見這：
Title: 我的第一篇文章
Date: 2020-05-12 20:20
Modified: 2020-05-12 23:30
Category: Python
Tags: pelican, publishing
Slug: writing-python-with-github
Authors: Suzuke
Summary: 我是摘要
文章的內容在這裡唷！
編輯 關於我 的頁面，打開 pages/about.md
title: 關於我
date: 2020-05-12
使用 Pelican 產生靜態網頁到 output 資料夾：
$ pelican content -o output -s publishconf.py
Pelican 也提供本地端預覽 http://localhost:8000/
$ pelican --listen
都確認沒問題之後使用 ghp-import 把 output 的內容都 commit & push 到 master branch 上：
$ ghp-import -m "Generate Pelican site" --no-jekyll -b master output
$ git push origin master
到這邊其實就已經可以到 https://username.github.io/ 查看結果是否正確。
但懶人如我，每次都要打上面 ghp-import 跟 git push 的指令實在太麻煩，這時就輪到 Makefile 上場救援了。打開 Makefile 看一下內容：
GITHUB_PAGES_BRANCH=master
...
中間省略
...
publish:
$(PELICAN) $(INPUTDIR) -o $(OUTPUTDIR) -s $(PUBLISHCONF) $(PELICANOPTS)
github: publish
ghp-import -m "Generate Pelican site" -b $(GITHUB_PAGES_BRANCH) $(OUTPUTDIR)
git push origin $(GITHUB_PAGES_BRANCH)
可以知道其實我們可以使用 make github 替代上面所說的 ghp-import 跟 git push 指令，這對懶人實在是一大福音啊！
最後再把本地端 content 裡的 Markdown 原始文件都 commit & push 到遠端 github 上：
$ git add content
$ git commit -m 'added a first post, a photo and an about page
$ git push origin content
當然你也可以在 Makefile 加入一點修改：
GITHUB_PAGES_BRANCH=master
GITHUB_CONTENT_BRANCH=content
...
中間省略
...
publish:
$(PELICAN) $(INPUTDIR) -o $(OUTPUTDIR) -s $(PUBLISHCONF) $(PELICANOPTS)
github: publish
ghp-import -m "Generate Pelican site" -b $(GITHUB_PAGES_BRANCH) $(OUTPUTDIR)
git push origin $(GITHUB_PAGES_BRANCH)
content:
git add content
git commit -m "update content"
git push origin $(GITHUB_CONTENT_BRANCH)
如此一來，就能使用 make content 來 commit & push 到 github上囉。