nxxy335
dda86294b0
- 默认零第三方自动请求：移除 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 文档与预览图
82 lines
2.6 KiB
Markdown
82 lines
2.6 KiB
Markdown
# 快速开始
|
||
|
||
WarmIsland（暖屿）是一款为 [Halo](https://halo.run) 打造的博客主题。暖如灯火，静如留白——它以柔和的色调和舒缓的节奏回归内容本身，为记录与阅读留出一方安静从容的角落。
|
||
|
||
## 主题特色
|
||
|
||
- 🎨 **暖色调设计** — 呼吸光球、毛玻璃导航栏、滚动渐入动画
|
||
- 🌙 **深色模式** — 跟随系统/浅色/深色三种方案，平滑切换
|
||
- 📱 **响应式布局** — 桌面到手机完美适配
|
||
- 📝 **沉浸阅读** — 侧边目录、进度条、代码高亮、图片灯箱
|
||
- 🔌 **插件生态** — 瞬间、图库、友链、朋友圈、豆瓣、装备、Steam
|
||
- ⚙️ **灵活配置** — 全维度自定义面板，无需改代码
|
||
|
||
## 前置要求
|
||
|
||
- Halo >= 2.24.0
|
||
- 已安装并运行 Halo 实例
|
||
|
||
## 安装方式
|
||
|
||
### 方式一：应用市场安装（推荐）
|
||
|
||
1. 登录 Halo 后台管理控制台
|
||
2. 进入 **主题** → **安装**
|
||
3. 搜索「WarmIsland 暖屿」或从应用市场安装
|
||
4. 点击 **启用** 激活主题
|
||
|
||
### 方式二：本地上传安装
|
||
|
||
1. 从 [源码仓库](https://git.nxxy335.top/nxxy335/halo-theme-WarmIsland) 的 Releases / 发行版页面下载最新版本的 `.zip` 安装包
|
||
2. 登录 Halo 后台管理控制台
|
||
3. 进入 **主题** → **安装** → 选择 **本地上传**
|
||
4. 上传下载的 `.zip` 文件
|
||
5. 点击 **启用** 激活主题
|
||
|
||
## 初始配置
|
||
|
||
安装并启用主题后，建议按以下顺序进行初始配置：
|
||
|
||
### 第一步：基础信息
|
||
|
||
进入 **主题** → **设置** → **基础设置**：
|
||
|
||
- 填写 **站点名称**（显示在导航栏和页脚）
|
||
- 填写 **站点描述**（用于 SEO）
|
||
- 上传 **自定义 Logo** 和 **Favicon**
|
||
|
||
### 第二步：外观样式
|
||
|
||
进入 **样式设置**：
|
||
|
||
- 选择 **配色方案**（跟随系统/浅色/深色）
|
||
- 设置 **强调色**（默认 `#d4764e` 暖橘色）
|
||
- 选择 **圆角风格** 和 **容器宽度**
|
||
|
||
### 第三步：导航菜单
|
||
|
||
1. 进入 Halo 后台 → **菜单** → 创建新菜单
|
||
2. 添加菜单项（首页、归档、瞬间等）
|
||
3. 主题自动读取主菜单渲染导航栏
|
||
|
||
### 第四步：Hero 首屏
|
||
|
||
进入 **Hero 首屏** 设置：
|
||
|
||
- 设置主标题和副标题
|
||
- 选择描述文案来源（一言 / 自定义 / 无）；「一言」默认读取主题内置的本地句子库，不请求外部服务
|
||
- 可选上传背景图片
|
||
|
||
### 第五步：页脚信息
|
||
|
||
进入 **页脚** 设置：
|
||
|
||
- 填写版权信息
|
||
- 添加社交链接（GitHub、微博等）
|
||
- 可选添加自定义 HTML（统计代码等）
|
||
|
||
## 下一步
|
||
|
||
- [基础设置](/config/basic) — 完整的主题配置说明
|
||
- [样式设置](/config/style) — 调整配色、圆角、动画
|