基于 Github issues 的單頁面靜態博客
玉伯的博客(https://github.com/lifesinger/lifesinger.github.com/issues )讓我第一次知道 github issues 還可以這樣用 ,作者發了很多干貨技術文章,讓我不由得感嘆 ,文章不在于形式,也不在于寫在哪里,只要是好文,總不會被埋沒。
即便如此,很多人仍然希望能有一個獨立域名、可以自由修改主題的博客。Wordpress 、Typecho 太重,還要買 VPS、部署服務器環境、安裝插件、主題,太折騰人,于是我想,完全可以利用 Github 提供的 API 來實現一個只有一個靜態頁面的博客,具體思路如下:
- 作者在 Github issues 上寫文章(寫 issues)
- 博客頁面通過 JS Ajax 請求 Github API 來獲取文章內容,進行頁面的渲染
- 通過社會化評論插件實現評論功能
于是花了幾天時間實現了這個設想, DEMO:http://wuhaoworld.github.io/
博客的 demo 內容是讀取的玉伯博客的 issues。
1. 部署方法
1.克隆本項目,修改根目錄的 config.js
var _config = { blog_name : '用于演示的博客', // 博客名稱 owner: 'lifesinger', // github 用戶名 repo: 'lifesinger.github.com',// github 中對應項目名 duoshuo_id : 'hello1234', // 在第三方評論插件多說申請站點的子域名 // access_token: '', // 請求量大時需要在 github 后臺單獨設置一個讀取公開庫的 token per_page: '15' // 默認一頁顯示幾篇文章 }
2.填寫好對應的博客名稱,你自己的 github 用戶名、對應項目名和多說 ID,保存。多說賬號在這里申請http://duoshuo.com/
3.將所有文件上傳到一個靜態空間,打開首頁即可看到效果。
接下來就是在對應的 repo 的 issues 下寫文章了!
2. 提高 API 訪問次數的配額
默認情況下你是用匿名權限訪問 github 接口的, github 的訪問限制是一個小時最多 60 次請求,這顯然是不夠的,如何提高限制呢?
-
到個人設置下的 Personal access tokens 頁(https://github.com/settings/tokens ),如下圖,點擊右上角的 Generate new token
-
填寫名稱,只勾選public_repo,然后保存,github 會生成一個可訪問你公開項目的 access_token,將它填入到配置文件的 access_token 的值中,并取消注釋。
-
打開app.js,取消掉第 17 行和 88 行的注釋,保存后重新上傳即可
data:{ // access_token:_config['access_token'] },