Skip to main content

[note] Hexo

指令#

# $ hexo new <scaffold_layout> <title> # 建立新文章
# $ hexo publish <title>
$ hexo new draft hello_world
$ hexo generate # 產生靜態檔案
$ hexo generate -d # 產生靜態檔案,並部署網站
$ hexo server # 啟動伺服器
$ hexo deploy # 部署網站
$ hexo deploy -g # 部署網站前先產生靜態檔案
$ hexo clean # 清除快取檔案
$ hexo list <type> # 列出網站相關資料
$ hexo version # 列出 hexo 版本

錯誤處理#

##
# 安全模式:不會載入外掛和腳本。當您在安裝新外掛後遭遇問題時,可以嘗試以安全模式重新執行。
##
$ hexo --safe
##
# 除錯模式:在終端機中顯示除錯訊息並儲存記錄檔到 debug.log。當您碰到問題時,試著以除錯模式重新執行一次,並 把除錯訊息貼到 GitHub。
##
$ hexo --debug

安裝與初始化專案#

MAC 的使用者在安裝前記得先到 App Store 安裝 XCode

$ npm install -g hexo-cli # hexo 安裝
$ hexo init <folder> # 建立 hexo 專案資料夾
$ cd <folder>
$ npm install # 安裝 hexo 套件

安裝完畢後,資料夾結構會長這樣:

.
├── _config.yml # 設定檔
├── package.json
├── scaffolds # 用來建立新的 post
├── public # 處理編譯過 md 檔案會放到這裡
├── source # 部落格的內容,除了 _posts 外,其他以 _ 開頭的檔案都會被忽略
| ├── _drafts
| └── _posts
└── themes # 網頁主題

清除#

在 hexo 建立完檔案後,有時候會有刪除掉的 categories 或 tag 還留著,因此如果要砍掉原本 build 好的檔案後重建,可以使用:

$ hexo clean

這將會刪除掉 Database 和 Public Folder 中的東西。

Plugin#

  • 如果有使用 insight-search 的功能,要記得先在 hexo 目錄安裝 npm install -S hexo-generator-json-content

好看主題#

  • vexo
  • hexo-theme-icarus
  • hexo-theme-hipaper

參考#

Last updated on