本文介绍如何在 Hexo 博客中添加一篇文章,以及文章的配置。
创建文章
执行下面的命令创建一篇文章:
$ hexo new [layout] <title>
您可以在命令中指定文章的布局(layout),默认为 post
,可以通过修改 _config.yml
中的 default_layout
参数来指定默认布局。
例如,以下命令用于创建一篇文件名为 “lesson-1” 的文章:
$ hexo new lesson-1
以上命令将在站点根目录的 source\_posts
目录下创建一个 lesson-1.md
的文件。
Front-matter
Front-matter 是文件最上方以 ---
分隔的区域,用于指定个别文件的变量,如下所示:
---
title: Hello World
date: 2022/5/16 20:46:25
---
以下是预先定义的参数,您可在模板中使用这些参数值并加以利用。
参数 | 描述 | 默认值 |
---|---|---|
layout |
布局 | config.default_layout |
title |
标题 | 文章的文件名 |
date |
建立日期 | 文件建立日期 |
updated |
更新日期 | 文件更新日期 |
comments |
开启文章的评论功能 | true |
tags |
标签(不适用于分页) | |
categories |
分类(不适用于分页) | |
permalink |
覆盖文章网址 | |
excerpt |
文章的摘要 |
分类和标签
只有文章支持分类和标签,您可以在 Front-matter 中设置。在其他系统中,分类和标签听起来很接近,但是在 Hexo 中两者有着明显的差别:分类具有顺序性和层次性,而标签没有顺序和层次。
分类和标签的添加如下:
categories:
- 分类1
tags:
- 标签1
- 标签2
Hexo 不支持指定多个同级分类。下面的指定方法会使分类 分类2
成为 分类1
的子分类,而不是并列分类。因此,有必要为您的文章选择尽可能准确的分类。
categories:
- 分类1
- 分类2
如果你需要为文章添加多个分类,可以尝试以下 list 中的方法。
categories:
- [分类1, 分类1-1]
- [分类1, 分类1-2]
- [分类2]
此时这篇文章同时包括二个分类: 分类1-1
和 分类1-2
分别都是父分类 分类1
的子分类,同时 分类2
是一个没有子分类的分类。
注:默认情况下,新创建的文章是没有 categories 和 tags 的,我们可以在根目录下的 scaffolds\post.md
文件添加如下代码,这样每次新建文章,就自动有了这两个参数。
title: {
{ title }}
date: {
{ date }}
tags:
categories:
文章摘要
如果没有设置摘要,首页将显示文章全部内容。摘要可以控制文章在首页显示的内容。
有两种设置摘要的方法。
方法一:写摘要
在文章的 front-matter
中添加 excerpt
,其中 excerpt
中的内容就会被显示在首页上。如:
---
title: Hello World
date: 2022/5/16 20:46:25
excerpt: 这是摘要...
---
方法二:文章截断
在文章中需要截断的地方加入:
<!--more-->
首页就会显示这条指令以上的所有内容,隐藏接下来的所有内容。
以上就是在 Hexo 博客中创建文章,以及对文章分类、标签和摘要的配置。