docs: update

This commit is contained in:
Erzbir
2025-11-20 15:32:39 +08:00
parent 64ee475a0c
commit c04952408a
+24 -26
View File
@@ -1,7 +1,5 @@
# Terminal # Terminal
一款 Terminal 风格的 Halo 主题, 基于 wan92hen 的 [Terminal](https://github.com/wan92hen/theme-terminal) 修改
<img src="https://raw.githubusercontent.com/Erzbir/halo-theme-terminal/refs/heads/main/preview/scheme.png" alt="scheme"> <img src="https://raw.githubusercontent.com/Erzbir/halo-theme-terminal/refs/heads/main/preview/scheme.png" alt="scheme">
前往: https://erzbir.com 查看 前往: https://erzbir.com 查看
@@ -18,30 +16,6 @@
8. 子菜单 8. 子菜单
9. 像素化 9. 像素化
## 关于 PJAX
**目前 PJAX 功能需要手动开启**
### 代码注入需注意的事项
预留了一个 `.ex-pjax` 类名, 可以通过将注入的标签设置 `class="ex-pjax"` 来使用 PJAX
如果要注入 `<script>`, 根据插入的位置需要为标签添加一些属性才能保证行为正常
在 `<head>`, `<footer>`, 以及 `.content` 下的 `<script>` 会被重新执行, 行为略有不同
- `<head>`: 重新执行所有请求页面新插入的无 `no-pjax` 属性的 `<script>`
- `<footer>`: 重新执行有 `data-pjax` 属性的 `<script>`
- `.content`: 重新执行有 `data-pjax` 属性的 `<script>`
设置 `no-pjax` 属性, 可以防止 `<script>` 被 PJAX 重新执行
### 已知的问题
首屏就加载全部 css 和 script 的情况下不会出现问题, 只有在动态注入的时候会出现一些问题
- highlightjs 插件的 _复制按扭_ 数量会随页面切换增加
## 关于自定义 CSS ## 关于自定义 CSS
目前只有原始 CSS 输入, 在样式设置中可以填入原始 CSS, 主题会直接将这段 CSS 插入到 head 目前只有原始 CSS 输入, 在样式设置中可以填入原始 CSS, 主题会直接将这段 CSS 插入到 head
@@ -146,6 +120,30 @@ html {
} }
``` ```
## 关于 PJAX
**目前 PJAX 功能需要手动开启**
### 代码注入需注意的事项
预留了一个 `.ex-pjax` 类名, 可以通过将注入的标签设置 `class="ex-pjax"` 来使用 PJAX, 也可以直接使用 `data-pjax` 属性
如果要注入 `<script>`, 根据插入的位置需要为标签添加一些属性才能保证行为正常
在 `<head>`, `<footer>`, 以及 `.content` 下的 `<script>` 会被重新执行, 行为略有不同
- `<head>`: 重新执行所有请求页面新插入的无 `no-pjax` 属性的 `<script>`
- `<footer>`: 重新执行有 `data-pjax` 属性的 `<script>`
- `.content`: 重新执行有 `data-pjax` 属性的 `<script>`
设置 `no-pjax` 属性, 可以防止 `<script>` 被 PJAX 重新执行
### 已知的问题
首屏就加载全部 css 和 script 的情况下不会出现问题, 只有在动态注入的时候会出现一些问题
- highlightjs 插件的 _复制按扭_ 数量会随页面切换增加
## 构建 ## 构建
项目使用原生 ES 模块, 用 `esbuild` 来构建, 使用 `pnpm` 管理依赖 项目使用原生 ES 模块, 用 `esbuild` 来构建, 使用 `pnpm` 管理依赖