Python/pelican搭建个人博客

2018-05-03 本文已影响11人听风轻咛

Title: Python/pelican搭建个人博客
Date: 2015-12-11 09:23
Modified: 2015-12-11 09:23
Category: 脚本
Tags: Mac,python,pelican
Slug: python_pelican_blog
Authors: lizhonghuan
Summary: 本文使用python pelican搭建个人静态博客，并上传到个人git仓库，实现访问个人博客，本文作者所用就是基于该博客的个人主页。

PS：提升到系统root权限：$ sudo -s；

1.安装git；

2.安装pip过程：

查看pythion安装目录：
$ which python
/usr/local/bin/python
安装pip:
$ sudo easy_install pip
第一次输入时出现无法安装，则可以选择进行下面的安装；
安装最新版本的python,pip&setuptools:
$ brew install python

PS:brew 又叫Homebrew，是Mac OSX上的软件包管理工具，能在Mac中方便的安装软件或者卸载软件，只需要一个命令,非常方便brew类似ubuntu系统下的apt-get的功能,http://brew.sh/ 安装方法如下：$ ruby -e "$(curl -fsSL https://raw.github.com/mxcl/homebrew/go)"

详细请见：http://www.cnblogs.com/TankXiao/p/3247113.html

3.安装virtualenv:

$ pip install virtualenv

4.创建虚拟环境：

$ virtualenv ~/virtualenv/pelican
$ cd ~/virtualenvs/pelican
$ source bin/activate

5.安装pelican：

$ pip install pelican

6.安装markdown,typogrify：

$ pip install markdown
$ pip install typogrify

7.创建博客站点：

$ mkdir blog
$ cd blog
$ pelican-quickstart

pelican-quickstart执行命令后，会提示输入博客的配置项，除了少数几个必填以外，其它都可以选择默认，而且都可以在pelicanconf.py文件中进行更改，所以你可以随意选择。命令成功执行后，会出现pelican的框架，如下所示

blog/

├── content # 存放输入的markdown或RST源文件

│ └── (pages) # 存放手工创建的静态页面，可选

│ └── (posts) # 存放手工创建的文章，可选

├── output # 存放最终生成的静态博客

├── develop_server.sh # 测试服务器

├── Makefile # 管理博客的Makefile

├── pelicanconf.py # 配置文件

└── publishconf.py # 发布文件，可删除

8.选择博客主题：

在blog目录下，各页面主题可以在这个网址查看Pelican themes http://pelicanthemes.com/, 克隆主题开源库 https://github.com/getpelican/pelican-themes

克隆主题到本地
$ git clone https://github.com/getpelican/pelican-themes.git
打开pelicanconf.py配置文件，更改或添加THEME为自己喜欢的主题，例如本博客所挑选的elegant，更多的配置含义请关注官方文档。
注意下面的这个主题需要填主题的目录路径

THEME = 'pelican-themes/gum'

添加评论系统:

开启个人博客的原因在于分享知识，分享就需要交流，评论模块当然少不了。在Disqus上申请帐号，按照流程Disqus会分配给你站点的Shortname，记牢Shortname，如果忘了请进入admin/settings中查看。然后同理，在pelicanconf.py添加

DISQUS_SITENAME = Shortname

生成博客站点:

$ Site generation

$ pelican /path/to/your/content/ [-s path/to/your/settings.py]

PS：上面的这个路径是你自己博客的content路径；

预览生成的站点

For Python 2, run:

$ cd output
$ python -m SimpleHTTPServer

For Python 3, run:

$ cd output
$ python -m http.server

9.环境建好之后的事情：

OK,到这里，pelican的环境部分我们已经配置完了，不过博主好奇刚才pelican的安装些什么了？也就是说pelican的依赖项：

feedgenerator, to generate the Atom feeds
jinja2, for templating support
pygments, for syntax highlighting
docutils, for supporting reStructuredText as an input format
pytz, for timezone definitions
blinker, an object-to-object and broadcast signaling system
unidecode, for ASCII transliterations of Unicode text
six, for Python 2 and 3 compatibility utilities
MarkupSafe, for a markup safe string implementation
markdown, for supporting Markdown as an input format

好家伙，这么多啊，都看看发现都不错！之后用到了在展开慢慢来说。

现在，让我们看看pelican是多么神奇吧，

$ pelican-quickstart

运行命令之后，在当前目录下有以下的文件

yourproject/

├── content

│ └── (pages)

├── output

├── develop_server.sh

├── fabfile.py

├── Makefile

├── pelicanconf.py # Main settings file

└── publishconf.py # Settings to use when ready to publish

我来说说都是些什么吧，

content这里是放置你的博文的，例如我的hello_python.md文章；pages是让永和可以自己定制些页面，比如aboutme.md等等页面；

output这个目录下放置的就是一会利用pelican生成的静态博客内容，当然是html的；

pelicanconf.py，是博客的配置文件，后面慢慢讲；

Makefile，make命令的配置文件，如果你懂linux这个就so easy！不过不懂也没事。

develop_server.sh 本地服务的脚本;

大致看完这个之后，我们可以先写一篇自己的文章瞅瞅啊，文章模板如下：

Title: My super title

Date: 2010-12-03 10:20

Category: Python

Tags: pelican, publishing

Slug: my-super-post

Author: Alexis Metaireau

Summary: Short version for index and feeds

This is the content of my super blog post.

写完保存后，要有以下的几个命令来生成博客内容啦；

10.git上创建个人主页

首先在自己的git帐号下新建一个组织，填写组织名；添加一个repository:usiege/usiege.github.com(必须用自己用户名，且唯一)；这里需要解决git多用户的问题；将生成的静态页面push到repository中；此时可以访问username.github.com的静态页面；

利用下面的命令来生成你的博客site：

$ make html

我比较喜欢下面的这个命令，它是实时生成你的站点，就是说你修改你的博客什么的它会实时的生成！很棒吧。

$ make regenerate

ok，生成之后，我们要看下显示的效果，用下面的命令吧

$ make serve

下面这个我比较喜欢，理由同上面的那个regerate，哈哈

$ make devserver

至此，我们可以在本地浏览刚才建好的博客了，地址就是http://localhost:8000

停止服务器则是下面的命令：

$ ./develop_server.sh>

创建成功以后，便可以把生成的页面push到github。

$ cd output
$ git init
$ git add .
$ git commit -m "first commit"
$ git remote add origin https://github.com/xxx/xxx.github.io.git
$ git push -u origin master

关于上传的一些注意点：
$ git push origin master
git push命令会将本地仓库推送到远程服务器。
git pull命令则相反。
修改完代码后，使用git status可以查看文件的差别，使用git add 添加要commit的文件，也可以用git add -i来智能添加文件。之后git commit提交本次修改，git push上传到github。