指令

init

$ hexo init [folder]

初始化網站。如果沒有提供 folder,Hexo 將會在目前目錄下建立網站。

此指令是執行下列步驟的快捷方式

  1. hexo-starter,包含 hexo-theme-landscape,複製到目前目錄或指定資料夾。
  2. 使用套件管理器安裝相依套件:Yarn 1pnpmnpm,以安裝的順序為優先。npm 預設會與 Node.js 捆綁在一起。

new

$ hexo new [layout] <title>

建立新文章。如果沒有提供 layout,Hexo 將會使用 _config.yml 中的 default_layout。使用 draft 版面配置來建立草稿。如果 title 包含空格,請用引號括起來。

選項 說明
-p, --path 文章路徑。自訂文章路徑。
-r, --replace 如果文章已存在,則取代當前文章。
-s, --slug 文章別名。自訂文章的 URL。

預設情況下,Hexo 將使用標題來定義檔案的路徑。對於頁面,它將建立一個該名稱的目錄,並在其中建立一個 index.md 檔案。使用 --path 選項覆蓋該行為並定義檔案路徑

hexo new page --path about/me "About me"

將建立 source/about/me.md 檔案,並在前端資訊中設定標題為「About me」。

請注意,標題是必要的。例如,這不會產生您可能預期的行為

hexo new page --path about/me

將會建立文章 source/_posts/about/me.md,並在前端資訊中設定標題為「page」。這是因為只有一個參數 (page),而預設的版面配置是 post

generate

$ hexo generate

產生靜態檔案。

選項 說明
-d, --deploy 產生完成後部署
-w, --watch 監看檔案變更
-b, --bail 如果在產生過程中拋出任何未處理的例外,則引發錯誤
-f, --force 強制重新產生
-c, --concurrency 並行產生的最大檔案數量。預設值為無限大

publish

$ hexo publish [layout] <filename>

發佈草稿。

server

$ hexo server

啟動本機伺服器。預設情況下,網址為 https://127.0.0.1:4000/

選項 說明
-p, --port 覆寫預設埠號
-s, --static 僅服務靜態檔案
-l, --log 啟用記錄器。覆寫記錄器格式。

deploy

$ hexo deploy

部署您的網站。

選項 說明
-g, --generate 部署前產生

render

$ hexo render <file1> [file2] ...

渲染檔案。

選項 說明
-o, --output 輸出目的地

migrate

$ hexo migrate <type>

從其他部落格系統遷移內容。

clean

$ hexo clean

清除快取檔案(db.json)和產生的檔案(public)。

list

$ hexo list <type>

列出所有路由。

version

$ hexo version

顯示版本資訊。

config

$ hexo config [key] [value]

列出設定(_config.yml)。如果指定了 key,則僅顯示設定中對應 key 的值;如果同時指定了 keyvalue,則設定中對應 key 的值會變更為 value

選項

安全模式

$ hexo --safe

停用載入外掛和腳本。如果在安裝新外掛後遇到問題,請嘗試此操作。

偵錯模式

$ hexo --debug

將詳細訊息記錄到終端機和 debug.log。如果您在使用 Hexo 時遇到任何問題,請嘗試此操作。如果看到錯誤,請提出 GitHub Issue

靜音模式

$ hexo --silent

靜音輸出到終端機。

自訂設定檔路徑

$ hexo --config custom.yml

使用自訂設定檔(而不是 _config.yml)。也接受以逗號分隔(不含空格)的 JSON 或 YAML 設定檔清單,這些檔案將合併為單一的 _multiconfig.yml

$ hexo --config custom.yml,custom2.json

顯示草稿

$ hexo --draft

顯示草稿文章(儲存在 source/_drafts 資料夾中)。

自訂 CWD

$ hexo --cwd /path/to/cwd

自訂目前工作目錄的路徑。