程序员日常Python日常

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

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的依赖项:

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

现在,让我们看看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。

上一篇下一篇

猜你喜欢

热点阅读