增加i18n支持

2026-05-20 17:18:33 +08:00
parent 6cd8167b49
commit bab8380894
80 changed files with 1363 additions and 743 deletions
@@ -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
+分享功能会自动携带文章标题和链接，无需手动配置分享内容。移动端会优先显示适合移动端的分享方式。
+:::
+
 ## 阅读增强功能

 除了可配置的项目外，文章详情页还包含以下内置功能：
@@ -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) — 调整配色、圆角、动画等视觉表现
@@ -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);