Pelican搭建靜態(tài)博客

前言

一直以來都希望擁有屬于自己的個人博客,隨性發(fā)點信息,寫點技術(shù)感想,記錄自己的生活,重要的是不受廣告的影響、不被河蟹、不會擔(dān)心有一天被莫名其妙地消失。

之前看過一篇文章:“像黑客一樣寫博客”,一下子就被這種簡單的方式深深的吸引住了。你只需要一個稱手的文本編輯器(Markdown編輯器),再配合終端的git命令就OK了,其余的都不用管了,交給第三方去。幾條簡單的命令就可以發(fā)布博客。

優(yōu)點:

  • 直接使用Markdown寫文章
  • 全站靜態(tài)化,根據(jù)Markdown生成文章的靜態(tài)頁面
  • 直接在Terminal把文章push到Github上即可,有版本管理真好,然后加之Github Page的支持,雖然有一些些小問題,比如緩存,但瑕不掩瑜
  • 整個寫作過程和寫代碼的過程是一致的,符合碼農(nóng)的行為習(xí)慣,也就是所謂的“像黑客一樣寫博客”

本博客是在Gentoo Linux環(huán)境下搭建完成,托管到Github Pages。
效果見我的博客:http://wonux.github.io
http://wonux.coding.me

知識儲備

搭建博客的工具選用了Pelican,Pelican是一個用Python語言編寫的靜態(tài)網(wǎng)站生成器,支持使用restructuredText和Markdown寫文章,配置靈活,擴展性強,有許多優(yōu)秀的主題和插件可供使用。Pelican 的Github地址是:https://github.com/getpelican/pelican;主頁:http://blog.getpelican.com/

搭建過程中涉及如下技術(shù)知識,不過你不必害怕,只是使用它們的開源框架而已,并不需要自己編碼,點擊可以了解它們是如何的強大,當(dāng)然你也可以略過它們,后面遇到時再進行了解。
假如你不能打開它們,原因你懂的,請爬墻解決~

github
github pages
git
python
pip
pelican
markdown

搭建Pelican環(huán)境

安裝git,pip

emerge --ask git
emerge --ask dev-python/pip

使用virtualenv工具創(chuàng)建pelican虛擬環(huán)境

emerge --ask virtualenv
virtualenv ~/virtualenvs/pelican
cd ~/virtualenvs/pelican
source bin/activate

安裝pelican

pip install pelican

安裝markdown,typogrify

pip install Markdown
pip install typogrify

創(chuàng)建博客站點

mkdir blog //創(chuàng)建文件夾,名稱可根據(jù)自己喜歡定
cd blog
pelican-quickstart

pelican-quickstart執(zhí)行命令后,會提示輸入博客的配置項,除了少數(shù)幾個必填以外,其它都可以選擇默認(rèn),而且都可以在pelicanconf.py文件中進行更改,所以你可以隨意選擇。
命令成功執(zhí)行后,會出現(xiàn)pelican的框架,如下所示

blog/
├── content                # 存放輸入的markdown或RST源文件
│   └── (pages)            # 存放手工創(chuàng)建的靜態(tài)頁面,可選
│   └── (posts)            # 存放手工創(chuàng)建的文章,可選
├── output                 # 存放最終生成的靜態(tài)博客
├── develop_server.sh      # 測試服務(wù)器
├── Makefile               # 管理博客的Makefile
├── pelicanconf.py         # 配置文件
└── publishconf.py         # 發(fā)布文件,可刪除

選擇博客主題

回到blog目錄下,按如下步驟下載pelican官方主題,從里面挑選出自己喜歡的主題吧,大多數(shù)主題預(yù)覽界面你可以打開這個網(wǎng)頁進行查看。不過如今pelican又新出了很多主題,所以你需看看pelican主題開源庫。

  • 克隆主題到本地
git clone https://github.com/getpelican/pelican-themes.git
  • 打開pelicanconf.py配置文件,更改或添加THEME為自己喜歡的主題,例如本博客所挑選的elegant,更多的配置含義請關(guān)注官方文檔
THEME = 'pelican-themes/gum'

添加評論系統(tǒng)

開啟個人博客的原因在于分享知識,分享就需要交流,評論模塊當(dāng)然少不了。在Disqus上申請帳號,按照流程Disqus會分配給你站點的Shortname,記牢Shortname,如果忘了請進入admin/settings中查看。然后同理,在pelicanconf.py添加

DISQUS_SITENAME = Shortname

書寫文章

完成上述博客主體搭建后,使用markdownpad創(chuàng)建一個.md文件,保存于content文件夾中(或自己加入posts文件夾)。
Metadata syntax for Markdown posts should follow this pattern:

Title: My super title
Date: 2010-12-03 10:20
Modified: 2010-12-05 19:30
Category: Python
Tags: pelican, publishing
Slug: my-super-post
Authors: Alexis Metaireau, Conan Doyle
Summary: Short version for index and feeds

This is the content of my super blog post.

發(fā)布博客站點

Publish your site
有三種方法可以發(fā)布博客:

  • pelican命令
  • fabric
  • make

生成博客站點

Site generation

pelican /path/to/your/content/ [-s path/to/your/settings.py]

預(yù)覽生成的站點

For Python 2, run:

cd output
python -m SimpleHTTPServer

For Python 3, run:

cd output
python -m http.server

瀏覽http://localhost:8000/地址預(yù)覽效果.

部署博客站點

Deployment

pelican content -s publishconf.py

自動化操作

  • Fabric
 pip install Fabric
fab build
fab regenerate
fab serve
fab publish
  • Make
make html
make regenerate
make serve
make devserver
./develop_server.sh stop

備注:發(fā)布的簡單流程:pelican content生成頁面至output目錄,然后git push output目錄到github站點的gh-pagesgitcafe-pages分支,即可自動渲生成染博客。

參考資料:
http://www.xycoding.com/articles/2013/11/21/blog-create/

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • Swift版本點擊這里歡迎加入QQ群交流: 594119878最新更新日期:18-09-17 About A cu...
    ylgwhyh閱讀 26,288評論 7 249
  • WebSocket-Swift Starscream的使用 WebSocket 是 HTML5 一種新的協(xié)議。它實...
    香橙柚子閱讀 24,830評論 8 183
  • 昨晚,見證了一個浪漫的求婚過程,看著女主角潸然淚下,我也淚流滿面。 早於約定的時間來到瑜伽館,見到了席老師。席老師...
    如心1976閱讀 283評論 1 0
  • 親愛的弟弟: 之所以想到給你寫信,是因為害怕自己總在電話里跟你“講道理,舉例子,擺事實”的樣子顯得太好為人師了。...
    summeeeer閱讀 498評論 0 0
  • 1 眼看著一年一度的大年就要到了,人們從年初出門,辛苦忙碌了一年,這幾天,都陸陸續(xù)續(xù)地回到了家鄉(xiāng),甚至不遠(yuǎn)千里,為...
    蘇長兵閱讀 680評論 0 3

友情鏈接更多精彩內(nèi)容