博客搭建

Mon 23 September 2013 by wbn

pelican 简介

之前用Octopress和Jeklly都搭过博客，不过因为ruby不熟悉(借口啦)，写了没两篇慢慢就丢掉了。后来突然发现这个用python写的博客生成工具，虽然感觉管理没有前两者那么方便，不过因为 python自己比较熟悉，方便hack，所以就选择它来重新搭起来自己的博客。

当然，写博客的才是最关键的啦！

搭建过程及创建文章

安装过程

pip install pelican
pip install Markdown

Configuration

Just follow the promption.

博客架构

blog/
├── content              # 存放输入的源文件
│   └── (pages)          # 存放手工创建的静态页面
├── output               # 生成的输出文件
├── develop_server.sh    # make devserver
├── Makefile             # 方便管理博客的Makefile
├── pelicanconf.py       # 主配置文件
└── publishconf.py       # 主发布文件

放github

cd output
git clone git@github.com:username/username.github.io.git

文章的meta data:

Title:
Date:
Category:
Tags:
Slug:

生成blog

make publish
make github (需要自行定义)

遇到的问题及解决方法

pip源速度极慢，通常会timeout

解决方法：更换数据源。网上介绍的config文件里面定义index-url，但是使用了一直没有起作用。后来随便改改试试，改成index_url后发现config文件可以起到作用了。

pip源设置

安装pytz包出错

解决方法：是因为版本的问题。

pip install --pre pytz

markdown文件不识别

解决方法：因为pelican依赖一个特定的markdwon包，注意上面安装过程的命令

将整个output文件作为git库，但是每次make publish后，output文件都会被覆盖

解决方法：在publishconf文件中有一个选项关于publish是否要覆盖output文件的，更改即可。

Reference

Categories
Tech