利用 Hexo + NexT + Github Page 建立自己的 Blog

發表於 2023-07-05 更新於 2024-03-30 分類於教學文閱讀次數：文章字數： 2k 所需閱讀時間 ≈ 7 分鐘

前言

我的 Blog 就是用 Hexo、NexT、Github Page 做出來的，而且不同其他架 Blog 的那種網站，做出來之後你的 Blog 後面會有一個 github.io 的後綴（就像 moon-jam.github.io），看起來就很厲害，趁昨天剛做完打第一篇教學文，這東東其實蠻簡單的，很快就有成品了 ~~不過要是你想裝一些酷酷的東西，就有可能搞很久 (最後還是有些沒用出來 QAQ~~

如果想要看詳細一點的教學我覺得六角學院的教學影片很棒，跟著做很快就好了，如果覺得我現在的 Blog 哪裡還可以修正，或是覺得我教學哪裡有問題或是有講錯的歡迎在底下留言指教喔～教學開始嘍！注意事項：這個教學會需要用到 vscode，如果不知道他是什麼或是跟他不熟的，建議先去爬爬文看怎麼用再來看這篇喔～

建構 Hexo

需要先裝 Node.js 還有 Git 然後從 vscode 開一個資料夾，並在 terminal 打下面這些

npm install hexo-cli -g
hexo init blog_folder_name  //要換成你自己的資料夾名稱
cd blog_folder_path         //要換成你自己的資料夾路徑
npm install
hexo s

然後就會看到你的網頁跑出來了

連接 Github

首先先到 github 新開一個 Repository（這裡附上本人的 Repository）到個人首頁新增一個Repository 然後取名叫做 username.github.io （username 要改成你自己的，如果要開更多網站的話可以取其他名字，但後面有地方要小改一點）選 public，然後其他都不要打勾，完成之後複製這一段把Repository的網址複製下來然後接下來就要把資料夾跟 Github 連上，輸入以下這些東西

git init
git add.
git commit -m "git init"

git remote add origin Repository_url //Repository_url換成剛剛複製的那個
git push -u origin master

接著到最外層的資料夾應該會看到一個_config.yml，點進去，然後找到 deploy，並修改成下面這樣

deploy:
  type: git
  repo: Repository_url //剛剛複製的那個
  branch: master

這裡要注意一下如果剛剛你 Repository 名字不是叫 username.github.io，要改成這樣子

deploy:
  type: git
  repo: Repository_url //剛剛複製的那個
  branch: gh-pages

此外如果你 Repository 名稱自己取的話還要找到 relative_link，並設定為 true

1	relative_link: true

最後就可以部署到 github 上去了

1 2	npm install hexo-deployer-git --save hexo d

完成之後你打開 username.github.io，應該就會看到你的網頁了🎉（Repository 名稱自己取的則是開啟 username.github.io/Repository_name）

接下來就可以開始寫部落格了，接下來就來講應該如何新建一片文章，是用 markdown 語法編輯，如果不熟的可以自己去找找文章，網路上蠻多教學的

1	hexo new title //會在source資料夾裡面產生一篇檔名叫做title的檔案，使用markdown語法編輯

完成之後就連打下面三行，就會發現你新的文章已經出現在網站上了 (如果還沒的話就在等一下，他可能還要一些時間，或者你可以在 terminal 打 hexo s，就可以在本地看到網站摟)

1
2
3

hexo cl //clean 刪掉之前的內容，不刪有時候也可以，但有可能會報錯
hexo g  //generate 建立網站
hexo d  //deploy 部署到github page

然後如果要傳到 github 上，每次都要 git commit -m ""、git push 實在太累了，這邊我蠻推薦裝 vscode 的插件連到 Github，可以直接一鍵上傳

Hexo 設定

找到外層資料夾最底下的_config.yml，這邊就講有需要調整的，其他有興趣可以自己玩玩看外層資料夾的_config.yml

Site：
－title 就打你想為網站取的名字
－subtitle 會顯示在網站 title 的底下，可以留空不會
－keyword 可打可不打
－author 打你的想叫的名字，之後如果有地方會用到作者的資訊都會直接從這裡拿
－language 就選你想要的語言（繁體中文 zh-TW，簡體中文 zh-CN，香港 zh-HK，英文 en）
－timezone 就留空就好
URL：
－url 填自己的網域，如果你有自己的網域的話就填自己的（~~之後如果哪天有的話再個教學~~ 最後面有教學喔），所以就是填 github page 的網址
－permalink 是代表你文章的網址要是什麼，預設是年 / 月 / 日 / 文章標題，不過這裡我建議你該城:name/，你也可以用:/title 這是代表用 title 當作網址，但如果是中文的話他會變亂碼，這樣對搜尋優化不好（原本用年月日也會因為層數太多所以讓演算法不喜歡），而且網址也會變比較難看，用:name / 的話會用檔案名稱當作網址，只要你檔名取英文的就好了（也有插件是會自己生成一串數字當作網址，但這樣對搜尋優化應該也不太好)
找到 theme 的地方，後面打上主題的資料夾名稱，詳細就看後面的吧

