決定不能讓我的 Github Pages 閒著,畢竟放一些技術性文章在上面應該還是可以的,也能作為筆記方便日後遇上同樣的問題後能及時找到解決方法。
群裡有人推薦 Gridea 來做靜態博客,我便搜了一搜,下載了客戶端,確實很簡潔,而且寫文章很方便,主題也挺讓我滿意的,於是乎便動手試著連接到我的 Github Page 上。
遠程連接與同步#
配置部分由於官網有對應教程,在此不再贅述,在一切信息填寫完畢後,顯示無法遠程連接,不論我怎麼核對倉庫名、用戶名,或者換 token 都沒有用,各路查找後,我打開了 Edit→開發者工具→console,然後發現錯誤代碼是 “spawn git ENOENT ... at Process.ChildProces...ickCallbak”,解決方法就是在環境變量中編輯 Path 那一項,新建兩條,分別包含你的計算機上安裝的 Git 的 bin 目錄和 git-core 目錄,如下圖所示:
這樣配置完後重啟 Gridea 客戶端,便能成功遠程連接了。
隨後同步又出了問題,顯示同步失敗,請到 FAQ 或者聯繫作者解決(總算有了幫助界面,而且剛才遠程連接的錯誤在裡面就有卻沒有提示指引我去看那裡),同樣打開 “Edit→開發者工具→console”,顯示的異常如下圖:
雙擊 “message” 便能看到所有報錯信息,複製粘貼出來看就好(甚至可以複製到谷歌翻譯上方便理解):
我這裡出的問題是郵箱私有了,導致無法正確執行 git 命令,在 github 設置後,成功出現同步成功的字樣。
至此,基本功能得以實現。
gitalk 評論系統的配置#
想在博客裡引入評論系統,我選擇了 Gitalk 這個評論插件,Gridea 只需要我們提供四個必須的東西,就能為站點添加好 gitalk 評論,我們需要去填的有 Client ID、Client Secret、倉庫和 owner 這四部分,其中 Client ID 和 Client Secret 需要我們去申請 OAuth App,步驟如下:
①在 Github 右上角點自己的頭像,點 “setting”
②點擊 “Developer settings”,點擊 “OAuth Apps”→“New OAuth Apps”
③到這個頁面後,Application name 隨便填,Homepage URL 填 Github Page 所在倉庫的鏈接(https://github.com/ 用戶名 / 倉庫名…… 之類的),Application description 可以不填,Authorization callback URL 填你的 Github Page 的域名(區分 http 和 https)
④完成後複製 Client ID 和 Client Secret 到客戶端,填好倉庫和 owner,就能使用 gitalk 評論插件啦!
若使用 Coding Pages#
經個人體驗 Coding Pages 確實比 Github Pages 強很多。
註冊和配置過程直接引入官方教程吧。
gitalk 部分,OAuth App 中需要修改的有兩個部分,一個是 Homepage URL,可以自己隨便建一個倉庫,填入倉庫所在地址就行,一個是 Authorization callback URL,需要填自己的 Coding Pages 的域名(區分 http 和 https),然後 Gridea 中倉庫一欄填自己 OAuth App 中用的倉庫名,owner 填建立倉庫所用的 Github 賬號的 username。