Hexo指定布局
你可以执行下列命令时指定不同布局来创建一篇新文章。
1 | hexo new [layout] <title> |
你可以在命令中指定文章的布局(layout),默认为 post,可以通过修改 _config.yml 中的 default_layout 参数来指定默认布局。
新建一篇文章如果没有设置 layout 的话,默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话,请使用引号括起来。
1 | hexo new "post title with whitespace" |
布局(Layout)
Hexo 有三种默认布局:post、page 和 draft,它们分别对应不同的路径,而您自定义的其他布局和 post 相同,都将储存到 source/_posts 文件夹。
布局 | 路径 | 说明 |
---|---|---|
post | source/_posts | 默认情况下,Hexo 会将文章将保存到 source/_posts 文件夹。 |
page | source | 对于独立页面来说,Hexo 会创建一个以标题为名字的目录,并在目录中放置一个 index.md 文件。 |
draft | source/_drafts |
如果你不想你的文章被处理,你可以将 Front-Matter 中的layout: 设为 false 。
文件名称
Hexo 默认以标题作为文件名称,但您可编辑 new_post_name 参数来改变默认的文件名称,举例来说,设为 :year-:month-:day-:title.md 可让您更方便的通过日期来管理文章。
变量 | 描述 |
---|---|
:title | 标题(小写,空格将会被替换为短杠) |
:year | 建立的年份,比如, 2022 |
:month | 建立的月份(有前导零),比如, 05 |
:i_month | 建立的月份(无前导零),比如, 5 |
:day | 建立的日期(有前导零),比如, 07 |
:i_day | 建立的日期(无前导零),比如, 7 |
草稿
Hexo 的一种特殊布局:draft,这种布局在建立时会被保存到 source/_drafts 文件夹,您可通过 publish 命令将草稿移动到 source/_posts 文件夹,该命令的使用方式与 new 十分类似,您也可在命令中指定 layout 来指定布局。
1 | hexo publish [layout] <title> |
草稿默认不会显示在页面中,您可在
hexo g
执行时加上 –draft 参数,或是把 render_drafts 参数设为 true来预览草稿。
指定参数
参数 | 描述 |
---|---|
-p, –path | 自定义新文章的路径 |
-r, –replace | 如果存在同名文章,将其替换 |
-s, –slug | 文章的 Slug,作为新文章的文件名和发布后的 URL |
你可以使用 –path 参数来自行决定文件的目录:
1 | hexo new page --path about/me "About me" |
以上命令会创建一个 source/about/me.md 文件,同时 Front Matter 中的 title 为 “About me”
注意!title 是必须指定的! 例如:下面的操作并不能达到你的目的,请看示例
1 | hexo new page --path about/me |
此时 Hexo 会创建 source/_posts/about/me.md,同时 me.md 的 Front Matter 中的 title 为 “page”。 这是因为在上述命令中,hexo 将 page 视为指定文章的标题、并采用默认的 layout。