写作

要创建新的文章或页面,你可以运行以下命令

$ hexo new [layout] <title>

post 是默认的 layout,但你可以提供自己的。你可以通过编辑 _config.yml 中的 default_layout 设置来更改默认布局。

布局

Hexo 中有三个默认布局:postpagedraft。每个布局创建的文件都保存到不同的路径。新创建的文章将保存到 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-markedhexo-renderer-ejs,因此你可以用 markdownejs 编写文章。如果你安装了 hexo-renderer-pug,那么你甚至可以用 pug 模板语言编写文章。

你可以重命名文章并从 .md 更改文件扩展名到 .ejs,然后 Hexo 将使用 hexo-renderer-ejs 来渲染该文件,其他格式也是如此。