你可以执行下列命令时指定不同布局来创建一篇新文章。
|-----------|-----------------------------------|
| 1
| hexo new [layout] <title>
|
你可以在命令中指定文章的布局(layout),默认为 post,可以通过修改 _config.yml 中的 default_layout 参数来指定默认布局。
新建一篇文章如果没有设置 layout 的话,默认使用 _config.yml 中的 default_layout 参数代替。如果标题包含空格的话,请使用引号括起来。
|-----------|-----------------------------------------------|
| 1
| hexo new "post title with whitespace"
|
布局(Layout) {#布局(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。