懶人包
透過 Hexo,您可以輕鬆地建立和管理個人部落格,享受快速生成和部署的便利。
- 安裝 Hexo: 確保已安裝 Node.js 和 Git,然後在終端機中執行
npm install -g hexo-cli
安裝 Hexo。 - 初始化專案: 在目標資料夾中執行
hexo init
,初始化 Hexo 專案結構。 - 撰寫文章: 使用
hexo new "文章標題"
指令建立新文章,文章檔案會儲存在source/_posts
資料夾中。 - 生成靜態檔案: 執行
hexo generate
(或簡寫為hexo g
),生成靜態網站檔案。 - 本地預覽: 透過
hexo server
(或簡寫為hexo s
)啟動本地伺服器,預設在http://localhost:4000/
預覽網站。 - 部署網站: 配置部署資訊後,使用
hexo deploy
(或簡寫為hexo d
)將網站部署到指定平台。
簡單介紹
Hexo 是一個基於 Node.js 的快速、簡單且強大的靜態網站生成器,特別適合用於建立個人部落格。
它使用 Markdown(或其他標記語言)來撰寫文章,並透過主題渲染,快速生成靜態檔案。
Hexo 的主要特點包括:
- 超高速生成: 利用 Node.js 的高效能,Hexo 能在數秒內生成數百個檔案。
- Markdown 支援: 全面支援 GitHub Flavored Markdown,讓撰寫和管理文章更加方便。
- 豐富的主題和插件: 擁有大量精美且功能豐富的主題,可自訂網站外觀;同時,強大的 API 允許無限擴充功能。
- 一鍵部署: 只需一個指令,即可將網站部署到 GitHub Pages、Heroku 等平台,簡化發布流程。
安裝
安裝必要環境
快速安裝
安裝 Hexo
他會安裝一個類似 hexo 套件,後面都使用
hexo
命令操作1
npm install hexo-cli -g
初始化
在指定資料夾中建立所有您需要的檔案。
該檔案可以放在 USB 到處帶著跑。1
2
3hexo init <folder>
cd <folder>
npm install資料夾結構
- 配置檔:hexo.io/docs/configuration
- 寫作(文章、文章模板):hexo.io/docs/writing
- 主題:hexo.io/docs/themes
1
2
3
4
5
6
7
8.
├── _config.yml # 網站配置檔
├── package.json # 應用程式數據
├── scaffolds # 文章模板
├── source # 文章(網站內容, MD檔)
| ├── _drafts
| └── _posts
└── themes # 主題
基本使用
撰寫文章
1
2
3
4# 格式
hexo new [layout] <title>
# 範例
hexo new post "Hello World"刪除文章
如果您使用 Git 進行部署,可能需要額外刪除根目錄下的
.deploy_git
資料夾,然後重新執行上述步驟,以確保已刪除的文章不再出現在網站上。1
2
3
4# 在 source/_posts 資料夾中,找到並刪除文章的 .md 檔案
hexo clean
hexo generate
hexo deploy產生靜態文件
生成靜態網站檔案,生成的檔案會在
public
目錄下1
2
3
4
5
6
7# 通常使用
hexo generate
# 或
hexo g
# 如果你想知道檔案異動
hexo generate --watch清理快取或生成的靜態文件
清理 快取檔(
db.json
) 和 生成的檔(public
)。刪除文章或變更設定會需要使用
1
hexo clean
啟動本地伺服器
預設為
http://localhost:4000/
,按ctrl
+c
結束本地伺服器。Node.js 會要開本機防火牆,但通常不需要防火牆也能運作!
1
hexo server
部署網站
將網站部署到指定平台
1
2
3hexo deploy
# 或
hexo d