nxxy335
c92429d139
版本升至 1.2.6（1.2.5 审核被拒未发布，整改内容并入本版）；README 新增原创声明（4.2.1/4.2.2 不适用）；Hero 描述来源默认 none，选一言自动填入官方接口、清空回退本地句子库；文档列出两个 IP 定位候选接口与访客 IP 披露文案；含上一轮 4.4.2 内容渲染安全与 5.2 字体许可证修复。
2.7 KiB
2.7 KiB
快速开始
WarmIsland（暖屿）是一款为 Halo 打造的博客主题。暖如灯火，静如留白——它以柔和的色调和舒缓的节奏回归内容本身，为记录与阅读留出一方安静从容的角落。
主题特色
- 🎨 暖色调设计 — 呼吸光球、毛玻璃导航栏、滚动渐入动画
- 🌙 深色模式 — 跟随系统/浅色/深色三种方案，平滑切换
- 📱 响应式布局 — 桌面到手机完美适配
- 📝 沉浸阅读 — 侧边目录、进度条、代码高亮、图片灯箱
- 🔌 插件生态 — 瞬间、图库、友链、朋友圈、豆瓣、装备、Steam
- ⚙️ 灵活配置 — 全维度自定义面板，无需改代码
前置要求
- Halo >= 2.24.0
- 已安装并运行 Halo 实例
安装方式
方式一：应用市场安装（推荐）
- 登录 Halo 后台管理控制台
- 进入 主题 → 安装
- 搜索「WarmIsland 暖屿」或从应用市场安装
- 点击 启用 激活主题
方式二：本地上传安装
- 从 源码仓库 的 Releases / 发行版页面下载最新版本的
.zip安装包 - 登录 Halo 后台管理控制台
- 进入 主题 → 安装 → 选择 本地上传
- 上传下载的
.zip文件 - 点击 启用 激活主题
初始配置
安装并启用主题后，建议按以下顺序进行初始配置：
第一步：基础信息
进入 主题 → 设置 → 基础设置：
- 填写 站点名称（显示在导航栏和页脚）
- 填写 站点描述（用于 SEO）
- 上传 自定义 Logo 和 Favicon
第二步：外观样式
进入 样式设置：
- 选择 配色方案（跟随系统/浅色/深色）
- 设置 强调色（默认
#d4764e暖橘色） - 选择 圆角风格 和 容器宽度
第三步：导航菜单
- 进入 Halo 后台 → 菜单 → 创建新菜单
- 添加菜单项（首页、归档、瞬间等）
- 主题自动读取主菜单渲染导航栏
第四步：Hero 首屏
进入 Hero 首屏 设置：
- 设置主标题和副标题
- 选择描述文案来源（默认「无」/ 一言 / 自定义）；默认不显示描述、不发起请求；选「一言」自动填入
https://v1.hitokoto.cn/，清空该字段则使用内置本地句子库（零外部请求） - 可选上传背景图片
第五步：页脚信息
进入 页脚 设置：
- 填写版权信息
- 添加社交链接（GitHub、微博等）
- 可选添加自定义 HTML（统计代码等）