diff --git a/README.md b/README.md index 000c4cf..ae80e1f 100644 --- a/README.md +++ b/README.md @@ -7,13 +7,12 @@ ## 功能 - Terminal 风格的响应式页面布局 -- 深色, 浅色和跟随系统 3 种默认模式 -- 12 套内置配色 -- 访客配色选择器 +- 浅色, 深色和跟随系统 3 种外观模式, 页头按钮会显示太阳, 月亮或圆圈图标 +- 12 套内置配色和多套自定义配色 +- 可分别控制页头的搜索, 配色选择, 外观切换和像素化按钮 - 常规图标和像素图标切换 -- 内置 JetBrains Mono, Hack 字体, 可切换 -- 可设置为访问者系统字体 -- 自定义字体 +- 内置 JetBrains Mono, Hack 和 Fira Code 字体, 也可使用访客系统字体 +- 支持多字体 fallback, PostScript Name 本地匹配和高级 `@font-face` 配置 - 基础行高, 文章段落间距和文章元信息分隔符配置 - 首页公告打字效果 - 文章目录和目录展开状态配置 @@ -42,66 +41,97 @@ | 朋友圈 | `templates/friends.html`, 需要朋友圈插件 | | 瞬间 | `templates/moments.html`, 需要瞬间插件 | | 项目作品集 | `templates/portfolio.html`, `templates/portfolio-detail.html`, 需要作品集插件 | -| 搜索 | 启用搜索组件时页头显示搜索按钮 | +| 搜索 | 搜索组件可用且开启页头搜索按钮时显示 | | 评论 | 启用评论插件并开启评论功能时显示评论组件 | | 错误页 | 提供 `404`, `5xx` 和通用错误模板 | ## 主题设置 -### 基本设置 +### 通用设置 -| 设置 | 配置名 | 说明 | -|---------|---------------------|----------------------| -| Logo 文本 | `basic.logo` | 留空时使用 Halo 站点标题 | -| 启用 PJAX | `basic.pjax_enable` | 默认关闭, 开启后站内链接只更新主要内容 | +| 设置 | 配置名 | 说明 | +|----------|--------------------------------------------------|-----------------------------------------| +| 时间格式 | `general.time_style`, `general.custom_time_style` | 支持预设格式或自定义 Java 时间格式字符串 | +| 偏好有效期 | `general.prefer_ttl` | 访客偏好的保存小时数, `0` 表示永久保存 | +| PJAX | `general.pjax_enable` | 默认关闭, 开启后站内链接只更新主要内容 | -### 布局和样式 +访客手动选择的外观模式, 配色和像素风格会保存在浏览器的 `localStorage` 中. 默认有效期为 24 小时, +偏好过期后会在下次访问时恢复主题默认值. 已有但没有过期时间的偏好会在升级后的首次访问时开始计算有效期. -| 设置 | 配置名 | 说明 | -|----------|--------------------------------------------------------|---------------------------------------------------| -| 全屏布局 | `style.fullscreen_layout` | 隐藏两侧占位区域, 正文使用全部可用宽度 | -| 正文最大宽度 | `style.max_width` | 接受 `960px`, `80vw` 等 CSS 长度 | -| 正文内边距 | `style.content_padding` | 同时控制桌面端和移动端正文内边距 | -| 正文媒体最大宽度 | `style.media_max_width` | 全屏布局中控制图片, 视频和 `figure` 宽度 | -| 表格铺满正文 | `style.table_full_width` | 让正文中的表格宽度为 `100%` | -| 基础字体大小 | `style.font_size` | 接受 `16px`, `1rem` 等 CSS 长度 | -| 基础行高 | `style.line_height` | 接受 `28px`, `1.75rem` 或 `calc(...)` 等 CSS 长度 | -| 文章段落间距 | `style.post_paragraph_spacing` | 控制文章正文段落的上下间距 | -| 元信息分隔符 | `style.post_meta_divider` | 控制文章时间, 作者和标签等元信息之间的分隔符 | -| 默认像素风格 | `style.pixel_style` | 使用像素字体和像素图标 | -| 自定义字体 | `style.custom_font_enable` | 上传字体文件并填写字体内部名称 | -| 无序列表标记 | `style.list_marker` | 可选 `-`, `*`, `+`, `>` 或默认标记 | -| 通用边线 | `style.border_width`, `style.border_style` | 控制通用边线宽度和样式 | -| 表格边线 | `style.table_border_width`, `style.table_border_style` | 控制表格边线宽度和样式 | -| 标题分隔线 | `style.title_divider_style` | 可选 `solid`, `dashed`, `dotted`, `double` 或 `none` | -| 时间格式 | `style.time_style` | 支持预设格式或 Java 时间格式字符串 | -| 自定义 CSS | `style.custom` | 将 CSS 写入页面 `
` 中的 `