Hexo 安裝與使用

📢 本文由 gemini-3-flash-preview 翻譯

最近伺服器快過期了,便想著把 VRC Blog 遷移到 GitHub 上,於是便想著看看有沒有什麼好的主題,剛開始是想著現在用的 Typecho 主題是從 Jekyll 移植的,但 半年前 去搜尋找不到了,然後最近又有點想了解 Hexo,找了半天主題又想到之前挺喜歡的 Argon 好像有 Hexo 版,然後便有了這篇文章。

環境

需要安裝 Node.js 10.13 以上版本,推薦 12.0 以上。

需要安裝 Git。

安裝

執行指令:

1
npm install -g hexo-cli

檢查安裝是否成功:

1
hexo -h

建立新部落格

切換到要安裝的資料夾:

1
hexo init <folder_name>

進入資料夾:

1
cd <folder_name>

安裝相依套件:

1
npm i

建立完成後可以修改 ./_config 進行設定。

安裝主題

主題站 挑選一個主題,不同主題可能有不同的安裝方法,具體請參考主題文件。

以下為 Argon 主題的安裝範例:

複製主題

首先在 ./themes 資料夾複製主題儲存庫:

1
git clone https://github.com/solstice23/hexo-theme-argon.git

將複製下來的資料夾重新命名為 argon

安裝 ejs 渲染器:

1
npm install hexo-renderer-ejs

./_config.yml 檔案中將 theme 改為 argon。

設定檔

修改檔案 ./themes/argon/_config.yml 以更改設定。

設定搜尋

在根目錄執行:

1
npm install hexo-generator-search --save

然後在 ./_config.yml 中加入選項:

1
2
3
4
search:
  path: search.xml
  field: post
  content: true

寫作

建立新文章:

1
hexo new [layout] <title>

其中 [layout] 是一個可選屬性,具體如下:

Layout描述路徑
post文章,預設source/_posts
page頁面source
draft草稿source/_drafts

建立完成後即可開始編寫文章。

預覽:

1
hexo s

存取 localhost:4000 查看效果。

產生靜態檔案

執行指令:

1
hexo generate

執行指令後只會針對有變動的部分進行產出,建議先將原有的刪除再重新產生會比較好。

參考文章

https://hexo.io/docs/

https://github.com/solstice23/hexo-theme-argon