每个人的独立博客

Stellar 是一个内置文档系统的简约商务风 Hexo 主题，支持丰富的标签和动态数据组件。
源码文档在线演示
npm i hexo-theme-stellarnpx hexo config theme stellar

Stellar 是一个内置文档系统的简约商务风 Hexo 主题，提供丰富的标签与动态数据组件，帮助您从容应对各种表达需求，轻松开启全新的博客之旅。

开始前的准备工作

有 AI
没 AI

新用户无需提前通读全部文档，借助 AI 助手即可快速上手：

  1. 让 AI 了解项目：本项目配套了较为完整的 AI 知识库，AI 能更轻松、更准确地理解 Stellar。
  2. 向 AI 提出需求：安装配置、页面搭建、主题自定义等任务，都可以让 AI 结合项目文档协助完成。
  3. 遇到问题直接询问：边做边学，随时向 AI 提问，或查阅 Hexo 中文文档。

自建独立博客需要具备一些基础知识：markdown 常用语法需要掌握；此外，您还需要了解 yaml 文件格式和基本的 git 操作。如果您还没有使用过 Hexo，建议先通读一遍 Hexo 中文文档。

https://hexo.io/zh-cn/docs/https://hexo.io/zh-cn/docs/

环境要求

无论是全新安装，还是从旧版本升级、从其他主题迁移，都建议保持环境版本不低于以下要求，以免出现兼容性问题：

建议的版本
Hexo: 6.3.0 ~ latest
hexo-cli: 4.3.0 ~ latest
node: >= 22 # 建议选择 LTS 版本
npm: >= 10

安装与更新

稳定版
最新版
自定义
引用源码

安装方法

  1. 打开终端并进入博客文件夹，执行：
  1. 在 blog/_config.yml 文件中找到并修改：

更新方法

  1. 打开终端并进入博客文件夹，执行：
  1. 查看 更新日志，按说明完成迁移。
适用范围

稳定版适用于以内容创作为主，不需要自定义主题，追求稳定和可靠性的用户。

安装方法

  1. 把 Stellar 主题仓库添加为博客仓库的子模块
  1. 在 blog/_config.yml 文件中找到并修改：

更新方法

  1. 打开终端并进入主题文件夹，执行：
  1. 查看 更新日志，按说明完成迁移。
适用范围

最新版适用于希望第一时间体验新特性的用户。

安装方法

  1. 把 Stellar 主题仓库 fork 到您的 GitHub 账号下

  2. 把您 fork 的 Stellar 主题仓库添加为博客仓库的子模块

  1. 在 blog/_config.yml 文件中找到并修改：

更新方法

  1. 在您 fork 的 Stellar 主题仓库打开终端，执行：
  1. 查看 更新日志，按说明完成迁移。
适用范围

自定义版适用于对主题有自定义需求，且掌握了一定的前端知识和动手能力的用户。

安装方法

下载源码放到 themes/ 文件夹下面试用。

适用范围

仅适合测试，无法获得更新。

开始使用

安装并启用主题后，建议按以下顺序阅读文档：

主题配置页面侧边栏标签插件评论区
小提示

完整文档目录见侧边栏或页面顶部的文档目录；示例站点 展示了 Stellar 的多种玩法，更新日志 记录了每个版本的变化。

问题排查

遇到问题时，按以下顺序排查：

  1. 翻阅和搜索本系列文档
  2. 搜索 issues 中是否已经有解决办法
  3. 如果没有，新建 issue 并按照要求进行操作，详尽地描述您遇到的问题

关于 Stellar

真正的简约不止删繁就简，而是在纷繁中建立秩序。它通过克制视觉元素、突出有效信息、删除无效内容，让注意力始终落在真正重要的东西上。

支持本项目

本项目永久开源、完全免费。如果您喜欢它，不妨 点个赞 支持一下～

开源许可协议

项目中的许可声明文件应包含在所有副本中

本项目由 @xaoxuu 设计并开发，同时收录了 开源贡献者 的代码贡献，采用 MIT License 协议开源。复制、分享或基于本项目进行创作时，请遵守协议内容：

MIT License

Copyright (c) 2021 xaoxuu

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

社区分享

这里展示最新 3 篇「探索号」投稿文章

更多文章投稿
本文贡献者 编辑本文