友荐云推荐

个人github 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上传到repomaster分支的根目录才可以!
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

Comments !