其實目前官網的文件非常詳細,這裡就不多做介紹了。
安裝 Hexo
$ npm install hexo-cli -g
建立 & 初始化
$ hexo init <folder>
$ cd <folder>
$ npm install
建立後會有以下資料夾 & 檔案
.
├── _config.yml # 網站設定檔
├── package.json
├── scaffolds # 鷹架資料夾
├── scripts # 腳本資料夾
├── source
| ├── _drafts
| └── _posts
└── themes # 主題
配置
※ 官方設定檔文件
常用指令
# 查看幫助
hexo help
# 新建文章
hexo new "postName"
# 新建頁面
hexo new page "pageName"
# 產生靜態網頁
hexo generate
# 本機預覽
hexo server
# 部署
hexo deploy
# 清除暫存,執行前建議使用
hexo clean
簡寫
hexo n == hexo new hexo g == hexo generate hexo s == hexo server hexo d == hexo deploy
部署到 Git
透過 Git 發佈,安裝 Git 套件
$ npm install hexo-deployer-git --save
修改 _config.yml
設定值
# Deployment
deploy:
type: git
repo: [email protected]:dexiang/dexiang.github.io.git
branch: master
message:
設定好以後就可以部署了
$ hexo deploy
GitHub Page
Domain Name 設定
首先當然要先有 Domain Name 啦~ 設定好以後,可透過 CNAME 設定到部落格上。
另外在每次 deploy 到 Github 上時,CNAME 會一直被覆蓋,怎麼辦呢?
安裝 CNAME,在 deploy 時自動產生 CNAME 檔案
$ npm install hexo-generator-cname --save
$ cd source/
$ touch CNAME
$ vim CNAME # 輸入domain,EX:dexiang.tw
主題
每一家的 Theme 都有長處,可依個人喜好,以下是以 github 星星數整理出來的排名。
- NexT
- Yilia
- Tranquilpeak
https://github.com/LouisBarranqueiro/hexo-theme-tranquilpeak
- Yelee
- Jacman
- Maupassant
- Apollo
- Icarus
- Material
- Fexo
我選用的是 Yilia Theme
常見問題
- 修改配置時需注意
YAML
語法,參數冒號後 (:) 一定要留一個空格 - 所有問題請轉成 UTF-8 格式