pelican + github 搭建个人博客一、安装环境1.1需要安装的软件Pythonpython2或者python

一、安装环境

1.1 需要安装的软件

Python

python2 或者 python3
pip
virtualenv
pelican
markdown

make

1.2 安装步骤

1.2.1 安装 Python

安装 Python2 或者 Python3 。

1.2.2 安装 virtualenv

# 安装 virtualenv 包
pip install virtualenv

# 为了使用virtualenv更方便，可以借助 virtualenvwrapper（可选）
pip install virtualenvwrapper-win

1.2.3 创建并激活虚拟环境

1）配置虚拟环境目录。

默认创建的虚拟环境位于C:\Users\username\下，可以通过环境变量 WORKON_HOME 来定制。通过计算机-->属性-->高级系统设置-->环境变量-->系统变量中新建“变量名”：WORKON_HOME，变量值：你自定义的用来创建虚拟环境的路径。

2）创建虚拟环境

# 新建 pelican 虚拟环境所在目录（如果通过环境变量设置了虚拟环境的目录，则不需要），例如：
mkdir Virtualenv
cd Virtualenv

# 创建并激活虚拟环境
mkvirtualenv env_pelican

常用命令：

# 激活虚拟环境
workon {虚拟环境目录}
# 停止虚拟环境
deactivate
# 进入虚拟环境目录
cdvirtualenv
# 列出所有虚拟环境
lsvirtualenv
# 检查虚拟环境是否激活（其他方法也可）
pip list

1.2.4 安装 Python 的相关模块

# 安装 pelican 和 markdown 模块pip install pelican
pip install markdown

1.2.5 安装 make 并设置好环境变量

make 下载地址：http://gnuwin32.sourceforge.net/packages/make.htm

建议把 make 放在./windows/system32目录下，省去设置环境变量的麻烦。

二、生成 pelican 博客

2.1 创建 pelican

1）创建目录，用于存放 pelican 程序。

mkdir pelican-blog
cd pelican-blog

2）创建 pelican 博客

# pelican 快速创建程序
pelican-quickstart

进入创建程序，出现如下提示：

> Where do you want to create your new web site? [.]  # 默认
> What will be the title of this web site? myblog  # 输入博客名称，例如：myblog
> Who will be the author of this web site? obama  # 输入博客作者
> What will be the default language of this web site? [Chinese (Simplified)]  # 默认中文
> Do you want to specify a URL prefix? e.g., https://example.com   (Y/n)  # Y ，如果打算放在github上，可以选择 n
> What is your URL prefix? (see above example; no trailing slash)  # 输入githup地址，例如：https://myblog.github.io
> Do you want to enable article pagination? (Y/n)  # 默认
> How many articles per page do you want? [10]  # 默认
> What is your time zone? [Europe/Paris]  # Asia/Shanghai
> Do you want to generate a tasks.py/Makefile to automate generation and publishing? (Y/n)  # 默认
> Do you want to upload your website using FTP? (y/N)  # N
> Do you want to upload your website using SSH? (y/N)  # N
> Do you want to upload your website using Dropbox? (y/N)  # N
> Do you want to upload your website using S3? (y/N)  # N
> Do you want to upload your website using Rackspace Cloud Files? (y/N)  # N
> Do you want to upload your website using GitHub Pages? (y/N)  # 如果是用 github，默认
Done. Your new project is available at F:\Blog\pelican_blog

2.2 配置 pelican

pelican 的配置文件是pelicanconf.py。

1）下载主题

pelican 的主题可以从这里下载：https://github.com/getpelican/pelican-themes

2）设置主题

先把下载好的主题文件放在博客程序根目录下的 pelican-themes文件夹下。如果没有这个文件夹，自己创建一个。

在pelicanconf.py文件的任意位置添加一行：

THEME = '主题目录（相对或绝对路径）'

例如，在 TIMEZONE 配置的下一行添加：

TIMEZONE = 'Asia/Shanghai'
THEME = './pelican-themes/fresh'

2.3 生成 HTML 文件

1）把 markdown 文件放在博客根目录的content文件夹下。

2）运行下面的命令，生成 HTML 文件

pelican
# 或者
pelican content
# 或者
make html
# 或者
make publish

3）生成的 HTML 文件在 output 目录下。

注意：

在生成HTML文件之前，要先在 markdown 文件开头添加一些必要的文件属性，这些属性放在---之间。

例如：

---
Title: pelican + github 搭建个人博客  （填写文章的标题，必填）
Slug: pelican + github creat blog  （生成的HTML文件名称，必填）
Date: 2018-12-10 16:39  （文章的发布时间）
Category: 搭建博客  （文章的分类）
Tags: pelican, github  （标签，多个标签之间用英文逗号隔开）
Author: xxx  （作者）
Summary: 使用 pelican + github 搭建个人博客。  （文章的摘要）
---

2.4 本地预览博客

1）执行命令：make serve

2）在浏览器中输入地址：http://127.0.0.1:8000就可以看到效果。

三、同步到 github

1、创建 github 博客仓库

github博客的仓库名称是固定格式的，必须是 用户名.github.io。如果还没有这样命名的仓库，请先创建。

2、把 output 目录下的文件全部提交到 xxx.github.io 仓库。（xxx代表你的用户名）

3、在浏览器中输入地址：https://xxx.github.io/就可以浏览你的博客了。