nxxy335/halo-theme-WarmIsland
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 3 Wiki Activity

增加i18n支持

Browse Source
This commit is contained in:
nxxy335top
2026-05-20 17:18:33 +08:00
parent 6cd8167b49
commit bab8380894
80 changed files with 1363 additions and 743 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/changelog.md
+29 -5
View File
@@ -4,6 +4,8 @@
首次发布 🎉
- 🗑️ 移除侧边栏功能
### 核心功能
- 🎨 暖色调设计语言，呼吸动效光球、毛玻璃导航栏
@@ -11,6 +13,23 @@
- 📱 响应式布局，移动端专属菜单与交互体验
- ✨ 滚动渐入动画、光感跟随效果
### SEO 与结构化数据
- 🔍 Open Graph 元标签，优化社交媒体分享预览
- 📋 JSON-LD 结构化数据，提升搜索引擎理解与展示
### 国际化
- 🌐 i18n 国际化支持（简体中文、繁体中文、英语）
- 🔄 跟随浏览器语言自动匹配，也可手动指定
### 文章页增强
- 📑 目录展开模式选项（仅展开当前分组 / 全部展开）
- 📰 相关文章推荐，帮助读者发现更多内容
- 🔗 分享功能（微博 / X / Facebook / Telegram / 复制链接）
- 🖼️ 图片懒加载 blur-up 效果，优化加载体验
### 页面模板
- 🏠 Hero 首屏（一言 API / 自定义描述 / 背景图片）
@@ -30,14 +49,19 @@
- 🎯 三种导航栏样式（Glass / Minimal / Float）
- 🌓 主题切换按钮
### 性能与体验
- ⚡ preconnect / dns-prefetch 资源提示，优化外部资源加载
- 🖼️ 图片懒加载 blur-up 渐显效果
- 🔤 移除自定义字体和内置字体功能，使用系统默认字体栈，提升加载速度
### 错误页面
- 🐘 404 / 500 错误页增强（导航栏 + 页脚），方便访客返回
### 配置与自定义
- ⚙️ 丰富的主题设置面板（13 个配置分组）
- 🎨 可自定义强调色、圆角风格、容器宽度
- 📝 自定义 CSS 支持
- 🔧 页脚社交链接和自定义 HTML
### 错误页面
- 🐘 404 页面
- 🐘 500 页面
docs/config/article.md
+56
View File
@@ -17,6 +17,11 @@
| `article_show_visit_count` | 开关 | `true` | 显示阅读量统计 |
| `article_show_read_time` | 开关 | `false` | 显示预计阅读时间 |
| `article_code_theme` | 下拉 | `warm` | 代码高亮主题：`warm` / `cold` |
| `article_toc_expand` | 下拉 | `active` | 目录展开模式：`active` / `all` |
| `article_show_related` | 开关 | `false` | 显示相关文章推荐 |
| `article_related_title` | 文本 | `相关推荐` | 相关文章标题 |
| `article_show_share` | 开关 | `true` | 显示分享按钮 |
| `article_share_title` | 文本 | `分享` | 分享区域标题 |
## 详细说明
@@ -98,6 +103,57 @@ article_code_theme: warm
代码高亮支持多种编程语言，包括 JavaScript、Python、Java、Go、Rust、YAML、JSON、Bash 等。语言检测基于代码块的语言标记自动完成。
:::
### 目录展开模式（article_toc_expand）
控制文章目录的展开方式：
| 值 | 说明 |
| --- | --- |
| `active` | 仅展开当前阅读位置所在的分组，其余分组折叠（默认） |
| `all` | 全部展开，显示所有层级的目录项 |
::: tip
对于标题层级较多的长文，推荐使用 `active` 模式，可以让读者更聚焦于当前章节。对于短文或标题层级较少的文章，`all` 模式可以一次性展示完整目录结构。
:::
### 相关文章推荐（article_show_related）
开启后，文章底部会显示相关文章推荐列表，帮助读者发现更多感兴趣的内容。相关文章基于 Halo 的随机推荐算法选取。
#### 相关文章标题（article_related_title）
自定义相关文章推荐区域的标题文字，默认为「相关推荐」。仅在 `article_show_related` 开启时显示此配置项。
```yaml
article_show_related: true
article_related_title: "猜你喜欢"
```
### 分享功能（article_show_share）
开启后，文章底部会显示分享按钮，支持以下社交平台：
| 平台 | 说明 |
| --- | --- |
| 微博 | 分享到新浪微博 |
| X (Twitter) | 分享到 X |
| Facebook | 分享到 Facebook |
| Telegram | 分享到 Telegram |
| 复制链接 | 复制文章链接到剪贴板 |
#### 分享区域标题（article_share_title）
自定义分享区域的标题文字，默认为「分享」。仅在 `article_show_share` 开启时显示此配置项。
```yaml
article_show_share: true
article_share_title: "分享这篇文章"
```
::: tip
分享功能会自动携带文章标题和链接，无需手动配置分享内容。移动端会优先显示适合移动端的分享方式。
:::
## 阅读增强功能
除了可配置的项目外，文章详情页还包含以下内置功能：
docs/config/basic.md
+16
View File
@@ -13,6 +13,7 @@
| `label_search` | 文本 | `搜索` | 搜索按钮的标签文案 |
| `label_theme_switch` | 文本 | `切换主题` | 主题切换按钮的标签文案 |
| `label_archives_title` | 文本 | `归档` | 归档页面的标题文案 |
| `language` | 下拉 | `auto` | 主题界面语言 |
## 详细说明
@@ -72,6 +73,21 @@ label_archives_title: "Archives"
标签文案的修改会即时生效，无需重启 Halo。如果使用多语言场景，可以配合 Halo 的多语言插件实现更完整的国际化。
:::
### 语言（language）
设置主题界面的显示语言，影响导航栏、文章页、错误页等所有主题内置文案。提供以下选项：
| 值 | 说明 |
| --- | --- |
| `auto` | 跟随浏览器语言自动匹配（默认） |
| `zh_CN` | 简体中文 |
| `zh_TW` | 繁體中文 |
| `en` | English |
::: tip
选择 `auto` 时，主题会根据访客浏览器的语言设置自动匹配最接近的语言。如果浏览器语言不在支持列表中，将回退到简体中文。
:::
## 相关页面
- [样式设置](/config/style) — 调整配色、圆角、动画等视觉表现
docs/config/style.md
-12
View File
@@ -10,7 +10,6 @@
| `accent_color` | 颜色 | `#d4764e` | 全局强调色 |
| `border_radius` | 下拉 | `medium` | 圆角风格：`small` / `medium` / `large` |
| `layout_container_width` | 下拉 | `medium` | 容器宽度：`narrow` / `medium` / `wide` |
| `layout_sidebar` | 开关 | `false` | 启用侧边栏（开发中） |
| `animation_enabled` | 开关 | `true` | 全局动画总开关 |
| `animation_breath` | 开关 | `true` | 呼吸动画效果 |
| `animation_scroll_reveal` | 开关 | `true` | 滚动渐入动画 |
@@ -79,12 +78,6 @@ accent_color: "#8b5cf6" # 紫罗兰
| `medium` | 中等宽度，兼顾阅读体验与信息密度（默认） |
| `wide` | 宽容器，适合图片较多的站点或需要更大展示空间的场景 |
### 侧边栏（layout_sidebar）
::: danger
侧边栏功能目前仍在开发中，此选项暂不可用。开启后不会产生实际效果，请关注后续版本更新。
:::
### 动画效果
WarmIsland 提供了丰富的动画效果，所有动画都可以独立开关：
@@ -118,11 +111,6 @@ WarmIsland 提供了丰富的动画效果，所有动画都可以独立开关：
在此处编写自定义 CSS 代码，会注入到全站所有页面的 `<style>` 标签中。可以用来覆盖主题默认样式或添加全新样式。
```css
/* 示例：修改正文字体 */
body {
font-family: "LXGW WenKai", sans-serif;
}
/* 示例：自定义卡片悬停效果 */
.post-card:hover {
transform: translateY(-4px);
docs/customize/style.md
+7 -7
View File
@@ -104,18 +104,18 @@ else if (!stored && prefersDark) { isDark = true; }
| 变量 | 字体栈 | 用途 |
|------|--------|------|
| `--font-sans` | `'Noto Serif SC', 'Source Han Serif SC', Georgia, serif` | 标题、强调文字 |
| `--font-body` | `'Noto Sans SC', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif` | 正文、UI 文字 |
| `--font-mono` | `'JetBrains Mono', 'Fira Code', monospace` | 代码 |
| `--font-sans` | `Georgia, 'Noto Serif SC', 'Source Han Serif SC', serif` | 标题、强调文字 |
| `--font-body` | `-apple-system, BlinkMacSystemFont, 'Segoe UI', 'Noto Sans SC', sans-serif` | 正文、UI 文字 |
| `--font-mono` | `'JetBrains Mono', 'Fira Code', 'Cascadia Code', monospace` | 代码 |
### 设计思路
- **标题用衬线体**：Noto Serif SC 赋予标题优雅的文艺气质
- **正文用无衬线体**：Noto Sans SC 保证长文阅读的舒适度
- **代码用等宽体**：JetBrains Mono 专为代码设计
- **标题用衬线体**：Georgia 赋予标题优雅的文艺气质，回退到系统中文字体
- **正文用系统字体**：使用各平台原生系统字体栈，确保最佳阅读体验与加载性能
- **代码用等宽体**：优先使用 JetBrains Mono，回退到系统等宽字体
::: tip
这些字体不会自动加载，需要在 Halo 后台或 HTML 中引入对应的字体 CSS。推荐使用 Google Fonts 或国内 CDN 镜像。
主题使用系统默认字体栈，无需额外加载字体文件，可显著提升页面加载速度。如需使用自定义字体，可通过 [自定义 CSS](/customize/custom-css) 覆盖 `--font-sans`、`--font-body` 等变量。
:::
## 间距系统
docs/guide/getting-started.md
+1 -17
View File
@@ -1,6 +1,6 @@
# 快速开始
WarmIsland（暖屿）是一款为 [Halo](https://halo.run) 打造的生活博客主题，具有独特的暖色调设计语言和丰富的功能模块。
WarmIsland（暖屿）是一款为 [Halo](https://halo.run) 打造的博客主题。暖如灯火，静如留白——它以柔和的色调和舒缓的节奏回归内容本身，为记录与阅读留出一方安静从容的角落。
## 主题特色
@@ -33,22 +33,6 @@ WarmIsland（暖屿）是一款为 [Halo](https://halo.run) 打造的生活博
4. 上传下载的 `.zip` 文件
5. 点击 **启用** 激活主题
### 方式三：Git 克隆安装
1. SSH 登录服务器，进入 Halo 主题目录：
```bash
cd ~/.halo2/themes
```
2. 克隆主题仓库：
```bash
git clone https://github.com/nxxy335top/halo-theme-WarmIsland.git warm-island
```
3. 在 Halo 后台 **主题** 管理页面中找到 WarmIsland，点击 **启用**
## 初始配置
安装并启用主题后，建议按以下顺序进行初始配置：
docs/guide/introduction.md
+11 -2
View File
@@ -1,6 +1,6 @@
# WarmIsland 是什么？
**WarmIsland（暖屿）** 是一款为 [Halo](https://halo.run) 打造的生活博客主题。
**WarmIsland（暖屿）** 是一款为 [Halo](https://halo.run) 打造的博客主题。暖如灯火，静如留白——它以柔和的色调和舒缓的节奏回归内容本身，为记录与阅读留出一方安静从容的角落。
> 本主题由 AI 开发完成。
@@ -33,11 +33,14 @@
### 📝 阅读体验
- **文章目录** — 桌面端侧边悬浮 + 移动端底部抽屉
- **文章目录** — 桌面端侧边悬浮 + 移动端底部抽屉，支持展开模式选项
- **阅读进度条** — 实时显示阅读进度
- **代码高亮** — Prism.js 支持，Warm / Cold 双主题
- **图片灯箱** — 点击放大，支持左右切换
- **图片懒加载** — blur-up 渐显效果，优化加载体验
- **点赞功能** — 一键点赞，状态持久化
- **相关文章推荐** — 文章底部推荐相关内容
- **分享功能** — 微博 / X / Facebook / Telegram / 复制链接
### 📱 响应式
@@ -46,6 +49,12 @@
- 文章卡片自动切换为上下布局
- 目录自动切换为悬浮按钮 + 抽屉
### 🔍 SEO 与国际化
- **Open Graph 元标签** — 优化社交媒体分享预览
- **JSON-LD 结构化数据** — 提升搜索引擎理解与展示
- **i18n 国际化** — 简体中文、繁体中文、英语，支持跟随浏览器自动匹配
### 🔌 插件生态
深度集成 Halo 插件，提供丰富的扩展页面：
docs/index.md
+1 -1
View File
@@ -4,7 +4,7 @@ layout: home
hero:
name: "WarmIsland"
text: "暖屿主题文档"
tagline: 具有独特气质的生活博客主题，为 Halo 打造
tagline: 暖如灯火，静如留白。暖屿以柔和的色调和舒缓的节奏回归内容本身，为记录与阅读留出一方安静从容的角落。
actions:
- theme: brand
text: 快速开始