在GitHub Pages上使用Pelican搭建博客的教程
Pelican 介紹
首先看看 Pelican 的一些主要特性:
- Python實現(xiàn),開放源碼
- 輸出靜態(tài)頁面,方便托管
- 支持主題,采用Jajin2模板引擎
- 支持代碼語法高亮
- 支持reStructuredText、Markdown、AsciiDoc格式
- 支持Disqus評論
- 支持Atom和RSS輸出
這些特性都是大愛,完全滿足我對博客系統(tǒng)的基本需求,再配合免費無限制的GitHub Pages,一切近乎完美了。
安裝 Pelican
開始前請自行安裝Python環(huán)境,支持2.7.X和3.3+,為方便,再順手裝上distribute、pip、virtualenv。(注:我的操作系統(tǒng)是:Windows 7)
創(chuàng)建Pelican虛擬環(huán)境
virtualenv PelicanEnv --distribute PelicanEnv\Scripts\activate
安裝 Pelican
pip install pelican
如果您使用Markdown來寫文章的話,還需要安裝Markdown庫
pip install Markdown
創(chuàng)建 Blog
創(chuàng)建一個 Blog 目錄
mkdir myblog cd myblog
快速創(chuàng)建 Blog
pelican-quickstart
根據(jù)提示一步步輸入相應的配置項,不知道如何設置的接受默認即可,后續(xù)可以通過編輯pelicanconf.py文件更改配置。
以下是生成的目錄結構:
├── content # 存放輸入的源文件
│ └── (pages) # 存放手工創(chuàng)建的靜態(tài)頁面
├── output # 生成的輸出文件
├── develop_server.sh # 方便開啟測試服務器
├── Makefile # 方便管理博客的Makefile
├── pelicanconf.py # 主配置文件
└── publishconf.py # 發(fā)布時使用的配置文件
撰寫文章
在 content 目錄下用 Markdown 語法來寫一篇文章
Date: 2010-12-03 10:20
Category: Python
Tags: pelican, publishing
Slug: my-super-post
Author: Alexis Metaireau
Summary: Short version for index and feeds
This is the content of my super blog post.
生成頁面
make html
現(xiàn)在就可以在output目錄查看生成的html文件了。
由于我的操作系統(tǒng)是Windows,我對Makefile做了一些修改。
PY=python PELICAN=pelican PELICANOPTS= BASEDIR=$(CURDIR) INPUTDIR=$(BASEDIR)/content OUTPUTDIR=$(BASEDIR)/output GITHUBDIR=$(BASEDIR)/togithub CONFFILE=$(BASEDIR)/pelicanconf.py PUBLISHCONF=$(BASEDIR)/publishconf.py help: @echo ' ' @echo 'Makefile for a pelican Web site ' @echo ' ' @echo 'Usage: ' @echo ' make help print help information ' @echo ' make all (re)generate the web site ' @echo ' make html (re)generate the web site ' @echo ' make clean remove the generated files ' @echo ' make cptogithub copy output files to GITHUBDIR ' @echo ' make regenerate regenerate files upon modification ' @echo ' make serve serve site at http://localhost:8000' @echo ' make devserver start/restart develop_server.sh ' @echo ' make stopserver stop local server ' @echo ' make publish generate using production settings ' @echo ' ' all: html html: clean $(OUTPUTDIR)/index.html cptogithub clean: @echo -n 'Cleaning............................' @rm -fr $(OUTPUTDIR) @mkdir $(OUTPUTDIR) @echo 'Done' $(OUTPUTDIR)/%.html: $(PELICAN) $(INPUTDIR) -o $(OUTPUTDIR) -s $(CONFFILE) $(PELICANOPTS) cptogithub: @echo -n 'Copying.............................' @cp -fR $(OUTPUTDIR)/* $(GITHUBDIR) @echo 'Done' regenerate: clean $(PELICAN) -r $(INPUTDIR) -o $(OUTPUTDIR) -s $(CONFFILE) $(PELICANOPTS) serve: cd $(OUTPUTDIR) && $(PY) -m pelican.server devserver: $(BASEDIR)/develop_server.sh restart stopserver: kill -9 `cat pelican.pid` kill -9 `cat srv.pid` @echo 'Stopped Pelican and SimpleHTTPServer processes running in background.' publish: $(PELICAN) $(INPUTDIR) -o $(OUTPUTDIR) -s $(PUBLISHCONF) $(PELICANOPTS) .PHONY: help all html clean cptogithub regenerate serve devserver stopserver publish
創(chuàng)建 GitHub Pages
GitHub Pages分兩種,一種是項目頁面,可創(chuàng)建多個;另一種是用戶頁面,每個用戶ID只能創(chuàng)建一個。兩種都可以用來托管Pelican博客,這里以用戶頁面為例。
點擊這里,新建一個Repository,Repository名字可以是 xxx.github.io 或者 xxx.github.com,其中 xxx 是您的用戶ID。
創(chuàng)建成功以后,便可以把生成的頁面push到github。
cd output git init git add . git commit -m "first commit" git remote add origin https://github.com/xxx/xxx.github.io.git git push -u origin master
現(xiàn)在可以通過 xxx.github.io 或者 xxx.github.com 來訪問您的博客了。
域名綁定
在repo的根目錄下面,新建一個名為CNAME的文本文件,里面寫入你要綁定的域名,比如頂級域名 example.com 或者二級域名 xxx.example.com。
如果綁定的是頂級域名,則DNS要新建一條A記錄,指向 204.232.175.78。
如果綁定的是二級域名,則DNS要新建一條CNAME記錄,指向 xxx.github.io 或者 xxx.github.com 。
以我的為例:
CNAME文件
www.dongxf.com
DNSPod上設置
在瀏覽器地址欄中輸入以下鏈接,都將跳轉指向 http://www.dongxf.com/
http://dongxf.com/
http://www.dongxf.com/
http://blog.dongxf.com/
http://dongdxf.github.io/
http://dongdxf.github.com/
未盡事宜
其他內(nèi)容請參考 Pelican官方文檔 。我正在翻譯這個文檔,才剛開始,進展緩慢。請點擊 Pelican文檔中文版 訪問,歡迎提出寶貴意見和建議。
相關文章
jupyter notebook 使用過程中python莫名崩潰的原因及解決方式
這篇文章主要介紹了jupyter notebook 使用過程中python莫名崩潰的原因及解決方式,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2020-04-04基于python list對象中嵌套元組使用sort時的排序方法
下面小編就為大家分享一篇基于python list對象中嵌套元組使用sort時的排序方法,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2018-04-04