Hexo 命令

2020-10-20 16:17 更新

init

$ hexo init [folder]

新建一個網(wǎng)站。如果沒有設(shè)置 folder ,Hexo 默認在目前的文件夾建立網(wǎng)站。

This command is a shortcut that runs the following steps:

  1. Git clone hexo-starter including hexo-theme-landscape into the current directory or a target folder if specified.
  2. Install dependencies using a package manager: Yarn 1, pnpm or npm, whichever is installed; if there are more than one installed, the priority is as listed. npm is bundled with Node.js by default.

new

$ hexo new [layout] <title>

新建一篇文章。如果沒有設(shè)置 layout 的話,默認使用 _config.yml 中的 default_layout 參數(shù)代替。如果標題包含空格的話,請使用引號括起來。

$ hexo new "post title with whitespace"
參數(shù) 描述
-p, --path 自定義新文章的路徑
-r, --replace 如果存在同名文章,將其替換
-s, --slug 文章的 Slug,作為新文章的文件名和發(fā)布后的 URL

默認情況下,Hexo 會使用文章的標題來決定文章文件的路徑。對于獨立頁面來說,Hexo 會創(chuàng)建一個以標題為名字的目錄,并在目錄中放置一個 index.md 文件。你可以使用 --path 參數(shù)來覆蓋上述行為、自行決定文件的目錄:

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

以上命令會創(chuàng)建一個 source/about/me.md 文件,同時 Front Matter 中的 title 為 "About me"

注意!title 是必須指定的!如果你這么做并不能達到你的目的:

hexo new page --path about/me

此時 Hexo 會創(chuàng)建 source/_posts/about/me.md,同時 me.md 的 Front Matter 中的 title 為 "page"。這是因為在上述命令中,hexo-cli 將 page 視為指定文章的標題、并采用默認的 layout。

generate

$ hexo generate

生成靜態(tài)文件。

選項 描述
-d, --deploy 文件生成后立即部署網(wǎng)站
-w, --watch 監(jiān)視文件變動
-b, --bail 生成過程中如果發(fā)生任何未處理的異常則拋出異常
-f, --force 強制重新生成文件
Hexo 引入了差分機制,如果 public 目錄存在,那么 hexo g 只會重新生成改動的文件。
使用該參數(shù)的效果接近 hexo clean && hexo generate
-c, --concurrency 最大同時生成文件的數(shù)量,默認無限制

該命令可以簡寫為

$ hexo g

publish

$ hexo publish [layout] <filename>

發(fā)表草稿。

server

$ hexo server

啟動服務(wù)器。默認情況下,訪問網(wǎng)址為: http://localhost:4000/

選項 描述
-p, --port 重設(shè)端口
-s, --static 只使用靜態(tài)文件
-l, --log 啟動日記記錄,使用覆蓋記錄格式

deploy

$ hexo deploy

部署網(wǎng)站。

參數(shù) 描述
-g, --generate 部署之前預(yù)先生成靜態(tài)文件

該命令可以簡寫為:

$ hexo d

render

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

渲染文件。

參數(shù) 描述
-o, --output 設(shè)置輸出路徑

migrate

$ hexo migrate <type>

從其他博客系統(tǒng) 遷移內(nèi)容。

clean

$ hexo clean

清除緩存文件 (db.json) 和已生成的靜態(tài)文件 (public)。

在某些情況(尤其是更換主題后),如果發(fā)現(xiàn)您對站點的更改無論如何也不生效,您可能需要運行該命令。

list

$ hexo list <type>

列出網(wǎng)站資料。

version

$ hexo version

顯示 Hexo 版本。

選項

安全模式

$ hexo --safe

在安全模式下,不會載入插件和腳本。當您在安裝新插件遭遇問題時,可以嘗試以安全模式重新執(zhí)行。

調(diào)試模式

$ hexo --debug

在終端中顯示調(diào)試信息并記錄到 debug.log。當您碰到問題時,可以嘗試用調(diào)試模式重新執(zhí)行一次,并 提交調(diào)試信息到 GitHub。

簡潔模式

$ hexo --silent

隱藏終端信息。

自定義配置文件的路徑

# 使用 custom.yml 代替默認的 _config.yml
$ hexo server --config custom.yml

# 使用 custom.yml 和 custom2.json,其中 custom2.json 優(yōu)先級更高
$ hexo generate --config custom.yml,custom2.json,custom3.yml

自定義配置文件的路徑,指定這個參數(shù)后將不再使用默認的 _config.yml。
你可以使用一個 YAML 或 JSON 文件的路徑,也可以使用逗號分隔(無空格)的多個 YAML 或 JSON 文件的路徑。例如:

# 使用 custom.yml 代替默認的 _config.yml
$ hexo server --config custom.yml

# 使用 custom.yml, custom2.json 和 custom3.yml,其中 custom3.yml 優(yōu)先級最高,其次是 custom2.json
$ hexo generate --config custom.yml,custom2.json,custom3.yml

當你指定了多個配置文件以后,Hexo 會按順序?qū)⑦@部分配置文件合并成一個 _multiconfig.yml。如果遇到重復(fù)的配置,排在后面的文件的配置會覆蓋排在前面的文件的配置。這個原則適用于任意數(shù)量、任意深度的 YAML 和 JSON 文件。

顯示草稿

$ hexo --draft

顯示 source/_drafts 文件夾中的草稿文章。

自定義 CWD

$ hexo --cwd /path/to/cwd

自定義當前工作目錄(Current working directory)的路徑。


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號