halo-theme-WarmIsland/docs/guide/getting-started.md

快速开始

WarmIsland（暖屿）是一款为 Halo 打造的生活博客主题，具有独特的暖色调设计语言和丰富的功能模块。

主题特色

• 🎨 暖色调设计 — 呼吸光球、毛玻璃导航栏、滚动渐入动画
• 🌙 深色模式 — 跟随系统/浅色/深色三种方案，平滑切换
• 📱 响应式布局 — 桌面到手机完美适配
• 📝 沉浸阅读 — 侧边目录、进度条、代码高亮、图片灯箱
• 🔌 插件生态 — 瞬间、图库、友链、朋友圈、豆瓣、装备、Steam
• ⚙️ 灵活配置 — 全维度自定义面板，无需改代码

前置要求

• Halo >= 2.24.0
• 已安装并运行 Halo 实例

安装方式

方式一：应用市场安装（推荐）

1. 登录 Halo 后台管理控制台
2. 进入 主题 → 安装
3. 搜索「WarmIsland 暖屿」或从应用市场安装
4. 点击 启用 激活主题

方式二：本地上传安装

1. 从 GitHub Releases 下载最新版本的 .zip 安装包
2. 登录 Halo 后台管理控制台
3. 进入 主题 → 安装 → 选择 本地上传
4. 上传下载的 .zip 文件
5. 点击 启用 激活主题

方式三：Git 克隆安装

1. SSH 登录服务器，进入 Halo 主题目录：

cd ~/.halo2/themes

2. 克隆主题仓库：

git clone https://github.com/nxxy335top/halo-theme-WarmIsland.git warm-island

3. 在 Halo 后台 主题 管理页面中找到 WarmIsland，点击 启用

初始配置

安装并启用主题后，建议按以下顺序进行初始配置：

第一步：基础信息

进入 主题 → 设置 → 基础设置：

• 填写 站点名称（显示在导航栏和页脚）
• 填写 站点描述（用于 SEO）
• 上传 自定义 Logo 和 Favicon

第二步：外观样式

进入 样式设置：

• 选择 配色方案（跟随系统/浅色/深色）
• 设置 强调色（默认 #d4764e 暖橘色）
• 选择 圆角风格 和 容器宽度

第三步：导航菜单

1. 进入 Halo 后台 → 菜单 → 创建新菜单
2. 添加菜单项（首页、归档、瞬间等）
3. 主题自动读取主菜单渲染导航栏

第四步：Hero 首屏

进入 Hero 首屏 设置：

• 设置主标题和副标题
• 选择描述文案来源（一言/自定义/无）
• 可选上传背景图片

第五步：页脚信息

进入 页脚 设置：

• 填写版权信息
• 添加社交链接（GitHub、微博等）
• 可选添加自定义 HTML（统计代码等）

下一步

• 基础设置 — 完整的主题配置说明
• 样式设置 — 调整配色、圆角、动画