Hexo博客Stellar主题配置

选择博客主题

看了看自己的博客已经两年没更新了，最后一篇博文的时间是2020年9月，已经差不多两年多了，这两年多有大事，喜事，哈哈开心的事，这个后面慢慢说。

准备重启博客，主题选择困难症开始，原来的那个Next主题想换换，然后奈何自己能力有限，自己写不出来，不过在翻官方的主题时候发现了Stellar主题，相当不错，迫不及待要尝试一下。

安装主题

主题的网站：https://xaoxuu.com/wiki/stellar/#start ，肯定选用最新版，新特性要用起来，作者给出的方法是在博客目录下添加主题子模块，不过我这边因为博客目录不是git目录没有成功，我是直接用的克隆的方法。

1
2
3
4

cd themes				# 进入主题目录
git clone https://github.com/xaoxuu/hexo-theme-stellar.git stellar			# 把主题克隆下来
# 修改博客目录下_config.yml中主题为 stellar
theme: stellar

主题的基本配置

这个主题的复杂程度和可定制性超出了我的预想，大部分主题都是简单更改一些文字和图片即可搞定，但是这个主题具有post、wiki两种大类型，同时还能够定制组件。

因为之前没有相应的经验，根据文档摸索了很久，下面是自己的一些摸索和理解，记录备忘。

站点配置

配置文档地址：https://xaoxuu.com/wiki/stellar/theme-settings/

这个比较简单，主要是站点的标题、副标题、logo、博客的简介、语言支持等（参照官方文档即可操作）配置文件是blog根目录下的 _config.yml 文件

1
2
3
4
5
6
7
8

title: 您的网站名称
avatar: 您的头像链接    # 配置如果文件中没有自行添加
favicon: 您的网站icon
# 多语言
language:
  - zh-CN
  - en
  - zh-TW

主题配置

在blog的根目录下创建一个主题配置文件 _config.stellar.yml，跟hexo站点配置文件 _config.yml 在同一个层级下。

Open Graph 头部标签自定义

在分享时能够让你的博客链接显示更好看，建议打开

1
2
3
4

# 在 _config.stellar.yml 文件中
open_graph:
  enable: true
  twitter_id: # for open_graph meta

文章配置

文章分类

我个人一般习惯每篇文章就一个分类，不过主题支持一篇文章多个分类，不过不建议这样操作。原因如下：

1
2
3
4
5
6
7
8
9
10
11

# 我新建了两篇文章
# 第一篇的分类
---
categories: [设计开发, ios] 
---
# 第二篇的分类
---
categories: ios
---
# 注意当你查看分类时会发现有两个ios分类，并不是一个
# 点击ios分类并不会出现两篇文章

文章标签

标签两种设置方法都可以，看自己的习惯了

1
2
3
4
5
6
7
8
9

---
tags: [iOS, 心率]
---
# 标签重复没有问题
---
tags: 
  - iOS
  - 心率
---

参考资料

参考资料之前一般都习惯放在最后面，不过在stellar主题中，参考资料需要放在frontmatter中，但是显示在文章的最后，格式很漂亮。（当然也可以放在最后用普通的markdown标记）

1
2
3
4
5
6
7
8

---
references:
  - title: '心跳之旅—💗—iOS用手机摄像头检测心率(PPG)'
    url: https://punmy.cn/2016/07/28/15231176397746.html
  - title: 'PPG光电容积脉搏波描记法技术概况'
    url: https://www.jianshu.com/p/695c131abfa5
  ...
---

不过后来想想也是符合习惯的，当准备写文章的时候，基本参考资料也就定了，可以直接写上。

独立页面

这个你可以用命令 hexo new page about 这种方式来新建关于页面，然后配置侧边栏以后就能看到。也可以直接source目录中新建，这里注意一般使用index.md来作为栏目的首页。

侧边栏配置

很多博客配置完上面的内容基本就差不多了，但是这个主题才刚刚开始，更刺激的还在后面。

侧边栏的配置，主要就是组件的配置，作者开发了很多小组件，然后不同的页面使用者可以按需配置。

组件配置

想启用的组件需要单独写一个配置文件，位置在 source/_data/widgets.yml 在这个文件中配置组件，然后才能在博客的页面中使用。

文档系统

重要的是文档系统，这里面才能够让你的博客能够有多个项目和页面，刚开始我一直郁闷的就是这个地方。

文档系统主要是wiki，在博客的 source 目录下新建一个wiki目录，然后把所有的项目放在里面，每个项目单独一个目录，然后在目录里面进行内容编写，因为每个项目不可能只有一个md文件，所以需要在 _data 目录下新建一个项目配置文件 projects.yml 这样就能够对每个项目进行具体的配置。

后面的配置就不写了，因为这个主题的配置内容较多，还是建议直接看官方文档，写的非常详细，这里就不再多说了。