init
初始化網站。如果沒有提供 folder
,Hexo 將會在目前目錄下建立網站。
此指令是執行下列步驟的快捷方式
- 將 hexo-starter,包含 hexo-theme-landscape,複製到目前目錄或指定資料夾。
- 使用套件管理器安裝相依套件:Yarn 1、pnpm 或 npm,以安裝的順序為優先。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
產生靜態檔案。
選項 |
說明 |
-d , --deploy |
產生完成後部署 |
-w , --watch |
監看檔案變更 |
-b , --bail |
如果在產生過程中拋出任何未處理的例外,則引發錯誤 |
-f , --force |
強制重新產生 |
-c , --concurrency |
並行產生的最大檔案數量。預設值為無限大 |
publish
$ hexo publish [layout] <filename>
|
發佈草稿。
server
啟動本機伺服器。預設情況下,網址為 https://127.0.0.1:4000/
。
選項 |
說明 |
-p , --port |
覆寫預設埠號 |
-s , --static |
僅服務靜態檔案 |
-l , --log |
啟用記錄器。覆寫記錄器格式。 |
deploy
部署您的網站。
選項 |
說明 |
-g , --generate |
部署前產生 |
render
$ hexo render <file1> [file2] ...
|
渲染檔案。
migrate
從其他部落格系統遷移內容。
clean
清除快取檔案(db.json
)和產生的檔案(public
)。
list
列出所有路由。
version
顯示版本資訊。
config
$ hexo config [key] [value]
|
列出設定(_config.yml
)。如果指定了 key
,則僅顯示設定中對應 key
的值;如果同時指定了 key
和 value
,則設定中對應 key
的值會變更為 value
。
選項
安全模式
停用載入外掛和腳本。如果在安裝新外掛後遇到問題,請嘗試此操作。
偵錯模式
將詳細訊息記錄到終端機和 debug.log
。如果您在使用 Hexo 時遇到任何問題,請嘗試此操作。如果看到錯誤,請提出 GitHub Issue。
靜音模式
靜音輸出到終端機。
自訂設定檔路徑
$ hexo --config custom.yml
|
使用自訂設定檔(而不是 _config.yml
)。也接受以逗號分隔(不含空格)的 JSON 或 YAML 設定檔清單,這些檔案將合併為單一的 _multiconfig.yml
。
$ hexo --config custom.yml,custom2.json
|
顯示草稿
顯示草稿文章(儲存在 source/_drafts
資料夾中)。
自訂 CWD
$ hexo --cwd /path/to/cwd
|
自訂目前工作目錄的路徑。