Pelican 另一個靜態網頁生成器

最近因為重新練習python 的一些語法、模組應用與操作,看到了有這麼一個「Web Scraping 101 with Python」部落格(我試著按上面的方法來學習,但不太推薦新手從這裏學習,作者可能假設對像都有部份編程基礎,所以程式碼用法偏向中階,且講解說明有點簡略),其部落格架軟體是Pelican,一個由python寫成的靜態網頁產生器。
之前已有介紹過hugo(language go); jekyll(ruby)這二個靜態網頁產生器,那麼怎麼可以不來試試這個由python撰寫的類似工具呢?於是我立馬在自己在電腦上試著安裝。

1)透過pip 一行安裝。
既然pelican是利用python寫成的應用,就得透過它的套件管理程式pip來安裝,如果電腦中已安裝好了python, pip, 只消在CLI命令列打入一行:
$pip install pelican markdown
沒錯,我們已經輕鬆完成了它在本地端電腦的安裝。若好奇這是怎麼回事,想一探它的原始碼,可在github上找到

2)建立新網站專案
在自己的電腦上,建立一個目錄夾,以作為新網站(網頁)的工作區,在文字指令介面下,將當前工作目錄切換到此建立的新目錄底下,並輸入以下指令:
$pelican-quickstart
這時電腦就會自動替建置一個靜態網站專案,並詢問你一些問題,例如網站標題、網站作者、存放位置、網址、時區、要不要利用ftp上傳、要不要放上gitpages等等。問完之後,pelican就會在此新專案目錄底下自動產生相關的檔案與資料目錄。例如下圖二是它的資料夾內容結構,其中content資料夾就是用來存於網頁資料內容的地方



3)Markdown 語法寫作
pelican支援Markdown語法寫法,所以可利用個人慣用的純文字編輯器來寫作即可,它的文章格式,大約是要求提供這標題、時間、文章類別等幾項資訊,接下來就可以進行內容的撰寫。
######
Title: My First Review
Date: 2010-12-03 10:20
Category: Review

這裏開始寫內文 Following is a review of my favorite mechanical keyboard.

#######
文章寫好後,存檔放在content資料夾底下,並在新專案工作目錄下的CLI指令行打入:
$pelican content
這時pelican會自動生成一個「output」資料夾,這裏面就是轉成了html格式網頁內容。


4)預覧網頁與套用綏網頁模版
將當前的工作目錄切換到新網頁專案的output目錄下,並打入以下指令:
$python2 -m pelican.server ##我電腦上雖然同時安裝了python2.7 與3.4版,而系統默認的是3.4版。但若我直接輸入python則這行指令回傳無相關模組的訊息,故我改採python2 來啟動此行。
然後打開瀏覧器,在網址列輸入:http://localhost:8000/ 就可以看到新專案網站的模樣。


目前pelican 收集了近100個網站主題樣式套件
http://www.pelicanthemes.com/
用套用某一個中意的模版,就是把它下載(或用git clone)後,修改pelican的設定檔案pelicanconf.py 加上這一行:
THEME = "/home/user/pelican-themes/theme-name" ##請再依模版名稱與存放位置作修改
pelicanconf.py 改好存檔案後,要再執行$make html 指令,利用Makefile讓原本已生成的html網頁配合更新為新採用主題模版。
同依前一步驟
$python2 -m pelican.server
然後打開瀏覧器,在網址列輸入:http://localhost:8000/ 應該就可以看到新專案網站的模樣。
就可以看到新的模版樣式已被全站套用了。


5) 發佈到伺服器主機或gitpage
如果是採ftp方式,就是把output底下的內容全部上傳到某網站伺服器www/底下。gitpages應該也與之前hugo網頁發佈, jekyll的作法大同小異吧

0 意見:

Security First: umbrella app 中文化滙整

之前提過會作一篇 Security First's umbrella app 滙整與中文化超連結整合,以讓未下載使用、觀看過原手機應用的讀者(其實指的就是錯亂的我自己本人)稍能有全盤的概念來想像這個手機應用程式(或更精準的說:一個手機上的隨身電子書)的內容。好了,本文...