撰寫

要建立新的文章或頁面,您可以執行以下指令

$ hexo new [layout] <title>

post 是預設的 layout,但您可以提供自己的。您可以透過編輯 _config.yml 中的 default_layout 設定來變更預設的版面配置。

版面配置

Hexo 中有三個預設的版面配置:postpagedraft。它們建立的檔案會儲存到不同的路徑。新建立的文章會儲存到 source/_posts 資料夾。

版面配置 路徑
post source/_posts
page source
draft source/_drafts
停用版面配置

如果您不希望文章(post/page)被佈景主題處理,請在其 front-matter 中設定 layout: false。請參考此章節以了解更多詳細資訊。

檔案名稱

預設情況下,Hexo 會使用文章標題作為其檔案名稱。您可以編輯 _config.yml 中的 new_post_name 設定來變更預設的檔案名稱。例如,:year-:month-:day-:title.md 將會在檔案名稱前加上文章建立日期。您可以使用以下佔位符

佔位符 描述
:title 文章標題 (小寫,空格替換為連字符號)
:year 建立年份,例如 2015
:month 建立月份 (帶前導零),例如 04
:i_month 建立月份 (不帶前導零),例如 4
:day 建立日期 (帶前導零),例如 07
:i_day 建立日期 (不帶前導零),例如 7

草稿

先前,我們提到 Hexo 中的一個特殊版面配置:draft。使用此版面配置初始化的文章會儲存到 source/_drafts 資料夾。您可以使用 publish 指令將草稿移動到 source/_posts 資料夾。publish 的運作方式與 new 指令類似。

$ hexo publish [layout] <title>

草稿預設不會顯示。您可以在執行 Hexo 時新增 --draft 選項,或啟用 _config.yml 中的 render_drafts 設定來渲染草稿。

骨架

建立文章時,Hexo 將會根據 scaffolds 資料夾中對應的檔案來建立檔案。例如

$ hexo new photo "My Gallery"

當您執行此指令時,Hexo 會嘗試在 scaffolds 資料夾中尋找 photo.md,並依據其建立文章。以下佔位符可在骨架中使用

佔位符 描述
layout 版面配置
title 標題
date 檔案建立日期

支援的格式

只要安裝了對應的渲染器外掛程式,Hexo 就支援以任何格式撰寫的文章。

例如,Hexo 預設安裝了 hexo-renderer-markedhexo-renderer-ejs,因此您可以使用 markdownejs 撰寫文章。如果您安裝了 hexo-renderer-pug,您甚至可以使用 pug 模板語言撰寫文章。

您可以重新命名文章並將檔案副檔名從 .md 變更為 .ejs,然後 Hexo 將會使用 hexo-renderer-ejs 來渲染該檔案,其他格式也是如此。