Skip to content

基础配置

配置文件

一共有两个配置文件,一个是 Hexo 自身的配置,一个是主题专用的配置。

shell
. # Hexo 项目根目录.
├─ _config.yml # Hexo 配置文件.
└─ _config.aurora.yml # 主题配置.
. # Hexo 项目根目录.
├─ _config.yml # Hexo 配置文件.
└─ _config.aurora.yml # 主题配置.

TIP

大部分主题的功能都是使用主题配置文件的,但是有部分需要用到 Hexo 插件的就需要在 Hexo 的配置中修改。

基础配置

我们可以使用 site 来设置我们博客的主要信息和配置。

site 配置拥有以下选项:

选项接受类型使用说明
subtitleString博客自标题,页面主标题后面会跟随这个标题内容。
authorString博客作者名字,或者是博客名字。会在 header 的 logo 区域显示,也会在博客简介中显示。
nickString博客子名字,会在 header 的 logo 下方显示。
descriptionString会在博客简介中显示,用几句话描述博主相关信息(支持 HTML 标签)
languageen, cn配置默认博客语言,en 是英文,cn 是中文。
multi_languagetrue, false开启博客的多语言支持
logoStringLogo 的图片链接 image.
avatarString头像的图片链接 image.
beianObject网站备案信息 (从版本 1.1.0 开始,这个配置拥有两个属性)
started_dateString建站开始日期(用于脚步显示建站时长)格式:2023-08-08

TIP

如果每首设置 avatar 的图片链接,默认会去取 logo 的图片链接。


网站备案信息

beian 选项

选项接受类型使用说明
numberString备案编号.
linkString备案链接.

公安备案信息

police_beian 选项

选项接受类型使用说明
numberString备案编号.
linkString备案链接.

配置例子

yaml
# Site 配置
site:
  subtitle: TriDiamond's Blog
  author: 三钻
  nick: TriDiamond
  description: 一位正在重塑知识的技术人 <br /> @ <b>公众号:技术银河</b>
  language: cn
  multi_language: true
  logo: https://image-website.com/path-to-image.jpg
  avatar: https://image-website.com/path-to-image.jpg
  beian: # 如果不需要可以让 number 和 link 保持空白
    number: "123123123123"
    link: 'https://link-to-beian.com'
  police_beian:
    number: "123123123123"
    link: 'https://link-to-police-beian.com'
  started_date: 2023-08-08
# Site 配置
site:
  subtitle: TriDiamond's Blog
  author: 三钻
  nick: TriDiamond
  description: 一位正在重塑知识的技术人 <br /> @ <b>公众号:技术银河</b>
  language: cn
  multi_language: true
  logo: https://image-website.com/path-to-image.jpg
  avatar: https://image-website.com/path-to-image.jpg
  beian: # 如果不需要可以让 number 和 link 保持空白
    number: "123123123123"
    link: 'https://link-to-beian.com'
  police_beian:
    number: "123123123123"
    link: 'https://link-to-police-beian.com'
  started_date: 2023-08-08

Released under the MIT License.