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