docs
This commit is contained in:
@@ -2,6 +2,8 @@
|
||||
|
||||
一款简洁, 复古的 Terminal 风格 Halo 主题
|
||||
|
||||

|
||||
|
||||

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