文章页面

  1. 1. 文章页面
    1. 1.1. 配置路径:顶部,文章信息区 (Front-Matter)
    2. 1.2. 模板与特定页面
    3. 1.3. 书写技巧

文章页面

配置路径:顶部,文章信息区 (Front-Matter)

  • pic : 可以指定这篇文章是否使用自定义的缩略图名称(在文章资源文件夹内),而不是使用随机化的图标

  • sticky : (number)重要的文章,把它们置顶吧!数字越大优先级越高哦~

  • comments : (true/false)是否为单篇文章指定开启或关闭评论区

  • toc: (true/false)该文章是否需要生成目录

  • only: 指定文章显示的位置,有以下关键词:

    • home: 在首页显示
    • category: 在分类页显示
    • tag: 在标签页显示

    留空或是不配置此项,则文章在所有该出现的位置都会显示。
    层级之间相互平等,没有覆盖关系。

    特别地,如果配置了此项,但是使用的并不是以上的关键词(例如只留了一个- none,那么文章就被隐藏起来了)

一个完整的 Front-Matter 区样式如下(可自行删去不必要的内容):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
title: 文章标题
date: 1970-01-01 00:00:00
categories: Demo
tags:
- Tag0
- Tag1
- Tag2
sticky: 100
pic:
comments: true
toc: true
only:
- home
- category
- tag

模板与特定页面

1
2
3
4
5
6
7
8
9
---
title: {{ title }}
date: {{ date }}
categories:
tags:
pic:
comments: true
toc: true
---

书写技巧

  • 文章概要

    可以将文章开头的一段作为概要显示在首页主题部分,方法就是在需要分割的地方加入<!-- more -->即可;或者可以在文章头指定excerpt

  • 图片资源

    Hexo有为每篇文章生成一个资源文件夹,可以将图片资源以{% asset_img 文件名 备注 %}的格式插入文章,本主题引入的fancybox会自动实现对文章内图片的放大功能。