hexo-theme-stellar 2.0.0-rc.1 → 2.0.0-rc.2

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 2.0.0-rc.2
+
+> 发布日期：2026-09-07
+
+本节记录从公开候选 `2.0.0-rc.1` 到 `2.0.0-rc.2` 最终文件树的净变化。
+
+### 新功能
+
+- Notebook 列表、设置页与错误页的专属配置统一收敛到 `profiles`；404 页新增默认关闭的评论区，可独立覆盖标题、线程、Provider 与参数。
+- 可信页面注入补全 `head_begin/head_end/body_begin/body_end` 四个位置，站点主题配置与页面 Front Matter 使用同一合并顺序和原样输出语义。
+
+### 修复与工程变化
+
+- 将 `hexo-front-matter` 声明为主题直接依赖，避免源码配置与 `stellar new note` 依赖 Hexo 宿主的传递依赖。
+- 重构中英文 README，明确 npm、源码与 Blueprint 三种安装入口，并补充随 npm 包分发的 Stellar 图标、项目描述、关键词和作者元数据。
+
+### 升级注意（配置变更与破坏性改动）
+
+- 从 RC1 升级时，将顶层 `notebook` 移到 `profiles.notebook`，将 `settings.about` 移到 `profiles.settings.about`，将 `error_page.image` 移到 `profiles.error.image`。
+- `profiles.notebook_index` 更名为 `profiles.notebooks`，`profiles.note_index` 更名为 `profiles.notebook`；Note 内容页继续使用 `profiles.note`。
+- `inject` 内容会作为可信 HTML 原样输出；只应配置维护者完全信任的内容，站点级内容在前、页面 Front Matter 在后。
+
+Full Changelog: [2.0.0-rc.1...2.0.0-rc.2](https://github.com/xaoxuu/hexo-theme-stellar/compare/2.0.0-rc.1...2.0.0-rc.2)
+
 ## 2.0.0-rc.1
 
 > 发布日期：2026-09-07

package/README.md

@@ -1,81 +1,87 @@
-# Stellar - 每个人的独立博客
+<div align="center">
+  <img src="assets/icon-v2-x512.webp" width="160" alt="Stellar">
+  <h1>Stellar</h1>
+  <p>每个人的独立博客</p>
+  <p>基于 Hexo 的全能个人知识库，开箱即用，内置海量标签和动态数据组件。可用于个人博客、项目文档、知识库、专栏、笔记等。</p>
+  <p><a href="README.md">简体中文</a> · <a href="README_EN.md">English</a></p>
+  <p>
+    <a href="https://github.com/xaoxuu/hexo-theme-stellar/releases"><img src="https://img.shields.io/github/v/release/xaoxuu/hexo-theme-stellar" alt="release"></a>
+    <a href="https://www.npmjs.com/package/hexo-theme-stellar"><img src="https://img.shields.io/npm/v/hexo-theme-stellar" alt="npm"></a>
+    <a href="https://www.npmjs.com/package/hexo-theme-stellar"><img src="https://img.shields.io/npm/dm/hexo-theme-stellar" alt="npm downloads"></a>
+    <a href="https://github.com/xaoxuu/hexo-theme-stellar"><img src="https://img.shields.io/github/stars/xaoxuu/hexo-theme-stellar" alt="stars"></a>
+    <a href="LICENSE"><img src="https://img.shields.io/github/license/xaoxuu/hexo-theme-stellar" alt="license"></a>
+  </p>
+  <p>
+    <a href="https://xaoxuu.com/wiki/stellar/start/install/">创建第一个博客</a> ·
+    <a href="https://xaoxuu.com/wiki/stellar/support/examples/">站点示例</a> ·
+    <a href="https://xaoxuu.com/wiki/stellar/">完整文档</a>
+  </p>
+</div>
 
-[简体中文](README.md) · [English](README_EN.md)
+## 在纷繁中建立秩序
 
-一个博客，也是一套可以长期生长的内容系统。
+> 真正的简约不止删繁就简，而是在纷繁中建立秩序。
 
-从一篇文章开始。以后想加项目文档、专栏或笔记，仍然在同一个站点里写。
+### 完善的内容组织体系
 
-[创建第一个博客](https://xaoxuu.com/wiki/stellar/start/install/) · [蓝图与展示墙](https://xaoxuu.com/wiki/stellar/support/examples/) · [完整文档](https://xaoxuu.com/wiki/stellar/)
+从普通文章开始。项目需要稳定的文档目录时，用 Wiki；文章逐渐形成系列时，收进专栏；零散知识需要长期积累时，放进笔记本。它们共享同一套导航、搜索、侧栏与阅读体验，没有启用的内容系统不会增加额外负担。
 
-> Stellar v2 当前版本为 `2.0.0-rc.1`；是否已经公开发布，以 npm 页面和 GitHub Releases 为准。
+### 灵活的排版与表达方式
 
-[![npm](https://img.shields.io/npm/v/hexo-theme-stellar)](https://www.npmjs.com/package/hexo-theme-stellar)
-[![license](https://img.shields.io/github/license/xaoxuu/hexo-theme-stellar)](https://github.com/xaoxuu/hexo-theme-stellar/blob/main/LICENSE)
-[![stars](https://img.shields.io/github/stars/xaoxuu/hexo-theme-stellar)](https://github.com/xaoxuu/hexo-theme-stellar)
-[![npm downloads](https://img.shields.io/npm/dm/hexo-theme-stellar)](https://www.npmjs.com/package/hexo-theme-stellar)
-[![release](https://img.shields.io/github/v/release/xaoxuu/hexo-theme-stellar)](https://github.com/xaoxuu/hexo-theme-stellar/releases)
+从外观预设、配色和字体，到分栏、选项卡、折叠块与图库，站点的样子和内容的表达方式都可以按需组合。本地搜索可以直接定位到相关章节，响应式布局会在窄屏上把主要空间留给正文。
 
-## 内容多起来，也不用推倒重来
+### 静态页面，也能常看常新
 
-普通文章照常发布。项目需要一套稳定目录时，用 Wiki；几篇文章写成了系列，收进专栏；零散知识想长期补充，放进笔记本。
+手写内容沉淀观点，外部数据保持新鲜。远程内容、社区数据和外部服务可以按需加载，与静态正文保持解耦；经常变化的数据不必每次都随整站重新生成。
 
-博客、Wiki、专栏和笔记本共享同一套导航、搜索、侧栏与阅读体验。只写博客时，其它系统不会跑出来打扰你。
+## 站点示例
 
-## 静态博客，也能放一些活的内容
+[Stellar Examples](https://github.com/xaoxuu/hexo-theme-stellar-examples/) 提供可以直接运行的示例站，适合先体验接近自己目标的站点，再逐步替换内容与配置。更多真实站点见[站点示例](https://xaoxuu.com/wiki/stellar/support/examples/)。
 
-动态时间线、自动友链、远程 README、GitHub 仓库与贡献者、评分和投票都可以按需接入。博客仍然是静态文件，但经常变化的内容不必每次都跟着整站重新部署。
+## 开始使用
 
-远程服务不会挡住正文先显示。接口暂时不可用时，文章仍然可以读。
-
-## 写作、检索和阅读是一件事
-
-提示框、折叠、标签页、图库、时间线、聊天和表格等内容组件可以互相组合。Markdown 表达不够时，不需要临时拼一套风格各异的插件。
-
-本地搜索由主题生成索引，结果可以直接落到文章章节；桌面端目录和信息栏到了手机上会变成抽屉，把位置让给正文。
+### 环境要求
 
-[内容组件](https://xaoxuu.com/wiki/stellar/reference/tags/) · [站内搜索](https://xaoxuu.com/wiki/stellar/guides/search/) · [外观与排版](https://xaoxuu.com/wiki/stellar/guides/appearance/)
+- Node.js 22 或更高版本
+- Hexo 8 或更高版本
 
-> 如果你只想写博客，它不会逼你理解这些系统；内容真的多起来时，它们已经在那里了。
+### 从蓝图创建
 
-## 选择一个起点
+准备好 Git 和 npm 后，一条命令即可启动交互式蓝图安装器：
 
-| 示例 | 适合什么样的站点 |
-| --- | --- |
-| 留白 · Light Blog | 安静写长文、随笔和生活记录 |
-| 星迹 · Blog | 使用经典侧栏整理文章、分类与专栏 |
-| 个人知识库 · Knowledge | 把博客、项目资料和长期主题放在一起 |
-| 项目文档 · Docs | 给一个项目维护清晰的文档目录 |
+```bash
+sh -c "$(curl -fsSL https://github.com/xaoxuu/hexo-theme-stellar-examples/raw/main/install.sh)"
+```
 
-示例源码在 [hexo-theme-stellar-examples](https://github.com/xaoxuu/hexo-theme-stellar-examples/)。
+安装器会读取示例仓库的 [`blueprints.json`](https://github.com/xaoxuu/hexo-theme-stellar-examples/blob/main/blueprints.json)，展示当前可用的蓝图，并依次确认蓝图、项目目录、依赖安装和创建计划。
 
-## 快速开始
+### 从 npm 安装
 
-### 环境要求
+在博客根目录安装 npm 当前提供的默认版本，并确认实际安装结果：
 
-```yaml
-Hexo: '>= 8'
-hexo-cli: 4.3.0 ~ latest
-node: '>= 22'
-npm: '>= 10'
+```bash
+npm install hexo-theme-stellar
+npm ls hexo-theme-stellar
 ```
 
-### 使用最新源码
+### 跟随最新源码
 
-在博客根目录添加主题源码并安装依赖：
+将官方仓库的 `main` 分支添加为子模块，并安装主题自身的依赖：
 
 ```bash
 git submodule add -b main https://github.com/xaoxuu/hexo-theme-stellar.git themes/stellar
 npm install --prefix themes/stellar
 ```
 
-然后在博客 `_config.yml` 中启用主题：
+### 启用并检查
+
+在博客 `_config.yml` 中启用主题：
 
 ```yaml
 theme: stellar
 ```
 
-运行 Doctor 和生成：
+然后运行 Doctor 并生成站点：
 
 ```bash
 npx hexo stellar doctor
@@ -84,29 +90,15 @@ npx hexo generate
 
 完整步骤见[环境与安装](https://xaoxuu.com/wiki/stellar/start/install/)和[创建第一个站点](https://xaoxuu.com/wiki/stellar/start/first-site/)。
 
-### 使用 npm 公开稳定版
-
-```bash
-npm install hexo-theme-stellar
-```
+## 文档与社区
 
-这条命令不保证安装到 v2。复制 v2 配置前，请先运行 `npm ls hexo-theme-stellar` 核对实际版本。
-
-## 文档
-
-- [从第一篇文章开始](https://xaoxuu.com/wiki/stellar/start/first-site/)
-- [把博客变成自己的样子](https://xaoxuu.com/wiki/stellar/start/configuration/)
-- [用 Wiki 写项目文档](https://xaoxuu.com/wiki/stellar/guides/wiki/)
-- [把文章整理成专栏](https://xaoxuu.com/wiki/stellar/guides/topic/)
-- [建立自己的笔记本](https://xaoxuu.com/wiki/stellar/guides/notebook/)
+- [配置自己的站点](https://xaoxuu.com/wiki/stellar/start/configuration/)
+- [使用内容组件](https://xaoxuu.com/wiki/stellar/reference/tags/)
+- [管理 Wiki、专栏与笔记本](https://xaoxuu.com/wiki/stellar/reference/collection/)
 - [主题配置参考](https://xaoxuu.com/wiki/stellar/reference/theme/)
 - [从 v1 迁移到 v2](https://xaoxuu.com/wiki/stellar/migration/v1-to-v2/)
-
-## 社区
-
 - [Issues](https://github.com/xaoxuu/hexo-theme-stellar/issues/)：反馈可以复现的问题
 - [Discussions](https://github.com/xaoxuu/hexo-theme-stellar/discussions/)：交流使用经验和想法
-- [蓝图与展示墙](https://xaoxuu.com/wiki/stellar/support/examples/)：看看不同的人怎样使用 Stellar
 - [贡献指南](CONTRIBUTING.md)：参与主题开发与文档维护
 
 ## 开源许可

package/README_EN.md

@@ -1,79 +1,102 @@
-# Stellar — a blog that can grow with your work
+<div align="center">
+  <img src="assets/icon-v2-x512.webp" width="160" alt="Stellar">
+  <h1>Stellar</h1>
+  <p>A blog that grows with your work</p>
+  <p>A complete, versatile, and feature-rich personal knowledge base designed to grow over time.</p>
+  <p><a href="README_EN.md">English</a> · <a href="README.md">简体中文</a></p>
+  <p>
+    <a href="https://github.com/xaoxuu/hexo-theme-stellar/releases"><img src="https://img.shields.io/github/v/release/xaoxuu/hexo-theme-stellar" alt="release"></a>
+    <a href="https://www.npmjs.com/package/hexo-theme-stellar"><img src="https://img.shields.io/npm/v/hexo-theme-stellar" alt="npm"></a>
+    <a href="https://www.npmjs.com/package/hexo-theme-stellar"><img src="https://img.shields.io/npm/dm/hexo-theme-stellar" alt="npm downloads"></a>
+    <a href="https://github.com/xaoxuu/hexo-theme-stellar"><img src="https://img.shields.io/github/stars/xaoxuu/hexo-theme-stellar" alt="stars"></a>
+    <a href="LICENSE"><img src="https://img.shields.io/github/license/xaoxuu/hexo-theme-stellar" alt="license"></a>
+  </p>
+  <p>
+    <a href="https://xaoxuu.com/wiki/stellar/start/install/">Create your first blog</a> ·
+    <a href="https://xaoxuu.com/wiki/stellar/support/examples/">Site examples</a> ·
+    <a href="https://xaoxuu.com/wiki/stellar/">Documentation</a>
+  </p>
+</div>
 
-[English](README_EN.md) · [简体中文](README.md)
+## Bring order to everything you publish
 
-Stellar can begin as a quiet personal blog and grow into a home for your articles, project documentation, series, and notes.
+> True simplicity is not just subtraction; it is creating order within complexity.
 
-[See the examples](https://xaoxuu.com/wiki/stellar/support/examples/) · [Getting started](https://xaoxuu.com/wiki/stellar/start/install/) · [Chinese documentation](https://xaoxuu.com/wiki/stellar/)
+### A complete system for organizing content
 
-> The current Stellar v2 version is `2.0.0-rc.1`. Check npm and GitHub Releases for its public availability.
+Start with regular posts. Give a project its own Wiki when it needs stable documentation, collect related posts into a Topic, and keep evolving knowledge in a Notebook. They share the same navigation, search, sidebars, and reading experience, while unused content systems stay out of the way.
 
-[![npm](https://img.shields.io/npm/v/hexo-theme-stellar)](https://www.npmjs.com/package/hexo-theme-stellar)
-[![license](https://img.shields.io/github/license/xaoxuu/hexo-theme-stellar)](https://github.com/xaoxuu/hexo-theme-stellar/blob/main/LICENSE)
-[![stars](https://img.shields.io/github/stars/xaoxuu/hexo-theme-stellar)](https://github.com/xaoxuu/hexo-theme-stellar)
-[![npm downloads](https://img.shields.io/npm/dm/hexo-theme-stellar)](https://www.npmjs.com/package/hexo-theme-stellar)
+### Flexible layout and expression
 
-## Four kinds of content, one site
+From appearance presets, colors, and type to columns, tabs, folding sections, and galleries, you can shape both the site and the way its content is presented. Local search can take readers directly to a matching section, while responsive layouts leave the main space to the article on narrow screens.
 
-Publish regular blog posts as usual. Give a project its own Wiki when it needs stable navigation. Keep a series of posts together as a Topic, or collect smaller pieces of knowledge in a Notebook.
+### Static pages that stay fresh
 
-They share the same navigation, search, sidebars, and reading experience. If all you need is a blog, the other systems stay out of the way.
+Your writing preserves ideas while external data stays current. Remote content, community data, and external services can load on demand without being coupled to the static article, so frequently changing data does not require a full-site rebuild.
 
-## A static site with room for live data
+## Site examples
 
-Timelines, link status, remote README files, GitHub repositories and contributors, ratings, and polls can load when they are needed. Your site remains static, while frequently changing data does not require a full rebuild.
+[Stellar Examples](https://github.com/xaoxuu/hexo-theme-stellar-examples/) provides runnable sites you can explore before replacing their content and configuration at your own pace. Visit [Site examples](https://xaoxuu.com/wiki/stellar/support/examples/) for more real sites.
 
-The article remains readable when a remote service is unavailable.
+## Get started
 
-## Writing, finding, and reading belong together
+### Requirements
 
-Stellar includes content components for notes, folding sections, tabs, galleries, timelines, chat, tables, and more. Built-in local search can take a reader straight to a matching section. On smaller screens, navigation moves into drawers and leaves the page to the article.
+- Node.js 22 or newer
+- Hexo 8 or newer
 
-## Choose a starting point
+### Create from a Blueprint
 
-| Example | A good fit for |
-| --- | --- |
-| Light Blog | Essays, personal notes, and distraction-free reading |
-| Blog | A classic sidebar blog with categories and series |
-| Knowledge | A personal site combining articles and long-lived knowledge |
-| Docs | Documentation for a single project |
+With Git and npm available, launch the interactive Blueprint installer with one command:
 
-The source for these sites lives in the catalog-driven [hexo-theme-stellar-examples](https://github.com/xaoxuu/hexo-theme-stellar-examples/) repository.
+```bash
+sh -c "$(curl -fsSL https://github.com/xaoxuu/hexo-theme-stellar-examples/raw/main/install.sh)"
+```
+
+The installer reads the example repository's [`blueprints.json`](https://github.com/xaoxuu/hexo-theme-stellar-examples/blob/main/blueprints.json), presents the available Blueprints, then confirms the Blueprint, project directory, dependency installation, and creation plan.
+
+### Install from npm
+
+Install the default version currently provided by npm, then confirm what was installed:
+
+```bash
+npm install hexo-theme-stellar
+npm ls hexo-theme-stellar
+```
 
-## Use the latest source
+### Follow the latest source
 
-You need Node.js 22 or newer and Hexo 8 or newer. In the root of an existing Hexo site:
+Add the official repository's `main` branch as a submodule and install the theme's own dependencies:
 
 ```bash
 git submodule add -b main https://github.com/xaoxuu/hexo-theme-stellar.git themes/stellar
 npm install --prefix themes/stellar
 ```
 
-Enable the theme in `_config.yml`:
+### Enable and check
+
+Enable the theme in your site's `_config.yml`:
 
 ```yaml
 theme: stellar
 ```
 
-Then check and build the site:
+Then run Doctor and generate the site:
 
 ```bash
 npx hexo stellar doctor
 npx hexo generate
 ```
 
-The full v2 documentation is currently maintained in Chinese. The example repository provides an English quick start and complete runnable sites that can be explored without reading the whole reference.
-
-## Stable npm release
-
-```bash
-npm install hexo-theme-stellar
-```
-
-This command may still install v1. Run `npm ls hexo-theme-stellar` before using any v2 configuration.
+See [Installation](https://xaoxuu.com/wiki/stellar/start/install/) and [Create your first site](https://xaoxuu.com/wiki/stellar/start/first-site/) for the complete workflow.
 
-## Community
+## Documentation and community
 
+- [Configure your site](https://xaoxuu.com/wiki/stellar/start/configuration/)
+- [Use content components](https://xaoxuu.com/wiki/stellar/reference/tags/)
+- [Manage Wikis, Topics, and Notebooks](https://xaoxuu.com/wiki/stellar/reference/collection/)
+- [Theme configuration reference](https://xaoxuu.com/wiki/stellar/reference/theme/)
+- [Migrate from v1 to v2](https://xaoxuu.com/wiki/stellar/migration/v1-to-v2/)
 - [Issues](https://github.com/xaoxuu/hexo-theme-stellar/issues/) for reproducible problems
 - [Discussions](https://github.com/xaoxuu/hexo-theme-stellar/discussions/) for ideas and usage questions
 - [Contributing](CONTRIBUTING.md) for code and documentation work

package/_config.yml

@@ -133,7 +133,7 @@ footer:
   # 设置主内容区页脚导航分栏；空数组表示不显示分栏。
   sections: []
 
-# 配置各页面类型的路由、导航和 Region 默认值；省略字段时继承站点级 Region。
+# 配置各页面与内容 Profile 的专属设置、路由、导航和 Region 默认值；省略字段时继承站点级 Region。
 profiles:
   # 配置主页默认布局。
   home:
@@ -265,8 +265,37 @@ profiles:
         - ghrepo
         - toc
 
+  # 配置单个 Notebook Collection 与列表页。
+  notebook:
+    # 设置 Notebook 列表页高亮的主菜单项；null 表示不高亮。
+    active_menu: null
+    # 配置 Notebook 列表页 Leftbar 覆盖项。
+    leftbar:
+      # 设置 Notebook 列表页 Leftbar 内容 Widget；数组会整体替换站点级列表。
+      widgets:
+        - tagtree
+        - recent
+    # 配置 Notebook 列表页 Rightbar 覆盖项。
+    rightbar:
+      # 设置 Notebook 列表页 Rightbar Widget；空数组表示显式隐藏。
+      widgets: []
+    # 配置 Notebook 条目列表。
+    listing:
+      # 设置每页条目数；null 表示继承站点分页配置，0 表示禁用分页。
+      per_page: null
+      # 配置 Notebook 条目排序。
+      sort:
+        # 设置排序字段；可选值为 date、updated 或 title。
+        field: updated
+        # 设置排序方向；可选值为 asc 或 desc。
+        direction: desc
+      # 设置没有 excerpt 和 description 时的自动摘要最大字符数；0 表示不自动生成摘要。
+      excerpt_length: 128
+    # 配置 Notebook 标签对应的图标；空对象表示不指定图标。
+    tag_icons: {}
+
   # 配置 Notebook 总索引页默认布局。
-  notebook_index:
+  notebooks:
     # 设置 Notebook 总索引页的自动生成路径；null 表示不生成总索引页。
     path: /notebooks/
     # 设置 Notebook 总索引页高亮的主菜单项；null 表示不高亮。
@@ -281,21 +310,6 @@ profiles:
       # 设置 Notebook 总索引页 Rightbar Widget；空数组表示显式隐藏。
       widgets: []
 
-  # 配置 Notebook 列表页默认布局。
-  note_index:
-    # 设置 Notebook 列表页高亮的主菜单项；null 表示不高亮。
-    active_menu: null
-    # 配置 Notebook 列表页 Leftbar 覆盖项。
-    leftbar:
-      # 设置 Notebook 列表页 Leftbar 内容 Widget；数组会整体替换站点级列表。
-      widgets:
-        - tagtree
-        - recent
-    # 配置 Notebook 列表页 Rightbar 覆盖项。
-    rightbar:
-      # 设置 Notebook 列表页 Rightbar Widget；空数组表示显式隐藏。
-      widgets: []
-
   # 配置 Notebook 内容页默认布局。
   note:
     # 设置 Notebook 内容页高亮的主菜单项；null 表示不高亮。
@@ -347,6 +361,22 @@ profiles:
   settings:
     # 设置设置页的生成路径。
     path: /settings/
+    # 配置设置页的关于信息。
+    about:
+      # 设置关于信息条目；数组会整体替换。
+      items:
+        # 设置条目名称。
+        - key: 博客框架
+          # 设置条目内容，支持主题模板变量。
+          value: Hexo {hexo.version}
+          # 设置条目链接。
+          url: https://hexo.io/
+        # 设置条目名称。
+        - key: 主题版本
+          # 设置条目内容，支持主题模板变量。
+          value: Stellar {theme.version}
+          # 设置条目链接，支持主题模板变量。
+          url: '{theme.tree}'
     # 设置设置页高亮的主菜单项；null 表示不高亮。
     active_menu: null
     # 配置设置页 Leftbar 覆盖项。
@@ -363,6 +393,20 @@ profiles:
   error:
     # 设置错误页的生成路径。
     path: /404.html
+    # 设置错误页插图地址；null 表示不显示插图。
+    image: https://gcore.jsdelivr.net/gh/cdn-x/placeholder@1.0.12/404/1c830bfcd517d.svg
+    # 配置错误页评论区。
+    comments:
+      # 控制是否显示错误页评论区。
+      enabled: false
+      # 设置错误页评论区标题；null 表示使用默认标题。
+      title: null
+      # 设置错误页评论线程标识；null 表示由页面上下文决定。
+      id: null
+      # 设置错误页专用评论 Provider；null 表示使用全局 Provider。
+      provider: null
+      # 设置错误页专用评论 Provider 参数；空对象表示不覆盖参数。
+      options: {}
     # 设置错误页高亮的主菜单项；null 表示不高亮。
     active_menu: post
     # 配置错误页 Leftbar 覆盖项。
@@ -427,42 +471,6 @@ article:
     # 控制文章页页脚是否显示标签。
     show_tags: true
 
-# 配置 Notebook 列表与内容页的展示行为。
-notebook:
-  # 配置 Notebook 列表。
-  listing:
-    # 设置每页条目数；null 表示继承站点分页配置，0 表示禁用分页。
-    per_page: null
-    # 配置 Notebook 条目排序。
-    sort:
-      # 设置排序字段；可选值为 date、updated 或 title。
-      field: updated
-      # 设置排序方向；可选值为 asc 或 desc。
-      direction: desc
-    # 设置没有 excerpt 和 description 时的自动摘要最大字符数；0 表示不自动生成摘要。
-    excerpt_length: 128
-  # 配置 Notebook 标签对应的图标；空对象表示不指定图标。
-  tag_icons: {}
-
-# 配置设置页内容。
-settings:
-  # 配置设置页的关于信息。
-  about:
-    # 设置关于信息条目；数组会整体替换。
-    items:
-      # 设置条目名称。
-      - key: 博客框架
-        # 设置条目内容，支持主题模板变量。
-        value: Hexo {hexo.version}
-        # 设置条目链接。
-        url: https://hexo.io/
-      # 设置条目名称。
-      - key: 主题版本
-        # 设置条目内容，支持主题模板变量。
-        value: Stellar {theme.version}
-        # 设置条目链接，支持主题模板变量。
-        url: '{theme.tree}'
-
 # -----------------------------------------------------------------------------
 # 外观
 # -----------------------------------------------------------------------------
@@ -893,11 +901,6 @@ fallbacks:
   # 设置封面占位图地址。
   cover: https://gcore.jsdelivr.net/gh/cdn-x/placeholder@1.0.12/cover/76b86c0226ffd.svg
 
-# 配置错误页资源。
-error_page:
-  # 设置错误页插图地址；null 表示不显示插图。
-  image: https://gcore.jsdelivr.net/gh/cdn-x/placeholder@1.0.12/404/1c830bfcd517d.svg
-
 # -----------------------------------------------------------------------------
 # SEO
 # -----------------------------------------------------------------------------
@@ -928,7 +931,11 @@ structured_data:
 
 # 配置原样注入页面的可信内容。
 inject:
+  # 设置注入到 <head> 后的内容；空字符串表示不注入。
+  head_begin: ''
   # 设置注入到 </head> 前的内容；空字符串表示不注入。
   head_end: ''
+  # 设置注入到 <body> 后的内容；空字符串表示不注入。
+  body_begin: ''
   # 设置注入到 </body> 前的内容；空字符串表示不注入。
   body_end: ''

package/layout/404.ejs

@@ -1,8 +1,10 @@
 <%
 page.robots = 'none';
+var errorProfile = stellar_config('profiles.error') || {}
+var errorComments = comments_model(page, errorProfile.comments)
 %>
 <article class='md-text error-page'>
-  <% var errorImage = stellar_config('errorPage.image') %>
+  <% var errorImage = errorProfile.image %>
   <% if (errorImage) { %>
     <h1><img id='error' src='<%- errorImage %>' alt='404'></h1>
   <% } %>
@@ -17,3 +19,4 @@ page.robots = 'none';
   <br><br>
   <a class='button' id='back' href="<%- config.root %>"><%- __('page.error.action') %></a>
 </article>
+<%- partial('_partial/comments/layout', {comments: errorComments}) %>

package/layout/_partial/head.ejs

@@ -11,8 +11,7 @@ var stellarSeo = {
 }
 var stellarResources = {
   preconnect: stellar_config('preconnect'),
-  fallbacks: stellar_config('fallbacks'),
-  errorPage: stellar_config('errorPage')
+  fallbacks: stellar_config('fallbacks')
 }
 
 function generate_title() {
@@ -159,8 +158,8 @@ function preconnect() {
   return el;
 }
 
-function custom_inject() {
-  return stellar_inject('headEnd', pageRender ? pageRender.document.headEndInject : pageConfig.inject?.headEnd)
+function custom_inject(kind) {
+  return stellar_inject(kind, pageRender ? pageRender.document[`${kind}Inject`] : pageConfig.inject?.[kind])
 }
 
 function generate_canonical() {
@@ -183,6 +182,7 @@ function generate_canonical() {
 %>
 
 <head>
+  <%- custom_inject('headBegin') %>
   <meta charset="utf-8">
   <meta name="hexo-theme" content="<%- stellar_info('tree') %>" theme-name="<%- stellar_info('name') %>" theme-version="<%- stellar_info('version') %>">
   <%- generate_canonical() %>
@@ -248,7 +248,7 @@ function generate_canonical() {
   <% } %>
 
   <%- json_ld(pageViewModel || undefined) %>
-  <%- custom_inject() %>
+  <%- custom_inject('headEnd') %>
 
   <!-- icons.yml 驱动的 CSS 装饰图标 -->
   <%

package/layout/_partial/primitives/shell.ejs

@@ -15,6 +15,7 @@ var html = '<!DOCTYPE html>'
 html += `<html lang="${language}"${htmlAttributes}>`
 html += head
 html += `<body${pageAttributes}>`
+html += bodyBegin || ''
 html += siteBackground || ''
 html += cover || ''
 html += `<div class="site-shell" id="start" data-regions="${presentRegions.join(' ')}">`

package/layout/_partial/scripts/runtime.ejs

@@ -15,6 +15,10 @@ var runtimeHomeComments = stellar_config('profiles.home.comments')
 if (!runtimeViewModel && runtimeHomeComments && runtimeHomeComments !== false && is_home_first_page()) {
   runtimeCommentOverrides = typeof runtimeHomeComments === 'object' ? runtimeHomeComments : {enabled: true}
 }
+var runtimeErrorComments = stellar_config('profiles.error.comments')
+if (!runtimeViewModel && page.layout === '404' && runtimeErrorComments && runtimeErrorComments !== false) {
+  runtimeCommentOverrides = typeof runtimeErrorComments === 'object' ? runtimeErrorComments : {enabled: true}
+}
 var runtimeComments = runtimeViewModel?.render?.article?.comments || comments_model(page, runtimeCommentOverrides)
 var runtimeProfile = runtimeViewModel?.collection?.profile
   || (page.notebookIndex?.mode === 'notes' ? 'notebook' : page.layout || '')

package/layout/_partial/widgets/tagtree.ejs

@@ -15,7 +15,7 @@ function isLeaf(tag) {
 }
 
 function getTagcon(tag) {
-  var tagIcons = stellar_config('notebook.tagIcons') || {}
+  var tagIcons = stellar_config('profiles.notebook.tagIcons') || {}
   return tagIcons[tag.name] || tagIcons[tag.id] || tagIcons[tag.label] || tagIcons[tag.label.toLowerCase()] || 'quot:hashtag'
 }
 

package/layout/layout.ejs

@@ -53,6 +53,7 @@ function shellDocument(options) {
     documentModel: options.documentModel,
     pageModel: options.pageModel,
     head: options.head,
+    bodyBegin: options.bodyBegin,
     siteBackground: options.siteBackground,
     cover: options.cover,
     regions: options.regions,
@@ -118,6 +119,7 @@ if (renderViewModel) {
       indent: render.layout.indent
     },
     head: partial('_partial/head', {viewModel: renderViewModel}),
+    bodyBegin: stellar_inject('bodyBegin', render.document.bodyBeginInject),
     siteBackground: siteBackground(render.layout.siteBackground),
     cover: coverSlot(renderViewModel),
     regions: {
@@ -148,9 +150,9 @@ if (renderViewModel) {
   if (is_home()) {
     profileKey = 'home'
   } else if (page.layout === 'notebooks') {
-    profileKey = 'notebookIndex'
+    profileKey = 'notebooks'
   } else if (page.layout === 'notes') {
-    profileKey = 'noteIndex'
+    profileKey = 'notebook'
     collectionRegions = notebookIndex?.layout
   } else if (is_category() || is_tag() || is_archive() || ['categories', 'tags', 'archives'].includes(page.layout)) {
     profileKey = 'blogIndex'
@@ -187,6 +189,7 @@ if (renderViewModel) {
       indent: indent
     },
     head: partial('_partial/head'),
+    bodyBegin: stellar_inject('bodyBegin', pageConfig.inject?.bodyBegin),
     siteBackground: siteBackground(appearance.backgrounds.page.image),
     cover: coverSlot(),
     regions: {

package/layout/settings.ejs

@@ -2,7 +2,7 @@
 page.robots = 'noindex,nofollow'
 var provider = stellar_config('comments.provider') || ''
 var providerSupported = ['artalk', 'waline', 'twikoo'].includes(String(provider).toLowerCase())
-var settingsConfig = stellar_config('settings') || {}
+var settingsConfig = stellar_config('profiles.settings') || {}
 var aboutItems = settingsConfig.about?.items || []
 var cacheItems = [
   { id: 'search', label: __('settings.cache.search') },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hexo-theme-stellar",
-  "version": "2.0.0-rc.1",
-  "description": "Elegant and powerful theme for Hexo.",
+  "version": "2.0.0-rc.2",
+  "description": "An all-in-one Hexo theme for blogs, project documentation, knowledge bases, series, and notebooks.",
   "main": "package.json",
   "scripts": {
     "lint": "eslint .",
@@ -24,10 +24,19 @@
   },
   "keywords": [
     "hexo",
+    "hexo-theme",
     "theme",
-    "stellar"
+    "stellar",
+    "blog",
+    "wiki",
+    "documentation",
+    "knowledge-base",
+    "notebook"
   ],
-  "author": "[@xaoxuu](https://github.com/xaoxuu/)",
+  "author": {
+    "name": "xaoxuu",
+    "url": "https://github.com/xaoxuu/"
+  },
   "license": "MIT",
   "engines": {
     "node": ">=22"
@@ -38,6 +47,7 @@
   "dependencies": {
     "cheerio": "^1.1.0",
     "glob": "^10.4.0",
+    "hexo-front-matter": "^4.2.1",
     "hexo-renderer-ejs": "^2.0.0",
     "hexo-renderer-stylus": "^3.0.1",
     "hexo-pagination": "^3.0.0",

package/scripts/generators/notebooks.js

@@ -12,7 +12,7 @@ const { selectListingItems, stableSort } = require("../lib/collection-pipeline/s
 hexo.extend.generator.register("notebooks", function (locals) {
   const { notebookIndex } = hexo.stellar.data;
   const profiles = requireLayoutProfiles(hexo.stellar?.config);
-  const profile = profiles.notebookIndex;
+  const profile = profiles.notebooks;
   if (!notebookIndex?.items || notebookIndex.items.length === 0) {
     return [];
   }
@@ -79,7 +79,7 @@ hexo.extend.generator.register("notebooks", function (locals) {
         layout: ["notes"],
         data: {
           layout: "notes",
-          navigation: { menu: notebook.navigation.menu ?? profiles.noteIndex.activeMenu }
+          navigation: { menu: notebook.navigation.menu ?? profiles.notebook.activeMenu }
         }
       });
       for (const slice of slices) {

package/scripts/lib/brand.js

@@ -21,8 +21,8 @@ function shouldShowMobileBrand({ profileKey }) {
     "home",
     "blogIndex",
     "wikiIndex",
-    "notebookIndex",
-    "noteIndex"
+    "notebooks",
+    "notebook"
   ].includes(profileKey);
 }
 

package/scripts/lib/content-defaults.js

@@ -8,14 +8,18 @@ const {
 } = require("./config-schema");
 
 function requireContentConfig(stellarConfig, source = "_config.stellar.yml") {
-  if (isPlainObject(stellarConfig?.article) && isPlainObject(stellarConfig?.notebook)) {
-    return { article: stellarConfig.article, notebook: stellarConfig.notebook };
+  const article = stellarConfig?.article;
+  const notebook = stellarConfig?.profiles?.notebook;
+  if (isPlainObject(article) && isPlainObject(notebook)) {
+    return { article, notebook };
   }
+  const path = isPlainObject(article) ? "stellarConfig.profiles.notebook" : "stellarConfig.article";
+  const actual = isPlainObject(article) ? notebook : article;
   throw new ConfigSchemaError([Object.freeze({
     code: "invalid_type",
     source,
-    path: "stellarConfig.article",
-    actualType: valueType(stellarConfig?.article),
+    path,
+    actualType: valueType(actual),
     expected: "normalized content defaults object",
     migration: null
   })]);

package/scripts/lib/contribution-registry.js

@@ -177,7 +177,7 @@ const CONTRIBUTIONS = defineContributions([
     tests: [RUNTIME_TEST, RUNTIME_CONSUMPTION_TEST],
     defaultsOwner: CONFIG_OWNER("comments.provider"),
     project(context) {
-      if (typeof context.comments.service !== "string" || context.comments.service.length === 0) return null;
+      if (context.comments.enabled !== true || typeof context.comments.service !== "string" || context.comments.service.length === 0) return null;
       return configResult({
         provider: context.comments.service,
         options: context.comments.options || {},

package/scripts/lib/models/index.js

@@ -499,7 +499,9 @@ function buildPostRenderModel(input, collection, item) {
   return {
     document: {
       language: normalizeLanguage(page.lang, page.language, frontMatter.lang, frontMatter.language, siteConfig.language),
+      headBeginInject: normalizeInject(frontMatter.inject?.headBegin),
       headEndInject: normalizeInject(frontMatter.inject?.headEnd),
+      bodyBeginInject: normalizeInject(frontMatter.inject?.bodyBegin),
       bodyEndInject: normalizeInject(frontMatter.inject?.bodyEnd),
       preferredTheme: appearance.colorScheme === "auto"
         ? "auto"
@@ -690,7 +692,9 @@ function buildWikiRenderModel(input, collection, item) {
   return {
     document: {
       language,
+      headBeginInject: normalizeInject(frontMatter.inject?.headBegin),
       headEndInject: normalizeInject(frontMatter.inject?.headEnd),
+      bodyBeginInject: normalizeInject(frontMatter.inject?.bodyBegin),
       bodyEndInject: normalizeInject(frontMatter.inject?.bodyEnd),
       preferredTheme: appearance.colorScheme === "auto" ? "auto" : String(appearance.colorScheme || "")
     },
@@ -1059,7 +1063,7 @@ function notebookBaseDir(collectionId, collectionConfig, stellarConfig) {
   if (typeof collectionConfig.route?.path === "string" && collectionConfig.route.path.length > 0) {
     return normalizeCollectionPath(collectionConfig.route.path);
   }
-  const root = profilePath(requireLayoutProfiles(stellarConfig).notebookIndex.path);
+  const root = profilePath(requireLayoutProfiles(stellarConfig).notebooks.path);
   return normalizeCollectionPath([root, collectionId].filter(Boolean).join("/"));
 }
 
@@ -1098,11 +1102,11 @@ function buildNotebookCollectionModel(input, collectionId) {
   const defaultListing = notebookDefaults.listing;
   const baseDir = notebookBaseDir(collectionId, collectionConfig, input.stellarConfig);
   const identity = normalizeCollectionIdentity(collectionConfig);
-  const profileNavigation = toRenderNavigation(profiles.noteIndex);
+  const profileNavigation = toRenderNavigation(profiles.notebook);
   const collectionNavigation = toContentNavigation(collectionConfig);
   const collectionRegions = pick(collectionConfig, CONTENT_MODEL_FIELDS.regionIds);
   const defaultBrand = collectionBrand(identity, baseDir, {
-    indexPath: profiles.notebookIndex.path,
+    indexPath: profiles.notebooks.path,
     backLabel: "btn.all_notebook"
   });
   assertCollectionBrandConfig(collectionConfig, "collection", input.collectionSource || "<collection>");
@@ -1218,7 +1222,7 @@ function buildNotebookRenderModel(input, collection, item) {
       articleStyle: core.layout.articleStyle,
       indent: core.layout.indent,
       siteBackground: core.layout.siteBackground,
-      notebookIndexPath: profilePath(requireLayoutProfiles(input.stellarConfig).notebookIndex.path),
+      notebookIndexPath: profilePath(requireLayoutProfiles(input.stellarConfig).notebooks.path),
       notebookPath: collection.route.baseDir,
       algoliaFilterPath: collection.route.baseDir,
       topbar: core.layout.topbar,

package/scripts/schema/config-rules.js

@@ -152,7 +152,6 @@ const inheritedRegionBrand = properties => ({
 });
 
 const CONFIG_RULES = Object.freeze([
-  ["settings.about.items", { items: aboutItem }],
   ["footer.sections", { items: footerSection }],
   ["footer.content", { normalizer: "trusted_text" }],
 
@@ -182,10 +181,12 @@ const CONFIG_RULES = Object.freeze([
   ["profiles.*.rightbar.enabled", { type: ["boolean", "null"], defaultValue: null }],
   ["profiles.*.rightbar.widgets", { type: ["array", "null"], defaultValue: null, items: widgetItems }],
   ["profiles.*.listing_nav.tabs", { validator: "navigation_tabs", items: navigationTab }],
-  ["profiles.home.comments.title", { type: ["string", "null"] }],
-  ["profiles.home.comments.id", { type: ["string", "null"], normalizer: "nullable_trimmed_string", validator: "nullable_non_empty_string" }],
-  ["profiles.home.comments.provider", { type: ["string", "null"], values: [null, "beaudar", "utterances", "giscus", "twikoo", "waline", "artalk"] }],
-  ["profiles.home.comments.options", parameterBag],
+  ["profiles.error.image", { type: ["string", "null"], validator: "nullable_resource" }],
+  ["profiles.settings.about.items", { items: aboutItem }],
+  ["profiles.*.comments.title", { type: ["string", "null"] }],
+  ["profiles.*.comments.id", { type: ["string", "null"], normalizer: "nullable_trimmed_string", validator: "nullable_non_empty_string" }],
+  ["profiles.*.comments.provider", { type: ["string", "null"], values: [null, "beaudar", "utterances", "giscus", "twikoo", "waline", "artalk"] }],
+  ["profiles.*.comments.options", parameterBag],
 
   ["article.style", { values: ["tech", "story"] }],
   ["article.paragraph_indent", { values: ["auto", "always", "never"] }],
@@ -198,11 +199,11 @@ const CONFIG_RULES = Object.freeze([
   ["article.footer.license", { type: ["boolean", "string"], validator: "license_value" }],
   ["article.footer.share", { items: item("string", { defaultValue: "", values: SHARE_SERVICE_IDS }), normalizer: "trimmed_string_list" }],
   ["article.related_posts_limit", { minimum: 0, validator: "non_negative_integer" }],
-  ["notebook.listing.excerpt_length", { minimum: 0, validator: "non_negative_integer" }],
-  ["notebook.listing.per_page", { type: ["number", "null"], minimum: 0, validator: "nullable_non_negative_integer" }],
-  ["notebook.listing.sort.field", { values: ["date", "updated", "title"] }],
-  ["notebook.listing.sort.direction", { values: ["asc", "desc"] }],
-  ["notebook.tag_icons", { ...stringRecord(), validator: "non_empty_record_keys" }],
+  ["profiles.notebook.listing.excerpt_length", { minimum: 0, validator: "non_negative_integer" }],
+  ["profiles.notebook.listing.per_page", { type: ["number", "null"], minimum: 0, validator: "nullable_non_negative_integer" }],
+  ["profiles.notebook.listing.sort.field", { values: ["date", "updated", "title"] }],
+  ["profiles.notebook.listing.sort.direction", { values: ["asc", "desc"] }],
+  ["profiles.notebook.tag_icons", { ...stringRecord(), validator: "non_empty_record_keys" }],
 
   ["appearance.preset", { values: ["card", "glass", "minimal", "flat"] }],
   ["appearance.color_scheme", { values: ["auto", "light", "dark"] }],
@@ -231,7 +232,6 @@ const CONFIG_RULES = Object.freeze([
   ["structured_data.same_as", { items: item("string", { defaultValue: "" }), normalizer: "trimmed_string_list" }],
   ["preconnect", { items: item("string", { defaultValue: "" }), normalizer: "origin_list" }],
   ["fallbacks.*", { validator: "resource" }],
-  ["error_page.image", { type: ["string", "null"], validator: "nullable_resource" }],
 
   ["search.provider", { type: ["string", "null"], values: [null, "local", "algolia"] }],
   ["search.local.cache_ttl_seconds", { minimum: 0, validator: "non_negative_integer" }],
@@ -278,7 +278,9 @@ const CONFIG_RULES = Object.freeze([
   ["services.github_card.provider", { values: ["github_readme_stats"] }],
   ["services.github_card.github_readme_stats", { runtimeKey: "github_readme_stats" }],
   ["services.*.*.endpoint", { validator: "absolute_http_url" }],
+  ["inject.head_begin", { normalizer: "trusted_text" }],
   ["inject.head_end", { normalizer: "trusted_text" }],
+  ["inject.body_begin", { normalizer: "trusted_text" }],
   ["inject.body_end", { normalizer: "trusted_text" }]
 ]);
 

package/scripts/schema/config-schema.js

@@ -19,7 +19,8 @@ const LEGACY_THEME_ROOTS = Object.freeze({
   data_cache: null,
   plugins: "features",
   style: "appearance",
-  default: "fallbacks | error_page",
+  notebook: "profiles.notebook",
+  default: "fallbacks | profiles.error.image",
   api_host: "services.github | services.github_card",
   system: null
 });

package/scripts/schema/content-config-rules.js

@@ -228,7 +228,9 @@ const FRONT_MATTER_TARGET_DEFINITIONS = [
   ["seo", "object", literal({}), { boundary: "sealed" }],
   ["seo.open_graph", "object", literal({}), { boundary: "parameter_bag" }],
   ["inject", "object", literal({}), { boundary: "sealed" }],
+  ["inject.head_begin", "string", literal("")],
   ["inject.head_end", "string", literal("")],
+  ["inject.body_begin", "string", literal("")],
   ["inject.body_end", "string", literal("")]
 ];
 

package/scripts/schema/model-schema.js

@@ -452,12 +452,12 @@ function collectionSchema(profile) {
           cardStyle: field(["string", "null"], { default: inherited("hexo.stellar.config.article.listing.cardLayout"), example: "hero", required: true })
         } : {}),
         excerptLength: field(["number", "null"], {
-          default: profile === "notebook" ? inherited("hexo.stellar.config.notebook.listing.excerptLength") : literal(null),
+          default: profile === "notebook" ? inherited("hexo.stellar.config.profiles.notebook.listing.excerptLength") : literal(null),
           example: 128,
           required: true
         }),
         perPage: field(["number", "null"], {
-          default: profile === "notebook" ? inherited("hexo.stellar.config.notebook.listing.perPage", "site.per_page") : literal(null),
+          default: profile === "notebook" ? inherited("hexo.stellar.config.profiles.notebook.listing.perPage", "site.per_page") : literal(null),
           example: 10,
           required: true
         }),
@@ -465,7 +465,7 @@ function collectionSchema(profile) {
           sort: object({
             field: field("string", { default: profile === "topic" ? literal("date") : literal("updated"), example: "updated", required: true }),
             direction: field("string", { default: literal("desc"), example: "desc", required: true })
-          }, { default: derived("collection.listing.sort", "hexo.stellar.config.notebook.listing.sort"), example: { field: "updated", direction: "desc" }, required: true })
+          }, { default: derived("collection.listing.sort", "hexo.stellar.config.profiles.notebook.listing.sort"), example: { field: "updated", direction: "desc" }, required: true })
         })
       };
 
@@ -618,10 +618,12 @@ function pageViewModelSchema(profile) {
     properties.render = object({
       document: object({
         language: field("string", { default: derived("page.lang", "page.language", "site.language"), example: "zh-CN", required: true }),
+        headBeginInject: field("string", { default: literal(""), example: "", required: true }),
         headEndInject: field("string", { default: literal(""), example: "", required: true }),
+        bodyBeginInject: field("string", { default: literal(""), example: "", required: true }),
         bodyEndInject: field("string", { default: literal(""), example: "", required: true }),
         preferredTheme: field("string", { default: derived("hexo.stellar.config.appearance.colorScheme"), example: "auto", required: true })
-      }, { required: true, example: { language: "zh-CN", headEndInject: "", bodyEndInject: "", preferredTheme: "auto" } }),
+      }, { required: true, example: { language: "zh-CN", headBeginInject: "", headEndInject: "", bodyBeginInject: "", bodyEndInject: "", preferredTheme: "auto" } }),
       layout: object({
         pageType: field("string", { default: literal("content"), example: "content", required: true }),
         articleStyle: field(["string", "null"], { default: inherited("item.presentation.article.style"), example: "tech", required: true }),
@@ -692,7 +694,7 @@ function pageViewModelSchema(profile) {
       }, { required: true, example: { href: "blog/hello", title: "Hello Stellar", layout: "post", date: null, cover: "", caption: "", excerpt: "", categories: [], categoryStyle: "", tags: [], authorId: "", priority: 0, listed: true, cardStyle: "classic" } })
     }, {
       default: computed(`由 ${profile === "topic" ? "Topic" : "Post"} PageViewModel 构建器生成`),
-      example: { document: { language: "zh-CN", headEndInject: "", bodyEndInject: "" }, layout: { pageType: "content" }, seo: { title: "Hello Stellar - Stellar" } },
+      example: { document: { language: "zh-CN", headBeginInject: "", headEndInject: "", bodyBeginInject: "", bodyEndInject: "" }, layout: { pageType: "content" }, seo: { title: "Hello Stellar - Stellar" } },
       required: true
     });
   }
@@ -761,10 +763,12 @@ function pageViewModelSchema(profile) {
     properties.render = object({
       document: object({
         language: field("string", { default: derived("page.lang", "page.language", "site.language"), example: "zh-CN", required: true }),
+        headBeginInject: field("string", { default: literal(""), example: "", required: true }),
         headEndInject: field("string", { default: literal(""), example: "", required: true }),
+        bodyBeginInject: field("string", { default: literal(""), example: "", required: true }),
         bodyEndInject: field("string", { default: literal(""), example: "", required: true }),
         preferredTheme: field("string", { default: derived("hexo.stellar.config.appearance.colorScheme"), example: "auto", required: true })
-      }, { required: true, example: { language: "zh-CN", headEndInject: "", bodyEndInject: "", preferredTheme: "auto" } }),
+      }, { required: true, example: { language: "zh-CN", headBeginInject: "", headEndInject: "", bodyBeginInject: "", bodyEndInject: "", preferredTheme: "auto" } }),
       layout: object({
         pageType: field("string", { default: literal("content"), example: "content", required: true }),
         articleStyle: field(["string", "null"], { default: inherited("item.presentation.article.style"), example: "tech", required: true }),
@@ -873,16 +877,18 @@ function pageViewModelSchema(profile) {
     properties.render = object({
       document: object({
         language: field("string", { default: derived("page.lang", "page.language", "site.language"), example: "zh-CN", required: true }),
+        headBeginInject: field("string", { default: literal(""), example: "", required: true }),
         headEndInject: field("string", { default: literal(""), example: "", required: true }),
+        bodyBeginInject: field("string", { default: literal(""), example: "", required: true }),
         bodyEndInject: field("string", { default: literal(""), example: "", required: true }),
         preferredTheme: field("string", { default: derived("appearance.colorScheme"), example: "auto", required: true })
-      }, { required: true, example: { language: "zh-CN", headEndInject: "", bodyEndInject: "", preferredTheme: "auto" } }),
+      }, { required: true, example: { language: "zh-CN", headBeginInject: "", headEndInject: "", bodyBeginInject: "", bodyEndInject: "", preferredTheme: "auto" } }),
       layout: object({
         pageType: field("string", { default: literal("content"), example: "content", required: true }),
         articleStyle: field(["string", "null"], { default: inherited("item.presentation.article.style"), example: "tech", required: true }),
         indent: field("boolean", { default: computed("由 article.paragraphIndent 与 style 解析"), example: false, required: true }),
         siteBackground: field("boolean", { default: derived("appearance.backgrounds.page.image"), example: false, required: true }),
-        notebookIndexPath: field("string", { default: derived("hexo.stellar.config.profiles.notebookIndex.path"), example: "notebooks", required: true }),
+        notebookIndexPath: field("string", { default: derived("hexo.stellar.config.profiles.notebooks.path"), example: "notebooks", required: true }),
         notebookPath: field("string", { default: inherited("collection.route.baseDir"), example: "notes/dev", required: true }),
         algoliaFilterPath: field("string", { default: inherited("collection.route.baseDir"), example: "notes/dev", required: true }),
         ...renderRegionsSchema(factory),