基本指令

官方文檔鏈結

Hexo安裝與升級

1
2
npm install hexo -g #安装Hexo
npm update hexo -g  #升级Hexo

網站起點 hexo init

1
hexo init [folder]  #初始化本地文件夾為網站的根目錄
  • folder為可選參數，用來指定初始化目錄的路徑，若無指定則默認為當前目錄
  • 完成建立後會出現以下資料夾與檔案：
    1
    2
    3
    4
    5
    6
    7
    8
    9
    .
    ├── _config.yml # 網站設定檔
    ├── package.json
    ├── scaffolds # 鷹架資料夾
    ├── scripts # 腳本資料夾
    ├── source
    |   ├── _drafts #草稿資料夾 (在此的文章暫時不會被發布出去)
    |   └── _posts  #可在_posts資料夾新建第一篇文章 (主要文章編寫處)
    └── themes # 主題資料夾

新建文章或頁面 hexo new

1
2
3
4
5
6
# 新建文章 #
hexo new [layout] <title>   #標準寫法
hexo n [layout] <title>     #簡寫寫法
# 新建頁面 #
hexo new page [layout] <title> #標準寫法
hexo n page [layout] <title>   #簡寫寫法
  • layout為可選參數，用來指定文章類型，若無指定則默認由配置文件中的default_layout選項決定
  • title為必要參數，用以指定文章標題，若有包含空格，則需使用雙引號" "包圍
  • 範例：hexo new "postName" hexo new page "pageName"

啟動本地伺服器 hexo server

1
2
hexo server  #標準寫法
hexo s       #簡寫寫法

localhost：代表只能從本地瀏覽此網站，無法從外部瀏覽

  • 可在自己電腦上預覽設定結果，按 Ctrl + C 即可關閉
  • 運行服務器前需先安裝 hexo-server 插件
    1
    npm install hexo-server --save

生成靜態文件 hexo generate

1
2
hexo generate   #標準寫法
hexo g          #簡寫寫法
  • 生成網站靜態文件到public資料夾內

部屬網站 hexo deploy

1
2
hexo deploy     #標準寫法
hexo d          #簡寫寫法
  • 自動生成網站靜態文件，並部署到設定的倉庫

清理緩存 hexo clean

1
2
hexo clean  #標準寫法
hexo cl     #簡寫寫法
  • 用於清理緩存文件，是非常常用的指令
  • 在每次儲存修正後的檔案之前，會建議先輸入此指令，清除快取檔案（db.json）和已產生的靜態檔案（public）。
  • 當網站發生異常時，可嘗試此操作

查看幫助 hexo help

1
hexo help #查看幫助

顯示Hexo版本資訊

1
hexo version  #顯示Hexo版本資訊

預覽與部屬網站流程

預覽網站

  • 當每次完成更新後，可先啟動本地伺服器來預覽更新的網站是否符合期待。
  • 可利用以下指令來重建頁面並啟動本地伺服器：
1
hexo cl && hexo g && hexo s

部屬網站

  • 在確認網站內容正確後，通常會依序輸入 clean -> generate -> deploy 三個指令，確保網站完整更新。
    1
    2
    3
    hexo cl     #清除緩存
    hexo g      #生成靜態頁面
    hexo d      #部署網站
  • 可直接使用以下一行指令一鍵完成更新：
    1
    hexo cl && hexo g && hexo d
    產生sitemap
    1
    hexo g -d