要创建新的文章或页面,你可以运行以下命令
$ hexo new [layout] <title> |
post 是默认的 layout,但你可以提供自己的。你可以通过编辑 _config.yml 中的 default_layout 设置来更改默认布局。
布局
Hexo 中有三个默认布局:post、page 和 draft。每个布局创建的文件都保存到不同的路径。新创建的文章将保存到 source/_posts 文件夹中。
| 布局 | 路径 |
|---|---|
post |
source/_posts |
page |
source |
draft |
source/_drafts |
禁用布局如果你不想用主题处理文章(文章/页面),请在其前置文件中设置
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 来渲染该文件,其他格式也是如此。