安装
Pelican 当前版本应当运行在 Python 2.7.x 或者 3.4 以上版本中;更早的版本将不再被支持。
您可以通过好几种不同的办法来安装 Pelican 。其中最简单的就是使用 pip :
pip install pelican
(请记住操作系统通常会要求您在上述命令之间加入 sudo
来系统级别的安装 Pelican。)
尽管上面是最简单的办法,但是推荐的做法是在安装之前,使用 virtualenv 来为 Pelican 创建一个虚拟环境。假设您已经安装了 virtualenv ,你可以打开一个新的终端,然后使用如下命令来为 Pelican 创建一个新的虚拟环境:
virtualenv ~/virtualenvs/pelican
cd ~/virtualenvs/pelican
source bin/activate
如上所述,一旦您创建并激活虚拟环境, Pelican 就可以通过 pip install pelican
命令来安装。或者,如果你已经有了项目的源代码,你可以使用 distutils 的办法来安装:
cd path-to-Pelican-source
python setup.py install
如果您安装了 Git 并且愿意安装最新版本的 Pelican 而非稳定版本,请使用如下命令:
pip install -e "git+https://github.com/getpelican/pelican.git#egg-pelican"
可选包
如果你打算使用 Markdown 作为标记语言,你需要安装 Markdown 库:
pip install Markdown
在设置中可以开启排版增强,但是首先需要安装依赖 Typogrify 库:
pip install typogrify
依赖
当 Pelican 被安装的时候,如下 Python 依赖包将会被自动的安装而无需更多的操作:
feedgenerator 来生成 Atom feeds 。
jinja2 来提供模版支持。
pygments 提供语法高亮。
docutils 提供 reStructuredText 作为输入格式的支持。
pytz 来定义时区。
blinker 一个对象到对象的广播信号系统。
unidecode 提供 ASCII 到 Unicode 文本的转换。
six 来提供 Python 2 和 3 之间的兼容。
MarkupSafe 一个安全的字符串实现。
python-dateutil 读取时间元信息。
更新
如果您通过 pip 安装了一个稳定的 Pelican 版本,并且想升级到最新的稳定版本,你可以通过添加 --upgrade
选项来做这件事:
pip install --upgrade pelican
如果您通过 distuils 安装了 Pelican 或者是最新的版本的话,请重复安装时的过程来安装最新的版本。
快速生成网站框架
一旦 Pelican 被安装,你就可以通过 pelican-quickstart
命令来构建您的网站。这个命令将会询问您一些信息。
pelican-quickstart
一旦您回答完毕这些问题,你的项目将会包括如下层级结构( pages 除外,如果你打算创建永久页面,你可以自己创建):
yourproject/
├── content
│ └── (pages)
├── output
├── tasks.py
├── Makefile
├── pelicanconf.py # Main settings file
└── publishconf.py # Settings to use when ready to publish
下一步就是通过向已经创建了的 content 文件夹添加内容来充实网站。
Last updated