教你从零开始搭建个人博客
—-以HEXO的Particlexf主题为例Part III
本文将要介绍 HEXO 博客的一些文章小技巧,以及 ParticleXF 主题的一些特色功能。
创建文章
在博客目录下,使用以下命令创建文章:
$ hexo new "My New Post"
当然,你也可以手动创建一个 Markdown 文件,并将其放在 source/_posts/ 目录下。
命令接受的是一个字符串参数,作为文章的标题。你可以使用中文、英文或其他语言的字符。
引号是不必须的,但是当标题中包含空格或特殊字符时,建议加上引号以防止解析错误。
标题如果包含了空格或特殊字符,Hexo 会将其转换为 -,作为文章的文件名。
此时,source/_posts/ 目录下会生成一个名为 my-new-post.md 的文件。
命令生成的文件是以 scaffolds 模板生成的,里面包含了文章的 front-matter 和一些默认内容。
如果你想自定义文章模板,可以在博客目录下的 scaffolds 目录中找到 post.md 文件,并进行修改。
Markdown
由于 Markdown 是非常基础的知识,这里不再赘述。你可以上网搜索相关的 Markdown 教程。
HEXO 的 Markdown 是支持内嵌 HTML 语法的,这意味着你可以在 Markdown 中直接使用 HTML 标签。
Tag 与 Category
在文章的 front-matter 中添加 tags 和 categories 字段,用于设置文章的标签和分类。
其中 tags 和 categories 字段都可以设置多个值,格式如下:
---
tags:
- hexo
- tutorial
categories:
- Tutorial
---
文章描述/缩略
其实 ParticleXF 主题是没有自动缩略的,也就是说,如果你没有加额外的限制,那么首页的文章列表将会显示整篇文章的内容。
添加描述/缩略有两种方式:
description 字段
在文章的 front-matter 中添加 description 字段,用于设置文章的描述。内容支持 Markdown 格式的内容。
---
description: 这是一篇关于 HEXO 博客的一些文章小技巧,以及 ParticleXF 主题的一些特色功能的教程。
---
description字段内如果要使用Markdown,有以下注意事项:
- 不要使用
---,否则会被 Hexo 解析为 front-matter 的结束标记 - 最好不要写多行内容
- 如果开头是代码块,要在
description:后面写|,否则会报错
---
description: |
这是一篇关于 `HEXO` 博客的一些文章小技巧,以及 ParticleXF 主题的一些特色功能的教程。
---
more 标签
<!-- more --> 可以让文章在首页只显示 <!-- more --> 之前的内容,<!-- more --> 之后的内容将会在文章详情页显示。
文章置顶
在 front-matter 中添加 pinned 字段,值为整数,用于设置文章的置顶顺序,值越大,文章越靠前。
---
pinned: 1
---
评论与TOC
在 ParticleXF 主题中,文章页最右侧有一个目录区域,这就是 TOC(Table of Contents)。
TOC 底部的 评论 按钮在评论未启用时会变成 底部 按钮
文章的评论和 TOC 是可以单独设置的。
在 front-matter 中添加 toc 和 comments 字段,用于设置文章是否显示目录和评论。
comments 字段在 about 页面也是可用的。
---
toc: false
comments: false
---
Note 提示框
Note 提示框是 ParticleXF 主题提供的一个特色功能,可以在文章中添加一些提示信息。
写法
{% note tip %}
正文,支持 **Markdown**。
{% endnote %}
{% note warning 自定义标题 %}
……
{% endnote %}
{% note danger no-icon %}
不显示图标。
{% endnote %}
类型一览
默认 / note:一般说明。
info:补充信息。
tip:技巧与建议。
success:完成、正确路径。
warning:需要注意的点。
danger:风险、错误、破坏性操作。
quote:引用式强调。
no-icon:不显示左侧图标(任意类型都可加)。
上一篇教程:HEXO-教程-2|主题与页面
下一篇教程:HEXO-教程-4|部署