This commit is contained in:
Erzbir
2026-08-22 15:30:25 +08:00
parent f31a7431aa
commit 97a8234ef3
+15 -30
View File
@@ -2,6 +2,8 @@
一款简洁, 复古的 Terminal 风格 Halo 主题 一款简洁, 复古的 Terminal 风格 Halo 主题
![主题预览](./screenshot.png)
![配色预览](https://raw.githubusercontent.com/Erzbir/halo-theme-terminal/refs/heads/main/preview/scheme.png) ![配色预览](https://raw.githubusercontent.com/Erzbir/halo-theme-terminal/refs/heads/main/preview/scheme.png)
## 功能 ## 功能
@@ -50,7 +52,7 @@
### 通用设置 ### 通用设置
| 设置 | 配置名 | 说明 | | 设置 | 配置名 | 说明 |
|----------|--------------------------------------------------|-----------------------------------------| |-------|---------------------------------------------------|-------------------------|
| 时间格式 | `general.time_style`, `general.custom_time_style` | 支持预设格式或自定义 Java 时间格式字符串 | | 时间格式 | `general.time_style`, `general.custom_time_style` | 支持预设格式或自定义 Java 时间格式字符串 |
| 偏好有效期 | `general.prefer_ttl` | 访客偏好的保存小时数, `0` 表示永久保存 | | 偏好有效期 | `general.prefer_ttl` | 访客偏好的保存小时数, `0` 表示永久保存 |
| PJAX | `general.pjax_enable` | 默认关闭, 开启后站内链接只更新主要内容 | | PJAX | `general.pjax_enable` | 默认关闭, 开启后站内链接只更新主要内容 |
@@ -61,7 +63,7 @@
### 页头 ### 页头
| 设置 | 配置名 | 说明 | | 设置 | 配置名 | 说明 |
|----------|----------------------------------------------|---------------------------------| |---------|---------------------------------------|------------------|
| Logo 文本 | `header.logo` | 留空时使用 Halo 站点标题 | | Logo 文本 | `header.logo` | 留空时使用 Halo 站点标题 |
| 搜索按钮 | `header.search_button_enable` | 搜索组件插件可用时展示 | | 搜索按钮 | `header.search_button_enable` | 搜索组件插件可用时展示 |
| 配色切换按钮 | `header.color_scheme_switcher_enable` | 展示自动发现的配色列表 | | 配色切换按钮 | `header.color_scheme_switcher_enable` | 展示自动发现的配色列表 |
@@ -74,7 +76,7 @@
### 字体与排版 ### 字体与排版
| 设置 | 配置名 | 说明 | | 设置 | 配置名 | 说明 |
|----------|--------------------------------------|-----------------------------------------| |-------|-------------------------------------|----------------------------------------|
| 默认字体 | `typography.default_font` | 系统字体, JetBrains Mono, Hack 或 Fira Code | | 默认字体 | `typography.default_font` | 系统字体, JetBrains Mono, Hack 或 Fira Code |
| 自定义字体 | `typography.custom_font_enable` | 启用自定义字体列表 | | 自定义字体 | `typography.custom_font_enable` | 启用自定义字体列表 |
| 字体列表 | `typography.custom_fonts` | 按顺序组成字体 fallback | | 字体列表 | `typography.custom_fonts` | 按顺序组成字体 fallback |
@@ -95,7 +97,7 @@
### 布局 ### 布局
| 设置 | 配置名 | 说明 | | 设置 | 配置名 | 说明 |
|----------|-----------------------------|---------------------------------| |--------|----------------------------|-----------------------------|
| 全屏布局 | `layout.fullscreen_layout` | 正文使用全部可用宽度 | | 全屏布局 | `layout.fullscreen_layout` | 正文使用全部可用宽度 |
| 正文最大宽度 | `layout.max_width` | 接受 `960px`, `80vw` 等 CSS 长度 | | 正文最大宽度 | `layout.max_width` | 接受 `960px`, `80vw` 等 CSS 长度 |
| 正文内边距 | `layout.content_padding` | 同时控制桌面端和移动端正文内边距 | | 正文内边距 | `layout.content_padding` | 同时控制桌面端和移动端正文内边距 |
@@ -105,7 +107,7 @@
### 配色 ### 配色
| 设置 | 配置名 | 说明 | | 设置 | 配置名 | 说明 |
|---------|----------------------------------------------|---------------------------------| |-------|-------------------------------------|-----------------|
| 默认外观 | `color_scheme.default_appearance` | 可选浅色, 深色或跟随系统 | | 默认外观 | `color_scheme.default_appearance` | 可选浅色, 深色或跟随系统 |
| 浅色方案 | `color_scheme.light_color_scheme` | 浅色模式使用的内置或自定义配色 | | 浅色方案 | `color_scheme.light_color_scheme` | 浅色模式使用的内置或自定义配色 |
| 深色方案 | `color_scheme.dark_color_scheme` | 深色模式使用的内置或自定义配色 | | 深色方案 | `color_scheme.dark_color_scheme` | 深色模式使用的内置或自定义配色 |
@@ -121,7 +123,7 @@
### 全局样式 ### 全局样式
| 设置 | 配置名 | 说明 | | 设置 | 配置名 | 说明 |
|----------|------------------------------------------------------------|---------------------------------------------------| |--------|----------------------------------------------------------------------|---------------------------------------------------|
| 默认像素风格 | `global_style.pixel_style` | 使用像素字体和像素图标 | | 默认像素风格 | `global_style.pixel_style` | 使用像素字体和像素图标 |
| 列表标记 | `global_style.list_style` | 接受 CSS `list-style` 值 | | 列表标记 | `global_style.list_style` | 接受 CSS `list-style` 值 |
| 通用边线 | `global_style.border_width`, `global_style.border_style` | 控制通用边线宽度和样式 | | 通用边线 | `global_style.border_width`, `global_style.border_style` | 控制通用边线宽度和样式 |
@@ -139,25 +141,17 @@
|-----|-----------------------------------| |-----|-----------------------------------|
| 首页 | 公告标题, 公告内容, 社交资料, 置顶图标, 图标位置和文章标签 | | 首页 | 公告标题, 公告内容, 社交资料, 置顶图标, 图标位置和文章标签 |
| 文章页 | 文章目录, 目录默认状态和文章标签 | | 文章页 | 文章目录, 目录默认状态和文章标签 |
| 归档页 | 页面标题和文章标签 | | 归档页 | 页面标题, 文章标签, 分页和年份展开模式 |
| 分类页 | 分类列表标题和分类详情标题 | | 分类页 | 分类列表标题和分类详情标题 |
| 标签页 | 标签列表标题和标签详情标题 | | 标签页 | 标签列表标题和标签详情标题 |
| 友链页 | 页面标题 | | 友链页 | 页面标题 |
文章目录会读取正文中的 `h1` 到 `h4`, `auto` 模式在普通布局中默认展开, 在全屏布局中默认收起, 目录也会根据浏览器宽度和正文右侧空间调整位置 文章目录会读取正文中的 `h1` 到 `h4`, `auto` 模式在普通布局中默认展开, 在全屏布局中默认收起, 目录也会根据浏览器宽度和正文右侧空间调整位置.
### 社交资料 ### 社交资料
首页可以显示以下资料: 首页可以添加任意社交资料. 每项资料可配置普通图标, 像素风格图标, 名称和链接; 链接支持
`http://`, `https://`, `mailto:` 和 `tel:`. RSS 可单独开启.
- Email
- GitHub
- Discord
- Telegram
- Facebook
- Instagram
- X
- RSS
### 备案信息 ### 备案信息
@@ -231,7 +225,7 @@ html[data-theme-color-scheme='matrix'] {
### 常用颜色变量 ### 常用颜色变量
| 变量 | 用途 | | 变量 | 用途 |
|----------------------------------|----------------------------| |---------------------------------|---------------------|
| `--color-theme-background` | 页面和基础背景 | | `--color-theme-background` | 页面和基础背景 |
| `--color-theme-text` | 正文和主要文字 | | `--color-theme-text` | 正文和主要文字 |
| `--color-theme-text-secondary` | 摘要, 插件等辅助文字 | | `--color-theme-text-secondary` | 摘要, 插件等辅助文字 |
@@ -310,7 +304,7 @@ PJAX 默认关闭, 开启后站内 `a[data-pjax]` 链接会更新以下区域:
- `.content` - `.content`
- `.ex-pjax` - `.ex-pjax`
预留了一个 `.ex-pjax` 类名, 可以通过将注入的标签设置 `class="ex-pjax"` 来使用 PJAX, 也可以直接使用 `data-pjax` 属性 `a[data-pjax]` 用于触发 PJAX 导航. `.ex-pjax` 是额外的内容替换区域, 需要确保当前页面和目标页面都存在对应元素.
```html ```html
@@ -319,20 +313,11 @@ PJAX 默认关闭, 开启后站内 `a[data-pjax]` 链接会更新以下区域:
</div> </div>
``` ```
OR:
```html
<div data-pjax>
Dynamic content
</div>
```
如果要注入 `<script>` 或 `<link rel="stylesheet">`, 根据插入的位置需要为标签添加一些属性才能保证行为正常 如果要注入 `<script>` 或 `<link rel="stylesheet">`, 根据插入的位置需要为标签添加一些属性才能保证行为正常
- `<head>`: 重新执行所有请求页面新插入的无 `data-no-pjax` 属性的 `<script>` 和 `<link rel="stylesheet">` - `<head>`: 重新执行所有请求页面新插入的无 `data-no-pjax` 属性的 `<script>` 和 `<link rel="stylesheet">`
- `<footer>`: 重新执行有 `data-pjax` 属性的 `<script>` 和 `<link rel="stylesheet">` - `<footer>`: 重新执行有 `data-pjax` 属性的 `<script>` 和 `<link rel="stylesheet">`
- `.content`: 重新执行有 `data-pjax` 属性的 `<script>` 和 `<link rel="stylesheet">` - `.content`: 重新执行有 `data-pjax` 属性的 `<script>`
设置 `data-no-pjax` 属性, 可以防止被 PJAX 处理 设置 `data-no-pjax` 属性, 可以防止被 PJAX 处理