主題與插件
到目前為止應該都還滿簡單的,基本上照著做不太會錯。接下來就是比較令人頭痛的問題了,沒錯就是設計或挑選一個合適的主題!基本上 Pelican 使用了 jinja2 這個強大的模版系統,如果大家是前端高手,大可以自己撰寫喜歡的 template 並輔以 css 和 javascript 來加強。但如果你跟我一樣是前端苦手(但又無法接受陽春的設計風格的話),使用各路高手們製作好的主題並略加以修改是個不錯的主意。
Pelican 的主題集中在 pelican-themes 這個 github repository 中,我們可以將一口氣將所有主題的目錄先 clone 出來:
$ git clone https://github.com/getpelican/pelican-themes.git
我們會發現這些目錄都是空著的,不要緊,等等我們也會把他們 clone 出來。現在要做的事情是選定一個好的主題,在 http://www.pelicanthemes.com/ 中有所有主題的展示,大家可以善加利用。
選定好主題之後,我們便把該主題的 repository 給 clone 出來,我們這邊以 mg 這個主題為例子:
$ cd pelican-themes
$ git clone https://github.com/lucachr/pelican-mg.git
接著在設定檔( pelicanconf.py
)中設定變數 THEME
來套用主題:
THEME = 'pelican-themes/pelican-mg' # 主題的"路徑"
接著我們可以參考該主題在 github 上的 README(mg/README)來進行更多的設定,甚至我們也可自己動手修改模板和樣式。
插件的使用方法跟主題大同小異,我們一樣先 clone 出所有的插件目錄:
$ git clone https://github.com/getpelican/pelican-plugins.git
因為所有的插件內容都已經下載下來了,所以要使用的插件則不需要個別 clone 出來,我們直接在設定檔中照著插件的說明設定即可(這邊以 custom article urls 為例,他可以幫助我們客製化網站頁面的 URL):
PLUGINS = ['custom_article_urls'] # 將要使用的插件"名稱"寫入
# plugin-custom_article_urls 設定
CUSTOM_ARTICLE_URLS = {
'misc': {
'URL': '{date:%Y}/{date:%b}/{slug}/',
'SAVE_AS': '{date:%Y}/{date:%b}/{slug}/index.html',
}
}
大家多試著使用幾個插件之後會發現套件的設定大概就三個步驟:
- 把插件名稱填入設定檔的
PLUGINS
清單變數中 - 根據插件的說明文件在設定檔中進行相關設定
- 部分插件可能要修改模板以展現功能