歡迎來到我的第一篇博客文章!今天,我想和大家分享一個非常棒的工具 — Hexo。這是一個基於 Node.js 的靜態網站生成器,專門用於建立博客。以下是我使用 Hexo 和 GitHub Pages 建立並部署我的博客的過程。

Hexo 的安裝和設置
首先,您需要在計算機上安裝 Node.js 和 npm。然後,通過以下命令安裝 Hexo:

1
npm install -g hexo-cli

接下來,創建一個新的 Hexo 專案:

1
2
3
hexo init my-blog
cd my-blog
npm install

這樣就成功創建了一個新的博客專案!

創建新文章
創建一篇新文章很簡單,只需執行:

1
hexo new "我的第一篇文章"

然後,您可以在 source/_posts 目錄下找到剛創建的 Markdown 文件,開始編輯您的文章。

部署到 GitHub Pages
要將您的網站部署到 GitHub Pages,您需要先在 GitHub 上創建一個 repository。然後,修改 _config.yml 文件中的 deploy 部分:

1
2
3
4
deploy:
type: git
repo: <您的 GitHub 儲存庫 URL>
branch: [分支名稱]

接著,安裝 hexo-deployer-git:

1
npm install hexo-deployer-git --save

最後,使用以下命令部署您的網站,第一次輸入會要求登入 GitHub 帳號:

1
2
hexo deploy
這樣,您的 Hexo 博客就成功部署到 GitHub Pages 了!

之後如果有任何修改動作,依序輸入 clean -> generate -> deploy 三行指令,避免更新不完全:

1
2
3
hexo cl    // 清除之前建立的靜態檔案
hexo g // 建立靜態頁面
hexo d // 部署至 GitHub

二三行能直接合併成 hexo g -d 能產生靜態頁面後立刻部署。

Hexo預設主題是landscape,之後如果想調整theme,可以到這裡,選擇主題,這邊以NexT為例
安裝Next

1
2
cd hexo-site
git clone https://github.com/next-theme/hexo-theme-next themes/next

接著修改_config.yml將 theme: landscape 改為 theme: next
語言設定將 language: en 改為 language: zh-tw
然後重新啟動server

1
hexo server

我安裝完重新部屬至GitHub時出現了warning: LF will be replaced by CRLF in ...的錯誤。
查詢後發現問題出在換行字元

  1. Windows/Dos 系統,採用CR+LF表示,符號\r\n
  2. Mac 系統,採用LF表示,符號\n

這邊我直接修改設定

1
git config –-global core.autocrlf false

然後重新佈署就行。