每個人都想擁有自己的網站,但是大部分比較屌絲,不想花錢租賃服務器,哈哈,屌絲有屌絲辦法。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
了.