# Pelican-Demo

**Repository Path**: lionker/Pelican-Demo

## Basic Information

- **Project Name**: Pelican-Demo
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2017-01-20
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Pelican博客演示
演示地址: [http://pelican-demo.coding.io/](http://pelican-demo.coding.io/)
# Pelican介绍
Pelican是一个用Python语言编写的静态网站生成器，支持使用restructuredText和Markdown写文章，配置灵活，扩展性强。有许多优秀的主题和插件可供使用。
Pelican 的Github地址是：[https://github.com/getpelican/pelican](https://github.com/getpelican/pelican)
# 如何搭建一个Pelican博客？
## 因为Pelican是静态博客，所以首先得在本地上搭建。
开始前请自行安装Python环境，为方便，再顺手装上distribute、pip、virtualenv。
创建Pelican虚拟环境
```bash
virtualenv PelicanEnv  --distribute
PelicanEnv\Scripts\activate
```
安装 Pelican
```bash
pip install pelican
```
如果您使用Markdown来写文章的话，还需要安装Markdown库
```bash
pip install Markdown
```
## 创建 Blog
创建一个 Blog 目录
```bash
mkdir myblog
cd myblog
```
快速创建 Blog
```bash
pelican-quickstart
```
根据提示一步步输入相应的配置项，不知道如何设置的接受默认即可，后续可以通过编辑pelicanconf.py文件更改配置。
以下是生成的目录结构：
```bash
myblog/ 
├── content              # 存放输入的源文件
│   └── (pages)          # 存放手工创建的静态页面
├── output               # 生成的输出文件
├── develop_server.sh    # 方便开启测试服务器
├── Makefile             # 方便管理博客的Makefile
├── pelicanconf.py       # 主配置文件
└── publishconf.py       # 发布时使用的配置文件
```
## 撰写文章
在 content 目录下用 Markdown 语法来写一篇文章
```bash
Title: Hello World
Date: 2014-12-22 12:20
Category: Python
Tags: pelican
Slug: hello-world
Author: Pelican Demo
Summary: Short version for index and feeds

Hello World!
```
生成页面
```bash
make html
```
我比较喜欢下面的这个命令，它是实时生成你的站点，就是说你修改你的博客什么的它会实时的生成！
```bash
make regenerate
```
生成之后，我们要看下显示的效果
```bash
make serve
```
## 创建一个页面
这里以创建 About页面为例
在content目录创建pages目录
```bash
mkdir content/pages
```
然后创建About.md并填入下面内容
```bash
Title: About Me
Date: 2013-04-18

About me content
```
执行 make html 生成html,  然后打开 http://localhost:8000查看效果 
## 让Pelican支持评论
Pelican 使用Disqus评论,  可以申请在Disqus上申请一个站点,  然后在pelicanconf.py里添加或修改DISQUS_SITENAME项:
```bash
DISQUS_SITENAME = u"pelicandemo"
```
执行
```bash
make html
```
浏览器打开 http://localhost:8000查看效果 
## 更换主题
Pelican本身也提供了一些主题可供选择,  可以从github克隆下来
```bash
git clone git://github.com/getpelican/pelican-themes.git     # 主题 
```
然后在里面找到想要的主题,  然后拷到博客项目当前目录,  这里已neat为例
```bash
cp -r /path/to/themes/from/github/neat .
```
然后在 pelicanconf.py 配置文件里添加或修改 THEME项为 neat
```bash
THEME = "neat"
```
重新执行
```bash
make html
```
## 使用插件
```bash
git clone git://github.com/getpelican/pelican-plugins.git    # 插件
```
现在我们博客目录就新添了一个 pelican-plugins目录, 我们已配置sitemap插件为例, sitemap插件可以生成 sitemap.xml 供搜索引擎使用
在pelicanconf.py配置文件里加上如下项:
```bash
PLUGIN_PATH = u"pelican-plugins"

PLUGINS = ["sitemap"]

## 配置sitemap 插件
SITEMAP = {
    "format": "xml",
    "priorities": {
        "articles": 0.7,
        "indexes": 0.5,
        "pages": 0.3,
    },
    "changefreqs": {
        "articles": "monthly",
        "indexes": "daily",
        "pages": "monthly",
    }
}
```
然后再执行
```bash
make html
```
## 部署演示平台
进入output目录，将生成好的静态HTML文件上传到Coding站点
在coding上新建Pelican-Demo项目，不要添加README.md和LISCENCE文件。
```bash
cd output
git init
git remote add origin https://coding.net/pelicandemo/Pelican-Demo.git
git add -A
git commit -m "Update Blog"
git push -u origin master
```
![img](http://xinwei.qiniudn.com/002.png)
![img](http://xinwei.qiniudn.com/003.png)
当所有设置完后，点选一键部署，然后就是耐心等待，当看到正在运行后就可以访问了。