Files
halo-theme-WarmIsland/docs/guide/getting-started.md
T
2026-05-20 17:18:33 +08:00

2.5 KiB
Raw Blame History

快速开始

WarmIsland(暖屿)是一款为 Halo 打造的博客主题。暖如灯火,静如留白——它以柔和的色调和舒缓的节奏回归内容本身,为记录与阅读留出一方安静从容的角落。

主题特色

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

前置要求

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

安装方式

方式一:应用市场安装(推荐)

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

方式二:本地上传安装

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

初始配置

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

第一步:基础信息

进入 主题设置基础设置

  • 填写 站点名称(显示在导航栏和页脚)
  • 填写 站点描述(用于 SEO
  • 上传 自定义 LogoFavicon

第二步:外观样式

进入 样式设置

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

第三步:导航菜单

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

第四步:Hero 首屏

进入 Hero 首屏 设置:

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

第五步:页脚信息

进入 页脚 设置:

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

下一步