README.md

September 18, 2026 · View on GitHub

Stellar

每个人的独立博客

基于 Hexo 的全能个人知识库，开箱即用，内置海量标签和动态数据组件。可用于个人博客、项目文档、知识库、专栏、笔记等。

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

从普通文章开始。项目需要稳定的文档目录时，用 Wiki；文章逐渐形成系列时，收进专栏；零散知识需要长期积累时，放进笔记本。它们共享同一套导航、搜索、侧栏与阅读体验，没有启用的内容系统不会增加额外负担。

从外观预设、配色和字体，到分栏、选项卡、折叠块与图库，站点的样子和内容的表达方式都可以按需组合。本地搜索可以直接定位到相关章节，响应式布局会在窄屏上把主要空间留给正文。

手写内容沉淀观点，外部数据保持新鲜。远程内容、社区数据和外部服务可以按需加载，与静态正文保持解耦；经常变化的数据不必每次都随整站重新生成。

Stellar Examples 提供可以直接运行的示例站，适合先体验接近自己目标的站点，再逐步替换内容与配置。更多真实站点见站点示例。

准备好 Git 和 npm 后，一条命令即可启动交互式蓝图安装器：

macOS / Linux：

sh -c "$(curl -fsSL https://github.com/xaoxuu/hexo-theme-stellar-examples/raw/main/install.sh)"

Windows PowerShell 7+（pwsh）：

& ([scriptblock]::Create((Invoke-RestMethod https://github.com/xaoxuu/hexo-theme-stellar-examples/raw/main/install.ps1)))

安装器会读取示例仓库的 blueprints.json，展示当前可用的蓝图，并依次确认蓝图、项目目录、依赖安装和创建计划。

在博客根目录安装 npm 当前提供的默认版本，并确认实际安装结果：

npm install hexo-theme-stellar
npm ls hexo-theme-stellar

将官方仓库的 main 分支添加为子模块，并安装主题自身的依赖：

git submodule add -b main https://github.com/xaoxuu/hexo-theme-stellar.git themes/stellar
npm install --prefix themes/stellar

在博客 _config.yml 中启用主题：

theme: stellar

然后运行 Doctor 并生成站点：

npx hexo stellar doctor
npx hexo generate