在Github寫(xiě)博客（blog），fastpages搭建入門(mén)，10分鐘建站

時(shí)間：2023-08-06 14:54:01 | 來(lái)源：網(wǎng)站運(yùn)營(yíng)

時(shí)間：2023-08-06 14:54:01 來(lái)源：網(wǎng)站運(yùn)營(yíng)

在Github寫(xiě)博客（blog），fastpages搭建入門(mén)，10分鐘建站：

寫(xiě)在前面

很多人都知道Github Pages可以用來(lái)搭建網(wǎng)站，也可以搭建個(gè)人博客，而且不用寫(xiě)繁瑣的HTML、CSS等代碼，只要用Markdown格式就行。當(dāng)然，國(guó)內(nèi)的CSDN，cnblogs這些也都可以。

但是畢竟md還是需要一定的代碼語(yǔ)言基礎(chǔ)，如果沒(méi)有基礎(chǔ)，那么可以來(lái)試試fastpages。它支持直接上傳word文檔、Jupyter文件，當(dāng)然也依舊支持Markdown格式文本。

如果你經(jīng)常寫(xiě)python，你應(yīng)該會(huì)很熟悉Jupyter Notebook。它是一個(gè)可以在網(wǎng)頁(yè)（服務(wù)器）實(shí)時(shí)運(yùn)行python并顯示結(jié)果的平臺(tái)。

如果你沒(méi)有用過(guò)Jupyter，那我強(qiáng)烈建議你試用一下，我保證，你會(huì)愛(ài)上它的。

案例展示

話不多說(shuō)，先看看效果吧。它完美適配不同機(jī)型屏幕尺寸，避免了HTML的各種煩惱。

這個(gè)網(wǎng)站基于 fastai/fastpages（Jeremy Howard & Hamel Husain） 項(xiàng)目的中文漢化版 建立。

如果你喜歡這個(gè)網(wǎng)站，并且想要搭建一個(gè)屬于自己的博客，請(qǐng)繼續(xù)讀下去吧。

不要忘了給我點(diǎn)個(gè)贊喏！

操作指導(dǎo)

零基礎(chǔ)也不要怕，按著步驟來(lái)一定沒(méi)問(wèn)題，10分鐘就能搭建一個(gè)屬于自己的網(wǎng)站。如果還有問(wèn)題也沒(méi)關(guān)系，給我留言吧。建議全程使用電腦操作。

第一步，注冊(cè)并登陸。（1分鐘）訪問(wèn)github.com，如果已經(jīng)有賬號(hào)，點(diǎn)擊sign in登錄，沒(méi)有則點(diǎn)sign up注冊(cè)。不要對(duì)英文感到懼怕，簡(jiǎn)單的操作用百度翻譯就可以解決。

第二步，復(fù)制博客模板。（1分鐘）訪問(wèn) https://github.com/EasonQYS/fastpagesJupyter 可以看到已經(jīng)漢化好的模板，可以點(diǎn)擊Star圖標(biāo)鼓勵(lì)一下作者。

繼續(xù)往下滑?？吹絉EADME文檔，就是這個(gè)項(xiàng)目的基本介紹啦。

再往下滑，看到“初始化指導(dǎo)”部分，點(diǎn)擊藍(lán)色字，即可生成自己的博客網(wǎng)站。

點(diǎn)擊后進(jìn)入下一個(gè)頁(yè)面，在第一個(gè)紅框內(nèi)輸入blog，代表這個(gè)倉(cāng)庫(kù)（repository，repo）是你的博客。你的博客網(wǎng)頁(yè)地址將是 {你的github用戶名}.http://github.io/blog。你可能會(huì)有疑惑，那 {你的github用戶名}.http://github.io 這個(gè)網(wǎng)址能不能訪問(wèn)呢？目前還不行，我們之后會(huì)談到。如果想了解，可以跳到最后一節(jié) 外層靜態(tài)網(wǎng)頁(yè)。

如果你對(duì)github比較熟悉，你也可以輸入其他名字。點(diǎn)擊第二個(gè)紅框生成，這需要大約20秒。成功后，你的郵箱會(huì)收到一封郵件。

第三步，配置博客密鑰對(duì)。（3分鐘）打開(kāi)郵件，可以看到三個(gè)有藍(lán)色的鏈接。下面將依次介紹。

點(diǎn)擊第一個(gè)鏈接，選擇RSA和4096，點(diǎn)擊生成（Generate-SSH-Keys），就會(huì)可到兩串字符。。保持頁(yè)面，記該頁(yè)面為（*）。

點(diǎn)擊第二個(gè)鏈接，點(diǎn)擊添加new secret。復(fù)制（*）中的Private Key至Value欄，包含"---BEGIN RSA PRIVATE KEY---" 和 "--END RSA PRIVATE KEY---"。在Name欄填寫(xiě)SSH_DEPLOY_KEY（只能是這個(gè)名字）。點(diǎn)Add secret保存。

