使用pelican创建静态博客 - 快车库

创建工作目录

首先使用pip安装pelican和markdown

pip install pelican markdown

然后创建目录

mkdir my_blog

接着进入目录cd my_blog，执行pelican-quickstart，当前目录内就会生成默认配置好的文件

修改配置

pelicanconf.py是博客的配置文件:

#!/usr/bin/env python
# -*- coding: utf-8 -*- #
from __future__ import unicode_literals

AUTHOR = u'printR'
SITENAME = u"catmelo"
SITEURL = 'http://www.cnblogs.com/catmelo/'

PATH = 'content'
TIMEZONE = 'Asia/Shanghai'
DATE_FORMATS = {'zh':'%Y-%m-%d %H:%M'}

DELETE_OUTPUT_DIRECTORY = False
DEFAULT_LANG = u'zh'

THEME = 'pelican-themes/pelican-bootstrap3'
PLUGIN_PATHS = ["plugins", "pelican-plugins"]
PLUGINS = ['tag_cloud', 'related_posts', 'pelican-toc']

USE_FOLDER_AS_CATEGORY = True
#DEFAULT_CATEGORY = u'文章'

SITELOGO = 'images/logo.png'
FAVICON = 'images/logo.png'
SITELOGO_SIZE = 14

ARTICLE_URL = 'posts/{category}/{slug}/'
ARTICLE_SAVE_AS = 'posts/{category}/{slug}/index.html'
PAGE_URL = 'pages/{slug}/'
PAGE_SAVE_AS = 'pages/{slug}/index.html'

MD_EXTENSIONS = ['codehilite(css_class=highlight)','extra']

STATIC_PATHS = ['images', 'extra']
EXTRA_PATH_METADATA = {'extra/CNAME': {'path': 'CNAME'},}

DISPLAY_ARTICLE_INFO_ON_INDEX = True
DISPLAY_TAGS_INLINE = False
DISPLAY_RECENT_POSTS_ON_SIDEBAR = True
SHOW_ARTICLE_CATEGORY = True
SHOW_DATE_MODIFIED = True
RELATED_POSTS_TEXT = u'相关文章'

FEED_ALL_ATOM = None
CATEGORY_FEED_ATOM = None
TRANSLATION_FEED_ATOM = None
AUTHOR_FEED_ATOM = None
AUTHOR_FEED_RSS = None

# Blogroll
LINKS = ((u'Github', 'http://github.com'),)

# Social widget
SOCIAL = (('Github', 'http://github.com'),)

DEFAULT_PAGINATION = 10

# Uncomment following line if you want document-relative URLs when developing
#RELATIVE_URLS = True

#pelican_toc插件配置
TOC = {
    'TOC_HEADERS' : '^h[3-6]',  # What headers should be included in the generated toc
                                # Expected format is a regular expression

    'TOC_RUN'     : 'true'      # Default value for toc generation, if it does not evaluate
                                # to 'true' no toc will be generated
}

在Makefile文件里添加upload命令，方便上传到github:

...

html:
    $(PELICAN) $(INPUTDIR) -o $(OUTPUTDIR) -s $(CONFFILE) $(PELICANOPTS)
upload:
    cd $(OUTPUTDIR) && git add -A && git commit -am "update blog" && git push origin master

...

使用主题和插件

获取主题：git clone git://github.com/getpelican/pelican-themes.git

获取插件：git clone git://github.com/getpelican/pelican-plugins.git

修改pelicanconf.py文件，使主题和插件生效：

THEME = 'pelican-themes/pelican-bootstrap3' #直接指定主题目录
PLUGIN_PATHS = ["plugins", "pelican-plugins"] #pelican-plugins为插件总目录
PLUGINS = ['tag_cloud', 'related_posts'] #插件总目录里的插件(文件夹)名

上传到GitHub Pages

域名设置

在content/extra/内添加CNAME文件，CNAME里只需写入一行域名，例如：github.com

修改pelianconf.py:

STATIC_PATHS = ['extra']
EXTRA_PATH_METADATA = {'extra/CNAME': {'path': 'CNAME'},}

git操作

cd output
git init
git remote add origin https://github.com/your_name/your_blog.git
git add -A
git commit -am "update blog"
git pull origin master
git push origin master

以后更新网站只需要执行：

cd my_blog
make html
make upload

添加logo和favicon(仅针对pelican-bootstrap3主题)

修改pelicanconf.py:

STATIC_PATHS = ['images', 'extra']

SITELOGO = 'images/logo.png'
FAVICON = 'images/logo.png'
SITELOGO_SIZE = 14

把图标logo.png放进content/images/里即可