套上主題

我是選擇 NexT，版型相當的好看，而且很多人用，要找資源也還算好找（這裡可以找其他主題喔） NexT的主題

下載 NexT

1	git clone https://github.com/theme-next/hexo-theme-next themes/NexT

接著到到最外層資料夾的_config.yml（不是你 theme 裡面的喔）找到 theme 的地方，並設成 NexT

1	theme: NexT

如果要下載別的主題可以點到進主題的 github，並複製他的網址，然後改成 git clone 你想要的主題 themes/你想要的資料夾名稱，然後把_config.yml 中的 theme，並設成你取的資料夾名稱

再輸入 hexo s，就看得到摟，部署到網站上就是在輸入上面那三條

修改 NexT 主題

如果要改 NexT 的主題 (就是上面看到的那四種)，可以到 theme/NexT/_config.yml，修改裡面的 Scheme Settings，把想要的取消註解，其他全部註解掉（像我就是使用 Pisces）

NexT 調整

這邊我就列出我改的東西跟教學，有興趣的再移過去看摟

心得

這個 Blog 前前後後大概花了 10 個小時，大概有七成時間都是在找 bug🥲，不過成果還算滿意😀。

期間為了要有一些更酷的功能，所以又找了很多的擴充，然後遇到好多奇怪的狀況，debug 了好久，然後還是有些做不出來，像是那個同一站內切換語言，我看有人做出來，想說應該有插件不會太難，結果我就用了三四個小時有時候切語言只有一半的東西切到，有時候切過去了切不回來，不然就是切過去之後沒有出先該出現的東西，後來實在用不好，所以才變成現在我分成中英兩個站點，然後分兩個地方更新，實在有點麻煩，而且如果要改設定還要改兩次，如果有人知道怎麼用的希望可以在底下跟我說🙏。其實本來還有動態背景跟酷酷的滑鼠爆炸特效，但感覺這樣網站看起來有點小亂，還是簡單一點比較好（枉費我浪費這麼多時間😠

對了我有用一點點 SEO 優化，不知道哪天我的網站可以在 google 上被搜尋到。之後不知道會不會想要買一個自己的網域，感覺也很酷。

更新 - 自訂網域

麻煩幫我移到這邊看喔～

參考資料

這裡面蠻多是別人的部落格，然後就會被發現我跟他們長差不多，就東抄西抄 XD
Hexo 官方網站
 【學習筆記】如何使用 Hexo + GitHub Pages 架設個人網誌
 使用 Hexo 建構個人化部落格 (六角學院的教學，基本上就跟著做就完成了)
使用 Hexo 建置網站（上面影片的上課講義）
中國的教學，還蠻詳細的但有點舊有些可能要再查一下
 試著學 Hexo - NexT 主題篇 - 可以安裝的套件 (他部落格裡面還有很多 Hexo 的教學)
在 Hexo 的 Next 樣板中引入 utterances 的留言區 | GitHub Issue
這個是用 Butterfly 做的，做的超猛
 Hexo Next 8 Language Switch