快速开始

我们推荐您阅读整个文档，但如果您急着开始，接下来就是简单的几步开始您的项目。

安装

在 Python 2.7.x 或者 Python 3.3 以上版本的环境中安装 Pelican （如果需要使用 Markdown 的话，也需要安装），只需要在您喜爱的终端中运行一下命令（如果提示警告的话，请在命令开头加上 sudo ）:

pip install pelican markdown

新建一个项目

首先，为您的项目起一个名字。为您的站点，使用合适的名字创建一个新的目录，然后进入那个目录：

mkdir -p ~/projects/yoursite
cd ~/projects/yoursite

使用 pelican-quickstart 命令来快速的为您的项目搭建框架，这个命令会询问你一些关于网站的基本信息：

pelican-quickstart

对于那些有默认答案的问题 来说，可以使用回车键来使用默认的配置。但询问你的 URL 前缀的时候，请输入您的域名（比如 http://example.com ）。

创建一篇文章

直到您为您的网站添加了一些内容之后，您才能运行 Pelican 来构建网站。任意使用你喜爱的文本编辑器来创建您的第一篇文章，并输入一下内容：

    Title: My First Review
    Date: 2010-12-03 10:20
    Category: Review

    Following is a review of my favorite mechanical keyboard.

假设这就是一篇 Markdown 格式的样例文章，并把它保存在 ~/projects/yoursite/content/keyboard-review.md 。

生成您的网站

从你的项目目录中，运行 Pelican 命令来生成您的网站：

Pelican content

你的网站就会在 output 目录中生成（你可以会看见一个关于 feeds 的警告，这在本地开发阶段是非常正常的，暂且忽略它就好。）

预览您的网站

打开一个新的终端会话，进入网站的目录，并且运行如下的命令来运行 Pelican 的服务器：

pelican --listen

在浏览器中，进入网址 http://localhost:8000/ 来预览网站。

请您继续阅读文档的其他章节来获取更多的信息，或者通过 Pelican wiki 的教程页面来获取社区发布的 教程。

脚注