我曾在大學時試過用 WordPress 搭建博客,但其複雜程度超過了我的掌控能力,後來也反反覆覆多次使用過 GitHub Jekyll,但總覺得不好用,堅持不了幾天。到後來,我就更願意使用現成的博客服務平台了,比如新浪博客、网易 Lofter、简书等,但國內博客平台存在嚴重的審查問題,所以也始終不稱意。然後我就開始用 Blogger,體驗很差,但好在沒了審查,所以也就忍受了幾年。但如此卻將我自己的故事擋在了牆外,常會讓我感到遺憾。儘管我嘗試使用 ZeroNet 來發布文章,但這個分佈式網絡可以說是一個鬼城,並沒有幾個真正嚴肅的真實用戶。
今天下午,我偶然在知乎上看到了一篇文章《完全小白教程:使用 Github Pages 和 Gridea 搭建个人博客》,發現了 Gridea 這個超簡單的博客工具,簡單了解了下發現這正是我需要的東西 —— 簡簡單單就能免費創建一個能受自己控制且(幾乎)不被審查的博客。真的非常簡單!
下面我將分步驟描述我的創建和配置過程,其中包括註冊配置 GitHub 代碼庫、下載配置 Gridea 客戶端、選擇合適的博客主題、綁定域名、配置谷歌分析、發布文章。
1 註冊配置 GitHub 代碼庫#
首先註冊一個 GitHub 賬戶。如果你不打算使用自己的域名,那麼請慎重選擇你的「用戶名」,因為它會以「用戶名.github.io」這一形式作為你的博客地址。
註冊完畢後,點擊右上角+,單擊 New repository,新建代碼庫:
之後在 Repository name 填寫你的「用戶名.github.io」,然後創建代碼庫:
此時你會得到一個空的代碼庫。
點擊右上角頭像,進入 Settings,找到 Developer Settings,選擇 Personal access tokens,然後點擊 Generate new token:
然後在 Note 處隨意填寫你的備註,勾選 repo,然後點擊下方生成 token:
複製這行 ghp_
開頭的 token。請注意藍色警告:退出該頁面後將無法看到這串字符。如果失誤丟失了這個 token 也別慌,你可以重複上述步驟再生成一個新的。
2 下載配置 Gridea 客戶端#
在 Gridea 官網或其 GitHub 代碼庫下載對應操作系統的客戶端並安裝。
首先進入「遠程」進行配置。平台選擇 GitHub Pages,域名選擇 https:// 並填寫你的「用戶名.github.io」,倉庫名稱也是「用戶名.github.io」,分支可填寫 master 或 main,用戶名便是你的用戶名,郵箱可選,令牌則粘貼上面的 token。如果你有自己的域名,就填入 CNAME;如果否則留空。然後點擊右下「保存」,並可點擊左下角「檢測遠程連接」。我個人偶爾會遇到連接不上的情況,可能還是有些 bug。 如果沒問題,便可以將你的初始博客「同步」到 GitHub。
同步成功後,等待很短時間,訪問你的「用戶名.github.io」應該就能看到你的博客了。
初始博客預置了兩篇文章,一篇是歡迎文章,一篇是「關於」,兩者均可刪除或修改。
另外,如果你希望在自己定義的文件夾(比如放在網盤文件夾中同步)管理你的博客,可點擊左下角的設置按鈕,配置「站點源文件路徑」:
3 選擇合適的博客主題#
在 Gridea 客戶端「主題」窗口,可以選擇博客主題。選擇之後一定要點擊保存,並且要同步成功後才能應用到博客上:
Gridea 預置了 4 個主題,但它們可能並不合你的心意。你也可以在官網主題頁面下載你感興趣的主題。然後將下載好的主題解壓後放入站點源文件路徑
下的 themes
路徑中。之後關閉 Gridea 客戶端並重啟,再重新選擇主題即可。
當然你也可以修改你的主題,這可通過 Gridea 客戶端的「自定義配置」實現,也可通過修改相應主題中的文件或 config
文件夾中相應配置文件完成。
4 綁定域名#
我的域名 czyouge.xyz 是幾年前在 Godaddy 購買的,當時挺便宜,現在價格應該也不高。購買完成後進入該域名的 DNS 管理,添加如下圖所示的幾條記錄:
其中一條是 CNAME 記錄,name
填入 www,當然你可以用其它的,比如 blog—— 這樣可通過 blog.你的域名
訪問你的博客。value
填入你的「用戶名.github.io」。
另外再添加一條或多條 A 記錄,這是為了實現更安全的 HTTPS 訪問,A 記錄的 IP 地址可選擇:
- 185.199.108.153
- 185.199.109.153
- 185.199.110.153
- 185.199.111.153
更多詳情可參考這個知乎回答。
然後進入你的 GitHub 代碼庫,選擇 Settings:
然後選擇 Pages,在 Custom domain 填入你的域名並保存(Save),然後等待驗證完成,點擊 Enforce HTTPS,這是強制啟用 HTTPS。這樣即使使用 http://你的域名
訪問,也會強制轉向 https://你的域名
。
這個功能很有用,至少 Chrome 瀏覽器在打開你的博客時不會發出安全警報,比如訪問飯否時便會收到這樣的警報:
5 配置谷歌分析#
如果你想知道博客的訪問數據,可以免費使用谷歌分析來做到這一點。Gridea 也提供了非常簡單易用的支持。
首先當然是註冊谷歌賬戶,然後進入 Google Analytics。點擊左下角管理:
然後在「賬號」欄創建賬號,之後你會得到一個 UA-xxxxxxxxx-x
格式的跟踪 ID。接下來進入「媒體資源設置」:
在「默認網址」設置 https 並填入你的網址:
然後進入 Gridea 客戶端「主題」→「自定義配置」→「谷歌統計」,填入跟踪 ID:
之後可通過谷歌分析查看博客訪問數據報告。
6 發布文章#
使用 Gridea,我們有兩種發布博客文章的方式。
一是使用客戶端文章窗口添加文章:
但這種方法略顯笨重。
第二種方法則是直接將 Markdown 文章放入 站點源文件路徑
下的 posts
文件夾中。使用這種方式有幾點需要注意:
- Markdown 文件的名稱即為文章的鏈接 ID。
- 文件內有一些重要的元數據:title 是文章標題,date 是展示的時間,tag 為標籤,published 為是否發布(false 為保存草稿)、hideInList 為是否隱藏(隱藏後不會在文章列表中出現)、isTop 為是否置頂,feature 的參數則為文章封面圖的鏈接(可留空)。
<!-- more -->
用於分割摘要和其餘正文。- 另外,如果是在其它位置編輯帶圖片的 Markdown 文件,請注意圖片的相對地址。
最後,在任何操作後都記得「同步」到 GitHub 代碼庫哦,這樣你的文章才能和讀者見面。