$ hexo init [folder]
新建一個網(wǎng)站。如果沒有設(shè)置 folder
,Hexo 默認(rèn)在目前的文件夾建立網(wǎng)站。
This command is a shortcut that runs the following steps:
$ hexo new [layout] <title>
新建一篇文章。如果沒有設(shè)置 layout
的話,默認(rèn)使用 _config.yml 中的 default_layout
參數(shù)代替。如果標(biāo)題包含空格的話,請使用引號括起來。
$ hexo new "post title with whitespace"
參數(shù) | 描述 |
---|---|
-p , --path
|
自定義新文章的路徑 |
-r , --replace
|
如果存在同名文章,將其替換 |
-s , --slug
|
文章的 Slug,作為新文章的文件名和發(fā)布后的 URL |
默認(rèn)情況下,Hexo 會使用文章的標(biāo)題來決定文章文件的路徑。對于獨(dú)立頁面來說,Hexo 會創(chuàng)建一個以標(biāo)題為名字的目錄,并在目錄中放置一個 index.md
文件。你可以使用 --path
參數(shù)來覆蓋上述行為、自行決定文件的目錄:
hexo new page --path about/me "About me"
以上命令會創(chuàng)建一個 source/about/me.md
文件,同時 Front Matter 中的 title 為 "About me"
注意!title 是必須指定的!如果你這么做并不能達(dá)到你的目的:
hexo new page --path about/me
此時 Hexo 會創(chuàng)建 source/_posts/about/me.md
,同時 me.md
的 Front Matter 中的 title 為 "page"
。這是因為在上述命令中,hexo-cli 將 page
視為指定文章的標(biāo)題、并采用默認(rèn)的 layout
。
$ hexo generate
生成靜態(tài)文件。
選項 | 描述 |
---|---|
-d , --deploy
|
文件生成后立即部署網(wǎng)站 |
-w , --watch
|
監(jiān)視文件變動 |
-b , --bail
|
生成過程中如果發(fā)生任何未處理的異常則拋出異常 |
-f , --force
|
強(qiáng)制重新生成文件
Hexo 引入了差分機(jī)制,如果 public 目錄存在,那么 hexo g 只會重新生成改動的文件。
使用該參數(shù)的效果接近 hexo clean && hexo generate
|
-c , --concurrency
|
最大同時生成文件的數(shù)量,默認(rèn)無限制 |
該命令可以簡寫為
$ hexo g
$ hexo publish [layout] <filename>
發(fā)表草稿。
$ hexo server
啟動服務(wù)器。默認(rèn)情況下,訪問網(wǎng)址為: http://localhost:4000/
。
選項 | 描述 |
---|---|
-p , --port
|
重設(shè)端口 |
-s , --static
|
只使用靜態(tài)文件 |
-l , --log
|
啟動日記記錄,使用覆蓋記錄格式 |
$ hexo deploy
部署網(wǎng)站。
參數(shù) | 描述 |
---|---|
-g , --generate
|
部署之前預(yù)先生成靜態(tài)文件 |
該命令可以簡寫為:
$ hexo d
$ hexo render <file1> [file2] ...
渲染文件。
參數(shù) | 描述 |
---|---|
-o , --output
|
設(shè)置輸出路徑 |
$ hexo migrate <type>
從其他博客系統(tǒng) 遷移內(nèi)容。
$ hexo clean
清除緩存文件 (db.json
) 和已生成的靜態(tài)文件 (public
)。
在某些情況(尤其是更換主題后),如果發(fā)現(xiàn)您對站點的更改無論如何也不生效,您可能需要運(yùn)行該命令。
$ hexo list <type>
列出網(wǎng)站資料。
$ hexo version
顯示 Hexo 版本。
$ hexo --safe
在安全模式下,不會載入插件和腳本。當(dāng)您在安裝新插件遭遇問題時,可以嘗試以安全模式重新執(zhí)行。
$ hexo --debug
在終端中顯示調(diào)試信息并記錄到 debug.log
。當(dāng)您碰到問題時,可以嘗試用調(diào)試模式重新執(zhí)行一次,并 提交調(diào)試信息到 GitHub。
$ hexo --silent
隱藏終端信息。
# 使用 custom.yml 代替默認(rèn)的 _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ù)后將不再使用默認(rèn)的 _config.yml
。
你可以使用一個 YAML 或 JSON 文件的路徑,也可以使用逗號分隔(無空格)的多個 YAML 或 JSON 文件的路徑。例如:
# 使用 custom.yml 代替默認(rèn)的 _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
當(dāng)你指定了多個配置文件以后,Hexo 會按順序?qū)⑦@部分配置文件合并成一個 _multiconfig.yml
。如果遇到重復(fù)的配置,排在后面的文件的配置會覆蓋排在前面的文件的配置。這個原則適用于任意數(shù)量、任意深度的 YAML 和 JSON 文件。
$ hexo --draft
顯示 source/_drafts
文件夾中的草稿文章。
$ hexo --cwd /path/to/cwd
自定義當(dāng)前工作目錄(Current working directory)的路徑。
更多建議: