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:
1 parent
c92429d139
commit
5c7c6325b1
34 files changed
+500
-210
No files matched your search
@@ -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 聚合动态设置
|
||||
Reference in new issue
Block a user