banner
虫子游戈

虫子游戈

一个写故事的人类
mastodon
email

用Gridea搭建博客竟如此簡單

我曾在大學時試過用 WordPress 搭建博客,但其複雜程度超過了我的掌控能力,後來也反反覆覆多次使用過 GitHub Jekyll,但總覺得不好用,堅持不了幾天。到後來,我就更願意使用現成的博客服務平台了,比如新浪博客、网易 Lofter、简书等,但國內博客平台存在嚴重的審查問題,所以也始終不稱意。然後我就開始用 Blogger,體驗很差,但好在沒了審查,所以也就忍受了幾年。但如此卻將我自己的故事擋在了牆外,常會讓我感到遺憾。儘管我嘗試使用 ZeroNet 來發布文章,但這個分佈式網絡可以說是一個鬼城,並沒有幾個真正嚴肅的真實用戶。

今天下午,我偶然在知乎上看到了一篇文章《完全小白教程:使用 Github Pages 和 Gridea 搭建个人博客》,發現了 Gridea 這個超簡單的博客工具,簡單了解了下發現這正是我需要的東西 —— 簡簡單單就能免費創建一個能受自己控制且(幾乎)不被審查的博客。真的非常簡單!

下面我將分步驟描述我的創建和配置過程,其中包括註冊配置 GitHub 代碼庫、下載配置 Gridea 客戶端、選擇合適的博客主題、綁定域名、配置谷歌分析、發布文章。

1 註冊配置 GitHub 代碼庫#

首先註冊一個 GitHub 賬戶。如果你不打算使用自己的域名,那麼請慎重選擇你的「用戶名」,因為它會以「用戶名.github.io」這一形式作為你的博客地址。

註冊完畢後,點擊右上角+,單擊 New repository,新建代碼庫:

image

之後在 Repository name 填寫你的「用戶名.github.io」,然後創建代碼庫:

image

此時你會得到一個空的代碼庫。

點擊右上角頭像,進入 Settings,找到 Developer Settings,選擇 Personal access tokens,然後點擊 Generate new token:

image

然後在 Note 處隨意填寫你的備註,勾選 repo,然後點擊下方生成 token:

image

複製這行 ghp_ 開頭的 token。請注意藍色警告:退出該頁面後將無法看到這串字符。如果失誤丟失了這個 token 也別慌,你可以重複上述步驟再生成一個新的。

image

2 下載配置 Gridea 客戶端#

Gridea 官網其 GitHub 代碼庫下載對應操作系統的客戶端並安裝。

首先進入「遠程」進行配置。平台選擇 GitHub Pages,域名選擇 https:// 並填寫你的「用戶名.github.io」,倉庫名稱也是「用戶名.github.io」,分支可填寫 master 或 main,用戶名便是你的用戶名,郵箱可選,令牌則粘貼上面的 token。如果你有自己的域名,就填入 CNAME;如果否則留空。然後點擊右下「保存」,並可點擊左下角「檢測遠程連接」。我個人偶爾會遇到連接不上的情況,可能還是有些 bug。 如果沒問題,便可以將你的初始博客「同步」到 GitHub。

image

同步成功後,等待很短時間,訪問你的「用戶名.github.io」應該就能看到你的博客了。

初始博客預置了兩篇文章,一篇是歡迎文章,一篇是「關於」,兩者均可刪除或修改。

另外,如果你希望在自己定義的文件夾(比如放在網盤文件夾中同步)管理你的博客,可點擊左下角的設置按鈕,配置「站點源文件路徑」:

image

3 選擇合適的博客主題#

在 Gridea 客戶端「主題」窗口,可以選擇博客主題。選擇之後一定要點擊保存,並且要同步成功後才能應用到博客上:

image

Gridea 預置了 4 個主題,但它們可能並不合你的心意。你也可以在官網主題頁面下載你感興趣的主題。然後將下載好的主題解壓後放入站點源文件路徑下的 themes 路徑中。之後關閉 Gridea 客戶端並重啟,再重新選擇主題即可。

image

當然你也可以修改你的主題,這可通過 Gridea 客戶端的「自定義配置」實現,也可通過修改相應主題中的文件或 config 文件夾中相應配置文件完成。

4 綁定域名#

我的域名 czyouge.xyz 是幾年前在 Godaddy 購買的,當時挺便宜,現在價格應該也不高。購買完成後進入該域名的 DNS 管理,添加如下圖所示的幾條記錄:

image

其中一條是 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:

image

然後選擇 Pages,在 Custom domain 填入你的域名並保存(Save),然後等待驗證完成,點擊 Enforce HTTPS,這是強制啟用 HTTPS。這樣即使使用 http://你的域名 訪問,也會強制轉向 https://你的域名

image

這個功能很有用,至少 Chrome 瀏覽器在打開你的博客時不會發出安全警報,比如訪問飯否時便會收到這樣的警報:

image

5 配置谷歌分析#

如果你想知道博客的訪問數據,可以免費使用谷歌分析來做到這一點。Gridea 也提供了非常簡單易用的支持。

首先當然是註冊谷歌賬戶,然後進入 Google Analytics。點擊左下角管理:

image

然後在「賬號」欄創建賬號,之後你會得到一個 UA-xxxxxxxxx-x 格式的跟踪 ID。接下來進入「媒體資源設置」:

image

在「默認網址」設置 https 並填入你的網址:

image

然後進入 Gridea 客戶端「主題」→「自定義配置」→「谷歌統計」,填入跟踪 ID:

image

之後可通過谷歌分析查看博客訪問數據報告。

6 發布文章#

使用 Gridea,我們有兩種發布博客文章的方式。

一是使用客戶端文章窗口添加文章:

image

但這種方法略顯笨重。

第二種方法則是直接將 Markdown 文章放入 站點源文件路徑 下的 posts 文件夾中。使用這種方式有幾點需要注意:

  • Markdown 文件的名稱即為文章的鏈接 ID。
  • 文件內有一些重要的元數據:title 是文章標題,date 是展示的時間,tag 為標籤,published 為是否發布(false 為保存草稿)、hideInList 為是否隱藏(隱藏後不會在文章列表中出現)、isTop 為是否置頂,feature 的參數則為文章封面圖的鏈接(可留空)。
  • <!-- more --> 用於分割摘要和其餘正文。
  • 另外,如果是在其它位置編輯帶圖片的 Markdown 文件,請注意圖片的相對地址。

image

最後,在任何操作後都記得「同步」到 GitHub 代碼庫哦,這樣你的文章才能和讀者見面。

載入中......
此文章數據所有權由區塊鏈加密技術和智能合約保障僅歸創作者所有。