用 Pelican 和 github 打造你的个人主页

用 Pelican 生成你的个人主页

无需申请站点, 也不要搭建服务器, 编写网页, 如果只是一个人站点, 发布点个人信息, 博客文章, 以及读书笔记, 用 pelican 和 github 就可以做一个免费的个人主页.

So easy.

1. 安装 brew

这里仅以 mac book 为例，在windows上差不多，先把python, pip装上，剩下的就好办了

homebrew 是必需的, 如果你还没有安装的话

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

2. 安装 python, pip and pelican

brew install python
sudo easy_install pip
sudo pip install pelican markdown

output: ::

Successfully installed blinker-1.3 docutils-0.12 feedgenerator-1.7 jinja2-2.7.3 markdown-2.6 markupsafe-0.23 pelican-3.5.0 pygments-2.0.2 unidecode-0.4.17

3. 执行 pelican-quickstart in yoursite folder

pelican-quickstart

常见问题

问题1: some errors showed up: ValueError: unknown locale: UTF-8

解决方案:

在 ~/.bash_profile增加如下两行

export LC_ALL=en_US.UTF-8

export LANG=en_US.UTF-8

问题2: No module named html_parser

解决方案: pip install six

if still encounter the error , upgrade python form 2.7.6 to 2.7.9

if still encounter the error::

sudo vi /Library/Python/2.7/site-packages/pelican/readers.py
#from six.moves.html_parser import HTMLParser
from HTMLParser import HTMLParser

4. 添加一个文件 test.md 在 content 目录中

Title: Journal
Date: 2015-02-27 10:20
Modified: 2015-02-27 19:30
Category: Journal
Tags: journal, blog
Authors: Walter Fan
Summary: Daily minute

# Task

5. 快速测试一下

步骤如下:

pelican content
cd output
python -m SimpleHTTPServer

6. 访问 http://localhost:8000

可见一个象模象样的博客网站已经生成了

Tips

edit pelicanconf.py to set RELATIVE_URLS = True

用 github 来发布你的个人主页

1. publish blog to github site

步骤如下:

cd output
git init
git add *
git remote add origin https://github.com/walterfan/walterfan.github.io.git git pull origin master
git commit -am 'add blog'
git push -u origin master

2. 定制你的博客站点样式

步骤如下:

mkdir theme
git submodule add https://github.com/DandyDev/pelican-bootstrap3.git git submodule init
git submodule update

然后编辑 pelicanconf.py, 增加下面这行

THEME = '../theme/pelican-bootstrap3'