# 快速开始

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

## 安装

在 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 的教程页面来获取社区发布的 [教程](https://github.com/getpelican/pelican/wiki/Tutorials)。

## 脚注
