为什么写博客
一方面是对自己平时工作和学习中收获的自我总结和积累,另一方面,借用知乎的一句话说就是“与世界分享你的知识”。
为什么选择Plican
写博客有两种选择:
一种是博客社区,中文的比如CSDN,博客园等,我之前在CSDN上的博客在这里。社区中不乏很多好的文章,而且搜索起来比较方便。
第二种是搭建个人的独立博客。一直以来搭建独立Blog的首选只有 Wordpress
,不但安装快捷简单,还有无数的插件和主题。我也学习过Python
和Django
,尝试过用Django
自己搭建一个博客,感兴趣的可以看看django-blog-zinnia,但最终因为相对繁杂的配置和管理放弃了。请原谅我的孤陋寡闻,我是直到三个月前才知道Github Pages 和静态博客这个概念的。
静态Blog生成工具的好处:
- 静态,对托管空间没有要求,只要支持Web服务即可,可以直接放在Github上
- 支持
reStructuredText
和Markdown
语法,这种所想即所得的标记语言加上Emacs
的定制配置,写起来很顺手 - 管理,日志都是文本文件,可以用
Git
方便的管理、进行版本控制。 - 内嵌代码支持,使用
pygments
代码高亮 - 轻量级,美观,自定义性强,让你专注于内容等等其他优点就不多说了
Github Pages 官方支持的是Jekyll
。看到很多使用Pelican的教程中都有这样一句话“之所以没有使用的Jekyll, 是因为它是Ruby编写, 而我又对Ruby没有啥兴趣, 所以还是选择了使用了我熟悉的Python编写的Pelican”。我自己也是一个Python爱好者,Ruby接触的很少,所以Python自然也是我的首选。
安装
建议在virtualenv
下使用,首先安装virtualenv:
$ sudo pip install virtualenv
建立 virtualenv 环境
$ virtualenv pelican
$ cd pelican
$ source bin/activate
从 Github
克隆最新代码安装 Pelican
$ git clone git://github.com/getpelican/pelican.git
$ cd pelican
$ python setup.py install
到此Pelican
就安装好了。
新建Blog
创建文件夹并新建Blog
$ mkdir myblog
$ cd myblog
$ pelican-quickstart
回答一系列的问题之后会自动在当前目录生成以下文件
.
|-- content # 所有的文章和图片都放在此目录
|-- develop_server.sh # 用于开启测试服务器
|-- Makefile # 方便管理博客的Makefile
|-- output # 静态文件生成目录
|-- pelicanconf.py # 配置文件
|-- publishconf.py # 发布用的配置文件
新建文章
在 content 目录下新建文件夹,文章便会自动归类到该文件夹名的分类中。
如果要建立页面(比如about页面),在 content 中新建文件夹 pages ,将文件放在该文件夹中即可。
以下用 Markdown 为例:
Title: [Pelican] 使用Pelican搭建静态博客
Date: 2014-03-25 22:20
Category: Python
Tags: pelican, python
Slug: build-blog-with-pelican #指定生成页面的名称, 比如这个页面的最后生成的名称为build-blog-with-pelican.html
Author: Xiong Xiao
Blog具体内容...
生成Blog
生成Blog非常简单,之需要运行
$ make html
即可在 output 目录下生成全站的页面。只需把 output 下的所有文件上传至Web服务器就可以访问了。