本文首發於「效率工具指南」
文/彭宏豪，筆名/安哥拉
Hello 大家好，我是安哥。
去年用騰訊雲搭建了一個可在國內正常訪問的博客，時間一晃而過，租用一年的服務器就快到期了，由於去年我是騰訊雲的新用戶，可以不到 100 塊的價格租到爲期一年的服務器。
但從新客戶變成老客戶，如果想要繼續租用服務器的話，並沒有任何續費優惠，反而是之後每年的價格都變高了，有點像是其他平臺「大數據殺熟」的感覺。
以我現在租用的一臺服務器爲例，續費一年的價格是 692 元，一次性續費至少 3 年，纔有所謂的 5 折折扣，總價爲 1251 元，均攤下來一年也要 417 元。
想着每年沒寫多少篇博客，也沒多少人看，在這上面也賺不到錢，每年卻要支出一筆費用，這讓我有點猶豫要不要續費下去。
基於此，我又重新尋找簡單、不需要過多折騰、最好還能是免費的建立個人博客的方法，正好這兩天看到一個基於 GitHub 的 Issues 功能來寫博客的開源項目。
gitblog 項目地址：
https://github.com/yihong0618/gitblog
對比我目前正在用的部署在騰訊雲的 Hexo 博客，使用 GitHub 自帶的 Issues 來寫博客，我目前能感知到的優點有：
- 完全免費，不需要租用域名和服務器
- 不需要過多折騰，對不懂技術的人來說非常友好
- Issues 自帶評論功能，不需要後期爲博客安裝評論插件
- GitHub 有網頁版和手機 App，只要有網，我們可以隨時隨地發佈博客，而不僅僅侷限於電腦
- 發佈到 GitHub 的內容，在 Google 的搜索結果中有非常高的權重，如果你寫的內容比較優質，或者是許多人都會有的需求，也能有非常不錯的曝光
除了這 4 個優點，這個開源博客項目的作者 @yihong 還提到了另外一些使用 GitHub 倉庫來寫博客的優點：
看完使用這個方法來搭建博客的好處，接下來就簡單介紹一下搭建的整個過程：
01. 下載整個項目文件
點擊項目首頁的綠色按鈕 Code，在彈出的面板中，選擇 Download ZIP，以壓縮包的形式下載整個項目文件。
下載解壓得到的文件，對解壓得到的文件進行修改。BACKUP 文件夾存放的是項目作者之前發佈的博客的備份文件，你可以將這個文件夾刪除。
打開 .github 文件夾，裏面有一個 workflows 子文件夾，繼續打開，可以看到一個名爲 generate_readme.yml 的文件，在記事本或代碼編輯器中打開這個文件。
這裏我使用代碼編輯器 VS Code 打開這個文件，需要修改兩個地方，一個是 branches 的值，將其由原來的 master 更改爲 main。
另一個是分別將下面的 GITHUB_NAME 和 GITHUB_EMAIL 替換成自己的 GitHub 賬號的 ID 和郵箱。
還沒有 GitHub 賬號的朋友，請出門右轉先註冊一個 GitHub 賬號：
修改好上面兩處地方之後，記得在關閉文件之前保存一下文件。
02. 在 GitHub 創建一個新的倉庫
回到瀏覽器中的 GitHub 個人主頁，點擊右上角的加號，選擇 New repository 創建一個新的倉庫。
爲你的新倉庫起一個名字，名字可以是英文，也可以是英文與數字的組成，暫不支持中文倉庫名。
接着勾選下方的 Choose a license，從內置的許可證中選擇一個協議，因爲我們使用的是別人寫好的代碼，因此這裏最好使用與原來相同的 MIT 開源協議。
最後點擊底部的綠色按鈕 Create repository，完成新倉庫的創建。
在新倉庫中，點擊右上角的 Add file，選擇 Upload files，將之前下載到本地的文件上傳到倉庫中。
上傳本地文件，和平常上傳文件到其他網站是一樣的，這裏需要上傳的文件有 main.py 和 requirements.txt。
本地的文件夾 .github 中有一個名爲 generate_readme.yml 的文件，由於 GitHub 網頁版不支持直接上傳文件夾，我們要使用另外一個選項 Create new file。
在左上角的文件名輸入 .github/ 才能創建一個文件夾路徑，按照本地的文件夾路徑，後面繼續輸入 workflows/generate_readme.yml。
最終得到的文件路徑和文件名如下圖，接着將本地的 generate_readme.yml 文件的內容複製到下方的編輯窗口中。
複製過來之後，滑動到頁面底部的綠色按鈕 Commit new file，點擊確認創建文件。
03. 獲取 Token 並配置參數
爲了讓我們前面創建的 generate_readme.yml 可以順利運行，我們還需要獲取一個 Token 參數，並將其配置到倉庫的 Secrets 中。
在瀏覽器打開網頁 https://github.com/settings/tokens ，點擊右上角的 Generate new token。
Note 這裏需要我們爲即將生成的 Token 添加一個備註信息，你可以隨意填，也可以填入一點比較有意義的信息，譬如下圖的 blog_token。
接着下方還要開啓權限，爲了避免後面程序運行時出錯，這裏建議勾選所有複選框，最後點擊底部的綠色按鈕 Generate token，生成一個 Token。
生成的 Token 是一長串數字和字母的組合，我們不需要記住它，只需要點擊 Token 右側的複製按鈕，將其複製到剪貼板。
接着回到我們前面創建的博客倉庫，點擊 Settings >> Secrets >> New repository secret。
這裏需要填入兩個值，Name 填入 G_T，這個值是固定的，它與之前的 generate_readme.yml 文件中定義的變量名有關，變量名沒有改變的話，值就是這一個。
下方的 Value 就填入剛剛我們複製到剪貼板的 Token 值，最後點擊下方的 Add secret 即可。
04. 使用 Issues 發佈第一篇博客
完成上面的操作，就可以說是完成了寫博客之前的所有配置，點擊倉庫頂部的 Issues 選項卡，接着點擊右側的 New issue。
在打開的新頁面中，可以看兩個文本框，一個是用來添加博客文章標題的 Title 區域，一個用來輸入或粘貼內容的編輯區，Issues 這種設計也很符合我們平時寫文章的習慣。
編輯好之後，點擊右下角的 Submit new issue，就完成了文章的發佈。
對於已發佈的文章，如果想在發佈後進行修改，可以點擊右側的 … 按鈕，選擇 Edit 切換到編輯模式，編輯沒有次數和字符數的限制，不像已經誕生 9 年的公衆號，每篇文章最多隻能修改 20 個字。
由於項目的作者用到了 GitHub 的另外一個功能——GitHub Actions，這是一個自動化操作，當我們創建或修改 Issues 中的文章時，它都會運行一次寫好的程序，在倉庫的首頁生成或更新 README 文件。
這裏就體現爲，它會在下方的「最近更新」自動生成我們最近更新的文章列表，方便訪問我們博客倉庫的人第一時間看到。
因爲我這個是今天剛建的博客，看起來還不夠壯觀，這裏放一下項目的原作者 @yihong 創建已久的博客，這或許才能真正讓人感受到記錄📝的意義：
以上就是本次想和你分享的內容。
看完文章如果覺得對你有幫助的話，別忘了點擊底部的「點贊/在看」鼓勵一下我，謝謝。
效率工具指南：分享推薦效率工具，好的產品值得被更多人知道。