feat(v1.2.7): 全面校准文档并精简三个可选 API 配置项文案

- 文档对齐 1.2.7:feed/RSS 聚合改由官方链接管理插件订阅承担、Halo 要求统一 >=2.27.0、补齐设置分组文档、清理与代码不符的描述,并修复正文引用块留白
- 三个可选 API 设置项 help 只保留功能说明,隐私披露统一由 README「外部资源与隐私」与文档站承载;字段恢复按开关条件显示,修正配置块缩进
- audit:external 改为防回潮检查:字段存在、help 不得出现披露文案、README 必须保留隐私披露章节
This commit is contained in:
nxxy335 committed 2026-11-11 22:34:32 +08:00
1 parent c92429d139
commit 5c7c6325b1
34 files changed
+500 -210

No files matched your search

+20 -6
View File
@@ -8,13 +8,15 @@ WarmIsland(暖屿)是一款为 [Halo](https://halo.run) 打造的博客主
- 🌙 **深色模式** — 跟随系统/浅色/深色三种方案,平滑切换
- 📱 **响应式布局** — 桌面到手机完美适配
- 📝 **沉浸阅读** — 侧边目录、进度条、代码高亮、图片灯箱
- 🔌 **插件生态** — 瞬间、图库、友链、朋友圈、豆瓣、装备、Steam
- ⚙️ **灵活配置** — 全维度自定义面板,无需改代码
- 🔌 **插件生态** — 瞬间、图库、友链、订阅动态、豆瓣、装备、Steam
- 🔒 **默认零第三方请求** — 静态资源全部自托管,可选 API 默认留空
- ⚙️ **灵活配置** — 17 个分组 / 126 个配置项,无需改代码
## 前置要求
- Halo >= 2.24.0
- **Halo >= 2.27.0**(主题 `theme.yaml` 声明 `requires: ">=2.27.0"`;页面布局契约与微信读书页面依赖 2.27 的能力)
- 已安装并运行 Halo 实例
- 如需插件页面(瞬间、图库、友链、订阅等),另需安装对应插件
## 安装方式
@@ -33,6 +35,11 @@ WarmIsland(暖屿)是一款为 [Halo](https://halo.run) 打造的博客主
4. 上传下载的 `.zip` 文件
5. 点击 **启用** 激活主题
::: warning
从源码自行打包时,必须先执行 `pnpm release`(build → snapshot → package)。
只上传源码或漏跑构建的 ZIP 会因缺少 `templates/` 导致首页 404,详见 [FAQ](/faq)。
:::
## 初始配置
安装并启用主题后,建议按以下顺序进行初始配置:
@@ -49,8 +56,8 @@ WarmIsland(暖屿)是一款为 [Halo](https://halo.run) 打造的博客主
进入 **样式设置**:
- 选择 **配色方案**(跟随系统/浅色/深色)
- 设置 **强调色**(默认 `#d4764e` 暖橘色)
- 选择 **配色方案**(跟随系统/浅色/深色)与 **主题配色**(11 套预设)
- 设置 **强调色**(留空则跟随所选配色,暖屿·赤陶为 `#d4764e`)
- 选择 **圆角风格** 和 **容器宽度**
### 第三步:导航菜单
@@ -64,7 +71,7 @@ WarmIsland(暖屿)是一款为 [Halo](https://halo.run) 打造的博客主
进入 **Hero 首屏** 设置:
- 设置主标题和副标题
- 选择描述文案来源(默认「无」/ 一言 / 自定义);默认不显示描述、不发起请求;选「一言」自动填入 `https://v1.hitokoto.cn/`,清空该字段则使用内置本地句子库(零外部请求)
- 选择描述文案来源(默认「无」/ 一言 / 自定义);默认不显示描述、不发起请求;「自定义一言 API」字段在来源非「无」时显示并默认预填 `https://v1.hitokoto.cn/`(仅「一言」模式生效),清空该字段则使用内置本地句子库(零外部请求)
- 可选上传背景图片
### 第五步:页脚信息
@@ -75,7 +82,14 @@ WarmIsland(暖屿)是一款为 [Halo](https://halo.run) 打造的博客主
- 添加社交链接(GitHub、微博等)
- 可选添加自定义 HTML(统计代码等)
### 可选:订阅动态页面
如需展示博友文章动态,安装官方「链接管理」(PluginLinks)插件并维护 RSS 订阅源,
再新建一个页面选择「订阅」自定义模板即可。原先的「朋友圈」插件已不再提供,
详见[订阅页面](/pages/subscriptions)。
## 下一步
- [基础设置](/config/basic) — 完整的主题配置说明
- [样式设置](/config/style) — 调整配色、圆角、动画
- [订阅配置](/config/subscriptions) — feed 聚合动态设置