LOADING

页面加载中...

HEXO-教程-3|文章小技巧

信息

教你从零开始搭建个人博客
—-以HEXO的Particlexf主题为例
Part III

本文将要介绍 HEXO 博客的一些文章小技巧,以及 ParticleXF 主题的一些特色功能。

转自ParticleXF-demo

创建文章

在博客目录下,使用以下命令创建文章:

$ 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 中添加 tagscategories 字段,用于设置文章的标签和分类。

其中 tagscategories 字段都可以设置多个值,格式如下:

---
tags:
    - hexo
    - tutorial
categories:
    - Tutorial
---

文章描述/缩略

其实 ParticleXF 主题是没有自动缩略的,也就是说,如果你没有加额外的限制,那么首页的文章列表将会显示整篇文章的内容。

添加描述/缩略有两种方式:

description 字段

在文章的 front-matter 中添加 description 字段,用于设置文章的描述。内容支持 Markdown 格式的内容。

---
description: 这是一篇关于 HEXO 博客的一些文章小技巧,以及 ParticleXF 主题的一些特色功能的教程。
---
注意

description字段内如果要使用Markdown,有以下注意事项:

  1. 不要使用 ---,否则会被 Hexo 解析为 front-matter 的结束标记
  2. 最好不要写多行内容
  3. 如果开头是代码块,要在description: 后面写 |,否则会报错
---
description: |
    这是一篇关于 `HEXO` 博客的一些文章小技巧,以及 ParticleXF 主题的一些特色功能的教程。
---

more 标签

<!-- more --> 可以让文章在首页只显示 <!-- more --> 之前的内容,<!-- more --> 之后的内容将会在文章详情页显示。

文章置顶

front-matter 中添加 pinned 字段,值为整数,用于设置文章的置顶顺序,值越大,文章越靠前。

---
pinned: 1
---

评论与TOC

在 ParticleXF 主题中,文章页最右侧有一个目录区域,这就是 TOC(Table of Contents)

提示

TOC 底部的 评论 按钮在评论未启用时会变成 底部 按钮

文章的评论和 TOC 是可以单独设置的。

front-matter 中添加 toccomments 字段,用于设置文章是否显示目录和评论。

提示

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|部署