官方蓝图
Stellar Examples 维护 5 个包含真实内容、可以直接运行的蓝图,创建器与站点示例都以仓库中的 blueprints.json 为准:
| Blueprint | 示例 | 适合…… |
|---|---|---|
lightblog | 轻博客 | 只想安静写文章,不需要常驻侧栏 |
minimalblog | 极简博客 | 想要极简侧栏,把注意力留给长文和笔记 |
knowledge | 个人知识库 | 想把文章、项目资料和长期主题放在一起 |
docs | 项目文档 | 正在给一个项目维护完整文档 |
notebook | 笔记本 | 想用笔记本和标签整理零散想法与长期笔记 |
拿不准时从 lightblog 开始,其它能力等真的用到再加。蓝图是独立站点:它不会覆盖或自动升级已有站点,目录名与内容都可以自由修改。
本地运行
克隆仓库并安装一次依赖,然后用 Blueprint ID 启动对应示例:
git clone https://github.com/xaoxuu/hexo-theme-stellar-examples.git |
把 lightblog 换成上表中的 ID 即可打开其它蓝图;各示例使用独立端口,可以同时运行。
创建站点副本
交互式创建见环境与安装。需要脚本化时指定蓝图并跳过交互:
curl -fsSL https://github.com/xaoxuu/hexo-theme-stellar-examples/raw/main/install.sh | sh -s -- create my-site --blueprint=lightblog --non-interactive |
创建器需要 Node.js 22+、Git 与 npm;它会检查目标目录、展示完整计划并拒绝覆盖已有文件。Windows 使用 PowerShell 7+ 时可传入同样的参数:
& ([scriptblock]::Create((Invoke-RestMethod https://github.com/xaoxuu/hexo-theme-stellar-examples/raw/main/install.ps1))) -CliArguments @('create', 'my-site', '--blueprint=lightblog', '--non-interactive') |
社区站点
下面的站点带有各自的内容和定制,样式与 v2 默认样式不同。可以参考它们的内容组织、页面排版和定制方式。
如果也想把自己的站点放进来,可以到 Showcase 仓库提交资料。