pelican 安裝教學

安裝 pelican 非常簡單,個人建議建立一新 python virtual environment 供 pelican 使用。

詳細作法如下:

1. 建立 pelican 程式目錄

$ sudo mkdir -p /usr/lib/pelican
$ sudo chown `whoami` /usr/lib/pelican

2. 建立 pelican 所使用之 python 環境

$ virtualenv --no-site-packages /usr/lib/pelican
$ . /usr/lib/pelican/bin/activate

3. 開始安裝 pelican

$ pip install -e git ...
more ...

pelican 使用教學

pelican 預設支援 reStructuredText 格式,並可透過 python 之 Markdown 模組以支援 Markdown 語法。

必須注意的是,無論是 reStructuredText 或 Markdown,其語法支援程度將隨 pelican 佈景主題而異。例如多數的 pelican theme 均無實作 reStructuredText 之 image :scale: (調整圖片大小)屬性。

1. pelican 網站目錄結構

使用 pelican-quickstart 建立網站後,目錄結構如下:

yourproject/
├── content
│   └── (pages)
├── output
├── develop_server.sh
├── Makefile
├── pelicanconf.py       # Main settings file
└── publishconf.py ...
more ...