要建立新的文章或頁面,您可以執行以下指令
$ hexo new [layout] <title> |
post
是預設的 layout
,但您可以提供自己的。您可以透過編輯 _config.yml
中的 default_layout
設定來變更預設的版面配置。
版面配置
Hexo 中有三個預設的版面配置:post
、page
和 draft
。它們建立的檔案會儲存到不同的路徑。新建立的文章會儲存到 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-marked
和 hexo-renderer-ejs
,因此您可以使用 markdown
或 ejs
撰寫文章。如果您安裝了 hexo-renderer-pug
,您甚至可以使用 pug 模板語言撰寫文章。
您可以重新命名文章並將檔案副檔名從 .md
變更為 .ejs
,然後 Hexo 將會使用 hexo-renderer-ejs
來渲染該檔案,其他格式也是如此。