超詳細 Hexo + GitHub Page 搭建技術 blog 教程

JeffreyBool發表於2020-06-09

前言

部落格有第三方平臺,也可以自建,比較早的有部落格園、CSDN,近幾年新興的也比較多諸如:WordPress、segmentFault、簡書、掘金、知乎專欄、Github Page 等等。

這次我要說的就是 Github Page + Hexo 搭建個人部落格的方式!Github Page 是 Github 提供的一種免費的靜態網頁託管服務(所以想想免費的空間不用也挺浪費的哈哈哈),可以用來託管部落格、專案官網等靜態網頁。支援 Jekyll、Hugo、Hexo 編譯靜態資源,這次我們的主角就是 Hexo 了,具體的內容下面在文章內介紹。

下面就開始吧~

準備環境

準備 node 和 git 環境,
首先,安裝 NodeJS,因為 Hexo 是基於 Node.js 驅動的一款部落格框架,相比起前面提到過的 Jekyll 框架更快更簡潔,因為天*朝網路被牆的原因嘗試過安裝 Jekyll 失敗而放棄了。
然後,安裝 git,一個分散式版本控制系統,用於專案的版本控制管理,作者是 Linux 之父。如果 Git 還不熟悉可以參考廖雪峰大神的 Git 教程。

兩個工具不同的平臺安裝方法有所不一樣,可自行了解按步驟安裝,這裡不詳述了。安裝成功後開啟git bash(Windowns)或者終端(Mac),下方中將統一稱為命令列。
在命令列中輸入相應命令驗證是否成功,如果成功會有相應的版本號。

bash

git version
node -v
npm -v

超詳細 Hexo + Github Page 搭建技術blog教程

超詳細 Hexo + Github Page 搭建技術blog教程

安裝 Hexo

如果以上環境準備好了就可以使用 npm 開始安裝 Hexo 了。也可檢視 Hexo 的詳細文件。
在命令列輸入執行以下命令:

bash

npm install -g hexo-cli

初始化專案

安裝 Hexo 完成後,再執行下列命令,Hexo 將會在指定資料夾中新建所需要的檔案。

bash

hexo init my-blog
cd my-blog
npm install

新建完成後,指定資料夾的目錄如下:

tree

.
├── _config.yml # 網站的配置資訊,您可以在此配置大部分的引數。 
├── package.json
├── scaffolds # 模版資料夾
├── source  # 資原始檔夾,除 _posts 檔案,其他以下劃線_開頭的檔案或者資料夾不會被編譯打包到public資料夾
|   ├── _drafts # 草稿檔案
|   └── _posts # 文章Markdowm檔案 
└── themes  # 主題資料夾

好了,如果上面的命令都沒報錯的話,就恭喜了,執行 hexo s 命令,其中 sserver 的縮寫,在瀏覽器中輸入 http://localhost:4000 回車就可以預覽效果了。

bash

hexo s

以下是我本地的預覽效果,更換了 hexo-theme-matery 主題的,預設不是這個主題。

hexo-theme-matery

hexo-theme-matery

hexo-theme-matery

hexo-theme-matery

hexo-theme-matery

hexo-theme-matery

hexo-theme-matery

hexo-theme-matery

至此,你本地的部落格就已經搭建成功,接下來就是部署到 Github Page 了。

建立 github page

  • 第一步建立repository

    repository

    repository

  • 第二步輸入你要申請的 github.io 域名

    github.io

    github.io

注意點來了,Github 僅能使用一個同名倉庫的程式碼託管一個靜態站點,這個網上很多教程沒說到的。

第三步配置 github page

在建好的倉庫右側有個settings按鈕,點選它,向下拉到GitHub Pages,你會看到有個網址,訪問它,你將會驚奇的發現該專案已經被部署到網路上,能夠通過外網來訪問它,當然裡面還很空什麼東西都沒有。 該地址就是你的部落格預設地址,你也可以購買域名,將其換成你喜歡的地址。

github page

github page

生成 github ssh

參考文章

上傳到github

如果你一切都配置好了,釋出上傳很容易,一句hexo d就搞定,當然關鍵還是你要把所有東西配置好。
首先,ssh key肯定要配置好。
其次,配置_config.yml中 有關deploy的部分:
正確寫法:

yml

deploy:
  type: git
  repository: git@github.com:JeffreyBool/jeffreybool.github.io.git
  branch: master

常用hexo命令

bash

hexo new "postName" #新建文章
hexo new page "pageName" #新建頁面
hexo generate #生成靜態頁面至public目錄
hexo server #開啟預覽訪問埠(預設埠4000'ctrl + c'關閉server)
hexo deploy #部署到GitHub
hexo help  # 檢視幫助
hexo version  #檢視Hexo的版本

縮寫:

bash

hexo n ==> hexo new
hexo g ==> hexo generate
hexo s ==> hexo server
hexo d ==> hexo deploy

組合命令

bash

hexo s -g # 生成並本地預覽
hexo d -g # 生成並上傳

參考文章

來源: JeffreyBool
文章作者: JeffreyBool
文章連結: www.zhanggaoyuan.com/article/d2b1e...
本文章著作權歸作者所有,任何形式的轉載都請註明出處。

本作品採用《CC 協議》,轉載必須註明作者和本文連結

by JeffreyBool blog :point_right: link

相關文章