使用github和pelican搭建本站博客

2013-07-13 1238 words 3 minutes

Contents

使用github和pelican搭建本站博客

安装virtualenv虚拟环境

安装虚拟环境是为了防止污染，linux本身的python环境

1

easy_install virtualenv

使用virtualenv

1
2
3


virtualenv pelican   #创建虚拟环境
cd pelican
source bin/activate   #激活虚拟环境

安装pelican和markdown

pelican 就是生成静态博客的程序

markdow 是写博客使用的轻量级标记语言,不会使用的同学可以查看帮助

1
2
3


$ pip install pelican
$ pip install Markdown
$ pip install ghp-import

建立blog目录

1

$ mkdir myblog

开始创建

1

$ pelican-quickstart

基本按照提示设置就可以，稍后可以在pelicanconf.py文件中手动修改。

1
2
3
4
5
6
7


.
|-- content #所有文章放于此目录
|-- develop_server.sh  #用于开启测试服务器
|-- Makefile   #方便管理博客的Makefile
|-- output #静态生成文件
|-- pelicanconf.py #配置文件
|-- publishconf.py #配置文件

写一篇文章

在content目录新建一个test.md文件, 填入一下内容:

1
2
3
4
5


Title: 文章标题
Date: 2013-04-18
Category: 文章类别
Tag: 标签1, 标签2    
这里是内容

然后执行:

1

make html

用以生成html

然后执行

1

./develop_server.sh start

开启一个测试服务器, 这会在本地 8000 端口建立一个测试web服务器, 可以使用浏览器打开:http://localhost:8000来访问这个测试服务器, 然后就可以欣赏到你的博客了

Github上的准备

在Github上创建一个新项目，把这个项目clone到myblog文件夹下。然后按照Github的规定建立一个没有父节点的分支gh-pages。

注：在是用分支创建github的blog的时候，要先确保自己的github上有例如：zbing3.github.io命名的项目并且在settings中开启Github Pages 如图：

点击Automatic Page Generator开启Github Pages服务

进入output目录中：

1
2
3
4
5
6


$ git init
$ git checkout --orphan gh-pages
$ git add .
$ git commit -m "first post"
$ git remote add origin git@github.com:zbing3/opslinux.git
$ git push origin gh-pages

这样上传完代码等10分钟左右，即可在浏览器中使用http://zbing3.github.io/myblog就能访问到自己的博客

定制自己的Makefile文件，让git提交更方便一点

使用此方法就不用在output目录中初始git了。编辑Makefile vim Makefile ，在github下面添加如下格式的文件：

1
2
3
4
5
6


pip install ghp-import

git:
    $(PELICAN) $(INPUTDIR) -o $(OUTPUTDIR) -s $(CONFFILE) $(PELICANOPTS)
    ghp-import $(OUTPUTDIR)
    git push origin gh-pages

ghp-import 是用来Easily import docs to your gh-pages branch，就是方便添加到gh-pages分支的，这个分支github才能解析我们的html嘛。接着以后：make git 就可以直接提交到git的gh-pages分支的

pelican的备份

因为有时候要换电脑，所以肯定要把你的pelican的博客环境做备份，以便换完电脑后快速的搭建出写博客的环境

进入blog目录：

1
2
3
4
5
6
7
8


$ git branch #查看本地分支，没有master所以要创建 如果有master就跳过创建
  gh-pages
$ git branch master #创建master分支
$ git checkout master #切换到master分支
$ git add .
$ git commit -m "first post"
$ git remote add origin git@github.com:zbing3/opslinux.git #添加过origin就不用添加
$ git push origin master  #有事提交报错，如因原来提交过master分支起冲突，就在后面追加--froce

Contents

使用github和pelican搭建本站博客

使用github和pelican搭建本站博客

安装virtualenv虚拟环境

使用virtualenv

安装pelican和markdown

建立blog目录

开始创建

写一篇文章

Github上的准备

定制自己的Makefile文件，让git提交更方便一点

pelican的备份

未完待续……