加载中...
主题介绍-文章Front-matter
发表于:2021-10-25 | 分类: 本站介绍
字数统计: 825 | 阅读时长: 3分钟 | 阅读量:

文章 Front-matter 介绍

这个指的是你在你的文章页面里面写的参数,针对的是这一篇文章,例如

---
title: Hexo主题--Bamboo介绍
date: 2021-10-24 14:06
swiper: true # 将改文章放入轮播图中
swiperImg: '/medias/1.jpg' # 该文章在轮播图中的图片,可以是本地目录下图片也可以是http://xxx图片
img: '/medias/1.jpg' # 该文章图片,可以是本地目录下图片也可以是http://xxx图片
categories: 前端
tags: [Hexo, hexo-theme-bamboo]
top: true

---

Front-matter 选项中的所有内容均为非必填的。但我仍然建议至少填写 titledate 的值。

配置选项 默认值 描述
title Markdown 的文件标题 文章标题,强烈建议填写此选项
date 文件创建时的日期时间 发布时间,强烈建议填写此选项,且最好保证全局唯一
author Fengqi 文章作者,没有设置默认是Fengqi
categories 文章分类,本主题的分类表示宏观上大的分类,只建议一篇文章一个分类
tags 文章标签,一篇文章可以多个标签
top false 将该值设为true,则将该篇文章显示在首页的置顶栏目中
toc true 将该值设为false,则该篇文章不显示右侧目录
tocOpen true 将该值设为false,则该篇文章右侧目录默认收缩
onlyTitle false 文章详情页头部是否只显示标题,不显示日期等信息
excerpt 文章描述(摘要),该文章在首页的描述文字,如果没有,则取swiperDesc,如果swiperDesc也没有,则取文章内容(优先取 <!-- more --> "上面的内容)
swiper false 表示该文章是否需要加入到首页轮播封面中
swiperImg 表示该文章在首页轮播封面需要显示的图片路径,如果没有,则默认使用文章的特色图片
swiperDesc 表示该文章在首页轮播封面需要显示的文字描述(摘要),如果没有,则使用excerpt,如果excerpt也没有,则取文章内容
img 文章特征图,该文章显示的图片,没有则默认使用文章的特色图片
bgImg - 单独为这篇文章设置背景图片或者背景颜色,可以是数组,数组里面放图片链接,可以是字符串,字符串里面是颜色值,空值则背景颜色透明
bgImgTransition fade 该篇文章的bgImg设置为数组,该值表示背景图片切换的动画, 有三种值(fade, scale, translate-fade)
bgImgDelay 180000(三分钟) 该篇文章的bgImg设置为数组,该值表示背景图片切换的延迟时间
comments true 将该值设为false,则该篇文章不显示评论
share true 将该值设为false,则该篇文章不显示分享按钮
copyright true 将该值设为false,则该篇文章不显示版权声明
donate true 将该值设为false,则该篇文章不显示打赏按钮
prismjs 如果使用的是hexo自带的prismjs代码高亮,通过设置该值为该篇文章设置不同的代码高亮主题(default, coy, dark, funky, okaidia, solarizedlight, tomorrow, twilight)
mathjax false mathjax公式

以上基本就是所有的配置项了

上一篇:
主题介绍-侧边栏功能
下一篇:
主题介绍-媒体文件书写功能
本文目录
本文目录