點(diǎn)擊第三個(gè)鏈接，點(diǎn)擊添加deploy key。復(fù)制（*）中的Public Key至key欄，name欄隨意填寫(xiě)，例如填寫(xiě)key。請(qǐng)注意勾選Allow write access。點(diǎn)擊Add key保存設(shè)置。（這里可能需要輸入一次github密碼）

完成后如圖所示，點(diǎn)擊Options，下滑找到GitHub Pages，source選擇gh-pages branch（如果沒(méi)有可以先選擇master branch，稍后自動(dòng)生成gh-pages branch后可以再修改）。等待一段時(shí)間，GitHub Pages欄生成一個(gè)網(wǎng)址，點(diǎn)擊即可訪問(wèn)該網(wǎng)站。

第四步，配置相關(guān)文件。（3分鐘）點(diǎn)擊Code，找到_config.yml，點(diǎn)擊它。

再點(diǎn)擊下圖紅框，進(jìn)入修改模式。需要修改的部分已在圖中標(biāo)注。

如果自己購(gòu)買(mǎi)了域名，除了在這里配置外，還需要修改CNAME文件，寫(xiě)入域名?？梢詤⒖紇vboard項(xiàng)目的設(shè)置。

第五步，訪問(wèn)博客網(wǎng)站。（2分鐘）確認(rèn)GitHub Pages設(shè)置的source選擇gh-pages branch。訪問(wèn){你的github用戶名}.http://github.io/blog?？纯词遣皇钦ｏ@示了，如果還沒(méi)有，可能網(wǎng)頁(yè)還在生成中。耐心等待一下。你可以在Actions查看處理進(jìn)度。

更新博客

網(wǎng)站搭好了，怎么發(fā)博客呢？

只要把文件上傳到指定文件夾下就行了。

先說(shuō)一下文件命名格式：YYYY-MM-DD-文件名（支持中文）.后綴

要注意：很容易將YYYY-MM-DD-的最后一個(gè)破折號(hào)落下。 并且，破折號(hào)后面的一個(gè)字符只能是文字而不能是符號(hào)。

如果是word文檔，那么一定要注意后綴是.docx。將其是上傳至_word目錄下。如果找不到這個(gè)目錄，就要看看Branch是不是選擇的master。

同理，Jupyter文件上傳至_notebooks目錄下。這里對(duì)文件第一個(gè)單元格內(nèi)容有要求。第一個(gè)單元格必須是markdown格式的單元格。內(nèi)容如下（可以缺省其中幾行）：

# "標(biāo)題"> "概要"- toc: true- badges: true- comments: true- categories: [fastpages, jupyter]- image: images/some_folder/your_image.png- author: A & B其中的categories是博客的標(biāo)簽，有的網(wǎng)站也稱之為tags，不同tags以英文逗號(hào)分隔。

有的朋友會(huì)在文檔中插入圖片。這里值得說(shuō)明的一點(diǎn)是，由于博客用于網(wǎng)頁(yè)留言，直接插入本地圖片是無(wú)效的，需要類似md文件那樣引用圖片，語(yǔ)句如下：

![](https://www.fast.ai/images/fastai_paper/show_batch.png "Credit: https://www.fast.ai/2020/02/13/fastai-A-Layered-API-for-Deep-Learning/")引號(hào)內(nèi)的內(nèi)容將會(huì)以圖注的形式出現(xiàn)在圖片下方，可以省略。

如果是Markdown文件。類似Jupyter也要有表頭。格式如下：

--- title: "標(biāo)題" summary: "概要" toc: true comments: true image: images/some_folder/your_image.png categories: [fastpages, jupyter] ---

外層靜態(tài)網(wǎng)頁(yè)

在github頁(yè)面右上角點(diǎn)擊加號(hào)，選擇New repository。輸入{你的github用戶名}.http://github.io，點(diǎn)擊Create repository。

默認(rèn)的主頁(yè)就是README.md文件，你可以編輯它修改你的主頁(yè)。如果你精通HTML+CSS，你也可以寫(xiě)一個(gè)index.html上傳到該目錄下。

點(diǎn)擊Settings，往下滑，看到Github Pages綠色欄的√，表示網(wǎng)頁(yè)已成功建立，你可以訪問(wèn)試試。

如果想建立子網(wǎng)站，只要在當(dāng)前目錄下建立新目錄，并在里面添加新的Markdown文件（如about/README.md）或HTML文件即可。也可以在根目錄下添加about.html。

可以參考這里：

當(dāng)然，這樣的管理可能會(huì)造成混亂。我們可以利用不同的倉(cāng)庫(kù)（repo）之間相互獨(dú)立的特性，

在該倉(cāng)庫(kù)僅保留簡(jiǎn)要的頁(yè)面以及相關(guān)鏈接，在相應(yīng)的倉(cāng)庫(kù)建立子網(wǎng)站，這樣管理可以更加有效。

如果你覺(jué)得喜歡的話，可以給我點(diǎn)個(gè)贊喏！