Files
halo-theme-WarmIsland/docs/guide/getting-started.md
T
nxxy335 dda86294b0 fix: 按 Halo 应用市场审核意见整改外部资源与隐私(v1.2.5 修订)
- 默认零第三方自动请求:移除 21 个模板的 preconnect/dns-prefetch、PrismJS+autoloader、qrcode-generator 及内置一言/IP 定位 API
- 一言与代码高亮配色改为自托管;欢迎弹窗自定义 IP 接口改为 opt-in;微信分享改为复制链接;LightGallery 按 GPLv3 使用
- README 新增「外部资源与隐私」「验证与回归测试」章节,修正无效链接并补充字体 OFL 来源;同步 docs 与修正虚构的目录树
- friends 等 12 处 #strings.substring 加空值保护;logo 由两份 1.5MB 压缩去重为单份 146KB
- 新增 pnpm audit:external 与打包前置合规审计;制品补齐 34 个 docs 文档与预览图
2026-11-11 14:37:09 +08:00

2.6 KiB
Raw Blame History

快速开始

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

主题特色

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

前置要求

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

安装方式

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

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

方式二:本地上传安装

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

初始配置

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

第一步:基础信息

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

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

第二步:外观样式

进入 样式设置:

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

第三步:导航菜单

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

第四步:Hero 首屏

进入 Hero 首屏 设置:

  • 设置主标题和副标题
  • 选择描述文案来源(一言 / 自定义 / 无);「一言」默认读取主题内置的本地句子库,不请求外部服务
  • 可选上传背景图片

第五步:页脚信息

进入 页脚 设置:

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

下一步