主題與插件

到目前為止應該都還滿簡單的,基本上照著做不太會錯。接下來就是比較令人頭痛的問題了,沒錯就是設計或挑選一個合適的主題!基本上 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',
    }   
}

大家多試著使用幾個插件之後會發現套件的設定大概就三個步驟:

  1. 把插件名稱填入設定檔的 PLUGINS 清單變數中
  2. 根據插件的說明文件在設定檔中進行相關設定
  3. 部分插件可能要修改模板以展現功能

results matching ""

    No results matching ""