缘起

最近,无意中看到一个博客主题:hexo-theme-stellar ,第一眼就被它优雅的设计所吸引。随后我仔细阅读了它的使用文档和一些实际案例,越发觉得它强大而富有美感,尤其触动我的是文档中的一句话:

真正的简约远不止删繁就简,而是在纷繁中建立秩序

这句话彻底动摇了我之前一直追求的极简主义理念,之前我使用的是hexo-theme-A4,它确实非常简洁,但在功能和内容组织上略显单一。而 Stellar 不仅外观现代,还内置了丰富的模块和组件,支持博客、知识库、专栏、笔记等多种内容形式,真正做到了“简约而不简单”。
于是我决定动手试一试。按照官方文档,我把感兴趣的配置都体验了一遍后,经过几个小时冷静思考,决定当晚就把博客迁移到Stellar,并借此机会好好梳理一下自己的建站历程——毕竟之前尝试过不少博客平台和主题,却一直没有系统的记录,有些细节已经模糊甚至遗忘了。

了解Stellar

  • 项目说明:由作者xaoxuu开发,基于hexo的综合性主题,同时具备博客+知识库+专栏+笔记的能力,且内置海量的标签组件和动态数据组件
  • 项目源码地址: 点击前往
  • 主题使用与配置文档:点击前往
  • 配置教程仓库:点击前往

使用要求说明

  1. 安装node:建议版本 14.17.3 ~ latest
  2. 安装npm:建议版本6.14.13 ~ latest
  3. 安装hexo:建议版本6.3.0 ~ latest
  4. 安装hexo-cli:建议版本4.3.0 ~ latest

使用与配置stellar

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# hexo init <folder>
hexo init blogsite

cd blogsite
git init

# 安装最新主题
git submodule add https://github.com/xaoxuu/hexo-theme-stellar.git themes/stellar

# 安装依赖
npm install

# 如果安装依赖有报错,执行下列命令后在重新安装依赖
npm cache clean --force
rm -rf node_modules

# 配置主题,在 blog/_config.yml 文件中找到并修改:
theme: stellar

# 创建stellar主题的配置文件
touch _config.stellar.yml

# 启动
hexo s
# 或
hexo clean && hexo generate && hexo server
# 或
hexo c && hexo g && hexo s

stellar常用进阶配置

ront-matter 全部字段索引

表达类标签组件

数据类标签组件

容器类标签组件

Markdown常用语法

博客发布流程

我采用Github + CI 的自动化发布方式:

  • 私有仓库 blogsite:存放 Hexo 源码,并设置 GitHub Actions 工作流
  • 公开仓库 sswfive.github.io:存放生成的静态页面,用于 GitHub Pages 展示
    撰写新文章后,推送至私有仓库触发 CI 流程(如 GitHub Actions),自动构建并发布到公开仓库,即可通过 https://sswfive.github.io 访问。

核心配置步骤

  1. 生成部署密钥对
    • 将生成的 github-actions-deploy.pub 内容添加到公开仓库的 Deploy Keys(勾选允许写入)
    • 将 github-actions-deploy 私钥内容添加到私有仓库的 Secrets,命名为 DEPLOY_PRIVATE_KEY
1
ssh-keygen -t rsa -b 4096 -C "your_email@example.com" -f github-actions-deploy
  1. 创建 GitHub Actions 工作流文件
    • 在私有仓库创建 .github/workflows/deploy.yml

本站由 sswfive 使用 Stellar 1.33.1 主题创建。
本博客所有文章除特别声明外,均采用 CC BY-NC-SA 4.0 许可协议,转载请注明出处。

本站总访问量