我的github blog環境設置

每一個人都想擁有本身的網站，可是大部分比較屌絲，不想花錢租賃服務器，哈哈，屌絲有屌絲辦法。github應該都據說過吧，github.io提供了此功能，並且使用github來管理本身的代碼，若是你有域名，還能夠綁定你本身的域名歐。我在github的博客（jacksu blog）終於搗鼓好了，也給你們介紹一下建站步驟。

軟件安裝

大致須要如下幾個東東，個性化的就須要本身去搜尋。

pelican

安裝

咱們須要網站的管理工具pelican，pelican能夠把markdown的文件生成html和pdf，pelican又依賴於pipe，安裝命令以下：

sudo easy_install pipe

sudo pip install pelican

檢查是否安裝成功

執行以下命令：

pelican -h或者
pelican .md所在目錄

Markdown包

pelican不能夠識別markdown，須要下載markdown包，markdown的下載方式爲：

sudo pip install Markdown

主題

沒有主題，你的網站太難看了，那麼下載一個主題：

git clone https://github.com/farseerfc/pelican-themes

---

設置

github上的設置

在github上創建username.github.io的項目（如何在github創建項目，我就不說了，應該不少人會），參考官方文檔設置，過十分鐘左右你就能夠經過username.github.io訪問了。

settings.py設置

settings.py的內容大致以下，我也是參考mx的blog的.

# -*- coding: utf-8 -*-
import sys

TIMEZONE = 'Asia/Shanghai'

DEFAULT_LANG = 'zhs'

SITENAME = "X. Wei's Blog"
AUTHOR = 'X.Wei'

DISQUS_SITENAME = 'xweisblog'
GITHUB_URL = '<https://github.com/X-Wei>'#github連接
SITEURL = '<http://x-wei.github.com>'
GOOGLE_ANALYTICS = 'UA-30756331-1'#谷歌站點分析
TAG_FEED  = 'feeds/%s.atom.xml'

DEFAULT_PAGINATION = 4#默認每一頁有多少篇文章

DEFAULT_CATEGORY ='misc'
OUTPUT_PATH = '.'
#須要把輸出路徑從默認的'output'改爲根目錄(your_id.github.com目錄), 由於githubpage須要把index.html上傳到repo的master分支的根目錄才能夠!
PATH = 'posts'#這個是指定放置.md/.rst文件的目錄

LINKS = (('dofine', '<http://www.dofine.me>'),
         ('farseerfc', "<http://farseerfc.github.com/>"),
        )#友情連接~

SOCIAL = (
          ('github', '<https://github.com/x-wei>'),
          )#社交網絡連接
          #~ ('twitter', '<http://twitter.com/farseerfc>'),
          #~ ('facebook', '<http://www.facebook.com/farseerfc>'),
          #~ ('weibo', '<http://weibo.com/farseerfc>'),
          #~ ('renren', '<http://www.renren.com/farseer>'),

#這個是farseerfc同窗本身加的, 能夠顯示他的新浪微博內容, 有微博的話能夠把這些加上~
#~ TWITTER_USERNAME = 'farseerfc'
#~ SIDEBAR_CUSTOM = r"""
#~ <li class="nav-header"><h4><i class="icon-list-alt"></i>Weibo</h4></li>
#~ <iframe width="100%" height="550" class="share_self"  frameborder="0" scrolling="no" 
#~ src="<http://widget.weibo.com/weiboshow/index.php?language=&width=0&height=550&fansRow=1&ptype=1&speed=0&skin=2&isTitle=1&noborder=1&isWeibo=1&isFans=1&uid=1862842353&verifier=b193b9de&dpc=1>">
#~ </iframe>
#~ """

#google自定義搜索(大概是站內搜索吧)
#~ GOOGLE_CUSTOM_SEARCH_SIDEBAR = "001578481551708017171:axpo6yvtdyg"
#~ GOOGLE_CUSTOM_SEARCH_NAVBAR = "001578481551708017171:hxkva69brmg"

個人settings.py。

md頭

每一個md文件必須包含下面相關內容，各個字段含義應該經過英文意思就能夠看出來。

Title: 我的github blog環境設置

Date: 2014-7-27 00:20

Modified: 2014-7-27 00:20

Category: env_set

Tags: github

Slug: my-github-blog-set

Author: jacksu

Summary: 每一個人都想擁有本身的網站，可是大部分比較屌絲，不想花錢租賃服務器，哈哈，屌絲有屌絲辦法。github應該都據說過吧，github.io提供了此功能，並且使用github來管理本身的代碼，若是你有域名，還能夠綁定你本身的域名歐。我在github的博客終於搗鼓好了，也給你們介紹一下建站步驟。

---

建站

把剛纔github的項目拉到本地，執行以下命令：

git clone https://github.com/username/username.github.io

pelican -s settings.py -t ../pelican-themes/bootstrap2/ posts/

其中－t後面是你的主題目錄，posts是md所在的目錄。再執行以下命令:

git add .

git commit -m "add"

git push

咱們的我的網站建成了，能夠訪問usrname.github.io了.

---

jacksu blog