http://www.xycoding.com/articles/2013/11/21/blog-create/
前言
一直以來都希望擁有屬於自己的個人博客，隨性發點信息，寫點技術感想，記錄自己的生活，重要的是不受廣告的影響、不被河蟹、不會擔心有一天被莫名其妙地消失。作爲一名技術渣碩，拋棄拿來主義，勇於摸索，踏出第一步，不再紙上談兵，從現在開始。
本博客是在windows下搭建完成。不過這和linux下是類似的，因爲搭建過程是在git bash中進行，git bash的命令風格是仿linux的。
知識儲備
搭建博客的工具選用了基於python的pelican，相比wordpress等其它工具來說，它比較輕盈並有很多令人興奮的特性，再配合免費無限制的github
pages，近乎完美。搭建過程中涉及如下技術知識，不過你不必害怕，只是使用它們的開源框架而已，並不需要自己編碼，點擊可以瞭解它們是如何的強大，當然你也可以略過它們，後面遇到時再進行了解。
假如你不能打開它們，原因你懂的，請爬牆解決~
下載安裝
請點擊下載以下內容，本文會一步一步介紹如何安裝，不着急，慢慢來。
- 安裝python，這個就不用多說了吧~
- 安裝git，簡單。git bash使用教程請參見官方文檔~
- 將python安裝文件夾中scripts和make.exe加入環境變量。
- 安裝pip，具體可以看官網介紹，或者Windows環境在python3裝pip。
-
安裝pelican和markdown，至於爲什麼使用markdown語法，這就看個人喜好呢，下載的markdownpad就是window下markdown的編輯器呢，非常簡單，linux等其它操作系統編輯器請自行google。你也可以選用REST語法，具體請參見markdown教程和REST教程。
pip install pelican pip install markdown
主體搭建
打開git bash，進入一個自己喜歡的文件夾（注意文件夾名最好不爲空，因爲後續make html命令會出錯），執行以下命令
mkdir blog //創建文件夾，名稱可根據自己喜歡定
cd blog
pelican-quickstart
pelican-quickstart執行命令後，會提示輸入博客的配置項，除了少數幾個必填以外，其它都可以選擇默認，而且都可以在pelicanconf.py文件中進行更改，所以你可以隨意選擇，如下圖~
命令成功執行後，會出現pelican的框架，如下所示
blog/
├── content # 存放輸入的markdown或RST源文件
│ └── (pages) # 存放手工創建的靜態頁面，可選
├── output # 存放最終生成的靜態博客
├── develop_server.sh # 測試服務器
├── Makefile # 管理博客的Makefile
├── pelicanconf.py # 配置文件
└── publishconf.py # 發佈文件，可刪除
書寫博文
完成上述博客主體搭建後，使用markdownpad創建一個.md文件，保存於content文件夾中。博文格式如下所示
圖中左側是我們書寫的markdown格式的源文件，右邊則是即使預覽效果，很棒吧~ 至於源文件頂部Title,Date,Category等內容則是必須的，具體可參見文檔，它們各自意義如下
Title: 文章標題
Date: 創建日期
Modified: 修改日期
Category: 文章分類，標誌本文處於該分類下
Tags: 文章標籤，標誌本文處於該標籤下
Slug: URL中該文章的鏈接地址
Author: 作者
寫完後，回到blog目錄下，執行make
html命令進行博客的生成
make html
(pelican e:/blog/content/ -o e:/blog/output -s e:/blog/pelicanconfg.py)
make
html命令將把剛纔寫的博文生成html，存放到output目錄下，如果你沒有make命令，也可執行第二行的pelican命令。接着執行make
serve開啓測試服務器
make serve
(cd e:/blog/output/ && python -m pelican.server)
make
serve命令也可由第二行替代，在瀏覽器中輸入http://localhost:8000即可看到博文效果。
主題選擇
回到blog目錄下，按如下步驟下載pelican官方主題，從裏面挑選出自己喜歡的主題吧，大多數主題預覽界面你可以打開這個網頁進行查看。不過如今pelican又新出了很多主題，所以你需看看pelican主題開源庫。
git clone https://github.com/getpelican/pelican-themes.git
打開pelicanconf.py配置文件，更改或添加THEME爲自己喜歡的主題，例如本博客所挑選的gum，更多的配置含義請關注官方文檔。
THEME = 'pelican-themes/gum'
添加評論系統
開啓個人博客的原因在於分享知識，分享就需要交流，評論模塊當然少不了。在Disqus上申請帳號，按照流程Disqus會分配給你站點的Shortname，記牢Shortname，如果忘了請進入admin/settings中查看。然後同理，在pelicanconf.py添加
DISQUS_SITENAME = Shortname
博文發佈
經過以上的折騰，離成功只差最後一步呢。寫好的博文總要找個站點發布吧，本文基於github pages，當然你也可以選擇你熟悉的站點服務器。具體步驟如官方教程，非常簡單。按照官方教程，你就擁有一個二級域名和一個版本庫，比如我的http://cowfighting.github.com/，當然現在訪問會出現跳轉，這在後面獨立域名章節會介紹。
進入上一章節所示的output目錄下，依次執行以下命令
git init
git add .
git remote add origin https://github.com/cowfighting/cowfighting.github.io
git pull origin master
git commit -m 'first blog'
git push origin master
熟悉git的同學肯定知道上述命令表達的是什麼意思吧，如果你還不甚瞭解，沒關係，先照做或者看看git的官方文檔。上述命令很長，如果你比較熟悉了，可以修改Makefile文件進行一鍵上傳~
最後打開瀏覽器輸入github pages的二級域名，效果如下
目前爲止，還算比較成功。從上圖可以看出，書寫源文件的Title,Date,Category,Slug等內容每個都有其的用武之處，具體你可以慢慢了解。
TODO
目前來說，博客的基本使用已經可以了，不過我們依然可以對其進行完善。接下來的一篇文章我會介紹以下幾個方面
- 獨立域名
- 博文URL格式配置，例http://www.xycoding.com/pages/2013/11/21/create-blog/
- pelican插件的使用（Sitemap等）
- Google Analytics和Google Webmasters
感想
這是我第一次比較認真的寫教程，參考了網上很多的例子，不過都覺得他們講得不夠詳細，讓我花了很多時間去看官方介紹，當然這可能是我太渣的緣故，看不懂大神們的教程，哈哈。不過從中我也學到了很多心得，比如不懂的地方第一選擇是官方文檔，本文基本給出了搭建博客過程的所有鏈接。
最後，不管怎樣，屬於自己個人的博客已經搭建起來，從現在開始，記錄自己的生活吧~